全部產品
Search
文件中心

ApsaraDB RDS:ST_AddZ

更新時間:Aug 26, 2026

根據柵格的波段值設定geometry的z值。

文法

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

參數

參數名稱

描述

source

需要計算的raster對象。

geom

需要查詢的幾何對象。

pyramid

柵格的金字塔層級值,從0開始,金字塔層級為N,金字塔層級值為0~N-1中的整數,預設值為0。

band

柵格的波段值,從0開始,波段數量為N時,波段值為0~N-1中的整數,預設值為0。

描述

根據柵格的波段值設定geometry的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)