Geo Catalog Azmaps Token - Get

Dienst:

Planetary Computer

API-Version:

2025-04-30-preview

Abrufen des Azmaps-Tokens
Rufen Sie ein Token für den Azure Maps-API-Dienst ab, das auf der aktuellen Dienstidentität basiert. Dieses Token wird für den Explorer verwendet, um sich beim Azure Maps-API-Dienst zu authentifizieren.

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/geocatalog/map/token?api-version=2025-04-30-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	AzMapsToken	Die Anforderung ist erfolgreich.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Unerwartete Fehlerantwort. 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

GeoCatalogAzmapsToken_Get

Beispielanforderung

HTTP

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/geocatalog/map/token?api-version=2025-04-30-preview

Beispiel für eine Antwort

Statuscode:

200

{
  "token": "token-0df36a74d7ed",
  "expires_on": 1735744566
}

Definitionen

Name	Beschreibung
AzMapsToken	Stellt ein Azure Maps-Token für die Kartenvisualisierung dar.
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. Gemäß den Microsoft One-API-Richtlinien – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

AzMapsToken

Objekt

Stellt ein Azure Maps-Token für die Kartenvisualisierung dar.

Name	Typ	Beschreibung
expires_on	integer (int32)	Ablaufzeitstempel des Tokens in Unix-Zeit.
token	string	Das Authentifizierungstoken für Azure Maps.

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 normal 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. Gemäß den Microsoft One-API-Richtlinien – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

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