ST_Force3DZ
ST_Force3DZ は、入力ジオメトリから 3DZ ジオメトリを返します。2D ジオメトリの場合、出力ジオメトリ内の空でないポイントのための z 座標は、すべて 0 に設定されます。ジオメトリが 3DM の場合、ジオメトリは XY デカルト平面上に射影され、出力ジオメトリ内の空でないポイントの z 座標は、すべて 0 に設定されます。ジオメトリが 3DZ の場合には、入力ジオメトリのコピーが返されます。4D ジオメトリの場合は、ジオメトリは XYZ デカルト空間に射影されます。入力ジオメトリの空のポイントは、出力ジオメトリでも空のポイントのままで維持されます。
構文
ST_Force3DZ(geom)
引数
- geom
-
データ型
GEOMETRYの値またはGEOMETRY型と評価される式の値。
戻り型
GEOMETRY.
返されたジオメトリの空間リファレンスシステム識別子 (SRID) 値が、入力ジオメトリの SRID 値です。
geom が null の場合、null が返されます。
geom が空の場合、空のジオメトリが返されます。
例
次の SQL は、3DM ジオメトリから 3DZ ジオメトリを返します。
SELECT ST_AsEWKT(ST_Force3DZ(ST_GeomFromText('MULTIPOINT M(0 1 2, EMPTY, 2 3 4, 5 6 7)')));
st_asewkt
-----------
MULTIPOINT Z ((0 1 0),EMPTY,(2 3 0),(5 6 0))
