Render V2 - Get Map Tile

Ist diese Seite hilfreich?

Haben Sie weiteres Feedback für uns?

Feedback wird an Microsoft gesendet: Wenn Sie auf die Sendeschaltfläche klicken, wird Ihr Feedback verwendet, um Microsoft-Produkte und -Dienste zu verbessern. Datenschutzrichtlinie

Service:

Maps

API Version:

2.1

Gilt für: Siehe Tarife.

Mit der API zum Abrufen von Kartenkacheln können Benutzer Kartenkacheln in Vektor- oder Rasterformaten anfordern, die in der Regel in ein Kartensteuerelement oder SDK integriert werden. Einige Beispielkacheln, die angefordert werden können, sind Azure Karten Straßenkacheln, Wetterradarkacheln in Echtzeit oder die kartenkacheln, die mit Azure Karten Creator erstellt wurden. Standardmäßig verwendet Azure Karten Vektorkacheln für das Webzuordnungssteuerelement (Web SDK) und die Android SDK.

GET https://atlas.microsoft.com/map/tile?api-version=2.1&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}

With optional parameters:

GET https://atlas.microsoft.com/map/tile?api-version=2.1&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}&timeStamp={timeStamp}&tileSize={tileSize}&language={language}&view={view}

URI-Parameter

Name	In	Required	Type	Description
api-version	query	True	string	Versionsnummer der Azure Karten-API. Aktuelle Version ist 2.1
tilesetId	query	True	TilesetID	Ein Kachelsatz ist eine Sammlung von Raster- oder Vektordaten, die in ein einheitliches Raster von Quadratkacheln mit voreingestellten Zoomstufen unterteilt sind. Jedes Kachelsatz verfügt über eine Kachelsatz-ID , die beim Erstellen von Anforderungen verwendet werden soll. Die Kachelsatz-ID für Kachelsätze, die mit Azure Karten Creator erstellt wurden, wird über die Kachelsatzerstellungs-API generiert. Die einsatzbereiten Kachelsätze, die von Azure Karten bereitgestellt werden, sind unten aufgeführt. Beispiel: microsoft.base.
x	query	True	integer int32	X-Koordinate der Kachel im Zoomraster. Der Wert muss im Bereich [0, 2zoom -1] liegen. Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .
y	query	True	integer int32	Y-Koordinate der Kachel im Zoomraster. Der Wert muss im Bereich [0, 2zoom -1] liegen. Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .
zoom	query	True	integer int32	Zoomfaktor für die gewünschte Kachel. Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .
language	query		string	Sprache, in der Suchergebnisse zurückgegeben werden sollen. Sollte eines der unterstützten IETF-Sprachtags sein, wobei die Groß-/Kleinschreibung nicht beachtet wird. Wenn Daten in der angegebenen Sprache für ein bestimmtes Feld nicht verfügbar sind, wird die Standardsprache verwendet. Weitere Informationen finden Sie unter Unterstützte Sprachen .
tileSize	query		MapTileSize	Die Größe der zurückgegebenen Kartenkachel in Pixel.
timeStamp	query		string date-time	Das gewünschte Datum und die gewünschte Uhrzeit der angeforderten Kachel. Dieser Parameter muss im standardmäßigen Datums-/Uhrzeitformat (z. B. 2019-11-14T16:03:00-08:00) angegeben werden, wie in ISO 8601 definiert. Dieser Parameter wird nur unterstützt, wenn der tilesetId-Parameter auf einen der folgenden Werte festgelegt ist. microsoft.weather.js.main: Wir stellen Kacheln bis zu 3 Stunden in der Vergangenheit bereit. Kacheln sind in Intervallen von 10 Minuten verfügbar. Wir runden den timeStamp-Wert auf den nächsten 10-Minuten-Zeitrahmen ab. microsoft.weather.radar.main: Wir stellen Kacheln bis zu 1,5 Stunden in der Vergangenheit und bis zu 2 Stunden in der Zukunft bereit. Kacheln sind in Intervallen von 5 Minuten verfügbar. Wir runden den timeStamp-Wert auf den nächsten 5-Minuten-Zeitrahmen ab.
view	query		LocalizedMapView	Mit dem View-Parameter (auch als Parameter "Benutzerregion" bezeichnet) können Sie die richtigen Zuordnungen für ein bestimmtes Land/eine bestimmte Region für geopolitische Konfliktregionen anzeigen. Verschiedene Länder haben unterschiedliche Ansichten dieser Regionen, und mit dem Parameter Ansicht kann Ihre Anwendung die Ansicht erfüllen, die für das Land erforderlich ist, in dem Ihre Anwendung verwendet wird. Standardmäßig ist der View-Parameter auf "Unified" festgelegt, auch wenn Sie ihn nicht in der Anforderung definiert haben. Es liegt in Ihrer Verantwortung, den Standort Ihrer Benutzer zu bestimmen und dann den „View“-Parameter für diesen Standort entsprechend festzulegen. Alternativ können Sie "View=Auto" festlegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgegeben werden. Der View-Parameter in Azure Karten muss in Übereinstimmung mit den geltenden Gesetzen verwendet werden, einschließlich derjenigen in Bezug auf die Zuordnung des Landes, in dem Karten, Bilder und andere Daten und Inhalte von Drittanbietern, auf die Sie über Azure Karten zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN. Ausführliche Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten.

Anforderungsheader

Name	Required	Type	Description
x-ms-client-id		string	Gibt an, welches Konto für die Verwendung in Verbindung mit dem Azure AD-Sicherheitsmodell vorgesehen ist. Sie stellt eine eindeutige ID für das Azure Karten-Konto dar und kann von der Konto-API der Azure Karten-Verwaltungsebene abgerufen werden. Informationen zur Verwendung Azure AD Sicherheit in Azure Karten finden Sie in den folgenden Artikeln.

Antworten

Name	Type	Description
200 OK	object	Die Kachel, die von einem erfolgreichen API-Aufruf zurückgegeben wurde. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" Headers Content-Type: string
Other Status Codes	ErrorResponse	Ein unerwarteter Fehler ist aufgetreten. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

Sicherheit

AADToken

Dies sind die Azure Active Directory OAuth2-Flows. In Kombination mit der rollenbasierten Zugriffssteuerung von Azure kann sie verwendet werden, um den Zugriff auf Azure Karten REST-APIs zu steuern. Rollenbasierte Zugriffssteuerungen in Azure werden verwendet, um den Zugriff auf mindestens ein Azure Karten-Ressourcenkonto oder untergeordnete Ressourcen festzulegen. Jedem Benutzer, jeder Gruppe oder jedem Dienstprinzipal kann Zugriff über eine integrierte Rolle oder eine benutzerdefinierte Rolle gewährt werden, die aus mindestens einer Berechtigung für Azure Karten REST-APIs besteht.

Um Szenarien zu implementieren, wird empfohlen, Authentifizierungskonzepte anzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zum Modellieren von Anwendungen über Objekte, die zugriffssteuerungsfähig für bestimmte APIs und Bereiche sind.

Notizen

• Diese Sicherheitsdefinition erfordert die Verwendung des x-ms-client-id -Headers, um anzugeben, auf welche Azure Karten Ressource die Anwendung Zugriff anfordert. Dies kann über die Karten-Verwaltungs-API erworben werden.

ist Authorization URL spezifisch für die öffentliche Azure-Cloudinstanz. Sovereign Clouds verfügen über eindeutige Autorisierungs-URLs und Azure Active Directory-Konfigurationen. * Die rollenbasierte Zugriffssteuerung in Azure wird über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert. * Die Verwendung des Azure Karten Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.

• Derzeit unterstützt Azure Active Directory v1.0 oder v2.0 Arbeits-, Schul- und Gastkonten, aber keine persönlichen Konten.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Dies ist ein gemeinsam verwendeter Schlüssel, der beim Erstellen einer Azure Karten-Ressource über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs bereitgestellt wird.

Mit diesem Schlüssel ist jede Anwendung berechtigt, auf alle REST-APIs zuzugreifen. Anders ausgedrückt: Diese können derzeit als Hauptschlüssel für das Konto behandelt werden, für das sie ausgestellt werden.

Für öffentlich verfügbar gemachte Anwendungen wird empfohlen, den Server-zu-Server-Zugriff auf Azure Karten REST-APIs zu verwenden, in denen dieser Schlüssel sicher gespeichert werden kann.

Type: apiKey
In: query

SAS Token

Dies ist ein SAS-Token für den gemeinsamen Zugriff, das aus dem Vorgang SAS auflisten für die Azure Karten-Ressource über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt wird.

Mit diesem Token ist jede Anwendung für den Zugriff mit rollenbasierten Azure-Zugriffssteuerungen und einer differenzierten Steuerung des Ablaufs, der Rate und der Regionen autorisiert, die für das jeweilige Token verwendet werden. Anders ausgedrückt: Das SAS-Token kann verwendet werden, um Anwendungen die Steuerung des Zugriffs auf sicherere Weise als der gemeinsam genutzte Schlüssel zu ermöglichen.

Für öffentlich verfügbar gemachte Anwendungen empfiehlt es sich, eine bestimmte Liste zulässiger Ursprünge in der Map-Kontoressource zu konfigurieren, um Rendering-Missbrauch einzuschränken und das SAS-Token regelmäßig zu erneuern.

Type: apiKey
In: header

Beispiele

Successful Tile Request

Sample Request

GET https://atlas.microsoft.com/map/tile?api-version=2.1&tilesetId=microsoft.base&zoom=6&x=10&y=22

Sample Response

Status code:

200

Content-Type: application/vnd.mapbox-vector-tile

Response Body

"binary image string"

Definitionen

ErrorAdditionalInfo	Zusätzliche Informationen zu Ressourcenverwaltungsfehlern.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
LocalizedMapView	Mit dem View-Parameter (auch als Parameter "Benutzerregion" bezeichnet) können Sie die richtigen Zuordnungen für ein bestimmtes Land/eine bestimmte Region für geopolitische Konfliktregionen anzeigen. Verschiedene Länder haben unterschiedliche Ansichten dieser Regionen, und mit dem Parameter Ansicht kann Ihre Anwendung die Ansicht erfüllen, die für das Land erforderlich ist, in dem Ihre Anwendung verwendet wird. Standardmäßig ist der View-Parameter auf "Unified" festgelegt, auch wenn Sie ihn nicht in der Anforderung definiert haben. Es liegt in Ihrer Verantwortung, den Standort Ihrer Benutzer zu bestimmen und dann den „View“-Parameter für diesen Standort entsprechend festzulegen. Alternativ können Sie "View=Auto" festlegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgegeben werden. Der View-Parameter in Azure Karten muss in Übereinstimmung mit den geltenden Gesetzen verwendet werden, einschließlich derjenigen in Bezug auf die Zuordnung des Landes, in dem Karten, Bilder und andere Daten und Inhalte von Drittanbietern, auf die Sie über Azure Karten zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN. Ausführliche Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten.
MapTileSize	Die Größe der zurückgegebenen Kartenkachel in Pixel.
TilesetID	Ein Kachelsatz ist eine Sammlung von Raster- oder Vektordaten, die in ein einheitliches Raster von Quadratkacheln mit voreingestellten Zoomstufen unterteilt sind. Jedes Kachelsatz verfügt über eine Kachelsatz-ID , die beim Erstellen von Anforderungen verwendet werden soll. Die Kachelsatz-ID für Kachelsätze, die mit Azure Karten Creator erstellt wurden, wird über die Kachelsatzerstellungs-API generiert. Die einsatzbereiten Kachelsätze, die von Azure Karten bereitgestellt werden, sind unten aufgeführt. Beispiel: microsoft.base.

ErrorAdditionalInfo

Zusätzliche Informationen zu Ressourcenverwaltungsfehlern.

Name	Type	Description
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Infotyp.

ErrorDetail

Die Fehlerdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen zum Fehler.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Type	Description
error	ErrorDetail	Das Fehlerobjekt.

LocalizedMapView

Mit dem View-Parameter (auch als Parameter "Benutzerregion" bezeichnet) können Sie die richtigen Zuordnungen für ein bestimmtes Land/eine bestimmte Region für geopolitische Konfliktregionen anzeigen. Verschiedene Länder haben unterschiedliche Ansichten dieser Regionen, und mit dem Parameter Ansicht kann Ihre Anwendung die Ansicht erfüllen, die für das Land erforderlich ist, in dem Ihre Anwendung verwendet wird. Standardmäßig ist der View-Parameter auf "Unified" festgelegt, auch wenn Sie ihn nicht in der Anforderung definiert haben. Es liegt in Ihrer Verantwortung, den Standort Ihrer Benutzer zu bestimmen und dann den „View“-Parameter für diesen Standort entsprechend festzulegen. Alternativ können Sie "View=Auto" festlegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgegeben werden. Der View-Parameter in Azure Karten muss in Übereinstimmung mit den geltenden Gesetzen verwendet werden, einschließlich derjenigen in Bezug auf die Zuordnung des Landes, in dem Karten, Bilder und andere Daten und Inhalte von Drittanbietern, auf die Sie über Azure Karten zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN.

Ausführliche Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten.

Name	Type	Description
AE	string	Vereinigte Arabische Emirate (arabische Ansicht)
AR	string	Argentinien (argentinische Ansicht)
Auto	string	Gibt die Kartendaten basierend auf der IP-Adresse der Anforderung zurück.
BH	string	Bahrain (arabische Ansicht)
IN	string	Indien (indische Ansicht)
IQ	string	Irak (arabische Ansicht)
JO	string	Jordanien (arabische Ansicht)
KW	string	Kuwait (arabische Ansicht)
LB	string	Libanon (arabische Ansicht)
MA	string	Marokko (marokkanische Ansicht)
OM	string	Oman (arabische Ansicht)
PK	string	Pakistan (pakistanische Ansicht)
PS	string	Palästinensische Autonomiegebiete (arabische Ansicht)
QA	string	Katar (arabische Ansicht)
SA	string	Saudi-Arabien (arabische Ansicht)
SY	string	Syrien (arabische Ansicht)
Unified	string	Einheitliche Ansicht (andere)
YE	string	Jemen (arabische Ansicht)

MapTileSize

Die Größe der zurückgegebenen Kartenkachel in Pixel.

Name	Type	Description
256	string	Gibt eine Kachel mit 256 x 256 Pixeln zurück.
512	string	Gibt eine Kachel mit 512 x 512 Pixeln zurück.

TilesetID

Ein Kachelsatz ist eine Sammlung von Raster- oder Vektordaten, die in ein einheitliches Raster von Quadratkacheln mit voreingestellten Zoomstufen unterteilt sind. Jedes Kachelsatz verfügt über eine Kachelsatz-ID , die beim Erstellen von Anforderungen verwendet werden soll. Die Kachelsatz-ID für Kachelsätze, die mit Azure Karten Creator erstellt wurden, wird über die Kachelsatzerstellungs-API generiert. Die einsatzbereiten Kachelsätze, die von Azure Karten bereitgestellt werden, sind unten aufgeführt. Beispiel: microsoft.base.

Name	Type	Description
microsoft.base	string	Eine Basiskarte ist eine Standardkarte, die Straßen, natürliche und künstliche Merkmale zusammen mit den Bezeichnungen für diese Merkmale in einer Vektorkachel anzeigt. Unterstützt die Zoomstufen 0 bis 22. Format: vector (pbf).
microsoft.base.darkgrey	string	Alle Ebenen mit unserem dunkelgrauen Stil. Unterstützt die Zoomstufen 0 bis 22. Format: raster (png).
microsoft.base.hybrid	string	Zeigt Straßen-, Begrenzungs- und Bezeichnungsdaten in einer Vektorkachel an. Unterstützt die Zoomstufen 0 bis 22. Format: vector (pbf).
microsoft.base.hybrid.darkgrey	string	Straßen-, Begrenzungs- und Bezeichnungsdaten in unserem dunkelgrauen Stil. Unterstützt die Zoomstufen 0 bis 22. Format: raster (png).
microsoft.base.hybrid.road	string	Straßen-, Begrenzungs- und Bezeichnungsdaten in unserem Hauptstil. Unterstützt die Zoomstufen 0 bis 22. Format: raster (png).
microsoft.base.labels	string	Zeigt Bezeichnungen für Straßen, natürliche und künstliche Merkmale in einer Vektorkachel an. Unterstützt die Zoomstufen 0 bis 22. Format: vector (pbf).
microsoft.base.labels.darkgrey	string	Bezeichnen Sie Daten in unserem dunkelgrauen Stil. Unterstützt die Zoomstufen 0 bis 22. Format: raster (png).
microsoft.base.labels.road	string	Bezeichnen Sie Daten in unserem Hauptstil. Unterstützt die Zoomstufen 0 bis 22. Format: raster (png).
microsoft.base.road	string	Alle Ebenen mit unserem Hauptstil. Unterstützt die Zoomstufen 0 bis 22. Format: raster (png).
microsoft.dem	string	Kacheln für digitales Rechteerweiterungsmodell. Die Kacheln weisen das GeoTIFF-Format mit einem einzelnen 32-Bit-Gleitkommaband auf. Die Kacheln decken die gesamte Landmaske der Erde ab. Einige kleine Inseln (z. B. Atolle) werden möglicherweise nicht genau dargestellt. Die vertikale Einheit für die Messung der Höhe der Höhe ist Meter. Ein Erhöhungswert von -32767,0 wird für Punkte ohne Datenwert verwendet, die am häufigsten zurückgegeben werden, wenn keine Landmasken (d. h. Wasser) vorhanden sind. Das horizontale Bezug datum ist das World Geodetic System 1984 (WGS84-G1150), und das vertikale Bezug datum ist das Earth Gravitational Model 2008 (EGM2008). Kacheln sind 258 x 258 Pixel quadratisch und nicht standardmäßig 256 x 256. Dies wird durchgeführt, um eine genaue Interpolation von Werten an den Kachelrändern zu ermöglichen. Daher überlappen sich angrenzende Kacheln an allen Rändern um 1 Pixel. Kacheldaten stammen aus dem Produkt "Soll WorldDEM4Ortho". Stadtbereiche werden ungefähr bis zum Boden abgesenkt. Alle anderen Bereiche werden durch die Objektoberflächenebene (z. B. Strukturen) dargestellt. Unterstützt nur Zoomfaktor 13. Format: raster (tiff).
microsoft.dem.contours	string	Kacheln für digitale Höhenlinienlinien. Im Vergleich zur Option microsoft.dem sind diese Kacheln im Vektorformat und für Visualisierungszwecke vorgesehen. Die Kacheln decken die gesamte Landmaske der Erde ab. Einige kleine Inseln (z. B. Atolle) werden möglicherweise nicht genau dargestellt. Die vertikale Einheit für die Messung der Höhe der Höhe ist Meter. Das horizontale Bezug datum ist das World Geodetic System 1984 (WGS84-G1150), und das vertikale Bezug datum ist das Earth Gravitational Model 2008 (EGM2008). Kacheldaten stammen aus dem Produkt "Soll WorldDEM4Ortho". Stadtbereiche werden ungefähr bis zum Boden abgesenkt. Alle anderen Bereiche werden durch die Objektoberflächenebene (z. B. Strukturen) dargestellt. Unterstützt die Zoomstufen 9 bis 14. Format: vector (pbf).
microsoft.imagery	string	Eine Kombination aus Satelliten- und Luftbildern. Nur in S1-Preis-SKU verfügbar. Unterstützt die Zoomstufen 1 bis 19. Format: raster (jpeg).
microsoft.terra.main	string	Schattierte Hilfs- und Terraebenen. Unterstützt die Zoomstufen 0 bis 6. Format: raster (png).
microsoft.traffic.absolute	string	Absolute Datenverkehrskacheln im Vektor
microsoft.traffic.absolute.main	string	Absolute Datenverkehrskacheln im Raster in unserem Hauptstil.
microsoft.traffic.delay	string	Verkehrskacheln im Vektor
microsoft.traffic.delay.main	string	Verkehrskacheln im Raster im Hauptstil
microsoft.traffic.incident	string	Incidentkacheln im Vektor
microsoft.traffic.reduced.main	string	Kacheln mit reduziertem Datenverkehr im Raster im Hauptstil
microsoft.traffic.relative	string	Kacheln für relativen Datenverkehr im Vektor
microsoft.traffic.relative.dark	string	Relative Datenverkehrskacheln im Raster im dunklen Stil.
microsoft.traffic.relative.main	string	Relative Datenverkehrskacheln im Raster in unserem Hauptstil.
microsoft.weather.infrared.main	string	Kacheln für Wetterkacheln. Die neuesten Satellite-Bilder zeigen Die Clouds nach ihrer Temperatur. Weitere Informationen finden Sie unter Abdeckungsinformationen für Azure Karten Wetterinfodienst. Weitere Informationen zu den zurückgegebenen Satellitendaten finden Sie unter Wetterkonzepte. Unterstützt die Zoomstufen 0 bis 15. Format: raster (png).
microsoft.weather.radar.main	string	Wetterradarkacheln. Neueste Wetterradarbilder, einschließlich Regen, Schnee, Eis und gemischten Bedingungen. Weitere Informationen finden Sie unter Abdeckungsinformationen für Azure Karten Wetterinfodienst. Weitere Informationen zu den Radardaten finden Sie unter Wetterkonzepte. Unterstützt die Zoomstufen 0 bis 15. Format: raster (png).