STDistance (type de données geography)
S’applique à : 
SQL Server Azure SQL Database Azure SQL Managed Instance
Retourne la distance la plus courte entre un point d’une instance geography et un point d’une autre instance geography.
Notes
STDistance() retourne le LineString le plus court entre deux types geography. Il s'agit d'une approximation proche de la distance géodésique. L’écart de STDistance() sur les modèles terrestres courants par rapport à la distance géodésique exacte ne dépasse pas 0,25 %. Cela évite toute confusion quant aux subtiles différences entre longueur et distance dans les types géodésiques.
Syntaxe
.STDistance ( other_geography )
Arguments
other_geography
Autre instance geography à partir de laquelle mesurer la distance par rapport à l’instance sur laquelle STDistance() est appelé. Si other_geography est un ensemble vide, STDistance() retourne une valeur Null.
Types de retour
Type de retour SQL Server : float
Type de retour CLR : SqlDouble
Remarques
Le résultat est exprimé dans l’unité de mesure définie par l’identificateur de référence spatiale (SRID) de données spatiales. STDistance() retourne toujours une valeur Null si les SRID (ID de référence spatiale) des instances geography ne correspondent pas.
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. Pour plus d’informations sur les SRID, consultez Identificateurs de référence spatiale (SRID).
Exemples
L’exemple suivant trouve la distance entre deux instances geography.
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);