STDistance (geometry-Datentyp)

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

Gilt für: SQL Server (SQL Server 2008 bis aktuelle Version), Windows Azure SQL-Datenbank (Ursprüngliche Version bis aktuelle Version).

Syntax

.STDistance ( other_geometry )

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

Siehe auch

Konzepte

Übersicht über räumliche Indizes

Andere Ressourcen

OGC-Methoden für geomety-Instanzen