Mosaic Collections Wmts - Get Capabilities Xml

Dienst:: Planetary Computer

API-Version:: 2026-04-15

Sammlung Wmts
OGC WMTS-Endpunkt für eine STAC-Sammlung.

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

Mit optionalen Parametern:

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}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
collectionId	path	True	string maxLength: 500 pattern: .*	STAC-Sammlungskennung
endpoint	path	True	string (uri)	GeoCatalog-Endpunkt, z. B. `https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com`
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
asset_as_band	query		boolean	Vermögenswert als Band
asset_bidx	query		string[]	Bandindizes pro Asset (koma-getrennte Indizes, z. B. "image\|1,2,3" bedeutet, dass die Bänder 1, 2 und 3 des Assets namens "image" verwendet werden)
assets	query		string[]	Namen der Assets.
bbox	query		string	Begrenzungsfeld (West, Süd, Ost, Nord).
bidx	query		integer[]	Bandindizes des Datensatzes
datetime	query		string	Datetime-Filterausdruck (einzelne Datetime oder Range mit Separator `/` ).
expression	query		string	Mathematischer Bandausdruck zwischen Assets
ids	query		string	Array von Item-IDs.
maxzoom	query		integer (int32)	Überschreiben Sie den Standardwert maxzoom.
minzoom	query		integer (int32)	Überschreiben Sie den Standard-Minzoom.
nodata	query		string	Interner Nodata-Wert überschreiben
query	query		string	JSON-Abfrageausdruck zum Filtern von Elementen.
reproject	query		WarpKernelResampling	WarpKernel-Resampling-Algorithmus (wird nur bei der Reprojektion verwendet). Wird standardmäßig auf `nearest` festgelegt.
sortby	query		string	Sortierausdruck (z. B. +/-Eigenschaft).
tile_format	query		TilerImageFormat	Ausgabebildtyp. Der Standardwert ist png.
tile_scale	query		integer (int32)	Kachelskalierungsfaktor, der sich auf die Ausgabegröße auswirkt. Die Werte > 1 erzeugen größere Kacheln (z. B. 1 = 256 x 256, 2 = 512 x 512).
TileMatrixSetId	query		TileMatrixSetId	Bezeichner, der eine der unterstützten TileMatrixSetId-Bezeichner auswählt (Standard: 'WebMercatorQuad')
unscale	query		boolean	Wenden Sie die interne Skalierung oder den Versatz an

Antworten

Name	Typ	Beschreibung
200 OK	file	Erfolgreiche Reaktion Media Types: "application/xml", "application/json"
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Unerwartete Fehlerantwort. Media Types: "application/xml", "application/json" Header x-ms-error-code: string

Name

Typ

Beschreibung

200 OK

file

Erfolgreiche Reaktion

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

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Unerwartete Fehlerantwort.

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

Header

x-ms-error-code: string

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

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

Beispiele

MosaicCollectionsWmts_GetCapabilitiesXml

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 200

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

Definitionen

Name	Beschreibung
Azure.Core.Foundations.Error	Das Fehlerobjekt.
Azure.Core.Foundations.ErrorResponse	Eine Antwort, die Fehlerdetails enthält.
Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Laut Azure REST API-Richtlinien – https://aka.ms/AzureRestApiGuidelines#handling-errors.
TileMatrixSetId	Bezeichner, der eine der unterstützten TileMatrixSetId-Bezeichner auswählt (Standard: 'WebMercatorQuad') Standardbezeichner für ein Koordinatenreferenzsystem und ein Tiling-Schema, das für das Bedienen von Kartenkacheln verwendet wird
TilerImageFormat	Bildformatbezeichner für Kachel- und Bildanforderungen
WarpKernelResampling	WarpKernel-Resampling-Algorithmus, der bei der Reprojektion verwendet wird. Wird standardmäßig auf `nearest` festgelegt.

Azure.Core.Foundations.Error

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	Azure.Core.Foundations.Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

Azure.Core.Foundations.ErrorResponse

Objekt

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	Azure.Core.Foundations.Error	Das Fehlerobjekt.

Azure.Core.Foundations.InnerError

Objekt

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Laut Azure REST API-Richtlinien – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
innererror	Azure.Core.Foundations.InnerError	Innerer Fehler.

TileMatrixSetId

Enumeration

Bezeichner, der eine der unterstützten TileMatrixSetId-Bezeichner auswählt (Standard: 'WebMercatorQuad')

Standardbezeichner für ein Koordinatenreferenzsystem und ein Tiling-Schema, das für das Bedienen von Kartenkacheln verwendet wird

Wert	Beschreibung
CanadianNAD83_LCC	Kanadisches NAD83 Lambert-konformes konisches Projektionsfliesen-Matrix-Set
EuropeanETRS89_LAEAQuad	Europäisches ETRS89 Lambert Azimuthal Equal Area Quad Tile Matrix Set
LINZAntarticaMapTilegrid	Land Information Neuseeland (LINZ) Antarktis-Karte Kachel Gitter Matrix Set
NZTM2000Quad	Neuseeland Quer Mercator 2000 Quad Fliesen Matrix Set
UPSAntarcticWGS84Quad	Universelles polares stereografisches Antarktis-WGS84-Quad-Kachel-Matrix-Set
UPSArcticWGS84Quad	Universal Polar Stereographic Arctic WGS84 Quad Fliesen Matrix Set
UTM31WGS84Quad	Universelles Querfliesen-Matrizen-Set Mercator Zone 31 WGS84 Quad-Fliesen-Matrizen-Set
WGS1984Quad	WGS 1984 Quad-Fliesen-Matrizen-Set
WebMercatorQuad	Web Mercator Quad-Kachel-Matrix-Set
WorldCRS84Quad	World CRS84 Quad-Kachel-Matrix-Set
WorldMercatorWGS84Quad	World Mercator WGS84 Quad Fliesen Matrix Set

TilerImageFormat

Enumeration

Bildformatbezeichner für Kachel- und Bildanforderungen

Wert	Beschreibung
png	Portable Network Graphics-Format - unterstützt Transparenz
npy	NumPy-Array-Format für den Zugriff auf Rohdaten
tif	GeoTIFF-Format für georeferenzierte Raster-Daten
jpeg	JPEG-Format - kleinere Dateigröße, aber verlustbehaftete Komprimierung
jpg	Alternative Erweiterung für das JPEG-Format
jp2	JPEG 2000-Format - unterstützt sowohl verlustbehaftete als auch verlustfreie Komprimierung
webp	WebP-Format - modernes Bildformat mit guter Komprimierung
pngraw	Rohformat PNG für den Zugriff auf unverarbeitete Daten

WarpKernelResampling

Enumeration

WarpKernel-Resampling-Algorithmus, der bei der Reprojektion verwendet wird. Wird standardmäßig auf nearest festgelegt.

Wert	Beschreibung
nearest	Nächster Nachbar
bilinear	Bilineare Interpolation
cubic	Kubische Interpolation
cubic_spline	Kubische Spline-Interpolation
lanczos	Lanczos Windowed Sinc Resampling
average	Durchschnittliche Resampling
mode	Modus-Resampling
max	Maximalwert-Resampling
min	Minimalwert-Resampling
med	Medianwert-Resampling
q1	Erstes Quartil-Resampling
q3	Dritte Quartil-Neubeschlagnahme
sum	Summen-Resampling
rms	Wurzelmittelwert-Quadrat-Resampling