Stac Collection Render Options - Get All

Referência

Serviço:: Planetary Computer

Versão da API:: 2025-04-30-preview

Obter opções de renderização de coleção
Obter todas as opções de renderização para uma determinada coleção

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/stac/collections/{collectionId}/configurations/render-options?api-version=2025-04-30-preview

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
collectionId	path	True	string maxLength: 500 pattern: .*	Identificador exclusivo para a coleção STAC.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Description
200 OK	RenderOption[]	O pedido foi bem-sucedido.
204 No Content		Não há conteúdo para enviar para esta solicitação, mas os cabeçalhos podem ser úteis.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Uma resposta de erro inesperada. Cabeçalhos x-ms-error-code: string

Name

Tipo

Description

200 OK

RenderOption[]

O pedido foi bem-sucedido.

204 No Content

Não há conteúdo para enviar para esta solicitação, mas os cabeçalhos podem ser úteis.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Uma resposta de erro inesperada.

Cabeçalhos

x-ms-error-code: string

Segurança

OAuth2Auth

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
https://geocatalog.spatio.azure.com/.default

Exemplos

StacCollectionRenderOptions_GetAll

Pedido de amostra

HTTP

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/stac/collections/sentinel-2-l2a-tutorial-7/configurations/render-options?api-version=2025-04-30-preview

Resposta da amostra

Código de estado:: 200

[
  {
    "id": "natural-color",
    "name": "Natural color",
    "description": "True color composite of visible bands (B04, B03, B02)",
    "type": "raster-tile",
    "options": "assets=B04&assets=B03&assets=B02&nodata=0&color_formula=Gamma RGB 3.2 Saturation 0.8 Sigmoidal RGB 25 0.35",
    "minZoom": 9
  },
  {
    "id": "natural-color-pre-feb-2022",
    "name": "Natural color (pre Feb, 2022)",
    "description": "Pre-Feb 2022 true color composite of visible bands (B04, B03, B02)",
    "type": "raster-tile",
    "options": "assets=B04&assets=B03&assets=B02&nodata=0&color_formula=Gamma RGB 3.7 Saturation 1.5 Sigmoidal RGB 15 0.35",
    "minZoom": 9
  },
  {
    "id": "color-infrared",
    "name": "Color infrared",
    "description": "Highlights healthy (red) and unhealthy (blue/gray) vegetation (B08, B04, B03).",
    "type": "raster-tile",
    "options": "assets=B08&assets=B04&assets=B03&nodata=0&color_formula=Gamma RGB 3.7 Saturation 1.5 Sigmoidal RGB 15 0.35",
    "minZoom": 9
  },
  {
    "id": "short-wave-infrared",
    "name": "Short wave infrared",
    "description": "Darker shades of green indicate denser vegetation. Brown is indicative of bare soil and built-up areas (B12, B8A, B04).",
    "type": "raster-tile",
    "options": "assets=B12&assets=B8A&assets=B04&nodata=0&color_formula=Gamma RGB 3.7 Saturation 1.5 Sigmoidal RGB 15 0.35",
    "minZoom": 9
  },
  {
    "id": "agriculture",
    "name": "Agriculture",
    "description": "Darker shades of green indicate denser vegetation (B11, B08, B02).",
    "type": "raster-tile",
    "options": "assets=B11&assets=B08&assets=B02&nodata=0&color_formula=Gamma RGB 3.7 Saturation 1.5 Sigmoidal RGB 15 0.35",
    "minZoom": 9
  },
  {
    "id": "normalized-difference-veg-inde",
    "name": "Normalized Difference Veg. Index (NDVI)",
    "description": "Normalized Difference Vegetation Index (B08-B04)/(B08+B04), darker green indicates healthier vegetation.",
    "type": "raster-tile",
    "options": "nodata=0&expression=(B08-B04)/(B08+B04)&rescale=-1,1&colormap_name=rdylgn&asset_as_band=true",
    "minZoom": 9
  },
  {
    "id": "moisture-index-ndwi",
    "name": "Moisture Index (NDWI)",
    "description": "Index indicating water stress in plants (B8A-B11)/(B8A+B11)",
    "type": "raster-tile",
    "options": "nodata=0&expression=(B8A-B11)/(B8A+B11)&rescale=-1,1&colormap_name=rdbu&asset_as_band=true",
    "minZoom": 9
  },
  {
    "id": "atmospheric-penetration",
    "name": "Atmospheric penetration",
    "description": "False color rendering with non-visible bands to reduce effects of atmospheric particles (B12, B11, B8A).",
    "type": "raster-tile",
    "options": "nodata=0&assets=B12&assets=B11&assets=B8A&color_formula=Gamma RGB 3.7 Saturation 1.5 Sigmoidal RGB 15 0.35",
    "minZoom": 9
  }
]

Código de estado:: 204

Definições

Name	Description
Azure.Core.Foundations.Error	O objeto de erro.
Azure.Core.Foundations.ErrorResponse	Uma resposta contendo detalhes do erro.
Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
LegendConfigType	Tipo de legenda a ser feito, um de: `continuous`, `classmap`, `interval` ou `none` (nota, `none` é um literal de cadeia de caracteres). Define os tipos de configuração de legenda para visualização de dados.
RenderOption	Define parâmetros de visualização para renderizar dados em um mapa.
RenderOptionCondition	Define uma condição para habilitar uma opção de renderização.
RenderOptionLegend	Configuração para gerar uma legenda de dados.
RenderOptionType	Especifica os tipos de opções de renderização para visualização de mapa.
RenderOptionVectorOptions	Define parâmetros para renderização de blocos vetoriais.

Azure.Core.Foundations.Error

Object

O objeto de erro.

Name	Tipo	Description
code	string	Um de um conjunto de códigos de erro definido pelo servidor.
details	Azure.Core.Foundations.Error[]	Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
innererror	Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação legível por humanos do erro.
target	string	O alvo do erro.

Azure.Core.Foundations.ErrorResponse

Object

Uma resposta contendo detalhes do erro.

Name	Tipo	Description
error	Azure.Core.Foundations.Error	O objeto de erro.

Azure.Core.Foundations.InnerError

Object

Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Tipo	Description
code	string	Um de um conjunto de códigos de erro definido pelo servidor.
innererror	Azure.Core.Foundations.InnerError	Erro interno.

LegendConfigType

Enumeração

Tipo de legenda a ser feito, um de: continuous, classmap, interval ou none (nota, none é um literal de cadeia de caracteres). Define os tipos de configuração de legenda para visualização de dados.

Valor	Description
classmap	Mapa classificado com cores discretas para as aulas.
continuous	Legenda contínua da rampa de cores.
interval	Legenda baseada em intervalos com intervalos discretos.
none	Sem lenda.

RenderOption

Object

Define parâmetros de visualização para renderizar dados em um mapa.

Name	Tipo	Default value	Description
conditions	RenderOptionCondition[]		Uma lista de condições de propriedade/valor que devem estar no CQL de mosaico ativo para que essa opção de renderização seja habilitada
description	string		Uma descrição mais longa da opção de renderização que pode ser usada para explicar seu conteúdo.
id	string minLength: 1 maxLength: 30 pattern: ^(?!\-\|_)[a-zA-Z0-9_-]*(?		Identificador exclusivo para a opção de renderização.
legend	RenderOptionLegend		Configuração de legenda para esta opção de renderização.
minZoom	integer (int32) maximum: 24	12	Nível mínimo de zoom para exibir essa camada.
name	string maxLength: 40		Nome descritivo curto para a opção de renderização.
options	string		Uma cadeia de caracteres codificada de cadeia de caracteres de URL das opções de renderização do TiLer. Válido apenas para `raster-tile` tipos. Consulte 'Parâmetros de consulta': https://developmentseed.org/titiler/endpoints/cog/#description
type	RenderOptionType	raster-tile	O tipo de renderização a ser aplicada (raster ou vetor).
vectorOptions	RenderOptionVectorOptions		Opções para renderizar blocos vetoriais. Válido apenas para `vt-polygon` e `vt-line` tipos.

RenderOptionCondition

Object

Define uma condição para habilitar uma opção de renderização.

Name	Tipo	Description
property	string	Nome da propriedade para fazer check-in do filtro CQL ativo.
value	string	Valor que a propriedade deve igualar.

RenderOptionLegend

Object

Configuração para gerar uma legenda de dados.

Name	Tipo	Description
labels	string[]	Rótulos de texto para exibir na legenda.
scaleFactor	number (float)	Um fator para multiplicar rótulos de legenda de intervalo por. Útil para rasters dimensionados cujas definições de mapa de cores são mapeadas para valores não dimensionados, mostrando efetivamente rótulos de legenda como valores dimensionados.
trimEnd	integer (int32)	Número de itens a serem cortados a partir do final da legenda.
trimStart	integer (int32)	O número de itens a serem cortados desde o início da definição da legenda. Usado se houver valores importantes para renderização (por exemplo, nodata) que não são desejáveis na legenda.
type	LegendConfigType	Tipo de legenda a ser feito, um de: `continuous`, `classmap`, `interval` ou `none` (nota, `none` é um literal de cadeia de caracteres).

RenderOptionType

Enumeração

Especifica os tipos de opções de renderização para visualização de mapa.

Valor	Description
raster-tile	Tipo de renderização de bloco raster.
vt-line	Tipo de renderização de linha de mosaico vetorial.
vt-polygon	Tipo de renderização de polígono de mosaico vetorial.

RenderOptionVectorOptions

Object

Define parâmetros para renderização de blocos vetoriais.

Name	Tipo	Description
fillColor	string	Cor de preenchimento para recursos de polígono.
filter	string[]	Expressão de filtro MapBox GL para filtrar recursos.
sourceLayer	string	Nome da camada de origem nos blocos vetoriais.
strokeColor	string	Cor do traçado para recursos de linha.
strokeWidth	integer (int32)	Largura dos traçados de linha em pixels.
tilejsonKey	string	Chave de ativo que contém a URL TileJSON.

Partilhar via

Stac Collection Render Options - Get All

Parâmetros do URI

Respostas

Segurança

OAuth2Auth

Âmbitos

Exemplos

StacCollectionRenderOptions_GetAll

Pedido de amostra

Resposta da amostra

Definições

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

LegendConfigType

RenderOption

RenderOptionCondition

RenderOptionLegend

RenderOptionType

RenderOptionVectorOptions