ST_Force2D

ST_Force2D は、入力ジオメトリの 2D ジオメトリを返します。2D ジオメトリの場合、入力のコピーが返されます。ジオメトリが 3DZ、3DM、4D の場合、ST_Force2D はジオメトリを XY デカルト平面に射影します。入力ジオメトリの空のポイントは、出力ジオメトリでも空のポイントのままで維持されます。

構文

ST_Force2D(geom)

引数

geom

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

戻り型

GEOMETRY.

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

geom が null の場合、null が返されます。

geom が空の場合、空のジオメトリが返されます。

例

次の SQL は、3DZ ジオメトリから 2D ジオメトリを返します。

SELECT ST_AsEWKT(ST_Force2D(ST_GeomFromText('MULTIPOINT Z(0 1 2, EMPTY, 2 3 4, 5 6 7)')));

st_asewkt
-----------
  MULTIPOINT((0 1),EMPTY,(2 3),(5 6))