Name
ST_StartPoint — Gibt den ersten Punkt eines LineString zurück.
Synopsis
geometry ST_StartPoint(geometry geomA);
Beschreibung
Gibt den Anfangspunkt einer LINESTRING oder CIRCULARLINESTRING Geometrie als POINT oder NULL zurück, falls es sich beim Eingabewert nicht um einen LINESTRING oder CIRCULARLINESTRING handelt.
Diese Methode setzt die SQL/MM-Spezifikation um. SQL-MM 3: 7.1.3
Diese Funktion unterstützt 3d und lässt den Z-Index nicht fallen.
Diese Methode unterstützt kreisförmige Strings und Kurven.
![[Note]](../images/note.png)
|
|
|
Verbessert: 3.2.0 gibt einen Punkt für alle Geometrien zurück. Vorheriges Verhalten gibt NULLs zurück, wenn die Eingabe kein LineString war. Änderung: 2.0.0 unterstützt die Verarbeitung von MultiLinestring's die nur aus einer einzelnen Geometrie bestehen, nicht mehr. In früheren Versionen von PostGIS gab die Funktion bei einem aus einer einzelnen Linie bestehender MultiLinestring den Anfangspunkt zurück. Ab 2.0.0 gibt sie nur NULL zurück, so wie bei jedem anderen MultiLinestring. Die alte Verhaltensweise war undokumentiert, aber Anwender, die annahmen, dass Sie Ihre Daten als LINESTRING vorliegen haben, könnten in 2.0 dieses zurückgegebene NULL bemerken. |
Beispiele
Startpunkt eines LineString
SELECT ST_AsText(ST_StartPoint('LINESTRING(0 1, 0 2)'::geometry));
st_astext
------------
POINT(0 1)
Startpunkt eines Nicht-LineString ist NULL
SELECT ST_StartPoint('POINT(0 1)'::geometry) IS NULL AS is_null;
is_null
----------
t
Startpunkt einer 3D-LinieString
SELECT ST_AsEWKT(ST_StartPoint('LINESTRING(0 1 1, 0 2 2)'::geometry));
st_asewkt
------------
POINT(0 1 1)
Gibt die Anzahl der Stützpunkte eines ST_LineString oder eines ST_CircularString zurück.
SELECT ST_AsText(ST_StartPoint('CIRCULARSTRING(5 2,-3 1.999999, -2 1, -4 2, 6 3)'::geometry));
st_astext
------------
POINT(5 2)