Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel wird erläutert, wie Sie die Bing Karten-API zum Abrufen einer statischen Karte zur Azure Maps-API zum Abrufen statischer Kartenbilder migrieren. Die Azure Maps-API zum Abrufen statischer Kartenbilder rendert ein benutzerdefiniertes, rechteckiges Kartenbild in den Stilen „Road“, „Satellite/Aerial“ oder „Traffic“.
Voraussetzungen
- Ein Azure-Konto
- Ein Azure Maps-Konto
- Ein Abonnementschlüssel oder eine andere Form der Authentifizierung bei Azure Maps
Wichtige Unterschiede
- Die Bing Karten-API zum Abrufen einer statischen Karte bietet die Kartenstile „Road“, „Satellite/Aerial“, „Traffic“, „Streetside“, „Birds Eye“ und „Ordnance Survey“. Die Azure Maps-API zum Abrufen statischer Kartenbilder bietet die gleichen Stile mit Ausnahme von „Streetside“, „Birds Eye“ und „Ordnance Survey“.
- Die Bing Karten-API zum Abrufen einer statischen Karte unterstützt das Abrufen einer statischen Karte mithilfe von Koordinaten, einer Adresse oder eines Ortsnamen als Standorteingabe. Die Azure Maps-API zum Abrufen statischer Kartenbilder unterstützt nur Koordinaten als Standorteingabe.
- Die Bing Karten-API zum Abrufen einer statischen Karte unterstützt das Abrufen einer statischen Karte einer Auto-, Spazier- oder Nahverkehrsroute nativ. Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt nativ keine Routenfunktionalität bereit.
- Die Bing Karten-API zum Abrufen einer statischen Karte stellt statische Karten in den Bildformaten PNG, JPEG und GIF bereit. Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt statische Karten in den Bildformaten PNG und JPEG bereit.
- Die Bing Karten-API zum Abrufen einer statischen Karte unterstützt die Antwortformate XML und JSON. Die Azure Maps-API zum Abrufen statischer Kartenbilder unterstützt nur das JSON-Antwortformat.
- Die Bing Karten-API zum Abrufen einer statischen Karte unterstützt HTTP-GET- und POST-Anforderungen. Die Azure Maps-API zum Abrufen statischer Kartenbilder unterstützt HTTP-GET-Anforderungen.
- Die Bing Karten-API zum Abrufen einer statischen Karte verwendet Koordinaten im Breiten-/Längengradformat. Die Azure Maps-API zum Abrufen statischer Kartenbilder verwendet Koordinaten im von GeoJSON definierten Längen-/Breitengradformat.
- Im Gegensatz zu Bing Maps for Enterprise ist Azure Maps ein globaler Dienst, der die Angabe eines geografischen Bereichs unterstützt, mit dem Sie die Datenresidenz auf die europäischen (EU) oder US-amerikanischen (US) geografischen Bereiche (Geografien) beschränken können. Alle Anforderungen (einschließlich Eingabedaten) werden ausschließlich im angegebenen geografischen Bereich verarbeitet. Weitere Informationen finden Sie unter Geografischer Bereich des Azure Maps-Dienstes.
Sicherheit und Authentifizierung
Bing Maps for Enterprise unterstützt nur die API-Schlüsselauthentifizierung. Azure Maps unterstützt mehrere Möglichkeiten zum Authentifizieren Ihrer API-Aufrufe, z. B. einen Abonnementschlüssel, Microsoft Entra ID und SAS-Token (Shared Access Signature). Weitere Informationen zur Sicherheit und Authentifizierung in Azure Maps finden Sie unter Authentifizierung mit Azure Maps sowie im Abschnitt Sicherheit der Dokumentation zur Azure Maps-API zum Abrufen statischer Kartenbilder.
Anforderungsparameter
In der folgenden Tabelle sind die Anforderungsparameter der Bing Karten-API zum Abrufen einer statischen Karte sowie deren Azure Maps-Entsprechungen aufgeführt:
| Bing Maps-Anforderungsparameter | Parameteralias | Azure Maps-Anforderungsparameter | Erforderlich in Azure Maps | Azure Maps-Datentyp | Beschreibung |
|---|---|---|---|---|---|
| Mittelpunkt | Mitte | TRUE (wenn „bbox“ nicht verwendet wird) | nummer[] | Für die Bing Karten-API zum Abrufen einer statischen Karte müssen Koordinaten im Längen-/Breitengradformat vorliegen, während die Azure Maps-API zum Abrufen statischer Kartenbilder sie im in GeoJSON definierten Längen-/Breitengradformat benötigt. longitude,latitude Bereich von [-90, 90]. Hinweis: Der Parameter center oder bbox muss angegeben werden. Sie schließen sich gegenseitig aus. |
|
| Kultur | c | Sprache | FALSE | String | In der Azure Maps-API zum Abrufen statischer Kartenbilder ist dies die Sprache, in der Suchergebnisse zurückgegeben werden sollen. Der Parameter wird im Azure Maps-Anforderungsheader angegeben. Weitere Informationen finden Sie unter Unterstützte Sprachen. |
| Pins aufräumen | dcl | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | |
| dpi | dir | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | |
| drawCurve | dv | Pfad | FALSE | String | |
| Sichtfeld | fov | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | In Bing Karten wird dieser Parameter für imagerySet-Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey und Streetside verwendet. Azure Maps unterstützt diese Kartenstile nicht. |
| format | fmt | format | TRUE | String | Die Bing Karten-API zum Abrufen einer statischen Karte stellt statische Karten in den Bildformaten PNG, JPEG und GIF bereit. Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt statische Karten in den Bildformaten PNG und JPEG bereit. |
| Überschrift | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | In Bing Karten wird dieser Parameter für „imagerySet Birdseye“, „BirdseyeWithLabels“, „BirdseyeV2“, „BirdseyeV2WithLabels“, „OrdnanceSurvey“ und „Streetside“ verwendet. Azure Maps unterstützt diese Kartenstile nicht. | |
| hervorhebenEntität | er | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | In der Bing Maps-API für eine statische Karte wird dieser Parameter verwendet, um ein Polygon der Positionseingabe (Entität) zu erhalten, das auf der Karte nativ angezeigt wird. Die Azure Maps-API zum Abrufen statischer Kartenbilder unterstützt dieses Feature nicht. Sie können jedoch ein Polygon eines Standorts (Lokalität) aus der Azure Maps-API zum Abrufen eines Polygons abrufen und dieses dann auf der statischen Karte anzeigen. |
| Bildersatz | tilesetID | TRUE | TilesetId | ||
| Kartenbereich | ma | bbox | TRUE (wenn „center“ nicht verwendet wird) | nummer[] | Ein Begrenzungsrahmen, der durch zwei Längengrade und zwei Breitengrade definiert ist, und die vier Seiten eines rechteckigen Bereichs auf der Erde im Format minLon, minLat, maxLon, maxLat darstellt. Hinweis: Der Parameter center oder bbox muss angegeben werden. Sie schließen sich gegenseitig aus.
bbox sollte nicht mit height oder widthverwendet werden. |
| mapLayer | ml | trafficLayer | FALSE | TrafficTilesetId | Optional. Wenn TrafficLayer bereitgestellt wird, wird das Kartenbild mit entsprechender Verkehrsebene zurückgegeben. Weitere Informationen finden Sie unter tilesetId. |
| Kartengröße | ms | Höhe | TRUE | Integer int32 | |
| Breite | |||||
| mapMetadata | mmd | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | |
| Ausrichtung | dir | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | In der Bing Karten-API zum Abrufen einer statischen Karte wird dieser Parameter für „imagerySet Birdseye“, „BirdseyeWithLabels“, „BirdseyeV2“, „BirdseyeV2WithLabels“, „OrdnanceSurvey“ und „Streetside“ verwendet. Azure Maps unterstützt diese Kartenstile nicht. |
| pitch | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | In der Bing Karten-API zum Abrufen einer statischen Karte wird dieser Parameter für „imagerySet Birdseye“, „BirdseyeWithLabels“, „BirdseyeV2“, „BirdseyeV2WithLabels“, „OrdnanceSurvey“ und „Streetside“ verwendet. Azure Maps unterstützt diese Kartenstile nicht. | |
| Reißnagel | pp | Kontaktstifte | FALSE | String | In der Bing Karten-API zum Abrufen einer statischen Karte ist eine HTTP-GET-Anforderung auf 18 Stecknadeln und eine HTTP-POST-Anforderung auf 100 Stecknadeln pro statischer Karte beschränkt. Azure Maps Get Static Image API HTTP GET-Anforderung hat keine Beschränkung für die Anzahl der Pins pro statische Karte. Die Anzahl der Pins, die auf der statischen Karte unterstützt werden, basiert jedoch auf der maximalen Anzahl von Zeichen, die in der HTTP-GET-Anforderung unterstützt werden. Siehe Azure Maps Get Map Static Image API ‚pins‘ Parameter in URI Parameter für weitere Details zur Pushpin Unterstützung. |
| Abfrage | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Die Azure Maps-API zum Abrufen statischer Kartenbilder unterstützt nur Koordinaten als Standorteingabe, keine Adressen oder Ortsnamen. Verwenden Sie die Azure Maps-API zum Abrufen der Geocodierung, um eine Straße oder einen Ortsnamen in Koordinaten umzuwandeln. | |
| Routenparameter: vermeiden | Keine | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Azure Maps Get Maps Static Image API bietet keine systemeigene Routenzuordnungsfunktionalität. Verwenden Sie zum Abrufen einer statischen Karte mit einem Routenpfad die Azure Maps-API zum Abrufen von Wegbeschreibungen oder Veröffentlichen von Wegbeschreibungen, um die Koordinaten eines bestimmten Routenpfads zu erhalten. Nutzen Sie dann die Azure Maps-API für Get Map Static Image, um diese Routenpfadkoordinaten mithilfe der Funktion drawCurve über die statische Karte zu legen. |
| Routenparameter: DistanzVorErsterAbbiegung | dbft | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Azure Maps Get Maps Static Image API bietet keine systemeigene Routenzuordnungsfunktionalität. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API Get Route Directions oder Post Route Directions verwenden, um die Koordinaten einer bestimmten Route zu erhalten, und anschließend die Azure Maps-API Get Map Static Image nutzen, um die Routenkoordinaten auf der statischen Karte zu überlagern. |
| Routenparameter: Datum und Uhrzeit | dt | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Azure Maps Get Maps Static Image API bietet keine systemeigene Routenzuordnungsfunktionalität. Sie können die Azure Maps-APIs zum Erhalten von Routenanweisungen oder zum Posten von Routenanweisungen verwenden, um die Koordinaten einer bestimmten Route abzurufen. Verwenden Sie dann die API-Funktion Get Map Static Image, um die Routenkoordinaten auf die statische Karte zu legen. |
| Routenparameter: maxSolutions | maxSolns | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Azure Maps Get Maps Static Image API bietet keine systemeigene Routenzuordnungsfunktionalität. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API Get Route Directions oder Post Route Directions nutzen, um die Koordinaten einer bestimmten Route zu erhalten. Sie können dann die Azure Maps-API Get Map Static Image verwenden, um die Routenkoordinaten auf der statischen Karte zu überlagern. |
| Routenparameter: optimieren | optmz | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Azure Maps Get Maps Static Image API bietet keine systemeigene Routenzuordnungsfunktionalität. Zum Erhalten einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API Routenanweisungen abrufen oder Routenanweisungen senden verwenden, um die Koordinaten einer bestimmten Route zu erhalten. Verwenden Sie dann die Azure Maps-API Statische Kartenbild abrufen Funktion drawCurve, um die Routenkoordinaten auf die statische Karte zu legen. |
| Routenparameter: Zeittyp | tt | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Azure Maps Get Maps Static Image API bietet keine systemeigene Routenzuordnungsfunktionalität. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API Get Route Directions oder Post Route Directions verwenden, um die Routenkoordinaten einer bestimmten Route zu erhalten. Verwenden Sie anschließend die Azure Maps Get Map Static Image-API-Funktion, um die Routenkoordinaten auf der statischen Karte zu überlagern. |
| Routenparameter: Reisemodus | Keine | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Azure Maps Get Maps Static Image API bietet keine systemeigene Routenzuordnungsfunktionalität. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API Get Route Directions oder Post Route Directions verwenden, um die Routenkoordinaten einer bestimmten Route zu erhalten. Verwenden Sie anschließend die Azure Maps Get Map Static Image-API-Funktion, um die Routenkoordinaten auf der statischen Karte zu überlagern. |
| Routenparameter: waypoint.n | wp.n | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Azure Maps Get Maps Static Image API bietet keine systemeigene Routenzuordnungsfunktionalität. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API Get Route Directions oder Post Route Directions verwenden, um die Routenkoordinaten einer bestimmten Route zu erhalten. Verwenden Sie anschließend die Azure Maps Get Map Static Image-API-Funktion, um die Routenkoordinaten auf der statischen Karte zu überlagern. |
| Stil | st | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | |
| userRegion | ur | Ansicht | FALSE | String | Eine Zeichenfolge, die einen ISO 3166-1 Alpha-2-Regions-/Ländercode darstellt. Dies ändert geopolitisch umstrittene Grenzen und Bezeichnungen, um sie an der angegebenen Benutzerregion auszurichten. Der Parameter "View" ist standardmäßig auf "Auto" festgelegt, auch wenn er in der Anforderung nicht definiert ist. Weitere Informationen finden Sie unter Unterstützte Ansichten. |
| Zoomstufe | Zoom | FALSE | String | Der gewünschte Zoomfaktor der Karte. Der Zoomwert muss im Bereich 0–20 (einschließlich) liegen. Der Standardwert ist 12. | |
| hervorhebenEntität | er | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | In der Bing Maps-API für eine statische Karte wird dieser Parameter verwendet, um ein Polygon der Positionseingabe (Entität) zu erhalten, das auf der Karte nativ angezeigt wird. Die Azure Maps-API zum Abrufen statischer Kartenbilder unterstützt dieses Feature nicht. Sie können jedoch ein Polygon eines Standorts (Lokalität) aus der Azure Maps-API zum Abrufen eines Polygons abrufen und dieses dann auf der statischen Karte anzeigen. |
Weitere Informationen zu den Anforderungsparametern der Azure Maps-API zum Abrufen statischer Kartenbilder finden Sie unter URI-Parameter.
Anforderungsbeispiele
Beispiel-GET-Anforderung der Bing Karten-API zum Abrufen einer statischen Karte:
https://dev.virtualearth.net/REST/v1/Imagery/Map/Road/51.504810,-0.113629/15?mapSize=500,500&pp=51.504810,-0.113629;45&key={BingMapsKey}
Beispiel-GET-Anforderung der Azure Maps-API zum Abrufen statischer Kartenbilder:
https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=15¢er=-0.113629,51.504810&height=500&Width=500&pins=default||-0.113629 51.504810||&subscription-key={Your-Azure-Maps-Subscription-key}
Beispielantworten
Der folgende Screenshot zeigt das Ergebnis, das beim Ausführen einer Anforderung der Bing Karten-API zum Abrufen einer statischen Karte im Textkörper der HTTP-Antwort zurückgegeben wird:
Im folgenden JSON-Beispiel wird das Ergebnis gezeigt, das beim Ausführen der Anforderung der Azure Maps-API zum Abrufen statischer Kartenbilder im Textkörper der HTTP-Antwort zurückgegeben wird:
Transaktionsnutzung
Wie die Bing Karten-API zum Abrufen einer statischen Karte protokolliert auch die Azure Maps-API zum Abrufen statischer Kartenbilder eine abrechenbare Transaktion pro Anforderung. Weitere Informationen zu Azure Maps-Transaktionen finden Sie unter Grundlegendes zu Azure Maps-Transaktionen.
Weitere Informationen
Unterstützung