Stac Collection Render Options - Create

Hizmet:: Planetary Computer

API Sürümü:: 2026-04-15

Koleksiyon Oluşturma Seçeneği Ekle
Belirli bir koleksiyon için oluşturma seçeneği ekleme

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
collectionId	path	True	string maxLength: 500 pattern: .*	STAC koleksiyonu için benzersiz tanımlayıcı.
endpoint	path	True	string (uri)	Örneğin GeoCatalog uç noktası. `https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com`
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
id	True	string minLength: 1 maxLength: 30 pattern: ^(?!\-\|_)[a-zA-Z0-9_-]*(?	Oluşturma seçeneği için benzersiz tanımlayıcı.
name	True	string maxLength: 40	Oluşturma seçeneği için kısa açıklayıcı ad.
conditions		RenderOptionCondition[]	Bu oluşturma seçeneğinin etkinleştirilmesi için etkin mozaik CQL'de olması gereken özellik/değer koşullarının listesi
description		string	Oluşturma seçeneğinin, içeriğini açıklamak için kullanılabilecek daha uzun bir açıklaması.
legend		RenderOptionLegend	Bu oluşturma seçeneği için gösterge yapılandırması.
minZoom		integer (int32) maximum: 24	Bu katmanın görüntüleneceği minimum yakınlaştırma düzeyi.
options		string	TiTiler işleme seçeneklerinin URL sorgu dizesiyle kodlanmış bir dizesi. Yalnızca türler için `raster-tile` geçerlidir. Sorgu parametreleri bölümünü inceleyin.
type		RenderOptionType	Uygulanacak görüntü oluşturma türü (raster veya vektör).
vectorOptions		RenderOptionVectorOptions	Vektör döşemeleri oluşturma seçenekleri. Yalnızca ve `vt-polygon` türleri için `vt-line` geçerlidir.

Yanıtlar

Name	Tür	Description
201 Created	RenderOption	İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Name

Tür

Description

201 Created

RenderOption

İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Beklenmeyen bir hata yanıtı.

Üst Bilgiler

x-ms-error-code: string

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

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

Örnekler

StacCollectionRenderOptions_Create

Örnek isteği

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
}

Örnek yanıt

Durum kodu:: 201

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

Tanımlar

Name	Description
Azure.Core.Foundations.Error	Hata nesnesi.
Azure.Core.Foundations.ErrorResponse	Hata ayrıntılarını içeren bir yanıt.
Azure.Core.Foundations.InnerError	Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.
LegendConfigType	Oluşturulacak gösterge türü, şunlardan biri: `continuous`, `classmap`, `interval` veya `none` (not, `none` bir dize değişmez değeridir).
RenderOption	Bir harita üzerinde veri işlemek için görselleştirme parametrelerini tanımlar.
RenderOptionCondition	Bir oluşturma seçeneğini etkinleştirmek için bir koşul tanımlar.
RenderOptionLegend	Veri göstergesi oluşturmak için yapılandırma.
RenderOptionType	Harita görselleştirmesi için oluşturma seçeneklerinin türlerini belirtir.
RenderOptionVectorOptions	Vektör döşemesi oluşturma için parametreleri tanımlar.

Azure.Core.Foundations.Error

Nesne

Hata nesnesi.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	Azure.Core.Foundations.Error[]	Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı.
innererror	Azure.Core.Foundations.InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
target	string	Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Nesne

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	Azure.Core.Foundations.Error	Hata nesnesi.

Azure.Core.Foundations.InnerError

Nesne

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
innererror	Azure.Core.Foundations.InnerError	İç hata.

LegendConfigType

Numaralandırma

Oluşturulacak gösterge türü, şunlardan biri: continuous, classmap, interval veya none (not, none bir dize değişmez değeridir).

Değer	Description
continuous	Sürekli renk rampası göstergesi.
classmap	Sınıflar için ayrı renklerle sınıflandırılmış harita.
interval	Ayrık aralıklara sahip aralık tabanlı gösterge.
none	Efsane yok.

RenderOption

Nesne

Bir harita üzerinde veri işlemek için görselleştirme parametrelerini tanımlar.

Name	Tür	Default value	Description
conditions	RenderOptionCondition[]		Bu oluşturma seçeneğinin etkinleştirilmesi için etkin mozaik CQL'de olması gereken özellik/değer koşullarının listesi
description	string		Oluşturma seçeneğinin, içeriğini açıklamak için kullanılabilecek daha uzun bir açıklaması.
id	string minLength: 1 maxLength: 30 pattern: ^(?!\-\|_)[a-zA-Z0-9_-]*(?		Oluşturma seçeneği için benzersiz tanımlayıcı.
legend	RenderOptionLegend		Bu oluşturma seçeneği için gösterge yapılandırması.
minZoom	integer (int32) maximum: 24	12	Bu katmanın görüntüleneceği minimum yakınlaştırma düzeyi.
name	string maxLength: 40		Oluşturma seçeneği için kısa açıklayıcı ad.
options	string		TiTiler işleme seçeneklerinin URL sorgu dizesiyle kodlanmış bir dizesi. Yalnızca türler için `raster-tile` geçerlidir. Sorgu parametreleri bölümünü inceleyin.
type	RenderOptionType	raster-tile	Uygulanacak görüntü oluşturma türü (raster veya vektör).
vectorOptions	RenderOptionVectorOptions		Vektör döşemeleri oluşturma seçenekleri. Yalnızca ve `vt-polygon` türleri için `vt-line` geçerlidir.

RenderOptionCondition

Nesne

Bir oluşturma seçeneğini etkinleştirmek için bir koşul tanımlar.

Name	Tür	Description
property	string	Etkin CQL filtresini iade etmek için özellik adı.
value	string	Özelliğin eşit olması gereken değer.

RenderOptionLegend

Nesne

Veri göstergesi oluşturmak için yapılandırma.

Name	Tür	Description
labels	string[]	Göstergede görüntülenecek metin etiketleri.
scaleFactor	number (float)	Aralık gösterge etiketlerini çarpmak için bir faktör. Renk eşlem tanımları ölçeklenmemiş değerlerle eşlenen ve gösterge etiketlerini ölçeklenmiş değerler olarak etkin bir şekilde gösteren ölçeklenmiş rasterler için kullanışlıdır.
trimEnd	integer (int32)	Göstergenin sonundan itibaren kırpılacak öğe sayısı.
trimStart	integer (int32)	Gösterge tanımının başından itibaren kırpılacak öğe sayısı. Göstergede istenmeyen, oluşturma için önemli değerler (ör. nodata) varsa kullanılır.
type	LegendConfigType	Oluşturulacak gösterge türü, şunlardan biri: `continuous`, `classmap`, `interval` veya `none` (not, `none` bir dize değişmez değeridir).

RenderOptionType

Numaralandırma

Harita görselleştirmesi için oluşturma seçeneklerinin türlerini belirtir.

Değer	Description
raster-tile	Raster döşeme oluşturma türü.
vt-polygon	Vektör döşeme poligon oluşturma türü.
vt-line	Vektör döşeme çizgisi oluşturma türü.

RenderOptionVectorOptions

Nesne

Vektör döşemesi oluşturma için parametreleri tanımlar.

Name	Tür	Description
fillColor	string	Çokgen unsurları için dolgu rengi.
filter	string[]	Özellik filtrelemek için MapBox GL filtre ifadesi.
sourceLayer	string	Vektör kutucuklarındaki kaynak katmanın adı.
strokeColor	string	Çizgi unsurları için kontur rengi.
strokeWidth	integer (int32)	Çizgi konturlarının piksel cinsinden genişliği.
tilejsonKey	string	TileJSON URL'sini içeren varlık anahtarı.