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