Kategorien:: Geodatenfunktionen

ST_LENGTH¶

Returns the geodesic length of the LineString(s) in a GEOGRAPHY object or the Euclidean length of the LineString(s) in a GEOMETRY object.

Syntax¶

ST_LENGTH( <geography_or_geometry_expression> )

Argumente¶

geography_or_geometry_expression: The argument must be of type GEOGRAPHY or GEOMETRY.

Rückgabewerte¶

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

Nutzungshinweise¶

If geography_or_geometry_expression is not a LineString, MultiLineString, or GeometryCollection containing linestrings, ST_LENGTH returns 0.
If geography_or_geometry_expression is a GeometryCollection, ST_LENGTH returns the sum of the lengths of the linestrings in the collection.
Wenn Sie die Umfangslänge eines Polygons ermitteln möchten, verwenden Sie stattdessen die Funktion ST_PERIMETER.

Beispiele¶

GEOGRAPHY Examples¶

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 |
+---------------------------------------------------------+

GEOMETRY Examples¶

The following example demonstrates how to use the ST_LENGTH function.

SELECT ST_LENGTH(g), ST_ASWKT(g)
FROM (SELECT TO_GEOMETRY(column1) AS g
  FROM VALUES ('POINT(1 1)'),
              ('LINESTRING(0 0, 1 1)'),
              ('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))'));

+--------------+--------------------------------+
| ST_LENGTH(G) | ST_ASWKT(G)                    |
|--------------+--------------------------------|
|  0           | POINT(1 1)                     |
|  1.414213562 | LINESTRING(0 0,1 1)            |
|  0           | POLYGON((0 0,0 1,1 1,1 0,0 0)) |
+--------------+--------------------------------+