ST_Collect
Prev  7.3. 几何构造函数  Next

Name

ST_Collect — 从一组几何图形创建 GeometryCollection 或 Multi* 几何图形。

Synopsis

geometry ST_Collect(geometry g1, geometry g2);

geometry ST_Collect(geometry[] g1_array);

geometry ST_Collect(geometry set g1field);

描述

将几何图形收集到几何图形集合中。 结果是 Multi* 或 GeometryCollection，具体取决于输入几何图形是否具有相同或不同类型（同质或异构）。输入几何图形在集合中保持不变。

第一种形式:接受两个输入几何图形

第二种形式: 接受几何数组

第三种形式: 接受几何行集的聚合函数。

[Note]

如果任何输入几何图形是集合（Multi* 或 GeometryCollection），ST_Collect 返回 GeometryCollection（因为这是唯一可以包含嵌套集合的类型）。 为了防止这种情况，请在子查询中使用ST_Dump 将输入集合扩展到其原子元素（请参见下面的示例）。

[Note]

ST_Collect 和ST_Union 看起来很相似，但实际上操作方式却截然不同。ST_Collect 将几何图形聚合到一个集合中，而不以任何方式更改它们。 ST_Union 在几何上合并重叠的几何图形，并在交叉点分割线串。当它合并边界时，它可能会返回单个几何图形。

可用性：引入了 1.4.0 - ST_Collect（几何）。 ST_Collect已得到增强，可以更快地处理更多几何图形。

该函数支持 3d 并且不会丢失 z-index。

此方法支持圆形字符串和曲线。

示例-双输入格式

合并2D点。

SELECT ST_AsText( ST_Collect( ST_GeomFromText('POINT(1 2)'),
        ST_GeomFromText('POINT(-2 3)') ));

st_astext
----------
MULTIPOINT((1 2),(-2 3))

合并3D点。

SELECT ST_AsEWKT( ST_Collect( ST_GeomFromEWKT('POINT(1 2 3)'),
                ST_GeomFromEWKT('POINT(1 2 4)') ) );

                st_asewkt
-------------------------
 MULTIPOINT(1 2 3,1 2 4)

合并曲线。

SELECT ST_AsText( ST_Collect( 'CIRCULARSTRING(220268 150415,220227 150505,220227 150406)',
                'CIRCULARSTRING(220227 150406,2220227 150407,220227 150406)'));

                st_astext
------------------------------------------------------------------------------------
MULTICURVE(CIRCULARSTRING(220268 150415,220227 150505,220227 150406),
 CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))

示例-数组作为参数

使用子查询的数组构造函数。

SELECT ST_Collect( ARRAY( SELECT geom FROM sometable ) );

使用数组构造函数来获取值。

SELECT ST_AsText(  ST_Collect(
                ARRAY[ ST_GeomFromText('LINESTRING(1 2, 3 4)'),
                        ST_GeomFromText('LINESTRING(3 4, 4 5)') ] )) As wktcollect;

--wkt collect --
MULTILINESTRING((1 2,3 4),(3 4,4 5))

示例-聚合函数格式

通过在表中对几何进行分组来生成多个集合。

SELECT stusps, ST_Collect(f.geom) as geom
         FROM (SELECT stusps, (ST_Dump(geom)).geom As geom
                                FROM
                                somestatetable ) As f
        GROUP BY stusps

相关信息

ST_Dump, ST_Union