Render V2 - Get Map Tile

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}
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

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

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

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

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

Content-Type: application/vnd.mapbox-vector-tile
"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

Die zusätzlichen Informationen zum Fehler.

code
  • string

Der Fehlercode.

details

Die Fehlerdetails.

message
  • string

Die Fehlermeldung.

target
  • string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Type Description
error

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).