从其他Geometry对象的collection返回一个具体的Geometry值(对应的对象)。
语法
geometry ST_Collect(geometry set g1Field);
geometry ST_Collect(geometry g1 , geometry g2);
geometry ST_Collect(geometry[] g1Array);
参数
参数名称 | 描述 |
---|---|
g1Field | Geometry对象在数据集中的字段。 |
g1 | 第一个Geometry对象。 |
g2 | 第二个Geometry对象。 |
g1Array | Geometry对象数组。 |
描述
- 输出类型可以是Multi或GeometryCollection类型。该函数有两种形式:
- 形式1:输入参数是两个Geometry对象。该函数会根据输入的两个Geometry对象,返回一个Collection对象,输出类型可能是Multi或GeometryCollection类型。
- 形式2:是一个聚合功能函数,输入对象是一个Geometry对象的集合,返回一个ST_Geometry函数值对应的Geometry对象。
- 该函数支持CircularString和CurveGeometry对象,但可能不会返回预期的一个MultiCurve类型或Multi类型对象。
- 函数ST_Collect 和函数ST_Union 经常可以互换使用,除了ST_Collect将始终返回GeometryCollection或Multi类型,而ST_Union溶解边界时可能返回单个Geometry对象。
ST_Union还将在节点相交处分割LineString,而ST_Collect则仅仅返回为MultiLineString。
- 一般来说函数ST_Collect要比函数ST_Union快很多,因为ST_Collect 函数不会去分解输入Geometry对象的边界或者检查一个MultiPolygon对象是否有重叠部分。它仅仅是把单个的Geometry对象组合成一个Multi类型对象,或者将Multi类型对象组合成一个GeometryCollection集合对象。
- 为了阻止函数ST_Collect把Multi类型对象变成GeometryCollection类型对象,用户可以使用如下小技巧:利用函数ST_Dump把Multi类型对象转换成单个Geometry对象,再重新聚合他们。
示例
- 输出MULTI对象:
SELECT ST_AsText(ST_Collect('POINT(0 0)'::geometry, 'POINT(0 1)'::geometry)); st_astext --------------------- MULTIPOINT(0 0,0 1) (1 row)
- 输出GEOMETRYCOLLECTION对象:
SELECT ST_AsText(ST_Collect('POINT(0 0)'::geometry, 'LINESTRING(0 2,0 3)'::geometry)); st_astext ---------------------------------------------------- GEOMETRYCOLLECTION(POINT(0 0),LINESTRING(0 2,0 3)) (1 row)
- 聚合数据集:
select ST_AsText(ST_Collect(t.geom)) from (select (ST_DumpPoints(st_buffer('POINT(0 0)'::geometry,1,'quad_segs=2'))).geom as geom) as t; st_astext ---------------------------------------------------------------- MULTIPOINT(1 0,0.707106781186548 -0.707106781186547,0 -1,-0.70. .7106781186546 -0.707106781186549,-1 0,-0.70710678118655 0.7071. .06781186545,0 1,0.707106781186544 0.707106781186551,1 0) (1 row)