Render - Get Map Static Image

Service:

Maps

API Version:

2022-08-01

Mit dieser Option können Sie ein benutzerdefiniertes, rechteckiges Bild mit einem Kartenausschnitt mit einer Zoomstufe von 0 bis 20 rendern.

Der unterstützte Auflösungsbereich für das Kartenbild liegt zwischen 1x1 und 8192x8192. 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, ist der Kartenkacheldienst die bessere Wahl.

Der Dienst bietet auch Bildkompositionsfunktionen, um ein statisches Bild mit zusätzlichen Daten wie zurückzuholen. Pushpins und Geometrieüberlagerungen mit folgenden Funktionen:

• Angeben mehrerer Pushpin-Stile
• Rendern von Kreis-, Polyline- und Polygongeometrietypen.

Ausführliche Beispiele finden Sie im Anleitungshandbuch .

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=2022-08-01

With optional parameters:

GET https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&layer={layer}&style={style}&zoom={zoom}&center={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	RasterTileFormat	Das gewünschte Format der Antwort. Möglicher Wert: png.
api-version	query	True	string	Versionsnummer der Azure Maps API. Aktuelle Version ist 01.08.2022
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 jeden Zoomfaktor in der Tabelle oben auf dieser Seite definiert.
center	query		number[]	Koordinaten des Mittelpunkts. Format: 'lon,lat'. Verwendete Projektion EPSG:3857. Längengrad: -180 bis 180. Breitengrad: -85 bis 85. 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 beträgt 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		StaticMapLayer	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 Standorte auf 100 pro Pfad beschränkt. Fügen Sie den parameter querystring hinzu, um einen Kreis mit Radius von 100 Metern und einem Mittelpunkt auf 45°N und 122°W Längengrad zu rendern. path=ra100||-122 45 Beachten Sie, dass der Längengrad vor dem Breitengrad liegt. Nach der URL-Codierung sieht dies wie folgt aus: path=ra100%7C%7C-122+45 Alle hier aufgeführten Beispiele zeigen den path-Parameter ohne URL-Codierung, um die Übersichtlichkeit zu erhöhen. Um eine Zeile zu rendern, trennen Sie jede Position durch ein Pipezeichen. Verwenden Sie beispielsweise path=||-122 45|-119.5 43.2|-121.67 47.12 Zum Rendern eines Polygons muss die letzte Position gleich der Startposition sein. Verwenden Sie beispielsweise path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45 Längen- und Breitengradwerte 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. Stilmodifizierer Sie können die Darstellung des Pfads ändern, indem Sie Stilmodifizierer 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 Kontur zu ändern, verwenden Sie den Formatmodifizierer "lc", und geben Sie die Farbe mit dem HTML/CSS-RGB-Farbformat an, das eine sechsstellige Hexadezimalzahl 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 path=lcFF1493||-122 45|-119.5 43.2 Mehrere Stilmodifizierer können kombiniert werden, um einen komplexeren visuellen Stil zu erstellen. lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6 Zusammenfassung des Formatmodifizierers Modifizierer BESCHREIBUNG Range Lc Linienfarbe 000000 bis FFFFFF fc Füllfarbe 000000 bis FFFFFF la Linien alpha (Deckkraft) 0 bis 1 fa Füll-Alpha (Deckkraft) 0 bis 1 Lw Linienstärke Größer als 0 Ra Kreisradius (Meter) Größer als 0
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. pins=default||-122 45 Beachten Sie, dass der Längengrad vor dem Breitengrad liegt. Nach der URL-Codierung sieht dies wie folgt aus. pins=default%7C%7C-122+45 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 pins=default||-122 45|-119.5 43.2|-121.67 47.12 Die S0 Azure Maps Konto-SKU lässt nur fünf Pushpins zu. Für andere Konto-SKUs gilt diese Einschränkung nicht. Stilmodifizierer Sie 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 pins=default|coFF1493||-122 45 Drucknadelbeschriftungen Um 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 pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12 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: pins=none||'A'-122 45|'B'-119.5 43.2 Um die Farbe der Druckpinbeschriftungen zu ändern, verwenden Sie den Farbformatmodifizierer "lc". Um z. B. rosa Druckpins mit schwarzen Etiketten zu verwenden, verwenden Sie pins=default|coFF1493|lc000000||-122 45 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. pins=default|ls12||'A'-122 45|'B'-119 43 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. pins=default|la10 -4||'A'-122 45|'B'-119 43 Benutzerdefinierte Pushpins Um 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: pins=custom||-122 45||http://contoso.com/pushpins/red.png Nach der URL-Codierung würde dies wie folgt aussehen: pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png 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 pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png 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. Skalieren, Drehen und Deckkraft Sie 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. pins=default|sc1.5||-122 45 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. pins=default|ro90|sc2||-122 45 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. pins=default|al.67||-122 45 Zusammenfassung des Formatmodifizierers Modifizierer BESCHREIBUNG Range al Alpha (Deckkraft) 0 bis 1 ein Anker anheften * co Farbe anheften 000000 bis FFFFFF la Bezeichnungsanker * Lc Beschriftungsfarbe 000000 bis FFFFFF ls Bezeichnungsgröße Größer als 0 ro Drehung -360 bis 360 Sc Skalieren Größer als 0 X- und Y-Koordinaten können sich an einer beliebigen Stelle innerhalb des Anheftbilds oder an einem Rand um das Bild befinden. Die Randgröße ist das Minimum der Stiftbreite und -höhe.
style	query		MapImageStyle	Zurückzugebende Kartenformatvorlage. Mögliche Werte sind Standard und dunkel.
view	query		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 .
width	query		integer int32	Breite des resultierenden Bilds in Pixel. Der Bereich beträgt 1 bis 8192. Der Standardwert ist 512. Es sollte nicht mit bbox verwendet werden.
zoom	query		integer int32	Gewünschter Zoomfaktor der Karte. Der Zoomwert muss sich im Bereich von 0 bis 20 (einschließlich) bewegen. Der Standardwert ist 12. Weitere Informationen finden Sie unter Zoomstufen und Kachelraster .

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
x-ms-client-id		string	Gibt an, welches Konto für die Verwendung in Verbindung mit dem Microsoft Entra ID Sicherheitsmodell vorgesehen ist. Es stellt eine eindeutige ID für das Azure Maps-Konto dar und kann von der konto-API auf Azure Maps Verwaltungsebene abgerufen werden. Anleitungen 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 "Statisches Bild abrufen" zurückgegeben. 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 Microsoft Entra OAuth 2.0 Flows. Wenn sie mit der rollenbasierten Zugriffssteuerung in Azure gekoppelt ist, 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 jedem 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.

Zum Implementieren von Szenarien empfiehlt es sich, Authentifizierungskonzepte anzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zum Modellieren von Anwendungen über Objekte, die auf bestimmte APIs und Bereiche zugreifen können.

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.

Der Authorization URL ist spezifisch für die öffentliche Azure-Cloud-instance. Sovereign Clouds verfügen über eindeutige Autorisierungs-URLs und Microsoft Entra ID 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 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.

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

Scopes

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

subscription-key

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

Mit diesem Schlüssel ist jede Anwendung für den Zugriff auf alle REST-APIs autorisiert. Mit anderen Worten, diese können derzeit als master Schlüssel für das Konto behandelt werden, für das sie ausgestellt werden.

Für öffentlich zugängliche Anwendungen wird empfohlen, den Server-zu-Server-Zugriff auf Azure Maps REST-APIs zu verwenden, in denen dieser Schlüssel sicher gespeichert werden kann.

Type: apiKey
In: header

SAS Token

Hierbei handelt es sich um 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 autorisiert, mit rollenbasierten Zugriffssteuerungen in Azure auf den Ablauf, die Rate und die Region(en) der Verwendung für das jeweilige Token zuzugreifen. Mit anderen Worten, das SAS-Token kann verwendet werden, um Anwendungen zu ermöglichen, den Zugriff auf eine sicherere Weise als der freigegebene Schlüssel zu steuern.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, eine bestimmte Liste der zulässigen Ursprünge für die Zuordnungskontoressource zu konfigurieren, um den Renderingmissbrauch zu begrenzen und das SAS-Token regelmäßig zu erneuern.

Type: apiKey
In: header

Beispiele

Successful Static Image Request

Sample Request

HTTP

GET https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&layer=basic&style=main&zoom=2&bbox=1.355233,42.982261,24.980233,56.526017

Sample Response

Status code:

200

Content-Type: image/png

Response Body

"{file}"

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
LocalizedMapView	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 .
MapImageStyle	Zurückzugebende Kartenformat Mögliche Werte sind Standard und dunkel.
RasterTileFormat	Gewünschtes Format der Antwort. Möglicher Wert: png.
StaticMapLayer	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	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

LocalizedMapView

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 .

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

Gewünschtes Format der Antwort. Möglicher Wert: png.

Name	Typ	Beschreibung
png	string	Ein Bild im PNG-Format. Unterstützt die 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 mit allen Kartenfeatures zurück, einschließlich Polygonen, Rahmen, Straßen und Bezeichnungen.
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 der Bezeichnungsinformationen der Karte zurück.