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

ApsaraDB RDS:ST_PixelAsCentroids

最終更新日:Aug 22, 2026

ラスタの指定した位置のピクセルをジオメトリオブジェクトに変換します。各オブジェクトは、ピクセルのセントロイドで表現されます。

構文

setof record ST_PixelAsCentroids(raster raster_obj,
    integer band default  0,
    integer pyramid default 0,
    boolean exclude_nodata_value default true,
    out integer rowsn,
    out integer columnsn,
    out integer bandsn,
    out double value,
    out geometry geom);

パラメーター

パラメーターデフォルト値説明
raster_objrasterクエリ対象のラスタ。
bandinteger0クエリ対象のバンド ID。有効なバンド ID は 0 から始まります。
pyramidinteger0クエリ対象のピラミッドレベル。
exclude_nodata_valuebooleantrueNoData ピクセルを除外するかどうか。
rowsnout integerピクセルの行番号。
columnsnout integerピクセルの列番号。
bandsnout integerピクセルのバンド ID。
valueout doubleピクセル値。
geomout geometryピクセルのセントロイド。

説明

ST_PixelAsCentroids は、ST_PixelAsPointsref_point パラメーターに CENTER を設定した場合の ST_PixelAsPoints と同じ結果を返します。

WITH tmp AS (
SELECT (ST_PixelAsCentroids(rast, 1)).*
FROM rast_table
WHERE id = 10 )
SELECT rowsn, columnsn, bandsn, value, ST_AsEWKT(geom)  FROM tmp WHERE value > 38.0;

----------------------------------------------------
    100 |      100 |      0 |    43 | SRID=4326;POINT(-89.5 0.5)