STDistance (type de données geometry)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstancePoint de terminaison analytique SQL dans Microsoft FabricEntrepôt dans Microsoft Fabric

Retourne la distance la plus courte entre un point d’une instance geometry et un point d’une autre instance geometry.

Syntaxe

  
.STDistance ( other_geometry )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez Versions antérieures de la documentation.

Arguments

other_geometry
Autre instance geometry à partir de laquelle mesurer la distance par rapport à l’instance sur laquelle STDistance() est appelé. Si other_geometry est un ensemble vide, STDistance() retourne une valeur Null.

Types de retour

Type de retour SQL Server : float

Type de retour CLR : SqlDouble

Remarques

STDistance() retourne toujours une valeur Null si les SRID (ID de référence spatiale) des instances geometry ne correspondent pas.

Exemples

DECLARE @g geometry;  
DECLARE @h geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))', 0);  
SET @h = geometry::STGeomFromText('POINT(10 10)', 0);  
SELECT @g.STDistance(@h);

Voir aussi

Vue d’ensemble des index spatiaux
Méthodes OGC sur des instances geography