STDistance (type de données geography)STDistance (geography Data Type)

S’APPLIQUE À : ouiSQL Server (à partir de 2012) ouiAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2012) yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Retourne la distance la plus courte entre un point d’une instance geography et un point d’une autre instance geography.Returns the shortest distance between a point in a geography instance and a point in another geography instance.

Notes

STDistance() retourne le LineString le plus court entre deux types geography.STDistance() returns the shortest LineString between two geography types. Il s'agit d'une approximation proche de la distance géodésique.This is a close approximate to the geodesic distance. L’écart de STDistance() sur les modèles terrestres courants par rapport à la distance géodésique exacte ne dépasse pas 0,25 %.The deviation of STDistance() on common earth models from the exact geodesic distance is no more than .25%. Cela évite toute confusion quant aux subtiles différences entre longueur et distance dans les types géodésiques.This avoids confusion over the subtle differences between length and distance in geodesic types.

SyntaxeSyntax

  
.STDistance ( other_geography )  

ArgumentsArguments

other_geographyother_geography
Autre instance geography à partir de laquelle mesurer la distance par rapport à l’instance sur laquelle STDistance() est appelé.Is another geography instance from which to measure the distance between the instance on which STDistance() is invoked. Si other_geography est un ensemble vide, STDistance() retourne une valeur Null.If other_geography is an empty set, STDistance() returns null.

Types de retourReturn Types

Type de retour SQL ServerSQL Server : floatSQL ServerSQL Server return type: float

Type de retour CLR : SqlDoubleCLR return type: SqlDouble

Notes Remarks

STDistance() retourne toujours une valeur Null si les SRID (ID de référence spatiale) des instances geography ne correspondent pas.STDistance() always returns null if the spatial reference IDs (SRIDs) of the geography instances do not match.

Notes

Les méthodes du type de données geography qui calculent une aire ou une distance retournent des résultats distincts selon le SRID de l’instance utilisée dans la méthode.Methods on the geography data type that calculate an area or distance will return different results based on the SRID of the instance used in the method. Pour plus d’informations sur les SRID, consultez Identificateurs de référence spatiale (SRID).For more information about SRIDs, see Spatial Reference Identifiers (SRIDs).

ExemplesExamples

L’exemple suivant trouve la distance entre deux instances geography.The following example finds the distance between two geography instances.

DECLARE @g geography;  
DECLARE @h geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SET @h = geography::STGeomFromText('POINT(-122.34900 47.65100)', 4326);  
SELECT @g.STDistance(@h);  

 Voir aussiSee Also

Méthodes OGC sur des instances geographyOGC Methods on Geography Instances