ST_Union

PDFRSS

ST_Union は、2 つのジオメトリの和集合を表すジオメトリを返します。つまり、入力ジオメトリをマージして、オーバーラップのない結果のジオメトリを生成します。

構文

ST_Union(geom1, geom2)

引数

geom1

データ型 GEOMETRY の値または GEOMETRY 型と評価される式の値。

geom2

データ型 GEOMETRY の値または GEOMETRY 型と評価される式の値。

戻り型

GEOMETRY

返されたジオメトリの空間リファレンス識別子 (SRID) 値が、入力ジオメトリの SRID 値です。

geom1 または geom2 が null の場合、null が返されます。

geom1 もしくは geom2 が空の場合、空のジオメトリが返されます。

geom1 および geom2 の空間リファレンスシステム識別子 (SRID) が同じ値でない場合、エラーが返されます。

geom1 または geom2 がジオメトリコレクション、linestring、または multilinestring である場合、エラーが返されます。

geom1 もしくは geom2 が 二次元の (2D) ジオメトリでない場合、エラーが返されます。

例

次の SQL は、2 つの入力ジオメトリの和集合を表す、空でないジオメトリを返します。

SELECT ST_AsEWKT(ST_Union(ST_GeomFromText('POLYGON((0 0,100 100,0 200,0 0))'), ST_GeomFromText('POLYGON((0 0,10 0,0 10,0 0))')));

        st_asewkt        
-------------------------
 POLYGON((0 0,0 200,100 100,5 5,10 0,0 0))