Kategorien:

Geodatenfunktionen

ST_LENGTH

Gibt die geodätische Länge in Metern der Polygonzüge (LineString) in einem GEOGRAPHY-Objekt zurück.

Syntax

ST_LENGTH( <geography_expression> )

Argumente

Geografischer_Ausdruck

Das Argument muss vom Typ GEOGRAPHY sein.

Rückgabewerte

Gibt einen REAL-Wert zurück, der die Länge in Metern repräsentiert.

Nutzungshinweise

  • Wenn Geografischer_Ausdruck weder ein LineString noch ein MultiLineString oder eine GeometryCollection ist, die LineString-Werte enthält, gibt ST_LENGTH den Wert 0 zurück.

  • Wenn Geografischer_Ausdruck eine GeometryCollection ist, gibt ST_LENGTH die Summe der Längen der Polygonzüge (LineStrings) in der Collection zurück.

  • Wenn Sie die Umfangslänge eines Polygons ermitteln möchten, verwenden Sie stattdessen die Funktion ST_PERIMETER.

Beispiele

Das folgende Beispiel zeigt die Länge eines Bogengrades am Äquator in Meter an:

SELECT ST_LENGTH(TO_GEOGRAPHY('LineString(0.0 0.0, 1.0 0.0)'));
+---------------------------------------------------------+
| ST_LENGTH(TO_GEOGRAPHY('LINESTRING(0.0 0.0, 1.0 0.0)')) |
|---------------------------------------------------------|
|                                        111195.101177484 |
+---------------------------------------------------------+