Render - Get Map Static Image
Wird verwendet, um ein benutzerdefiniertes, rechteckiges Bild mit einem Kartenabschnitt mit einem Zoomfaktor von 0 bis 20 zu rendern.
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 folgenden Funktionen:
- Angeben mehrerer Pinstile
- Rendern von Kreis-, Polyline- und Polygongeometrietypen.
Ausführliche Beispiele finden Sie unter Anleitung .
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 | Max. 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
GET https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&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. 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 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 Werte dieses Parameters ordnungsgemäß urlcodiert 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 path-Parameters ermöglichen das Angeben mehrerer Geometrien mit ihren Stilen. 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.
Zusammenfassung des Formatmodifizierers
|
||||||||||||||||||||||||||||
pins
|
query |
string[] |
Pushpin-Stil und -Instanzen. Verwenden Sie diesen Parameter, um dem Bild optional Druckpins hinzuzufügen. Der Pinstil beschreibt die Darstellung der Pins, und die Instanzen geben die Koordinaten der Pins und optionalen Bezeichnungen für jeden Pin an. (Stellen Sie sicher, dass Werte dieses Parameters ordnungsgemäß urlcodiert werden, da er reservierte Zeichen wie Pipes und Interpunktion enthält.) Die 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 eine Stecknadel im Breitengrad 45°N und 122°W mit der standardmäßigen integrierten Pin-Stilart 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, um die Übersichtlichkeit zu erhöhen. Um eine Pin an mehreren Positionen zu rendern, trennen Sie jede Position durch ein Strichzeichen. Verwenden Sie beispielsweise
Die S0 Azure Maps Konto-SKU lässt nur fünf Pins 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 Pin zu ändern, verwenden Sie den Formatmodifizierer "co", und geben Sie die Farbe mithilfe des HTML/CSS-RGB-Farbformats 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
DrucknadeletikettenUm den Pins eine Bezeichnung hinzuzufügen, setzen Sie die Bezeichnung in einfache Anführungszeichen direkt vor den Koordinaten. Wenn Sie beispielsweise drei Pins mit den Werten "1", "2" und "3" bezeichnen möchten, verwenden Sie
Es gibt eine integrierte Druckmarke namens "none", die kein Pinbild anzeigt. Sie können dies verwenden, wenn Sie Bezeichnungen ohne Pinbild anzeigen möchten. Beispiel:
Um die Farbe der Pinbeschriftungen zu ändern, verwenden Sie den Farbstilmodifizierer "lc". Wenn Sie beispielsweise rosa Druckpins mit schwarzen Etiketten verwenden möchten, verwenden Sie
Um die Größe der Bezeichnungen zu ändern, verwenden Sie den Größenformatmodifizierer "ls". Die Bezeichnungsgröße stellt die ungefähre Höhe des Bezeichnungstexts in Pixel dar. Um beispielsweise die Bezeichnungsgröße auf 12 zu erhöhen, verwenden Sie
Die Bezeichnungen werden an der Stecknadel "Etikettenanker" zentriert. Die Ankerposition ist für integrierte Pins vordefiniert und befindet sich in der oberen Mitte von benutzerdefinierten Pins (siehe unten). Um den Bezeichnungsanker zu überschreiben, verwenden Sie den Formatmodifizierer "la" und geben X- und Y-Pixelkoordinaten für den Anker an. Diese Koordinaten sind relativ zur oberen linken Ecke des Stecknadelbilds. Positive X-Werte verschieben den Anker nach rechts, und positive Y-Werte verschieben den Anker nach unten. Um den Bezeichnungsanker beispielsweise 10 Pixel rechts und 4 Pixel über der oberen linken Ecke des Druckpinbilds zu positionieren, verwenden Sie
Benutzerdefinierte PinsUm ein benutzerdefiniertes Pinbild zu verwenden, verwenden Sie das Wort "custom" als Namen der Pinformatvorlage, 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 sieht dies wie folgt aus:
Standardmäßig werden benutzerdefinierte Stiftbilder zentriert an den Pinkoordinaten gezeichnet. Dies ist in der Regel nicht ideal, da es den Speicherort verdeckt, den Sie hervorheben möchten. Um die Ankerposition des Anheftbilds zu überschreiben, verwenden Sie den Formatmodifizierer "an". Dabei wird das gleiche Format wie der Modifizierer "la" für den Ankerstil verwendet. Wenn ihr benutzerdefiniertes Stecknadelbild beispielsweise die Spitze des Stifts 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 Pinbild verwenden, ersetzt die angegebene Farbe die RGB-Kanäle der Pixel im Bild, lässt jedoch den Alphakanal (Deckkraft) unverändert. Dies würde in der Regel nur mit einem benutzerdefinierten Volltonbild erfolgen. Skalierung, Drehung 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 Pins 50 % größer als normal zu zeichnen.
Mithilfe des Modifizierers "ro" können Sie Pins und deren Bezeichnungen 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 Pins um 90 Grad im Uhrzeigersinn zu drehen und ihre Größe zu verdoppeln.
Sie können Pins und deren Bezeichnungen teilweise transparent machen, indem Sie den Alphaformatmodifizierer "al" angeben. Dies ist eine Zahl zwischen 0 und 1, die die Deckkraft der Pins angibt. Null macht sie vollständig transparent (und nicht sichtbar) und 1 macht sie vollständig undurchsichtig (dies ist die Standardeinstellung). Verwenden Sie beispielsweise, um Druckmarken und deren 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" 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 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.
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 verwendeter 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. Anders ausgedrückt: Diese können derzeit als master Schlüssel für das Konto behandelt werden, für das sie ausgestellt wurden.
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
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.
Type:
apiKey
In:
header
Beispiele
Successful Static Image Request
Sample Request
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
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. |