ST_LineMerge
Prev  7.14. Geometrieverarbeitung  Next

Name

ST_LineMerge — Gibt die Linien zurück, die durch das Zusammenfügen eines MultiLineString gebildet werden.

Synopsis

geometry ST_LineMerge(geometry amultilinestring);

geometry ST_LineMerge(geometry amultilinestring, boolean directed);

Beschreibung

Gibt einen LineString oder MultiLineString zurück, der durch Zusammenfügen der Linienelemente eines MultiLineString gebildet wird. Linien werden an ihren Endpunkten an 2-Wege-Kreuzungen verbunden. Linien werden nicht über Schnittpunkte mit 3 oder mehr Richtungen verbunden.

Wenn directed TRUE ist, dann ändert ST_LineMerge nicht die Reihenfolge der Punkte innerhalb von LineStrings, so dass Linien mit entgegengesetzten Richtungen nicht zusammengeführt werden

[Note]

Nur mit MultiLineString/LineStrings verwenden. Andere Geometrietypen geben eine leere GeometryCollection zurück

Wird vom GEOS Modul ausgeführt

Verbessert: 3.3.0 akzeptiert einen gerichteten Parameter.

Erfordert GEOS >= 3.11.0 zur Verwendung des gerichteten Parameters.

Verfügbarkeit: 1.1.0

[Warning]

Diese Funktion entfernt die Dimension M.

Beispiele

Zusammenführen von Linien mit unterschiedlicher Ausrichtung. 

SELECT ST_AsText(ST_LineMerge(
'MULTILINESTRING((10 160, 60 120), (120 140, 60 120), (120 140, 180 120))'
                ));
--------------------------------------------
 LINESTRING(10 160,60 120,120 140,180 120)

Linien werden nicht über Schnittpunkte mit dem Grad > 2 zusammengeführt. 

SELECT ST_AsText(ST_LineMerge(
'MULTILINESTRING((10 160, 60 120), (120 140, 60 120), (120 140, 180 120), (100 180, 120 140))'
                ));
--------------------------------------------
 MULTILINESTRING((10 160,60 120,120 140),(100 180,120 140),(120 140,180 120))

Ist das Zusammenführen aufgrund von sich nicht berührenden Zeilen nicht möglich, wird der ursprüngliche MultiLineString zurückgegeben.

SELECT ST_AsText(ST_LineMerge(
'MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45.2 -33.2,-46 -32))'
));
----------------
MULTILINESTRING((-45.2 -33.2,-46 -32),(-29 -27,-30 -29.7,-36 -31,-45 -33))

Linien mit entgegengesetzten Richtungen werden nicht zusammengeführt, wenn directed = TRUE.

SELECT ST_AsText(ST_LineMerge(
'MULTILINESTRING((60 30, 10 70), (120 50, 60 30), (120 50, 180 30))',
TRUE));
-------------------------------------------------------
 MULTILINESTRING((120 50,60 30,10 70),(120 50,180 30))

Beispiel für die Handhabung der Z-Dimension.

SELECT ST_AsText(ST_LineMerge(
      'MULTILINESTRING((-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 6), (-29 -27 12,-30 -29.7 5), (-45 -33 1,-46 -32 11))'
        ));
--------------------------------------------------------------------------------------------------
LINESTRING Z (-30 -29.7 5,-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 1,-46 -32 11)