Use a função ST_PointValues para obter valores de pixel de todas as bandas em uma localização específica - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Sintaxe

SETOF record ST_PointValues(raster raster_obj, integer column_sn, integer row_sn, boolean exclude_nodata DEFAULT true, OUT integer* band, OUT float8 value)

SETOF record ST_PointValues(raster raster_obj, float8 x, float8 y, boolean exclude_nodata DEFAULT true, text options DEFAULT '{}', OUT integer band, OUT float8 value)

A primeira sobrecarga localiza um pixel pelos índices de coluna e linha. A segunda sobrecarga localiza um pixel por longitude e latitude, com ressamostragem opcional.

Parâmetros

Parâmetro	Descrição
`raster_obj`	O objeto raster.
`column_sn`	Índice da coluna do pixel alvo, começando pelo canto superior esquerdo.
`row_sn`	Índice da linha do pixel alvo, começando pelo canto superior esquerdo.
`x`	Longitude do pixel alvo.
`y`	Latitude do pixel alvo.
`exclude_nodata`	Defina se os valores NoData devem ser excluídos. Se definido como `true`, pixels com valores NoData não são retornados. Valor padrão: `true`.
`options`	Método de ressamostragem especificado como string JSON. Consulte o subparâmetro `resample` abaixo. Valor padrão: `'{}'`.
`band`	Parâmetro de saída. Número da banda do pixel.
`value`	Parâmetro de saída. Valor do pixel.

Subparâmetro de `options`: `resample`

Ao configurar resample, a função utiliza os quatro pixels vizinhos no cálculo.

Valor	Descrição
`none`	Sem ressamostragem.
`idw`	Ressamostragem por ponderação pelo inverso da distância (IDW).
`mean`	Ressamostragem pela média dos valores.
`max`	Ressamostragem pelo valor máximo.
`min`	Ressamostragem pelo valor mínimo.

Exemplo: '{"resample": "idw"}'

Valores de retorno

Campo	Tipo	Descrição
`band`	integer	Número da banda.
`value`	float8	Valor do pixel da banda.

Descrição

A função ST_PointValues retorna os valores de pixel de todas as bandas em uma determinada localização. Especifique a localização pelas coordenadas do pixel (column_sn, row_sn) ou pelas coordenadas geográficas (x para longitude, y para latitude).

Ao especificar a opção resample, a função utiliza os quatro pixels vizinhos para calcular o valor retornado:

Exemplos

Consulta por coordenadas geográficas

Os exemplos a seguir consultam valores de pixel do raster armazenado em t_pixel onde id = 3, usando coordenadas de longitude e latitude.

Consulta com exclusão de NoData desativada (exclude_nodata = false):

SELECT * FROM
    (SELECT (st_pointValues(rast, 125.84382034243441, 47.67709555783107, false)).*
     FROM t_pixel WHERE id = 3) a
ORDER BY band;

Resultado:

 band | value
------+-------
    0 |    66
    1 |    87
    2 |    28

Consulta com coordenadas inteiras:

SELECT * FROM
    (SELECT (st_pointValues(rast, 125, 47)).*
     FROM t_pixel WHERE id = 3) a
ORDER BY band;

Resultado:

 band | value
------+-------
    0 |    39
    1 |    66
    2 |    11

Consulta com ressamostragem IDW

Especifique o método de ressamostragem idw.

SELECT * FROM
    (SELECT (st_pointValues(rast, 125.84382034243441, 47.67709555783107, false, '{"resample": "idw"}')).*
     FROM t_pixel WHERE id = 3) a
ORDER BY band;

Resultado:

 band | value
------+--------------------
    0 |  60.81401293159196
    1 |  85.23822259113626
    2 | 26.300926205142165

Sintaxe

Parâmetros

Subparâmetro de options: resample

Valores de retorno

Descrição

Exemplos

Consulta por coordenadas geográficas

Consulta com ressamostragem IDW

Subparâmetro de `options`: `resample`