STLength (geography-Datentyp)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed Instance

Gibt die Gesamtlänge der Elemente in einer geography -Instanz oder der geography in einer GeometryCollectionzurück.

Syntax

  
.STLength ( )  

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.

Rückgabetypen

SQL Server-Rückgabetyp: float

CLR-Rückgabetyp: SqlDouble

Hinweise

Wenn eine geography -Instanz geschlossen ist, wird ihre Länge als Gesamtlänge um die Instanz herum berechnet. Die Länge eines Polygons entspricht seinem Umfang und die Länge eines Punkts ist 0. Die Länge einer GeometryCollection wird ermittelt, indem die Summe der Längen aller in der Auflistung enthaltenen geography -Instanzen berechnet wird.

STLength() funktioniert sowohl für gültige als auch für ungültige LineStrings. In der Regel ist ein LineString aufgrund überlappender Segmente ungültig, die möglicherweise durch Anomalien wie ungenaue GPS-Ablaufverfolgungen verursacht werden. STLength() entfernt keine überlappenden oder ungültigen Segmente. Sie schließt überlappende und ungültige Segmente in den zurückgegebenen Längenwert ein. Die MakeValid()-Methode kann überlappende Segmente aus einem LineString entfernen.

Beispiele

Im folgenden Beispiel wird eine LineString -Instanz erstellt und STLength() verwendet, um die Länge der Instanz zu bestimmen.

DECLARE @g geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SELECT @g.STLength();  

Weitere Informationen

OGC-Methoden für geography-Instanzen