Migrieren von Bing Maps: Find a Location by Point-API

Artikel
05/25/2024

In diesem Artikel wird erläutert, wie Sie die Bing Maps Find a Location by Point-API zur Azure Maps Get Reverse Geocoding-API migrieren. Die Azure Maps Get Reverse Geocoding-API wird verwendet, um Längengrad- und Breitengradkoordinaten in eine menschliche verständliche Straßenadresse zu übersetzen.

Voraussetzungen

Ein Azure-Konto
Ein Azure Maps-Konto
Ein Abonnementschlüssel oder eine andere Form der Authentifizierung bei Azure Maps

Wichtige Unterschiede

Bing Maps Find a Location by Point-API unterstützt XML- und JSON-Antwortformate. Die Azure Maps Get Reverse Geocoding-API unterstützt das GeoJSON-Antwortformat.
Bing Maps Find a Location by Point-API verwendet Koordinaten im Breiten-/Längengradformat. Azure Maps Get Reverse Geocoding-API verwendet Koordinaten im Längen-/Breitengradformat, wie von GeoJSON definiert.
Im Gegensatz zur Bing Maps Find a Location by Point-API unterstützt die Azure Maps Get Reverse Geocoding-API derzeit keine Adress- oder Straßendaten für China, Japan oder Südkorea.
Im Gegensatz zur Bing Maps Find a Location by Point-API verfügt die Azure Maps Get Reverse Geocoding-API über einen view-Eingabeparameter, der eine Zeichenfolge darstellt, die einen ISO 3166-1 Alpha-2-Region/Ländercode darstellt. Der view-Eingabeparameter ändert geopolitische umstrittene Grenzen und Bezeichnungen, um sie an der angegebenen Benutzerregion auszurichten. Weitere Informationen finden Sie unter URI-Parameter.
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 und im Abschnitt Sicherheit der Dokumentation zum Azure Maps Gets Geocoding.

Anforderungsparameter

In der folgenden Tabelle sind die Bing Maps Find a Location by Point-Anforderungsparameter und die Azure Maps-Entsprechung aufgeführt:

Bing Maps-Anforderungsparameter	Alias des Bing Maps-Anforderungsparameters	Azure Maps-Anforderungsparameter	Erforderlich in Azure Maps	Azure Maps-Datentyp	Beschreibung
culture	c	Anforderungsheader: Accept-Language	False	Zeichenfolge	In der Azure Maps Get Reverse Geocoding-API ist dies die Sprache, in der Suchergebnisse zurückgegeben werden sollen. Dies wird im Azure Maps Anforderungsheader angegeben. Weitere Informationen finden Sie unter unterstützten Sprachen.
include	inkl.	Nicht erforderlich	Nicht erforderlich	Nicht erforderlich	In Bing Maps Find a Location by Point ist der Eingabeparameter „include“ erforderlich, um einen ISO-Ländercode aus zwei Buchstaben für das Standortergebnis in der Antwort abzurufen. In Azure Maps Get Reverse Geocoding-API wird standardmäßig der ISO-Ländercode mit zwei Buchstaben zurückgegeben.
includeEntityTypes		resultTypes	False	query
includeNeighborhood	inclnb	Nicht erforderlich	Nicht erforderlich	Nicht erforderlich	In Azure Maps Get Reverse Geocoding API werden Nachbarschaftsinformationen standardmäßig in der Antwort zurückgegeben, sofern sie verfügbar sind.
Punkt		Koordinaten	True	nummer[]	In der Bing Maps Find a Location by Point-API sind die Koordinaten in der Anforderung und der Antwort im Breiten-/Längengradformat, wohingegen die Azure Maps Get Reverse Geocoding-API in der Anforderung und in der Antwort die Koordinaten im Breiten-/Längengradformat erfordert, wie von GeoJSON festgelegt.
userRegion	ur	view	False	Zeichenfolge	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 Sie ihn in der Anforderung nicht definiert haben. Weitere Informationen sowie die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten.
verboseplacenames	vbpn	Nicht unterstützt	Nicht unterstützt	Nicht unterstützt	Azure Maps Get Reverse Geocoding-API unterstützt nur die Rückgabe von adminDistricts-Kurznamen (FL anstelle von Florida).

Weitere Informationen zu den Anforderungsparametern der Azure Maps Get Reverse Geocoding-API finden Sie unter URI-Parameter.

Beispiele für Anforderungen

Anforderung der Bing Maps Find a Location by Point-API:

https://dev.virtualearth.net/REST/v1/Locations/48.830345,2.338166&key={BingMapsKey}

Anforderung der Azure Maps Get Reverse Geocoding-API:

http://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates=2.338166,48.830345&subscription-key={Your-Azure-Maps-Subscription-key}

Antwortfelder

In der folgenden Tabelle sind die Felder aufgeführt, die in der HTTP-Antwort angezeigt werden können, wenn die Anforderung der Bing Maps Find a Location by Point und die Azure Maps-Entsprechung ausgeführt werden:

Bing Maps-Antwort	Azure Maps-Antwort	Beschreibung
Adresse: addressLine (JSON) Adresse: AddressLine (XML)	Adresse: addressLine
Adresse: adminDistrict (JSON) Adresse: AdminDistrict (XML)	Adresse: adminDistricts
Adresse: adminDistrict2 (JSON) Adresse: AdminDistrict2 (XML)	Adresse: adminDistricts
Adresse: countryRegion (JSON) Adresse: CountryRegion (XML)	Adresse: countryRegion
Adresse: countryRegionIso2 (JSON) Adresse: CountryRegionIso2 (XML)	Adresse: countryRegion - iso
Adresse: neighborhood (JSON) Adresse: Neighborhood (XML)	Adresse: neighborhood
Adresse: formattedAddress (JSON) Adresse: FormattedAddress (XML)	Adresse: formattedAddress
Adresse: locality (JSON) Adresse: Locality (XML)	Adresse: locality
Adresse: postalCode (JSON) Address: PostalCode (XML)	Adresse: postalCode
Adresse: Intersection – baseStreet (JSON) Adresse: Intersection – BaseStreet (XML)	Adresse: intersection – baseStreet
Adresse: Intersection – secondaryStreet1 (JSON) Adresse: Intersection – SecondaryStreet1 (XML)	Adresse: Intersection – secondaryStreet1
Adresse: Intersection – secondaryStreet2 (JSON) Adresse: Intersection – SecondaryStreet2 (XML)	Adresse: intersection – secondaryStreet2
Adresse: Intersection – intersectionType (JSON) Adresse: Intersection – IntersectionType (XML)	Adresse: intersection – intersectionType
Adresse: Intersection – displayName (JSON) Adresse: Intersection – DisplayName (XML)	Adresse: intersection – displayName
bbox (JSON) BoundingBox (XML)	Features: bbox	In der Bing Maps Find a Location by Point-API sind die Koordinaten in der Antwort im Breiten-/Längengradformat. In der Azure Maps Get Reverse Geocoding-API sind die Koordinaten in der Antwort im Breiten-/Längengradformat, wie in der GeoJSON festgelegt.
calculationMethod (JSON) CalculationMethod (XML)	properties: geocodePoints - calculationMethod
confidence (JSON) Confidence (XML)	properties: confidence
entityType (JSON) EntityType (XML)	properties: type
geocodePoints (JSON) GeocodePoint (XML)	properties: geocodePoints - Koordinaten
matchCodes (JSON) MatchCode (XML)	properties: matchCodes
name (JSON) Name (XML)	Nicht unterstützt	Azure Maps `formattedAddress` liefert einen ähnlichen Wert wie Bing Maps `name`
point (JSON) Point (XML)	features: coordinates	In der Bing Maps Find a Location by Point-API sind die Koordinaten in der Antwort im Breiten-/Längengradformat. In der Azure Maps Get Reverse Geocoding-API sind die Koordinaten in der Antwort im Breiten-/Längengradformat, wie in der GeoJSON festgelegt.
usageTypes (JSON) usageType (XML)	properties: geocodePoints: usageTypes

Weitere Informationen zu den Antwortfeldern der Azure Maps Get Reverse Geocoding-API finden Sie unter Definitions.

Beispielantworten

Das folgende JSON-Beispiel zeigt, was im Textkörper der HTTP-Antwort zurückgegeben wird, wenn die Bing Maps Find a Location by Point-Anforderung ausgeführt wird:

{
    "authenticationResultCode": "ValidCredentials",
    "brandLogoUri": "https://dev.virtualearth.net/Branding/logo_powered_by.png",
    "copyright": "Copyright © 2024 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.",
    "resourceSets": [
        {
            "estimatedTotal": 1,
            "resources": [
                {
                    "__type": "Location:http://schemas.microsoft.com/search/local/ws/rest/v1",
                    "bbox": [
                        48.826534682429326,
                        2.330334564829834,
                        48.83426011757068,
                        2.345980835170166
                    ],
                    "name": "30 Rue Cabanis, 75014 Paris, France",
                    "point": {
                        "type": "Point",
                        "coordinates": [
                            48.8303974,
                            2.3381577
                        ]
                    },
                    "address": {
                        "addressLine": "30 Rue Cabanis",
                        "adminDistrict": "Île-de-France",
                        "adminDistrict2": "Paris",
                        "countryRegion": "France",
                        "formattedAddress": "30 Rue Cabanis, 75014 Paris, France",
                        "intersection": {
                            "baseStreet": "Rue Cabanis",
                            "secondaryStreet1": "Villa de Lourcine",
                            "intersectionType": "Near",
                            "displayName": "Rue Cabanis and Villa de Lourcine"
                        },
                        "locality": "Paris",
                        "neighborhood": "14th Arrondissement",
                        "postalCode": "75014"
                    },
                    "confidence": "High",
                    "entityType": "Address",
                    "geocodePoints": [
                        {
                            "type": "Point",
                            "coordinates": [
                                48.8303974,
                                2.3381577
                            ],
                            "calculationMethod": "Rooftop",
                            "usageTypes": [
                                "Display"
                            ]
                        }
                    ],
                    "matchCodes": [
                        "Good"
                    ]
                }
            ]
        }
    ],
    "statusCode": 200,
    "statusDescription": "OK",
    "traceId": "c525b02f7f1e9e4ee3d7b81cce266671"

Das folgende JSON-Beispiel zeigt, was beim Ausführen einer Azure Maps Get Reverse Geocoding-Anforderung im Textkörper der HTTP-Antwort zurückgegeben wird:

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    2.3381577,
                    48.8303974
                ]
            },
            "properties": {
                "geocodePoints": [
                    {
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                2.3381577,
                                48.8303974
                            ]
                        },
                        "calculationMethod": "Rooftop",
                        "usageTypes": [
                            "Display"
                        ]
                    }
                ],
                "address": {
                    "addressLine": "30 Rue Cabanis",
                    "adminDistricts": [
                        {
                            "shortName": "Île-de-France"
                        },
                        {
                            "shortName": "Paris"
                        }
                    ],
                    "countryRegion": {
                        "name": "France",
                        "iso": "FR"
                    },
                    "intersection": {
                        "baseStreet": "Rue Cabanis",
                        "displayName": "Rue Cabanis and Villa de Lourcine",
                        "intersectionType": "Near",
                        "secondaryStreet1": "Villa de Lourcine",
                        "secondaryStreet2": null
                    },
                    "locality": "Paris",
                    "neighborhood": "14th Arrondissement",
                    "postalCode": "75014",
                    "formattedAddress": "30 Rue Cabanis, 75014 Paris, France"
                },
                "confidence": "High",
                "matchCodes": [
                    "Good"
                ],
                "type": "Address"
            },
            "bbox": [
                2.330334564829834,
                48.826534682429326,
                2.345980835170166,
                48.83426011757068
            ]
        }
    ]
}

Transaktionsnutzung

Wie bei der Bing Maps Find a Location by Point-API protokolliert Azure Maps Get Reverse Geocoding-API eine abrechnungsfähige Transaktion pro Anforderung. Weitere Informationen zu Azure Maps-Transaktionen finden Sie unter Grundlegendes zu Azure Maps-Transaktionen.

Weitere Informationen

Azure Maps Get Reverse Geocoding Batch-API: Dient zum Senden eines Batches von Abfragen an die Azure Maps Get Reverse Geocoding-API in einer einzigen Anforderung.

Unterstützung

Microsoft Q&A-Forum

Freigeben über