STDistance (type de données geography)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure 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 )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

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);

Voir aussi

Méthodes OGC sur des instances Geography