Migration der Bing Maps-Finde einen Standort per Abfrage-API

In diesem Artikel wird erläutert, wie Sie die Bing Maps Find a Location by Query API zur Azure Maps Get Geocoding API migrieren. Die Azure Maps Get Geocoding-API wird verwendet, um Längengrad- und Breitengradkoordinaten einer Straße, eines Orts oder eines Wahrzeichens abzurufen. Azure Maps Get Geocoding API unterstützt Geocodierungseingaben in einem unstrukturierten oder strukturierten Format. Diese Migrationsdokumentation richtet sich an Szenarien, in denen Ihre Geocodierungseingabe, z. B. Straße, Ortsadresse, Postleitzahl oder Orientierungsname, in einem unstrukturierten Format (query=) liegt – ähnlich wie bing Maps Find a Location by Query API. Informationen zum Migrieren von Bing Maps-Szenarien, in denen die Geocodierungseingabe strukturiert ist, um einen Standort nach Adresse zu finden, finden Sie unter Migrieren von Bing Maps Finden eines Speicherorts nach Adress-API.

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 Query API unterstützt nur Geocodierungseingaben im unstrukturierten Format, während Azure Maps Get Geocoding API Geocodierungseingaben in einem unstrukturierten (query=) oder strukturierten (addressLine=)-Format unterstützt. Verwenden Sie für geocodierungsfähige Orientierungsnamen die Azure Maps Get Geocoding-API mit unstrukturiertem Eingabeformat.
• Bing Maps Find a Location by Query API gibt Koordinaten im Breiten-/Längengrad-Format zurück, während Azure Maps Get Geocoding API Koordinaten im Längen-/Breitengrad-Format zurückgibt, wie im GeoJSON-Format definiert.
• Bing Maps Find a Location by Query API unterstützt XML- und JSON-Antwortformat. Die Azure Maps Get Geocoding-API unterstützt GeoJSON.
• Im Gegensatz zur Bing Maps Find a Location by Query API verfügt azure Maps Get Geocoding API über einen view Eingabeparameter, bei dem es sich um eine Zeichenfolge handelt, die einen ISO 3166-1 Alpha-2-Regions-/Ländercode darstellt. Der view Eingabeparameter ändert geopolitische strittige Grenzen und Bezeichnungen so, dass sie mit der angegebenen Benutzerregion übereinstimmen. Weitere Informationen finden Sie unter URI-Parameter.
• Im Gegensatz zur Bing Maps Find a Location by Query API unterstützt Azure Maps Get Geocoding API derzeit keine Adress-Geocodierung in China.
• Im Gegensatz zu Bing Maps for Enterprise ist Azure Maps ein globaler Dienst, der die Angabe eines geografischen Bereichs unterstützt, wodurch Beschränkungen für die Datenaufbewahrung in den europäischen (EU) oder den Vereinigten Staaten (USA) geografischen Regionen ermöglicht werden. Alle Anforderungen (einschließlich Eingabedaten) werden ausschließlich im angegebenen geografischen Bereich verarbeitet. Weitere Informationen finden Sie im geografischen Bereich.

Sicherheit und Authentifizierung

Bing Maps for Enterprise unterstützt nur die API-Schlüsselauthentifizierung. Azure Maps unterstützt mehrere Möglichkeiten für die Authentifizierung Ihrer API-Aufrufe, z. B. Abonnementschlüssel, Microsoft Entra ID und SAS-Tokens (Shared Access Signature). Weitere Informationen zur Sicherheit und Authentifizierung in Azure Maps finden Sie im Abschnitt " Authentifizierung mit Azure Maps " und im Abschnitt "Sicherheit " in der Dokumentation "Geocodierung abrufen" von Azure Maps.

Anforderungsparameter

Die folgende Tabelle enthält die Bing Maps Find a Location by Query Request Parameters und die Azure Maps-Entsprechung:

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

Beispiele anfordern

Bing Maps Find a Location by Query API POST-Anforderung:

http://dev.virtualearth.net/REST/v1/Locations/15127 NE 24th Street Redmond WA&key={BingMapsKey}

Azure Maps API-POST-Anfrage Get Geocoding:

https://atlas.microsoft.com/geocode?api-version=2023-06-01&query=15127 NE 24th Street Redmond WA&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 Bing Maps-Abfrage " Standort nach Abfrage suchen " und das Azure Maps-Äquivalent ausgeführt wird:

Weitere Informationen zu den Antwortfeldern der Azure Maps Get Geocoding API finden Sie unter Definitionen.

Beispielantworten

Das folgende JSON-Beispiel zeigt, was im Inhalt der HTTP-Antwort zurückgegeben wird, wenn die Bing Maps-Abfrage eine Ort anhand einer Abfrage finden-Anforderung ausführt.

{ 
    "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": [ 
                        47.62649628242932, 
                        -122.14631082421619, 
                        47.634221717570675, 
                        -122.1310271757838 
                    ], 
                    "name": "15127 NE 24th St, Redmond, WA 98052", 
                    "point": { 
                        "type": "Point", 
                        "coordinates": [ 
                            47.630359, 
                            -122.138669 
                        ] 
                    }, 
                    "address": { 
                        "addressLine": "15127 NE 24th St", 
                        "adminDistrict": "WA", 
                        "adminDistrict2": "King County", 
                        "countryRegion": "United States", 
                        "formattedAddress": "15127 NE 24th St, Redmond, WA 98052", 
                        "locality": "Redmond", 
                        "postalCode": "98052" 
                    }, 
                    "confidence": "High", 
                    "entityType": "Address", 
                    "geocodePoints": [ 
                        { 
                            "type": "Point", 
                            "coordinates": [ 
                                47.630359, 
                                -122.138669 
                            ], 
                            "calculationMethod": "Rooftop", 
                            "usageTypes": [ 
                                "Display" 
                            ] 
                        }, 
                        { 
                            "type": "Point", 
                            "coordinates": [ 
                                47.630563, 
                                -122.1387383 
                            ], 
                            "calculationMethod": "Rooftop", 
                            "usageTypes": [ 
                                "Route" 
                            ] 
                        } 
                    ], 
                    "matchCodes": [ 
                        "Good" 
                    ] 
                } 
            ] 
        } 
    ], 
    "statusCode": 200, 
    "statusDescription": "OK", 
    "traceId": "7896468b37528ac145ef77cc62484fd6|MWH0032BE2|0.0.0.1|Ref A: 7D01B283F7644D2891600E265FB30B24 Ref B: CO1EDGE2318 Ref C: 2024-04-23T18:29:55Z" 

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

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -122.138679,
                    47.630356
                ]
            },
            "bbox": [
                -122.14632082377759,
                47.62649328242932,
                -122.1310371762224,
                47.634218717570675
            ],
            "properties": {
                "type": "Address",
                "confidence": "High",
                "matchCodes": [
                    "Good"
                ],
                "geocodePoints": [
                    {
                        "calculationMethod": "Rooftop",
                        "usageTypes": [
                            "Display"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                -122.138679,
                                47.630356
                            ]
                        }
                    },
                    {
                        "calculationMethod": "Rooftop",
                        "usageTypes": [
                            "Route"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                -122.138685,
                                47.6305637
                            ]
                        }
                    }
                ],
                "address": {
                    "addressLine": "15127 NE 24th St",
                    "postalCode": "98052",
                    "locality": "Redmond",
                    "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
                    "countryRegion": {
                        "name": "United States",
                        "ISO": "US"
                    },
                    "adminDistricts": [
                        {
                            "shortName": "WA"
                        },
                        {
                            "shortName": "King County"
                        }
                    ]
                }
            }
        }
    ]
}

Transaktionsnutzung

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

Weitere Informationen

• Get Geocoding Batch: Verwenden Sie, um eine Gruppe von Abfragen in einer einzelnen synchronen Anfrage an die Get Geocoding API zu senden.

Support

• Microsoft Q&A-Forum