Eseguire la migrazione dell'API Find a Location by Point di Bing Maps

Articolo
05/23/2024

Questo articolo spiega come eseguire la migrazione dell'API Find a Location by Point di Bing Maps all'API Get Reverse Geocoding di Mappe di Azure. L'API Get Reverse Geocoding di Mappe di Azure viene usata per convertire le coordinate di latitudine e longitudine in un indirizzo stradale comprensibile.

Prerequisiti

Un account Azure
Un account Mappe di Azure
Una chiave di sottoscrizione o un altro tipo di autenticazione con Mappe di Azure

Differenze rilevanti

L'API Find a Location by Point di Bing Maps supporta i formati di risposta XML e JSON. L'API Get Reverse Geocoding di Mappe di Azure supporta il formato di risposta GeoJSON.
L'API Find a Location by Point di Bing Maps usa le coordinate nel formato latitudine/longitudine. L'API Get Reverse Geocoding di Mappe di Azure usa le coordinate nel formato longitudine/latitudine, come definito da GeoJSON.
A differenza dell'API Find a Location by Point di Bing Maps, l'API Get Reverse Geocoding di Mappe di Azure attualmente non supporta la geocodifica degli indirizzi per Cina, Giappone o Corea del Sud.
A differenza dell'API Find a Location by Point di Bing Maps, l'API Get Reverse Geocoding di Mappe di Azure dispone di un parametro di input view, ovvero una stringa che rappresenta un codice paese/area ISO 3166-1 Alpha-2. Il parametro di input view modifica i bordi e le etichette geopolitici contestati per allinearsi all'area utente specificata. Per altre informazioni, vedere Parametri URI.
A differenza di Bing Maps for Enterprise, Mappe di Azure è un servizio globale che supporta la specifica di un ambito geografico, il che consente di limitare la residenza dei dati alle aree geografiche di Europa (UE) o Stati Uniti (US). Tutte le richieste (inclusi i dati di input) vengono elaborate esclusivamente nell'area geografica specificata. Per altre informazioni, vedere Ambito geografico del servizio Mappe di Azure.

Sicurezza e autenticazione

Bing Maps for Enterprise supporta solo l'autenticazione con chiave API. Mappe di Azure supporta diversi modi per autenticare le chiamate API, ad esempio una chiave di sottoscrizione, Microsoft Entra ID e il token di firma di accesso condiviso (SAS). Per altre informazioni sulla sicurezza e l'autenticazione in Mappe di Azure, vedere Autenticazione con Mappe di Azure e la sezione Sicurezza nella documentazione di Mappe di Azure Ottenere la geocodifica.

Parametri della richiesta

Nella tabella seguente sono elencati i parametri di richiesta di Find a Location by Point di Bing Maps e l'equivalente di Mappe di Azure:

Parametro di richiesta di Bing Mappe	Alias del parametro di richiesta di Bing Mappe	Mappe di Azure parametro di richiesta	Obbligatorio in Mappe di Azure	Mappe di Azure tipo di dati	Descrizione
Impostazioni cultura	c	Intestazione richiesta: Accept-Language	Falso	string	Nell'API Get Reverse Geocoding di Mappe di Azure si tratta della lingua in cui devono essere restituiti i risultati della ricerca. Questo valore viene specificato nell'intestazione della richiesta di Mappe di Azure. Per informazioni dettagliate, vedere lingue supportate.
include	incl	Non necessaria	Non necessaria	Non necessaria	In Bing Maps Find a Location by Point, il parametro di input "include" è necessario per ottenere un codice paese ISO a due lettere per il risultato della posizione nella risposta. Nell'API Get Reverse Geocoding di Mappe di Azure il codice paese ISO a due lettere viene restituito per impostazione predefinita.
includeEntityTypes		resultTypes	Falso	query
includeNeighborhood	inclnb	Non necessaria	Non necessaria	Non necessaria	Nell'API Get Reverse Geocoding di Mappe di Azure, le informazioni sul quartiere vengono restituite nella risposta per impostazione predefinita, se disponibili.
point		Coordinate	Vero	number[]	Nell'API Find a Location by Point di Bing Maps, le coordinate nella richiesta e nella risposta sono in formato latitudine/longitudine, mentre l'API Get Reverse Geocoding di Mappe di Azure richiede che le coordinate nella richiesta e nella risposta utilizzino il formato longitudine/latitudine, come definito da GeoJSON.
userRegion	ur	view	Falso	string	Stringa che rappresenta un codice area/paese ISO 3166-1 Alpha-2. Modifica i bordi e le etichette geopolitici contestati per allinearsi all'area utente specificata. Per impostazione predefinita, il parametro View è impostato su "Auto", anche se non è stato definito nella richiesta. Per informazioni dettagliate e per vedere le visualizzazioni disponibili, vedere Viste supportate.
verboseplacenames	vbpn	Non supportato	Non supportato	Non supportato	Mappe di Azure'API Get Reverse Geocoding supporta solo la restituzione del nome breve adminDistricts (FL invece della Florida).

Per altre informazioni sui parametri di richiesta dell'API Get Reverse Geocoding di Mappe di Azure, vedere Parametri URI.

Esempi di richiesta

Richiesta dell'API Find a Location by Point di Bing Maps:

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

Richiesta dell'API Get Reverse Geocoding di Mappe di Azure:

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

Campi di risposta

La tabella seguente elenca i campi che possono essere visualizzati nella risposta HTTP durante l'esecuzione della richiesta Find a Location by Point di Bing Maps e l'equivalente di Mappe di Azure:

Risposta Mappe Bing	Mappe di Azure risposta	Descrizione
address: addressLine (JSON) Address: AddressLine (XML)	address: addressLine
address: adminDistrict (JSON) Address: AdminDistrict (XML)	address: adminDistricts
address: adminDistrict2 (JSON) Address: AdminDistrict2 (XML)	address: adminDistricts
address: countryRegion (JSON) Address: CountryRegion (XML)	address: countryRegion
address: countryRegionIso2 (JSON) Address: CountryRegionIso2 (XML)	address: countryRegion - iso
address: neighborhood (JSON) Address: Neighborhood (XML)	address: neighborhood
address: formattedAddress (JSON) Address: FormattedAddress (XML)	address: formattedAddress
address: locality (JSON) Address: Locality (XML)	address: locality
address: postalCode (JSON) Address: PostalCode (XML)	address: postalCode
address: Intersection – baseStreet (JSON) Address: Intersection – BaseStreet (XML)	address: intersection -baseStreet
address: Intersection – secondaryStreet1 (JSON) Address: Intersection – SecondaryStreet1 (XML)	address: intersection - secondaryStreet1
address: Intersection – secondaryStreet2 (JSON) Address: Intersection – SecondaryStreet2 (XML)	address: intersection - secondaryStreet2
address: Intersection – intersectionType (JSON) Address: Intersection – IntersectionType (XML)	address: intersection - intersectionType
address: Intersection – displayName (JSON) Address: Intersection – DisplayName (XML)	address: intersection - displayName
bbox (JSON) BoundingBox (XML)	funzionalità: bbox	In Trova una posizione tramite API Point di Bing Maps le coordinate nella risposta sono in formato latitudine/longitudine. Nell'API Get Reverse Geocoding di Mappe di Azure le coordinate nella risposta usano il formato longitudine/latitudine, come definito da GeoJSON.
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 - coordinates
matchCodes (JSON) MatchCode (XML)	properties: matchCodes
name (JSON) Name (XML)	Non supportato	Mappe di Azure `formattedAddress` offre un valore simile a quello di Bing Maps `name`
point (JSON) Point (XML)	features: coordinates	In Trova una posizione tramite API Point di Bing Maps le coordinate nella risposta sono in formato latitudine/longitudine. Nell'API Get Reverse Geocoding di Mappe di Azure le coordinate nella risposta usano il formato longitudine/latitudine, come definito da GeoJSON.
usageTypes (JSON) usageType (XML)	properties: geocodePoints: usageTypes

Per altre informazioni sui campi di risposta dell'API Get Reverse Geocoding di Mappe di Azure, vedere Definizioni.

Esempi di risposta

L'esempio JSON seguente mostra cosa viene restituito nel corpo della risposta HTTP durante l'esecuzione di una richiesta Find a Location by Point di Bing Maps:

{
    "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"

L'esempio JSON seguente mostra cosa viene restituito nel corpo della risposta HTTP durante l'esecuzione di una richiesta Get Reverse Geocoding di Mappe di Azure:

{
    "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
            ]
        }
    ]
}

Utilizzo delle transazioni

Come l'API Find a Location by Point di Bing Maps, l'API Get Reverse Geocoding di Mappe di Azure registra una transazione fatturabile per ogni richiesta. Per altre informazioni sulle transazioni di Mappe di Azure, vedere Informazioni sulle transazioni di Mappe di Azure.

Informazioni aggiuntive

API Get Reverse Geocoding Batch di Mappe di Azure: usare per inviare un batch di query all'API Get Reverse Geocoding di Mappe di Azure in una singola richiesta.

Supporto tecnico

Forum di domande e risposte Microsoft

Condividi tramite