Box2D、Box3D、またはジオメトリオブジェクトのバウンディングボックスにおける最小 z 座標を返します。
構文
float ST_ZMin(box3d aGeomorBox2DorBox3D);パラメーター
| パラメーター | 説明 |
|---|---|
aGeomorBox2DorBox3D | Box2D、Box3D、またはジオメトリオブジェクトです。 |
注意事項
パラメーター型はbox3dとして定義されていますが、ST_ZMin は自動キャストにより Box2D およびジオメトリ値も受け付けます。ただし、Box2D またはジオメトリ値を文字列リテラルとして渡すと、自動キャストがバイパスされ、エラーが発生します。文字列形式の入力を利用する場合は、ST_GeomFromEWKTを使用するか、明示的なキャスト式(::geometry)で変換してください。
その他の動作:
z 座標を保持します — 3D オブジェクトから z ディメンションを削除しません。
円弧文字列(circular strings)および曲線をサポートします。
例
LineString の最小 z 座標を取得
SELECT ST_ZMin('LINESTRING(0 1 2,3 4 5)'::geometry);
st_zmin
---------
2
(1 行)Box3D の最小 z 座標を取得
SELECT ST_ZMin('BOX3D(1 2 3, 4 5 6)');
st_zmin
---------
3
(1 行)ST_GeomFromEWKT を使用してジオメトリ文字列を渡す
SELECT ST_ZMin(ST_GeomFromEWKT('LINESTRING(1 3 4, 5 6 7)'));
st_zmin
---------
4
(1 行)ジオメトリ文字列を直接渡すとエラーが発生
-- このクエリは失敗します。文字列は box3d へ自動キャストされないためです。
SELECT ST_ZMin('LINESTRING(1 3 4, 5 6 7)');
-- ERROR: BOX3D parser - doesn't start with BOX3D(