Render - Get Map Image
Wird verwendet, um ein benutzerdefiniertes, rechteckiges Bild mit einem Kartenabschnitt mit einem Zoomfaktor von 0 bis 20 zu rendern.
Hinweis
Azure Maps Render v1-Dienst eingestellt
Der Azure Maps Render v1 Dienst ist jetzt veraltet und wird am 17.09.2026 eingestellt. Um Dienstunterbrechungen zu vermeiden, müssen alle Aufrufe der Render v1-API bis zum 17.09.26 aktualisiert werden, um die Render v2-API zu verwenden.
Der unterstützte Auflösungsbereich für das Kartenbild liegt zwischen 1x1 und 8192 x 8192. Wenn Sie entscheiden, wann sie den Dienst für statische Bilder über den Kartenkacheldienst verwenden, sollten Sie überlegen, wie Sie mit der gerenderten Karte interagieren möchten. Wenn der Karteninhalt relativ unveränderlich ist, ist eine statische Karte eine gute Wahl. Wenn Sie viel Zoomen, Schwenken und Ändern des Karteninhalts unterstützen möchten, wäre der Kartenkacheldienst die bessere Wahl.
Der Dienst bietet auch Bildkompositionsfunktionen, um ein statisches Bild mit zusätzlichen Daten wie zu erhalten. Pushpins und Geometrieüberlagerungen mit den folgenden Gen1 S0-, S1- und Gen2-Funktionen.
In Gen1 S0 haben Sie folgende Möglichkeiten:
- Rendern von bis zu 5 In der Anforderung angegebenen Pins
- Geben Sie ein benutzerdefiniertes Image für die In der Anforderung referenzierten Pins an.
- Hinzufügen von Bezeichnungen zu den Pins
In Gen1 S1 und Gen2 haben Sie folgende Möglichkeiten:
- Rendern von Pins über Azure Maps Data Service
- Angeben mehrerer Pinstile
- Rendern von Kreis-, Polyline- und Polygongeometrietypen.
- Rendern unterstützter GeoJSON-Geometrietypen, die über Azure Maps Data Service hochgeladen wurden
Ausführliche Beispiele finden Sie in der Anleitung Rendern von benutzerdefinierten Daten auf einer Rasterkarte.
Hinweis : Der Center - oder bbox-Parameter muss für die API angegeben werden.
Die unterstützten Lat- und Lon-Bereiche bei Verwendung des bbox-Parameters sind wie folgt:
Zoomfaktor | Max. Lon-Bereich | Maximaler Lat-Bereich |
---|---|---|
0 | 360.0 | 170.0 |
1 | 360.0 | 170.0 |
2 | 360.0 | 170.0 |
3 | 360.0 | 170.0 |
4 | 360.0 | 170.0 |
5 | 180.0 | 85.0 |
6 | 90,0 | 42,5 |
7 | 45,0 | 21.25 |
8 | 22,5 | 10.625 |
9 | 11,25 | 5.3125 |
10 | 5.625 | 2.62625 |
11 | 2.8125 | 1.328125 |
12 | 1.40625 | 0.6640625 |
13 | 0.703125 | 0.33203125 |
14 | 0.3515625 | 0.166015625 |
15 | 0.17578125 | 0.0830078125 |
16 | 0.087890625 | 0.0415039063 |
17 | 0.0439453125 | 0.0207519531 |
18 | 0.0219726563 | 0.0103759766 |
19 | 0.0109863281 | 0.0051879883 |
20 | 0.0054931641 | 0.0025939941 |
GET https://atlas.microsoft.com/map/static/png?api-version=1.0
GET https://atlas.microsoft.com/map/static/png?api-version=1.0&layer={layer}&style={style}&zoom={zoom}¢er={center}&bbox={bbox}&height={height}&width={width}&language={language}&view={view}&pins={pins}&path={path}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
format
|
path | True |
Gewünschtes Format der Antwort. Möglicher Wert: png. |
||||||||||||||||||||||||||||
api-version
|
query | True |
string |
Versionsnummer der Azure Maps API. |
|||||||||||||||||||||||||||
bbox
|
query |
number[] |
Begrenzungsrahmen. Verwendete Projektion – EPSG:3857. Format: 'minLon, minLat, maxLon, maxLat'. Hinweis: Entweder bbox oder center sind erforderliche Parameter. Sie schließen sich gegenseitig aus. Es sollte nicht mit Höhe oder Breite verwendet werden. Die maximal zulässigen Bereiche für Lat und Lon werden für jede Zoomstufe in der Tabelle oben auf dieser Seite definiert. |
||||||||||||||||||||||||||||
center
|
query |
number[] |
Koordinaten des Mittelpunkts. Format: 'lon,lat'. Verwendete Projektion
Hinweis: Entweder center oder bbox sind erforderliche Parameter. Sie schließen sich gegenseitig aus. |
||||||||||||||||||||||||||||
height
|
query |
integer int32 |
Höhe des resultierenden Bilds in Pixel. Der Bereich ist 1 bis 8192. Der Standardwert ist 512. Es sollte nicht mit bbox verwendet werden. |
||||||||||||||||||||||||||||
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 . |
||||||||||||||||||||||||||||
layer
|
query |
Kartenebene angefordert. Wenn die Ebene auf Bezeichnungen oder Hybride festgelegt ist, sollte das Format png sein. |
|||||||||||||||||||||||||||||
path
|
query |
string[] |
Pfadstil und Speicherorte. Verwenden Sie diesen Parameter, um dem Bild optional Linien, Polygone oder Kreise hinzuzufügen. Der Pfadstil beschreibt die Darstellung der Zeile und der Füllung. (Stellen Sie sicher, dass Die Werte dieses Parameters ordnungsgemäß URL codiert werden, da er reservierte Zeichen wie Pipes und Interpunktion enthält.) Der Pfadparameter wird in Azure Maps Konto-SKU ab S1 unterstützt. Mehrere Instanzen des Pfadparameters ermöglichen es, mehrere Geometrien mit ihren Stilen anzugeben. Die Anzahl der Parameter pro Anforderung ist auf 10 und die Anzahl der Speicherorte auf 100 pro Pfad beschränkt. Um einen Kreis mit Einem Radius von 100 Metern und Einem Mittelpunkt bei breiten 45°N und 122°W Längengrad im Standardformat zu rendern, fügen Sie den Parameter querystring hinzu.
Beachten Sie, dass der Längengrad vor dem Breitengrad liegt. Nach der URL-Codierung sieht dies wie folgt aus.
Alle hier aufgeführten Beispiele zeigen den Pfadparameter ohne URL-Codierung zur Übersichtlichkeit. Um eine Linie zu rendern, trennen Sie jede Position durch ein Pipezeichen. Verwenden Sie beispielsweise
Zum Rendern eines Polygons muss die letzte Position gleich dem Startort sein. Verwenden Sie beispielsweise
Längen- und Breitenwerte für Positionen von Linien und Polygonen können im Bereich von -360 bis 360 liegen, um das Rendern von Geometrien zu ermöglichen, die den Antimeridian überschreiten. StilmodifiziererSie können die Darstellung des Pfads ändern, indem Sie Formatmodifizierer hinzufügen. Diese werden vor den Speicherorten hinzugefügt. Stilmodifizierer haben jeweils einen Namen aus zwei Buchstaben. Diese abgekürzten Namen werden verwendet, um die Länge der URL zu verringern. Um die Farbe der Gliederung zu ändern, verwenden Sie den Formatmodifizierer "lc", und geben Sie die Farbe mit dem HTML/CSS-RGB-Farbformat an, das eine sechsstellige hexadezimale Zahl ist (die dreistellige Form wird nicht unterstützt). Um beispielsweise eine tief rosa Farbe zu verwenden, die Sie als #FF1493 in CSS angeben würden, verwenden Sie
Mehrere Stilmodifizierer können kombiniert werden, um einen komplexeren visuellen Stil zu erstellen.
Abrufen von Pfadspeicherorten aus Azure Maps DatenspeicherFür alle Azure Maps Konto-SKUs außer S0 können die Pfadspeicherortinformationen aus Azure Maps Datenspeicher abgerufen werden. Nach dem Hochladen eines GeoJSON-Dokuments mit Pfadspeicherorten gibt der Datenspeicherdienst eine eindeutige Daten-ID (UDID) zurück, die Sie verwenden können, um auf die Daten im Pfadparameter zu verweisen. Um die Punktgeometrie aus einem hochgeladenen GeoJSON-Dokument als Pfadpositionen zu verwenden, geben Sie die UDID im Abschnitt speicherorte des Pfadparameters an. Beispiel:
Beachten Sie, dass es nicht zulässig ist, Pfadspeicherorte aus Data Storage mit im Pfadparameter angegebenen Speicherorten zu mischen. Zusammenfassung des Formatmodifizierers
|
||||||||||||||||||||||||||||
pins
|
query |
string[] |
Pushpin-Stil und -Instanzen. Verwenden Sie diesen Parameter, um dem Bild optional Pushpins hinzuzufügen. Der Druckstiftstil beschreibt das Aussehen der Druckstifte, und die Instanzen geben die Koordinaten der Druckstifte und optionale Bezeichnungen für jeden Pin an. (Stellen Sie sicher, dass Die Werte dieses Parameters ordnungsgemäß URL codiert werden, da er reservierte Zeichen wie Pipes und Interpunktion enthält.) Die S0-SKU des Azure Maps-Kontos unterstützt nur eine einzelne instance des Pins-Parameters. Andere SKUs ermöglichen es mehreren Instanzen des Pins-Parameters, mehrere Pinstile anzugeben. Fügen Sie den Querystring-Parameter hinzu, um einen Pushpin-Wert im Breitengrad 45°N und einem Längengrad von 122°W mithilfe des integrierten Standard-Pushpin-Stils zu rendern.
Beachten Sie, dass der Längengrad vor dem Breitengrad liegt. Nach der URL-Codierung sieht dies wie folgt aus.
Alle hier aufgeführten Beispiele zeigen den Pins-Parameter ohne URL-Codierung zur Übersichtlichkeit. Um einen Pin an mehreren Stellen zu rendern, trennen Sie jede Position mit einem Pipezeichen. Verwenden Sie beispielsweise
Die S0 Azure Maps Konto-SKU lässt nur fünf Pushpins zu. Für andere Konto-SKUs gilt diese Einschränkung nicht. StilmodifiziererSie können die Darstellung der Ortsmarken durch Hinzufügen von Stilmodifizierern ändern. Diese werden nach dem Format, aber vor den Speicherorten und Bezeichnungen hinzugefügt. Stilmodifizierer haben jeweils einen Namen aus zwei Buchstaben. Diese abgekürzten Namen werden verwendet, um die Länge der URL zu verringern. Um die Farbe der Drucknadel zu ändern, verwenden Sie den Formatmodifizierer "co", und geben Sie die Farbe mit dem HTML/CSS-RGB-Farbformat an, das eine sechsstellige hexadezimale Zahl ist (die dreistellige Form wird nicht unterstützt). Um beispielsweise eine tief rosa Farbe zu verwenden, die Sie als #FF1493 in CSS angeben würden, verwenden Sie
DrucknadelbeschriftungenUm den Pins eine Bezeichnung hinzuzufügen, setzen Sie die Bezeichnung in einzelne Anführungszeichen direkt vor den Koordinaten. Um beispielsweise drei Pins mit den Werten "1", "2" und "3" zu kennzeichnen, verwenden Sie
Es gibt einen integrierten Pushpin-Stil namens "none", der kein Pushpin-Image anzeigt. Sie können dies verwenden, wenn Sie Bezeichnungen ohne Anheften anzeigen möchten. Beispiel:
Um die Farbe der Druckpinbeschriftungen zu ändern, verwenden Sie den Farbformatmodifizierer "lc". Um z. B. rosa Druckpins mit schwarzen Etiketten zu verwenden, verwenden Sie
Um die Größe der Bezeichnungen zu ändern, verwenden Sie den Beschriftungsformatmodifizierer "ls". Die Bezeichnungsgröße stellt die ungefähre Höhe des Bezeichnungstexts in Pixel dar. Verwenden Sie beispielsweise, um die Bezeichnungsgröße auf 12 zu erhöhen.
Die Bezeichnungen werden am Drucknadel "Bezeichnungsanker" zentriert. Der Ankerstandort ist für integrierte Druckpins vordefiniert und befindet sich in der oberen Mitte der benutzerdefinierten Stecknadeln (siehe unten). Zum Überschreiben des Bezeichnungsankers verwenden Sie den Modifizierer "la" und geben X- und Y-Pixelkoordinaten für den Anker an. Diese Koordinaten sind relativ zur oberen linken Ecke des Drucknadelbilds. Positive X-Werte verschieben den Anker nach rechts, und positive Y-Werte verschieben den Anker nach unten. Verwenden Sie beispielsweise, um den Bezeichnungsanker 10 Pixel rechts und 4 Pixel über der oberen linken Ecke des Drucknadelbilds zu positionieren.
Benutzerdefinierte PushpinsUm ein benutzerdefiniertes Pushpin-Bild zu verwenden, verwenden Sie das Wort "custom" als Namen der Anheftformatvorlage, und geben Sie dann eine URL nach den Informationen zu Speicherort und Bezeichnung an. Verwenden Sie zwei Pipezeichen, um anzugeben, dass Sie mit der Angabe von Speicherorten fertig sind und die URL starten. Beispiel:
Nach der URL-Codierung würde dies wie folgt aussehen:
Standardmäßig werden benutzerdefinierte Druckstiftbilder zentriert an den Pinkoordinaten gezeichnet. Dies ist in der Regel nicht ideal, da es den Speicherort verschleiert, den Sie hervorheben möchten. Um die Ankerposition des Anheftbilds zu überschreiben, verwenden Sie den Formatmodifizierer "an". Dabei wird das gleiche Format wie der Ankermodifizierer "la" verwendet. Wenn Ihr benutzerdefiniertes Pinbild beispielsweise die Spitze der Pin in der oberen linken Ecke des Bilds aufweist, können Sie den Anker auf diese Stelle festlegen, indem Sie
Hinweis: Wenn Sie den Farbmodifizierer "co" mit einem benutzerdefinierten Pushpin-Bild verwenden, ersetzt die angegebene Farbe die RGB-Kanäle der Pixel im Bild, lässt jedoch den Alphakanal (Deckkraft) unverändert. Dies würde normalerweise nur mit einem benutzerdefinierten Einfarbig-Bild erfolgen. Abrufen von Pushpins aus Azure Maps DatenspeicherFür alle Azure Maps Konto-SKUs außer S0 können die Pushpin-Standortinformationen aus Azure Maps Datenspeicher abgerufen werden. Nach dem Hochladen eines GeoJSON-Dokuments mit Pinspeicherorten gibt der Datenspeicherdienst eine eindeutige Daten-ID (Unique Data ID, UDID) zurück, die Sie verwenden können, um auf die Daten im Pins-Parameter zu verweisen. Um die Punktgeometrie aus einem hochgeladenen GeoJSON-Dokument als Pinpositionen zu verwenden, geben Sie die UDID im Abschnitt locations des Pins-Parameters an. Beispiel:
Beachten Sie, dass nur Punkt- und Mehrpunktgeometrie, Punkte und Mehrpunkte aus Geometrieauflistungen und Punktgeometrie aus Features verwendet werden. Linienzeichenfolgen- und Polygongeometrie werden ignoriert. Wenn der Punkt von einem Feature stammt und das Feature über eine Zeichenfolgeneigenschaft namens "label" verfügt, wird der Wert dieser Eigenschaft als Bezeichnung für den Pin verwendet. Sie können Pinspeicherorte aus datenspeicher- und anheften, die im Pins-Parameter angegeben sind. Jeder der durch Pipe getrennten Pin-Standorte kann längen- und breitengrad oder eine UDID sein. Beispiel:
Skalieren, Drehen und DeckkraftSie können Ortsmarken und ihre Bezeichnungen vergrößern oder verkleinern, indem Sie den Skalierungsmodifikator „sc“ verwenden. Dies ist ein Wert größer als 0. Der Wert 1 ist die Standardskalierung. Werte größer als 1 machen die Ortsmarken größer, und Werte kleiner als 1 machen sie kleiner. Verwenden Sie beispielsweise, um die Druckpins 50 % größer als normal zu zeichnen.
Sie können Pushpins und deren Bezeichnungen mithilfe des Modifizierers "ro" drehen. Dies ist eine Reihe von Graden der Drehung im Uhrzeigersinn. Verwenden Sie eine negative Zahl, um gegen den Uhrzeigersinn zu drehen. Verwenden Sie beispielsweise, um die Druckpins im Uhrzeigersinn um 90 Grad zu drehen und ihre Größe zu verdoppeln.
Sie können Pushpins und ihre Bezeichnungen teilweise transparent machen, indem Sie den Alpha-Modifizierer "al" angeben. Dies ist eine Zahl zwischen 0 und 1, die die Deckkraft der Stecknadeln angibt. Null macht sie vollständig transparent (und nicht sichtbar) und 1 macht sie vollständig undurchsichtig (die Standardeinstellung). Verwenden Sie beispielsweise, um Drucknadeln und ihre Bezeichnungen nur zu 67 % undurchsichtig zu machen.
Zusammenfassung des Formatmodifizierers
|
||||||||||||||||||||||||||||
style
|
query |
Zurückzugebende Kartenformat Mögliche Werte sind Standard und dunkel. |
|||||||||||||||||||||||||||||
view
|
query |
Mit dem Parameter View (auch als "Benutzerregion" bezeichnet) können Sie die richtigen Karten für ein bestimmtes Land/eine bestimmte Region für geopolitisch umstrittene Regionen anzeigen. Verschiedene Länder/Regionen haben unterschiedliche Ansichten zu diesen Regionen, und der View-Parameter ermöglicht es Ihrer Anwendung, die Ansicht zu erfüllen, die für das Land/die Region erforderlich ist, in dem/der 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 haben Sie die Möglichkeit, „View=Auto“ festzulegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgibt. Der View-Parameter in Azure Maps muss in Übereinstimmung mit den geltenden Gesetzen verwendet werden, einschließlich derjenigen zur Zuordnung des Landes/der Region, in dem Karten, Bilder und andere Daten sowie Inhalte von Drittanbietern, auf die Sie über Azure Maps zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN. Weitere Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten . |
|||||||||||||||||||||||||||||
width
|
query |
integer int32 |
Breite des resultierenden Bilds in Pixel. Der Bereich ist 1 bis 8192. Der Standardwert ist 512. Es sollte nicht mit bbox verwendet werden. |
||||||||||||||||||||||||||||
zoom
|
query |
integer int32 |
Gewünschte Zoomstufe der Karte. Der Zoomwert muss im Bereich 0-20 (einschließlich) liegen. Der Standardwert ist 12. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
x-ms-client-id |
string |
Gibt an, welches Konto in Verbindung mit dem Microsoft Entra ID-Sicherheitsmodell verwendet werden soll. Es stellt eine eindeutige ID für das Azure Maps-Konto dar und kann von der Azure Maps-Verwaltungsebenen-API abgerufen werden. Informationen zur Verwendung Microsoft Entra ID Sicherheit in Azure Maps finden Sie in den folgenden Artikeln. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
object |
Dieses Bild wird von einem erfolgreichen Aufruf "Get Map Static Image" zurückgegeben. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" Header 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 Microsoft Entra OAuth 2.0-Flows. In Kombination mit der rollenbasierten Zugriffssteuerung in Azure kann sie verwendet werden, um den Zugriff auf Azure Maps REST-APIs zu steuern. Rollenbasierte Zugriffssteuerungen in Azure werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps Ressourcenkonto oder Unterressourcen festzulegen. Jedem Benutzer, jeder Gruppe oder einem Dienstprinzipal kann zugriff über eine integrierte Rolle oder eine benutzerdefinierte Rolle gewährt werden, die aus einer oder mehreren Berechtigungen für Azure Maps REST-APIs besteht.
Zur Implementierung von Szenarien wird empfohlen, Authentifizierungskonzepte anzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zum Modellieren von Anwendungen über Objekte, die die Zugriffssteuerung für bestimmte APIs und Bereiche ermöglichen.
Hinweise
- Diese Sicherheitsdefinition erfordert die Verwendung des
x-ms-client-id
Headers, um anzugeben, auf welche Azure Maps Ressource die Anwendung Zugriff anfordert. Dies kann über die Kartenverwaltungs-API abgerufen werden.
ist Authorization URL
spezifisch für die öffentliche Azure-Cloud instance. Sovereign Clouds verfügen über eindeutige Autorisierungs-URLs und Microsoft Entra ID Konfigurationen.
* Die rollenbasierte Zugriffssteuerung von Azure wird über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert.
* Die Verwendung des Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.
- Weitere Informationen zu Microsoft Identity Platform finden Sie unter Microsoft Identity Platform Übersicht.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Dies ist ein gemeinsam verwendeter Schlüssel, der beim Erstellen eines Azure Maps-Kontos im Azure-Portal oder mithilfe von PowerShell, CLI, Azure SDKs oder REST-API bereitgestellt wird.
Mit diesem Schlüssel kann jede Anwendung auf die gesamte REST-API zugreifen. Anders ausgedrückt: Dieser Schlüssel kann als master Schlüssel in dem Konto verwendet werden, in dem er ausgestellt wird.
Für öffentlich zugängliche Anwendungen wird empfohlen, den Ansatz vertraulicher Clientanwendungen für den Zugriff auf Azure Maps REST-APIs zu verwenden, damit Ihr Schlüssel sicher gespeichert werden kann.
Typ:
apiKey
In:
query
SAS Token
Dies ist ein Shared Access Signature-Token, das aus dem Sas-Listenvorgang auf der Azure Maps-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 präzisen Steuerung des Ablaufs, der Rate und der Regionen für das jeweilige Token autorisiert. Anders ausgedrückt: Das SAS-Token kann verwendet werden, um Anwendungen die Steuerung des Zugriffs auf eine sicherere Weise zu ermöglichen als der gemeinsam genutzte Schlüssel.
Für öffentlich verfügbar gemachte Anwendungen wird empfohlen, eine bestimmte Liste der zulässigen Ursprünge in der Ressource "Konto zuordnen " zu konfigurieren, um den Renderingmissbrauch zu begrenzen und das SAS-Token regelmäßig zu erneuern.
Typ:
apiKey
In:
header
Beispiele
Successful Static Image Request
Beispielanforderung
GET https://atlas.microsoft.com/map/static/png?api-version=1.0&layer=basic&style=main&zoom=2&bbox=1.355233,42.982261,24.980233,56.526017
Beispiel für eine Antwort
Content-Type: image/png
"{file}"
Definitionen
Name | Beschreibung |
---|---|
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Localized |
Mit dem Parameter View (auch als Parameter "Benutzerregion" bezeichnet) können Sie die richtigen Karten für ein bestimmtes Land/eine bestimmte Region für geopolitisch umstrittene Regionen anzeigen. Unterschiedliche Länder/Regionen haben unterschiedliche Ansichten dieser Regionen, und der Parameter View ermöglicht es Ihrer Anwendung, die für das Land/die Region, das/die/die Ihre Anwendung bereitstellen wird, erforderlich zu erfüllen. Standardmäßig ist der View-Parameter auf "Unified" festgelegt, auch wenn Sie ihn in der Anforderung nicht 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 haben Sie die Möglichkeit, „View=Auto“ festzulegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgibt. Der View-Parameter in Azure Maps muss in Übereinstimmung mit den geltenden Gesetzen verwendet werden, einschließlich derjenigen zur Zuordnung des Landes/der Region, in dem Karten, Bilder und andere Daten sowie Inhalte von Drittanbietern, auf die Sie über Azure Maps zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN. Weitere Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten . |
Map |
Zurückzugebende Kartenformatvorlage. Mögliche Werte sind Standard und dunkel. |
Raster |
Das gewünschte Format der Antwort. Möglicher Wert: png. |
Static |
Kartenebene angefordert. Wenn die Ebene auf Bezeichnungen oder Hybride festgelegt ist, sollte das Format PNG sein. |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorDetail
Die Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
LocalizedMapView
Mit dem Parameter View (auch als Parameter "Benutzerregion" bezeichnet) können Sie die richtigen Karten für ein bestimmtes Land/eine bestimmte Region für geopolitisch umstrittene Regionen anzeigen. Unterschiedliche Länder/Regionen haben unterschiedliche Ansichten dieser Regionen, und der Parameter View ermöglicht es Ihrer Anwendung, die für das Land/die Region, das/die/die Ihre Anwendung bereitstellen wird, erforderlich zu erfüllen. Standardmäßig ist der View-Parameter auf "Unified" festgelegt, auch wenn Sie ihn in der Anforderung nicht 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 haben Sie die Möglichkeit, „View=Auto“ festzulegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgibt. Der View-Parameter in Azure Maps muss in Übereinstimmung mit den geltenden Gesetzen verwendet werden, einschließlich derjenigen zur Zuordnung des Landes/der Region, in dem Karten, Bilder und andere Daten sowie Inhalte von Drittanbietern, auf die Sie über Azure Maps zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN.
Weitere Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten .
Name | Typ | Beschreibung |
---|---|---|
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) |
MapImageStyle
Zurückzugebende Kartenformatvorlage. Mögliche Werte sind Standard und dunkel.
Name | Typ | Beschreibung |
---|---|---|
dark |
string |
Dunkelgraue Version des Azure Maps Standard-Stils |
main |
string |
Azure Maps Standard Stil |
RasterTileFormat
Das gewünschte Format der Antwort. Möglicher Wert: png.
Name | Typ | Beschreibung |
---|---|---|
png |
string |
Ein Bild im PNG-Format. Unterstützt Zoomstufen 0 bis 18. |
StaticMapLayer
Kartenebene angefordert. Wenn die Ebene auf Bezeichnungen oder Hybride festgelegt ist, sollte das Format PNG sein.
Name | Typ | Beschreibung |
---|---|---|
basic |
string |
Gibt ein Bild zurück, das alle Kartenfeatures einschließlich Polygone, Rahmen, Straßen und Bezeichnungen enthält. |
hybrid |
string |
Gibt ein Bild mit Rahmen, Straßen und Bezeichnungen zurück und kann auf anderen Kacheln (z. B. Satellitenbildern) überlagert werden, um Hybridkacheln zu erzeugen. |
labels |
string |
Gibt ein Bild nur der Bezeichnungsinformationen der Karte zurück. |