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