Todos os produtos
Search
Central de documentação

ApsaraDB RDS:ST_PixelAsCentroid

Última atualização: Sep 01, 2026

Retorna o centroide (geometria de ponto) da área representada por um pixel.

Sintaxe

geometry ST_PixelAsCentroid(raster raster_obj,
    integer row default 0,
    integer column default 0,
    integer pyramid default 0);

Parâmetros

Parâmetro

Descrição

raster_obj

Raster a consultar.

row

Índice da linha do pixel. Valores válidos começam em 0, que corresponde ao canto superior esquerdo.

column

Índice da coluna do pixel. Valores válidos começam em 0, que corresponde ao canto superior esquerdo.

pyramid

Nível de pirâmide do pixel.

Descrição

A função ST_PixelAsCentroid converte um pixel específico do raster em uma geometria de ponto no centro da área desse pixel. Isso equivale a chamar ST_PixelAsPoint com ref_point definido como CENTER.

Exemplo

SELECT ST_AsText(ST_PixelAsCentroid(rast, 10, 10))
FROM rast_table
WHERE id = 10;

Saída:

POINT(-178.2 88.2)

Veja também

  • ST_PixelAsPoint — Retorna uma geometria de ponto em uma posição de referência especificada dentro de um pixel, como o canto superior esquerdo ou o centro.