STDistance (geometry-Datentyp)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceSQL Analytics-Endpunkt in Microsoft FabricWarehouse in Microsoft Fabric

Gibt die kürzeste Entfernung zwischen einem Punkt in einer geometry -Instanz und einem Punkt in einer anderen geometry -Instanz zurück.

Syntax

  
.STDistance ( other_geometry )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

other_geometry
Eine andere geometry -Instanz, von der aus die Entfernung zur Instanz, in der STDistance() aufgerufen wird, gemessen werden soll. Wenn other_geometry eine leere Menge ist, gibt STDistance() NULL zurück.

Rückgabetypen

SQL Server-Rückgabetyp: float

CLR-Rückgabetyp: SqlDouble

Hinweise

STDistance() gibt immer NULL zurück, wenn die SRIDs (Spatial Reference IDs) der geometry-Instanzen nicht übereinstimmen.

Beispiele

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

Weitere Informationen

Übersicht über räumliche Indizes
OGC-Methoden für geometry-Instanzen