ポイントジオメトリのZ座標を浮動小数点数として返します。
構文
float ST_Z(geometry aPoint);パラメータ
| パラメータ | 説明 |
|---|---|
aPoint | Z座標を抽出するポイントジオメトリ。 |
戻り値
Z座標をfloatとして返します。
入力がNULLであるか、有効なポイントジオメトリではない場合、NULLを返します。
注意事項
aPointはポイントジオメトリである必要があります。他のジオメトリタイプを渡すと、NULLが返されます。ST_ZはZ座標を保持し、3Dジオメトリからそれらを除去しません。
例
4DポイントからのZ座標の抽出
SELECT ST_Z('POINT(0 1 2 3)'::geometry);出力：
st_z
------
2
(1 row)入力ポイントはx=0、y=1、z=2、m=3の座標を持ちます。ST_ZはZ座標である2を返します。
NULLおよび非ポイント入力の動作
ST_Zは、NULL入力と非ポイントジオメトリタイプの場合の両方で、NULLを返します。
SELECT
ST_Z(NULL),
ST_Z('LINESTRING(0 0 1, 1 1 2)'::geometry);出力：
st_z | st_z
------+------
NULL | NULL
(1 row)