Stac Collection Render Options - Create

Usługa:: Planetary Computer

Wersja interfejsu API:: 2026-04-15

Dodaj opcję renderowania kolekcji
Dodawanie opcji renderowania dla danej kolekcji

POST {endpoint}/stac/collections/{collectionId}/configurations/render-options?api-version=2026-04-15

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
collectionId	path	True	string maxLength: 500 pattern: .*	Niepowtarzalny identyfikator kolekcji STAC.
endpoint	path	True	string (uri)	Endpoint GeoCatalog, np. `https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com`
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
id	True	string minLength: 1 maxLength: 30 pattern: ^(?!\-\|_)[a-zA-Z0-9_-]*(?	Unikalny identyfikator opcji renderowania.
name	True	string maxLength: 40	Krótka opisowa nazwa opcji renderowania.
conditions		RenderOptionCondition[]	Lista warunków właściwości/wartości, które muszą znaleźć się w aktywnym mozaikowym CQL, aby ta opcja renderowania została włączona
description		string	Dłuższy opis opcji renderowania, który może wyjaśnić jej zawartość.
legend		RenderOptionLegend	Konfiguracja legendy dla tej opcji renderowania.
minZoom		integer (int32) maximum: 24	Minimalny poziom powiększenia, na którym można wyświetlić tę warstwę.
options		string	Łańcuch zakodowany przez zapytanie łańcucha URL z opcjami renderowania TiTiler. Dotyczy tylko `raster-tile` typów. Zobacz Parametry zapytania.
type		RenderOptionType	Rodzaj renderowania, który należy zastosować (rastr lub wektor).
vectorOptions		RenderOptionVectorOptions	Opcje renderowania kafelków wektorowych. Dotyczy tylko `vt-polygon` typów i `vt-line` typów.

Odpowiedzi

Nazwa	Typ	Opis
201 Created	RenderOption	Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Nieoczekiwana odpowiedź na błąd. Nagłówki x-ms-error-code: string

Nazwa

Typ

Opis

201 Created

RenderOption

Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Nagłówki

x-ms-error-code: string

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
https://geocatalog.spatio.azure.com/.default

Przykłady

StacCollectionRenderOptions_Create

Przykładowe żądanie

HTTP

POST {endpoint}/stac/collections/naip-atl/configurations/render-options?api-version=2026-04-15

{
  "id": "test-natural-color",
  "name": "Test Natural color",
  "type": "raster-tile",
  "options": "assets=image&asset_bidx=image|1,2,3",
  "minZoom": 6
}

Przykładowa odpowiedź

Kod stanu:: 201

{
  "id": "test-natural-color",
  "name": "Test Natural color",
  "type": "raster-tile",
  "options": "assets=image&asset_bidx=image|1,2,3",
  "minZoom": 6
}

Definicje

Nazwa	Opis
Azure.Core.Foundations.Error	Obiekt błędu.
Azure.Core.Foundations.ErrorResponse	Odpowiedź zawierająca szczegóły błędu.
Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z Azure wytycznymi API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.
LegendConfigType	Typ legendy do wykonania: `continuous`, `classmap`, lub `intervalnone` (uwaga, `none` to dosłowny ciąg znaków).
RenderOption	Definiuje parametry wizualizacji do renderowania danych na mapie.
RenderOptionCondition	Definiuje warunek umożliwiający włączenie opcji renderowania.
RenderOptionLegend	Konfiguracja generowania legendy danych.
RenderOptionType	Określa typy opcji renderowania dla wizualizacji map.
RenderOptionVectorOptions	Definiuje parametry renderowania kafelków wektorowych.

Azure.Core.Foundations.Error

Objekt

Obiekt błędu.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	Azure.Core.Foundations.Error[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
innererror	Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.
target	string	Element docelowy błędu.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpowiedź zawierająca szczegóły błędu.

Nazwa	Typ	Opis
error	Azure.Core.Foundations.Error	Obiekt błędu.

Azure.Core.Foundations.InnerError

Objekt

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z Azure wytycznymi API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
innererror	Azure.Core.Foundations.InnerError	Błąd wewnętrzny.

LegendConfigType

Wyliczenie

Typ legendy do wykonania: continuous, classmap, lub intervalnone (uwaga, none to dosłowny ciąg znaków).

Wartość	Opis
continuous	Legenda ciągłej kolorowej rampy.
classmap	Mapa klas z dyskretnymi kolorami.
interval	Legenda oparta na interwałach z dyskretnymi zakresami.
none	Nie ma legendy.

RenderOption

Objekt

Definiuje parametry wizualizacji do renderowania danych na mapie.

Nazwa	Typ	Domyślna wartość	Opis
conditions	RenderOptionCondition[]		Lista warunków właściwości/wartości, które muszą znaleźć się w aktywnym mozaikowym CQL, aby ta opcja renderowania została włączona
description	string		Dłuższy opis opcji renderowania, który może wyjaśnić jej zawartość.
id	string minLength: 1 maxLength: 30 pattern: ^(?!\-\|_)[a-zA-Z0-9_-]*(?		Unikalny identyfikator opcji renderowania.
legend	RenderOptionLegend		Konfiguracja legendy dla tej opcji renderowania.
minZoom	integer (int32) maximum: 24	12	Minimalny poziom powiększenia, na którym można wyświetlić tę warstwę.
name	string maxLength: 40		Krótka opisowa nazwa opcji renderowania.
options	string		Łańcuch zakodowany przez zapytanie łańcucha URL z opcjami renderowania TiTiler. Dotyczy tylko `raster-tile` typów. Zobacz Parametry zapytania.
type	RenderOptionType	raster-tile	Rodzaj renderowania, który należy zastosować (rastr lub wektor).
vectorOptions	RenderOptionVectorOptions		Opcje renderowania kafelków wektorowych. Dotyczy tylko `vt-polygon` typów i `vt-line` typów.

RenderOptionCondition

Objekt

Definiuje warunek umożliwiający włączenie opcji renderowania.

Nazwa	Typ	Opis
property	string	Nazwa właściwości, aby sprawdzić w aktywnym filtrze CQL.
value	string	Wartości, której nieruchomość musi być równa.

RenderOptionLegend

Objekt

Konfiguracja generowania legendy danych.

Nazwa	Typ	Opis
labels	string[]	Etykiety tekstowe do wyświetlenia na legendzie.
scaleFactor	number (float)	Czynnik do mnożenia etykiet legend przez. Przydatne dla skalowanych rastrów, których definicje mapy kolorów odwzorowują się na wartości nieskalowane, skutecznie pokazując etykiety legend jako wartości skalowane.
trimEnd	integer (int32)	Liczba przedmiotów do usunięcia z końca legendy.
trimStart	integer (int32)	Liczba elementów do przycięcia od początku definicji legendy. Używa się, jeśli w legendzie są wartości ważne dla renderowania (np. nodata), które nie są pożądane.
type	LegendConfigType	Typ legendy do wykonania: `continuous`, `classmap`, lub `intervalnone` (uwaga, `none` to dosłowny ciąg znaków).

RenderOptionType

Wyliczenie

Określa typy opcji renderowania dla wizualizacji map.

Wartość	Opis
raster-tile	Typ renderowania kafelków rastrowych.
vt-polygon	Typ renderowania wielokątów z kafelkami wektorowymi.
vt-line	Typ renderowania linii wektorowych kafelków.

RenderOptionVectorOptions

Objekt

Definiuje parametry renderowania kafelków wektorowych.

Nazwa	Typ	Opis
fillColor	string	Kolor wypełniający dla cech wielokątnych.
filter	string[]	MapBox GL wyrażenie filtrów do cech filtracyjnych.
sourceLayer	string	Nazwa warstwy źródłowej w kafelkach wektorowych.
strokeColor	string	Kolor kresek dla cech linii.
strokeWidth	integer (int32)	Szerokość kresek linii w pikselach.
tilejsonKey	string	Klucz asset zawierający adres URL TileJSON.