すべてのプロダクト
Search
ドキュメントセンター

PolarDB:ST_AddZ

最終更新日:Sep 01, 2026

ジオメトリの Z 座標を、指定されたラスターバンドの値に設定します。

構文

geometry ST_AddZ(raster source,
                 geometry geom,
                 integer pyramid,
                 integer band);

パラメーター

パラメーター説明
sourceジオメトリを変換する元となるラスターです。
geomZ 座標を設定する対象のジオメトリです。
pyramidラスターのピラミッドレベルです。有効な値は 0 ~ N−1(N はピラミッドレベル数)です。デフォルト値は 0 です。
bandラスターのバンドです。有効な値は 0 ~ N−1(N はバンド数)です。デフォルト値は 0 です。

説明

ジオメトリ内の各ポイントの Z 座標を、そのポイント位置における指定バンドの値に設定します。ラスターが地理参照されている場合、関数は地理座標を返します。ラスターが地理参照されていない場合、関数はピクセル座標を返します。

説明

ジオメトリ内のすべてのポイントは、ラスターの範囲内に収まっている必要があります。

使用例

SELECT ST_AddZ(rast_object, ST_GeomFromText('POINT(120.5 30.6)', 4326), 0, 0)
FROM raster_table;

------------------------
POINT Z(120.5 30.6 27)

SELECT ST_AddZ(rast_object, ST_GeomFromText('POINT(120.5 30.6)', 4326), 1, 1)
FROM raster_table;

------------------------
POINT Z(120.5 30.6 115)