ST_LineMerge
Prev  7.14. 几何处理  Next

Name

ST_LineMerge — 返回通过将 MultiLineString 缝合在一起形成的线。

Synopsis

geometry ST_LineMerge(geometry amultilinestring);

geometry ST_LineMerge(geometry amultilinestring, boolean directed);

描述

返回通过将 MultiLineString 的线元素连接在一起而形成的 LineString 或 MultiLineString。 线在 2 线交叉点处的端点处连接。 线不会在三向或更高阶次的交叉点上连接。

如果定向为 TRUE，则 ST_LineMerge 将不会更改 LineStrings 内的点顺序，因此方向相反的线不会被合并

[Note]

仅与 MultiLineString/LineString 一起使用。 其他几何类型返回空的 GeometryCollection

这个函数是由 GEOS 模块执行的。

增强：3.3.0 接受定向参数。

需要 GEOS >= 3.11.0 才能使用定向参数。

可用性：1.1.0

[Warning]

此函数剥离 M 维度。

示例

合并不同方向的线。 

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)

在交点的度数大于2时，线段不会合并。 

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

如果由于不接触线而无法合并，则返回原始 MultiLineString。

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

如果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))

显示 处理Z 维度的示例。

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)