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 |
|---|---|---|---|---|---|
| centerPoint | 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. Die Parameter schließen sich gegenseitig aus. |
|
| culture | c | language | 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. |
| declutterPins | 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 | |
| fieldOfView | 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. |
| heading | 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. | |
| highlightEntity | er | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | In der Bing Karten-API zum Abrufen einer statischen Karte wird dieser Parameter zum Abrufen eines Polygon der Standorteingabe (Entität) verwendet, das nativ auf der Karte 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. |
| imagerySet | tilesetID | TRUE | TilesetId | ||
| mapArea | 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. Die Parameter schließen sich gegenseitig aus. bbox darf nicht mit height oder width verwendet 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. |
| mapSize | ms | height | TRUE | integer int32 | |
| width | |||||
| mapMetadata | mmd | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | |
| orientation | 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. | |
| pushpin | pp | pins | 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. In der Azure Maps-API zum Abrufen statischer Kartenbilder gibt es keine Beschränkungen für die Anzahl der Stecknadeln pro statischer Karte in HTTP-GET-Anforderungen. Die Anzahl der in der statischen Karte unterstützten Stecknadeln basiert jedoch auf der maximalen Anzahl von Zeichen, die in der HTTP-GET-Anforderung unterstützt werden. Weitere Informationen zur Unterstützung von Stecknadeln finden Sie unter URI Parameter beim „pins“-Parameter der Azure Maps-API zum Abrufen statischer Kartenbilder. |
| query | 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: avoid | Keine | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt nativ keine Routenfunktionalität bereit. 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 einer bestimmten Route abzurufen. Verwenden Sie dann das Feature drawCurve der Azure Maps-API zum Abrufen statischer Kartenbilder, um die Routenkoordinaten über die statische Karte zu legen. |
| Routenparameter: distanceBeforeFirstTurn | dbft | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt nativ keine Routenfunktionalität bereit. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API zum Abrufen von Wegbeschreibungen oder Veröffentlichen von Wegbeschreibungen verwenden, um die Koordinaten einer bestimmten Route abzurufen. Verwenden Sie dann das Feature drawCurve der Azure Maps-API zum Abrufen statischer Kartenbilder, um die Routenkoordinaten über die statische Karte zu legen. |
| Routenparameter: dateTime | dt | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt nativ keine Routenfunktionalität bereit. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API zum Abrufen von Wegbeschreibungen oder Veröffentlichen von Wegbeschreibungen verwenden, um die Koordinaten einer bestimmten Route abzurufen. Verwenden Sie dann das Feature drawCurve der Azure Maps-API zum Abrufen statischer Kartenbilder, um die Routenkoordinaten über die statische Karte zu legen. |
| Routenparameter: maxSolutions | maxSolns | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt nativ keine Routenfunktionalität bereit. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API zum Abrufen von Wegbeschreibungen oder Veröffentlichen von Wegbeschreibungen verwenden, um die Koordinaten einer bestimmten Route abzurufen. Verwenden Sie dann das Feature drawCurve der Azure Maps-API zum Abrufen statischer Kartenbilder, um die Routenkoordinaten über die statische Karte zu legen. |
| Routenparameter: optimize | optmz | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt nativ keine Routenfunktionalität bereit. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API zum Abrufen von Wegbeschreibungen oder Veröffentlichen von Wegbeschreibungen verwenden, um die Koordinaten einer bestimmten Route abzurufen. Verwenden Sie dann das Feature drawCurve der Azure Maps-API zum Abrufen statischer Kartenbilder, um die Routenkoordinaten über die statische Karte zu legen. |
| Routenparameter: timeType | tt | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt nativ keine Routenfunktionalität bereit. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API zum Abrufen von Wegbeschreibungen oder Veröffentlichen von Wegbeschreibungen verwenden, um die Koordinaten einer bestimmten Route abzurufen. Verwenden Sie dann das Feature drawCurve der Azure Maps-API zum Abrufen statischer Kartenbilder, um die Routenkoordinaten über die statische Karte zu legen. |
| Routenparameter: travelMode | Keine | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt nativ keine Routenfunktionalität bereit. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API zum Abrufen von Wegbeschreibungen oder Veröffentlichen von Wegbeschreibungen verwenden, um die Koordinaten einer bestimmten Route abzurufen. Verwenden Sie dann das Feature drawCurve der Azure Maps-API zum Abrufen statischer Kartenbilder, um die Routenkoordinaten über die statische Karte zu legen. |
| Routenparameter: waypoint.n | wp.n | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | Die Azure Maps-API zum Abrufen statischer Kartenbilder stellt nativ keine Routenfunktionalität bereit. Zum Abrufen einer statischen Karte mit einem Routenpfad können Sie die Azure Maps-API zum Abrufen von Wegbeschreibungen oder Veröffentlichen von Wegbeschreibungen verwenden, um die Koordinaten einer bestimmten Route abzurufen. Verwenden Sie dann das Feature drawCurve der Azure Maps-API zum Abrufen statischer Kartenbilder, um die Routenkoordinaten über die statische Karte zu legen. |
| style | st | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | |
| userRegion | ur | view | 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 „view“-Parameter ist standardmäßig auf „Auto“ festgelegt, auch wenn er in der Anforderung nicht definiert ist. Weitere Informationen finden Sie unter Unterstützte Ansichten. |
| zoomLevel | Zoom | FALSE | String | Der gewünschte Zoomfaktor der Karte. Der Zoomwert muss im Bereich 0–20 liegen. Der Standardwert ist 12. | |
| highlightEntity | er | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt | In der Bing Karten-API zum Abrufen einer statischen Karte wird dieser Parameter zum Abrufen eines Polygon der Standorteingabe (Entität) verwendet, das nativ auf der Karte 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.
Beispiele für Anforderungen
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