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

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

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

SyntaxeSyntax

  
.STDistance ( other_geometry )  

ArgumentsArguments

other_geometryother_geometry
Autre instance geometry à partir de laquelle mesurer la distance par rapport à l’instance sur laquelle STDistance() est appelé.Is another geometry instance from which to measure the distance between the instance on which STDistance() is invoked. Si other_geometry est un ensemble vide, STDistance() retourne une valeur Null.If other_geometry 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 geometry ne correspondent pas.STDistance() always returns null if the spatial reference IDs (SRIDs) of the geometry instances do not match.

ExemplesExamples

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 aussiSee Also

Vue d’ensemble des index spatiaux Spatial Indexes Overview
Méthodes OGC sur des instances geographyOGC Methods on Geometry Instances