名前
ST_UnaryUnion — 単一のジオメトリーの要素の結合を計算します。
概要
geometry ST_UnaryUnion(geometry geom, float8 gridSize = -1);
説明
単一入力の形式のST_Unionです。入力は単一ジオメトリー、マルチ系ジオメトリー、ジオメトリーコレクションが可能です。結合は、入力の個々のエレメントに適用されます。
この関数は要素間のオーバラップが原因で不正とされるマルチポリゴンを修正するのに使えます。しかしながら、入力の要素は妥当でなければなりません。蝶ネクタイポリゴンのような入力の個々の要素はエラーを引き起こすかも知れません。このためST_MakeValidを使う方が良いかも知れません。
この関数は、他に、クロスやオーバラップするラインストリングのコレクションを単純にするためのノード追加とディソルブに使われます (ST_Node も同様のことを行いますが、任意引数gridSizeを与えることができません。)
一度に結合するジオメトリーの数量を調整するために ST_UnaryUnion とST_Collectとを混ぜることができます。メモリ使用と処理時間のトレードオフが可能になり、ST_Union とST_MemUnionとのバランスが得られます。
任意パラメーター gridSize が与えらえれると (GEOS-3.9.0 が必要です)、全ての結果の頂点が指定サイズのスナップ用グリッドに落ちることが保証されます。グリッド上で行われる処理は、グリッドに揃える際に意図しない小さな変更が発生する可能性があることに注意して下さい。ST_ReducePrecision を参照して下さい。
この関数は3次元に対応し、Z値を削除しません。 ただし、結果は XY のみを使用して計算されます。結果の Z 値は複写するか、平均値になるか、補間されます。
Enhanced: 3.1.0 gridSize パラメータを受け付けるようになりました。
gridSize パラメータを使うには GEOS 3.9.0以上が必要です
Availability: 2.0.0