Todos os produtos
Search
Central de documentação

ApsaraDB RDS:ST_Contour

Última atualização: Aug 20, 2026

Gera linhas de contorno com base nos valores de elevação do DEM em uma região.

Sintaxe

set of record ST_Contour(
    raster rast,
    integer band,
    cstring contourOptions);

Parâmetros

Parâmetro

Descrição

rast

O objeto raster. Atualmente, apenas DEMs com uma banda são suportados.

band

O número da banda, começando em 0.

contourOptions

Os parâmetros para gerar linhas de contorno.

contourOptions aceita os seguintes parâmetros:

Parâmetro

Descrição

Tipo

Valor padrão

Observações

level_base

O valor inicial do contorno.

float

0.0

N/A.

fixed_level

Especifica os valores de cada linha de contorno como um array float.

float array

None

Se fixed_level for especificado, interval será ignorado.

interval

O intervalo entre as linhas de contorno.

float

None

N/A.

polygonize

O tipo de saída do contorno.

bool

false

O tipo de contorno a criar:

  • false: Retorna linhas de contorno como curvas fechadas.

  • true: Preenche a área entre duas linhas de contorno consecutivas com valores de elevação e retorna o resultado como polígonos.

nodata

O valor de nodata.

float

-1.0

N/A.

Descrição

Gera linhas de contorno ao especificar um objeto raster e um número de banda.

Os campos no resultado retornado incluem:

  • id: O número sequencial da linha de contorno ou do polígono.

  • max_value: O valor máximo na linha de contorno ou no polígono.

  • min_value: O valor mínimo na linha de contorno ou no polígono.

  • geom: O objeto de geometria da linha de contorno ou do polígono.

Exemplos

-- Specify interval. Return lines
select (ST_Contour(rast,0,'{"interval":"2.0"}')).* from raster_table where id =1;

-- Specify the contour intervals as an array. Return polygons
select (ST_Contour(rast,0,'{"fixed_level":[1,5,10,15,20,30],"polygonize":"true"}')).* from raster_table where id =1;

-- Specify nodata. Return polygons
select (ST_Contour(rast,0,'{"interval":"5","nodata":"0.0","level_base":"1.0","polygonize":"true"}')).* from raster_table where id =1;