STDistance (geography-Datentyp)
Gibt die kürzeste Entfernung zwischen einem Punkt in einer geography-Instanz und einem Punkt in einer anderen geography-Instanz zurück.
Hinweis |
---|
STDistance() gibt den kürzesten LineString zwischen zwei Geografietypen zurück. Dies ist ein naher Schätzwert der geodätischen Entfernung. Die Abweichung von STDistance() bei allgemeinen Erdemodellen von der genauen geodätischen Entfernung beträgt nicht mehr als 0,25 %. Dies verhindert Verwechslungen hinsichtlich der feinen Unterschiede zwischen Länge und Entfernung bei geodätischen Typen. |
Syntax
.STDistance ( other_geography )
Argumente
- other_geography
Eine andere geography-Instanz, von der aus die Entfernung zur Instanz, in der STDistance() aufgerufen wird, gemessen werden soll. Wenn other_geography 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 geography-Instanzen nicht übereinstimmen.
Hinweis |
---|
Methoden für den geography-Datentyp, mit denen eine Fläche oder eine Entfernung berechnet wird, geben je nach SRID der in der jeweiligen Methode verwendeten Instanz unterschiedliche Ergebnisse zurück. Weitere Informationen zu SRIDs finden Sie unter SRIDs (Spatial Reference Identifiers). |
Beispiele
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);