Todos os produtos
Search
Central de documentação

ApsaraDB RDS:ST_PixelAsPoint

Última atualização: Sep 01, 2026

Retorna uma geometria de ponto para um pixel especificado de um raster. Use ref_point para definir se o ponto fica no canto superior esquerdo ou no centro do pixel.

Sintaxe

geometry ST_PixelAsPoint(raster raster_obj,
    integer row default 0,
    integer column default 0,
    integer pyramid default 0,
    cstring ref_point default 'UPPERLEFT');

Parâmetros

Parâmetro

Descrição

raster_obj

Raster a consultar.

row

Índice da linha do pixel, começando em 0 no canto superior esquerdo.

column

Índice da coluna do pixel, começando em 0 no canto superior esquerdo.

pyramid

Nível de pirâmide do pixel.

ref_point

Posição de referência do ponto retornado no pixel. Valores válidos: UPPERLEFT (padrão) — canto superior esquerdo do pixel; CENTER — centro do pixel.

Exemplo

O exemplo a seguir retorna o ponto do canto superior esquerdo do pixel na linha 10, coluna 10 e nível de pirâmide 0.

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

------------------
POINT(-178.2 88.2)