ST_Force3DM

ST_Force3DM は、入力ジオメトリの 3DM ジオメトリを返します。2D ジオメトリの場合、出力ジオメトリ内の空でないポイントのための m 座標は、すべて 0 に設定されます。3DM ジオメトリの場合、入力ジオメトリのコピーが返されます。3DZ ジオメトリの場合、ジオメトリは XY デカルト平面に射影され、出力ジオメトリ内の空でないポイントの m 座標は、すべて 0 に設定されます。4D ジオメトリの場合、ジオメトリは XYM デカルト空間に射影されます。入力ジオメトリの空のポイントは、出力ジオメトリでも空のポイントのままで維持されます。

構文

ST_Force3DM(geom)

引数

geom

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

戻り型

GEOMETRY.

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

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

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

例

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

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

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