Todos os produtos
Search
Central de documentação

ApsaraDB RDS:ST_PixelAsCentroids

Última atualização: Aug 22, 2026

Converte pixels em uma posição especificada de um raster em objetos de geometria, cada um representado pelo centroide do pixel.

Sintaxe

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);

Parâmetros

Parâmetro

Tipo

Padrão

Descrição

raster_obj

raster

Raster a consultar.

band

integer

0

ID da banda a consultar. IDs válidos começam em 0.

pyramid

integer

0

Nível de pirâmide a consultar.

exclude_nodata_value

boolean

true

Define se os pixels NoData serão excluídos.

rowsn

out integer

Número da linha do pixel.

columnsn

out integer

Número da coluna do pixel.

bandsn

out integer

ID da banda do pixel.

value

out double

Valor do pixel.

geom

out geometry

Extensão espacial do pixel.

Descrição

A função ST_PixelAsCentroids retorna os mesmos resultados que ST_PixelAsPoints quando o parâmetro ref_point de ST_PixelAsPoints é definido como CENTER.

Exemplos

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)