ST_Collect
戻る  7.3. ジオメトリ コンストラクタ  次へ

名前

ST_Collect — ジオメトリの集合からジオメトリコレクションまたはマルチ系ジオメトリを生成します。

概要

geometry ST_Collect(geometry g1, geometry g2);

geometry ST_Collect(geometry[] g1_array);

geometry ST_Collect(geometry set g1field);

説明

ジオメトリを集めてジオメトリコレクションにします。結果はマルチ系ジオメトリかジオメトリコレクションかのいずれかで、この差は、入力ジオメトリのタイプが同じか異なるか(均質か不均質か)で決まります。入力ジオメトリはコレクション内で変更されることはありません。

1番目の形式: 二つの入力ジオメトリを受け付ける。

2番目の形式: ジオメトリの配列を受け付ける。

3番目の形式: ジオメトリの行集合を受け付ける集約関数。

[警告]

ST_Collect は境界のディソルブやオーバーラップのディゾルブを行いません。オーバーラップしているポリゴンの収集は不正な MultiPolygon を生成する恐れがあります。結果ジオメトリーが、オーバーラップ部をマージしていて妥当なポリゴンジオメトリーでなければならないのでしたら、代わりに ST_Union を使います。ST_Union もインターセクトする位置でラインストリングを分割し、境界のディゾルブを行った単一ジオメトリーを返します。

入力ジオメトリーがコレクション (マルチ系または GEOMETRYCOLLECTION) の場合には、ST_Collect は GEOMETRYCOLLECTION を返します。GEOMETRYCOLLECTION がコレクションのネストが可能な唯一のタイプだからです。これを避けるにはサブクエリーで ST_Dump を使って入力コレクションを単一ジオメトリー要素に展開します。

Availability: 1.4.0 - ST_Collect(geometry)が導入されました。ST_Collectがより多くのジオメトリをより早く扱えるよう強化されました。

この関数は3次元に対応し、Z値を削除しません。

このメソッドは曲線ストリングと曲線に対応しています。

例

2入力形式。

2次元ポイントを収集します。

Code
SELECT ST_Collect(
    'POINT(1 2)',
    'POINT(-2 3)' );
出力:
MULTIPOINT((1 2),(-2 3))
Figure
Geometry figure for visual-st-collect-01

2次元ポイントの収集

Code
SELECT ST_Collect(
        'POINT(1 2 3)',
        'POINT(1 2 4)' );
出力:
MULTIPOINT(1 2 3,1 2 4)
Figure
Geometry figure for visual-st-collect-02

曲線を収集します。

Code
SELECT ST_Collect(
        'CIRCULARSTRING(220268 150415,220227 150505,220227 150406)',
        'CIRCULARSTRING(220227 150406,2220227 150407,220227 150406)');
出力:
MULTICURVE(CIRCULARSTRING(220268 150415,220227 150505,220227 150406),
CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))
Figure
Geometry figure for visual-st-collect-03

配列形式。

サブクエリから配列を生成するコンストラクタの使用。

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

値から配列を生成するコンストラクタの使用。

Code
SELECT ST_Collect(
        ARRAY[ 'LINESTRING(1 2,3 4)'::geometry,
            'LINESTRING(3 4,4 5)'::geometry ] ) As wktcollect;
出力:
MULTILINESTRING((1 2,3 4),(3 4,4 5))
Figure
Geometry figure for visual-st-collect-04

集約形式。

テーブル内のジオメトリのグループ化による複数コレクションを生成します。

Code
SELECT stusps, ST_Collect(geom) AS geom
FROM (
  SELECT stusps, (ST_Dump(geom)).geom AS geom
  FROM somestatetable
) AS f
GROUP BY stusps;

関連情報

ST_Dump, ST_Union