ST_Extent - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Retorna a caixa delimitadora de um raster como um valor BOX do PostgreSQL no formato ((maxX,maxY),(minX,minY)).

Sintaxe

BOX ST_Extent(raster raster_obj, CoorSpatialOption csOption = 'WorldFirst')
BOX ST_Extent(raster raster_obj, integer pyramid, CoorSpatialOption csOption = 'WorldFirst')

Parâmetros

Parâmetro	Descrição
`raster_obj`	Objeto raster consultado.
`pyramid`	Nível de pirâmide consultado. Valores válidos começam em 0.
`csOption`	Espaço de coordenadas utilizado. Padrão: `WorldFirst`.

Descrição

A função ST_Extent retorna um valor BOX que representa a caixa delimitadora do raster. O formato é ((maxX,maxY),(minX,minY)): o canto superior direito aparece primeiro, seguido pelo canto inferior esquerdo.

O parâmetro csOption define o espaço de coordenadas utilizado:

Valor	Comportamento
`Raster`	Retorna coordenadas de pixel.
`World`	Retorna coordenadas geográficas (mundo).
`WorldFirst`	Retorna coordenadas geográficas se o raster for georreferenciado; caso contrário, retorna coordenadas de pixel.

Nota

WorldFirst é o valor padrão. Se o raster não for georreferenciado e você chamar ST_Extent sem especificar csOption, o resultado estará em coordenadas de pixel. Para obter sempre coordenadas geográficas, passe 'World'::CoorSpatialOption explicitamente.

Exemplos

Retornar coordenadas de pixel:

SELECT ST_Extent(raster_obj, 'Raster'::CoorSpatialOption) FROM raster_table;

Resultado:

((255,255),(0,0))

Retornar coordenadas geográficas:

SELECT ST_Extent(raster_obj, 'World'::CoorSpatialOption) FROM raster_table;

Retornar coordenadas geográficas em um nível específico de pirâmide:

SELECT ST_Extent(raster_obj, 2, 'World'::CoorSpatialOption) FROM raster_table;