ST_LocateAlong
Prev  7.19. Kilometrierung  Next

Name

ST_LocateAlong — Gibt die Punkte auf einer Geometrie zurück, die einem Messwert entsprechen.

Synopsis

geometry ST_LocateAlong(geometry geom_with_measure, float8 measure, float8 offset = 0);

Beschreibung

Gibt die Position(en) entlang einer gemessenen Geometrie zurück, die die angegebenen Messwerte aufweisen. Das Ergebnis ist ein Point oder MultiPoint. Polygonale Eingaben werden nicht unterstützt.

Wenn offset angegeben ist, wird das Ergebnis um den angegebenen Abstand nach links oder rechts von der Eingabezeile verschoben. Ein positiver Versatz geht nach links, ein negativer nach rechts.

[Note]

Verwenden Sie diese Funktion nur für lineare Geometrien mit einer M-Komponente

Die Semantik ist in der Norm ISO/IEC 13249-3 SQL/MM Spatial festgelegt.

Verfügbarkeit: 1.1.0 über die alte Bezeichnung ST_Locate_Along_Measure.

Änderung: 2.0.0 In Vorgängerversionen als ST_Locate_Along_Measure bezeichet. Der alte Name ist überholt und wird in der Zukunft entfernt ist aber noch verfügbar.

Diese Funktion unterstützt M-Koordinaten.

Diese Methode setzt die SQL/MM-Spezifikation um. SQL-MM IEC 13249-3: 5.1.13

Beispiele

SELECT ST_AsText(
  ST_LocateAlong(
    'MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 3),(1 2 3, 5 4 5))'::geometry,
    3 ));

----------------------------------
 MULTIPOINT M ((1 2 3),(9 4 3),(1 2 3))