Mosaic Collections Wmts - Get Capabilities Xml

Servizio:: Planetary Computer

Versione API:: 2026-04-15

Collezione Wmts
Endpoint OGC WMTS per una collezione STAC.

GET {endpoint}/data/mosaic/collections/{collectionId}/WMTSCapabilities.xml?api-version=2026-04-15

Con parametri facoltativi:

GET {endpoint}/data/mosaic/collections/{collectionId}/WMTSCapabilities.xml?api-version=2026-04-15&ids={ids}&bbox={bbox}&query={query}&sortby={sortby}&datetime={datetime}&TileMatrixSetId={TileMatrixSetId}&tile_format={tile_format}&tile_scale={tile_scale}&minzoom={minzoom}&maxzoom={maxzoom}&bidx={bidx}&assets={assets}&expression={expression}&asset_bidx={asset_bidx}&asset_as_band={asset_as_band}&nodata={nodata}&unscale={unscale}&reproject={reproject}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
collectionId	path	True	string maxLength: 500 pattern: .*	Identificatore della collezione STAC
endpoint	path	True	string (uri)	Endpoint GeoCatalog, ad esempio `https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com`
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
asset_as_band	query		boolean	Asset come banda
asset_bidx	query		string[]	Indici per banda per asset (indici separati in coma, ad esempio "image\|1,2,3" significa usare le bande 1, 2 e 3 dell'asset denominato "image")
assets	query		string[]	Nomi dei beni.
bbox	query		string	Scatola di delimitazione (ovest, sud, est, nord).
bidx	query		integer[]	Indici delle bande di dati
datetime	query		string	Espressione del filtro datetime (singolo datetime o intervallo usando `/` separatore).
expression	query		string	Espressione matematica a bande tra asset
ids	query		string	Array di ID di oggetti.
maxzoom	query		integer (int32)	Sovrascrivi maxzoom predefinito.
minzoom	query		integer (int32)	Sovrascrivi minzoom predefinito.
nodata	query		string	Sovrascrivi il valore Nodata interno
query	query		string	Espressione di query JSON per il filtraggio degli elementi.
reproject	query		WarpKernelResampling	Algoritmo di ricampionamento WarpKernel (usato solo durante la riproiezione). Il valore predefinito è `nearest`.
sortby	query		string	Espressione di ordinamento (ad esempio +/-proprietà).
tile_format	query		TilerImageFormat	Tipo di immagine di output. Il valore predefinito è png.
tile_scale	query		integer (int32)	Fattore di scala delle tessere che influisce sulle dimensioni dell'output. I valori > 1 producono tessere più grandi (ad esempio, 1=256x256, 2=512x512).
TileMatrixSetId	query		TileMatrixSetId	Identificatore che seleziona uno dei TileMatrixSetId supportati (predefinito: 'WebMercatorQuad')
unscale	query		boolean	Applica scala interna o offset

Risposte

Nome	Tipo	Descrizione
200 OK	file	Risposta riuscita Media Types: "application/xml", "application/json"
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Media Types: "application/xml", "application/json" Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

200 OK

file

Risposta riuscita

Media Types: "application/xml", "application/json"

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Risposta di errore imprevista.

Media Types: "application/xml", "application/json"

Intestazioni

x-ms-error-code: string

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://geocatalog.spatio.azure.com/.default

Esempio

MosaicCollectionsWmts_GetCapabilitiesXml

Esempio di richiesta

HTTP

GET {endpoint}/data/mosaic/collections/naip-atl/WMTSCapabilities.xml?api-version=2026-04-15&ids=item-id-1,item-id-2&bbox=-180,-90,180,90&query={}&sortby=-datetime

Risposta di esempio

Codice di stato:: 200

"<?xml version=\"1.0\" encoding=\"UTF-8\"?><Capabilities/>"

Definizioni

Nome	Descrizione
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. Secondo le linee guida Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.
TileMatrixSetId	Identificatore che seleziona uno dei TileMatrixSetId supportati (predefinito: 'WebMercatorQuad') Identificatore standard per un sistema di riferimento di coordinate e uno schema di tiling utilizzati per servire le tessere della mappa
TilerImageFormat	Identificatore del formato immagine per le richieste di riquadri e immagini
WarpKernelResampling	Algoritmo di ricampionamento WarpKernel utilizzato durante la riproiezione. Il valore predefinito è `nearest`.

Azure.Core.Foundations.Error

Oggetto

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	Azure.Core.Foundations.Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

Azure.Core.Foundations.ErrorResponse

Oggetto

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Oggetto

Oggetto contenente informazioni più specifiche sull'errore. Secondo le linee guida Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

TileMatrixSetId

Enumerazione

Identificatore che seleziona uno dei TileMatrixSetId supportati (predefinito: 'WebMercatorQuad')

Identificatore standard per un sistema di riferimento di coordinate e uno schema di tiling utilizzati per servire le tessere della mappa

Valore	Descrizione
CanadianNAD83_LCC	Set di matrici di piastrelle di proiezione conica conforme canadese NAD83 Lambert
EuropeanETRS89_LAEAQuad	Set di matrici per quad quad ad area uguale Lambert Lambert europeo ETRS89
LINZAntarticaMapTilegrid	Informazioni sul territorio Nuova Zelanda (LINZ) Set di matrici di griglie di tessere della mappa dell'Antartide
NZTM2000Quad	Nuova Zelanda Trasversa Mercatore 2000 Set di matrici a quad
UPSAntarcticWGS84Quad	Set di matrici per quad Quad Stereographic Antarctic WGS84 Stereografico Polare Universale
UPSArcticWGS84Quad	Set di matrici per quad Universal Polar Stereographic Arctic WGS84
UTM31WGS84Quad	Universal Transverse Mercator Zone 31 WGS84 Set di matrici quad
WGS1984Quad	WGS 1984 Set di matrici quad tile
WebMercatorQuad	Web Mercator Set di matrici quad tile
WorldCRS84Quad	World CRS84 Set di matrici quad
WorldMercatorWGS84Quad	World Mercator WGS84 Set di matrici quad

TilerImageFormat

Enumerazione

Identificatore del formato immagine per le richieste di riquadri e immagini

Valore	Descrizione
png	Formato Portable Network Graphics - supporta la trasparenza
npy	Formato array NumPy per l'accesso ai dati grezzi
tif	Formato GeoTIFF per dati raster georeferenziati
jpeg	Formato JPEG: dimensioni del file più piccole ma compressione con perdita di dati
jpg	Estensione alternativa per il formato JPEG
jp2	Formato JPEG 2000 - supporta sia la compressione con perdita che senza perdita di dati
webp	Formato WebP - formato immagine moderno con una buona compressione
pngraw	Formato PNG grezzo per l'accesso ai dati non elaborati

WarpKernelResampling

Enumerazione

Algoritmo di ricampionamento WarpKernel utilizzato durante la riproiezione. Il valore predefinito è nearest.

Valore	Descrizione
nearest	Vicino più prossimo
bilinear	Interpolazione bilineare
cubic	Interpolazione cubica
cubic_spline	Interpolazione a spline cubiche
lanczos	Ricampionamento a finestre sinc di Lanczos
average	Ricampionamento medio
mode	Ricampionamento delle modalità
max	Ricampionamento del valore massimo
min	Ricampionamento a valori minimi
med	Ricampionamento dei valori mediani
q1	Ricampionamento del primo quartile
q3	Ricampionamento del terzo quartile
sum	Ricampionamento somma
rms	Ricampionamento quadratico medio radice