Condividi tramite

Eseguire la migrazione dell'API per ottenere una mappa statica con Bing Maps

Questo articolo spiega come eseguire la migrazione dell'API Ottieni mappa statica di Bing Mappe all'API Ottieni immagine statica mappa di Mappe di Azure. L'API Get Map Static Image di Mappe di Azure esegue il rendering di un'immagine mappa in stile stradale, satellitare/aerea o di traffico definita dall'utente.

Prerequisiti

Differenze rilevanti

  • L'API Get a Static Map di Bing Mappe offre mappe in stile stradale, satellitare/aereo, traffico, streetside, viste aeree e Ordnance Survey. L'API Get Map Static Image di Azure Maps offre gli stessi stili, ad eccezione di Streetside, Birds Eye e Ordnance Survey.
  • L'API Recupera mappa statica di Bing Mappe supporta il recupero di una mappa statica usando coordinate, indirizzo o nome del luogo come input per la posizione. L'API Get Map Static Image di Azure Maps supporta solo le coordinate come input per la posizione.
  • L'API Ottieni mappa statica di Bing Mappe supporta l'acquisizione di una mappa statica di un percorso di guida, camminata o transito in modo nativo. L'API Ottieni immagine statica della mappa di Azure Maps non fornisce funzionalità di mappa per percorsi in modo nativo.
  • L'API Ottieni mappa statica di Bing Mappe fornisce mappe statiche in formati di immagine PNG, JPEG e GIF. Azure Maps Get Map Static Image API fornisce mappe statiche nei formati di immagine PNG e JPEG.
  • L'API Ottieni una mappa statica di Bing Maps supporta i formati di risposta XML e JSON. L'API di Azure Maps per ottenere immagini statiche della mappa supporta solo il formato di risposta JSON.
  • L'API Ottieni mappa statica di Bing Mappe supporta le richieste HTTP GET e POST. L'API Azure Maps Get Map Static Image supporta le richieste HTTP GET.
  • L'API Ottieni mappa statica di Bing Mappe usa le coordinate nel formato latitudine e longitudine. L'API Get Map Static Image di Mappe di Azure usa le coordinate nel formato longitudine e latitudine, come definito in GeoJSON.
  • 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 maggiori informazioni sulla sicurezza e sull'autenticazione in Azure Maps, vedere Autenticazione con Mappe di Azure e la sezione Sicurezza nella documentazione di Mappe di Azure, Immagine Statica della Mappa.

Parametri della richiesta

La tabella seguente elenca i parametri di richiesta Ottieni mappa statica di Bing Mappe e l'equivalente di Mappe di Azure:

Parametro di richiesta Bing Maps Alias parametri Parametro di richiesta di Azure Maps Obbligatorio in Mappe di Azure Tipo di dati Mappe di Azure Descrizione
punto centrale centro True (se non si usa bbox) numero[] L'API per ottenere una mappa statica di Bing Maps richiede coordinate in formato latitudine e longitudine, mentre l'API per ottenere un'immagine statica della mappa di Azure Maps richiede il formato longitudine e latitudine, come definito nel formato GeoJSON. 

Intervallo longitude,latitude da [-90, 90]​. Nota: center o bbox sono parametri obbligatori Sono reciprocamente esclusivi.
cultura c lingua FALSO String Nell'API di Azure Maps Get Map Static Image, questa è la lingua in cui i risultati della ricerca devono essere restituiti ed è specificata nell'intestazione della richiesta di Azure Maps. Per altre informazioni, vedere Linguaggi supportati.
declutterPins dcl Non supportato Non supportato Non supportato
dpi dir Non supportato Non supportato Non supportato
drawCurve dv Percorso FALSO String
campo visivo fov Non supportato Non supportato Non supportato In Bing Mappe questo parametro viene usato per imagerySet Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside. Mappe di Azure non supporta questi stili di mappe.
formato fmt formato TRUE String L'API Ottieni mappa statica di Bing Mappe fornisce mappe statiche in formati di immagine PNG, JPEG e GIF. Azure Maps Get Map Static Image API fornisce mappe statiche nei formati di immagine PNG e JPEG.
heading Non supportato Non supportato Non supportato In Bing Mappe questo parametro viene usato per imagerySet Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside. Mappe di Azure non supporta questi stili di mappe.
highlightEntity lui Non supportato Non supportato Non supportato Nell'API Get a Static Map di Bing Mappe, questo parametro viene usato per ottenere un poligono dell'input di posizione (entità) visualizzato sulla mappa in modo nativo. L'API Ottieni immagine statica mappa di Mappe di Azure non supporta questa funzionalità, ma è possibile ottenere un poligono di una posizione (località) dall'API Ottieni poligono di Mappe di Azure e quindi visualizzare tale posizione sulla mappa statica.
set di immagini tilesetID TRUE TilesetId
mapArea ma bbox True (se non si usa il centro) numero[] Un riquadro di delimitazione, definita da due longitudini e due latitudini, rappresenta i quattro lati di un'area rettangolare sulla superficie terrestre, nel formato minLon, minLat, maxLon, maxLat. 

Nota: center o bbox sono parametri obbligatori Sono reciprocamente esclusivi. bbox non deve essere usato con height o width.
strato della mappa ml trafficLayer FALSO TrafficTilesetId Facoltativo. Se viene fornito TrafficLayer, restituisce l'immagine della mappa con il livello di traffico corrispondente. Per ulteriori informazioni, vedere tilesetId.
mapSize ms altezza TRUE integer int32
larghezza
mapMetadata mmd Non supportato Non supportato Non supportato
orientamento dir Non supportato Non supportato Non supportato Nell'API Ottieni mappa statica di Bing Mappe questo parametro viene usato per "imagerySet" Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside. Mappe di Azure non supporta questi stili di mappe
pitch Non supportato Non supportato Non supportato Nell'API Ottieni mappa statica di Bing Mappe questo parametro viene usato per "imagerySet" Birdseye, BirdseyeWithLabels, BirdseyeV2, BirdseyeV2WithLabels, OrdnanceSurvey, Streetside. Mappe di Azure non supporta questi stili di mappe
puntina pp segnaposto FALSO String Nell'API Ottieni mappa statica di Bing Mappe, una richiesta HTTP GET è limitata a 18 pin e una richiesta HTTP POST è limitata a 100 pin per ogni mappa statica. La richiesta HTTP GET dell'API Get Map Static Image di Azure Maps non ha un limite per il numero di pin per ogni mappa statica. Tuttavia, il numero di pin supportati nella mappa statica si basa sul numero massimo di caratteri supportati nella richiesta HTTP GET. Per ulteriori dettagli sul supporto delle puntine, vedere il parametro 'pins' in Parametri URI dell'API Get Map Static Image di Mappe di Azure.
interrogazione Non supportato Non supportato Non supportato L'API di Azure Maps per ottenere immagini statiche della mappa supporta solo le coordinate come dati di localizzazione, non un indirizzo o un nome di luogo. Usare l'API di geocodifica di Azure Maps per convertire un indirizzo o un nome del luogo in coordinate.
Parametri di percorso: avoid nessuno Non supportato Non supportato Non supportato L'API Azure Maps Get Maps Static Image non offre nativamente funzionalità di mappa percorso. Per ottenere una mappa statica con un percorso su di essa, usare le API Ottieni indicazioni stradali o Pubblica indicazioni stradali di Mappe di Azure per ottenere le coordinate di un determinato percorso e quindi usare l'API Ottieni immagine statica mappa con la funzionalità drawCurve per sovrapporre le coordinate del percorso nella mappa statica.
Parametri di percorso: distanzaPrimaDellaPrimaSvolta dbft Non supportato Non supportato Non supportato L'API Azure Maps Get Maps Static Image non offre nativamente funzionalità di mappa percorso. Per ottenere una mappa statica con un percorso su di essa, è possibile usare le API Ottieni indicazioni stradali o Pubblica indicazioni stradali di Mappe di Azure per ottenere le coordinate di un determinato percorso e quindi usare l'API Ottieni immagine statica mappa con la funzionalità drawCurve per sovrapporre le coordinate del percorso nella mappa statica.
Parametri di percorso: dateTime dt Non supportato Non supportato Non supportato L'API Azure Maps Get Maps Static Image non offre nativamente funzionalità di mappa percorso. Per ottenere una mappa statica con un percorso su di essa, è possibile usare le API Ottieni indicazioni stradali o Pubblica indicazioni stradali di Mappe di Azure per ottenere le coordinate di un determinato percorso e quindi usare l'API Ottieni immagine statica mappa con la funzionalità drawCurve per sovrapporre le coordinate del percorso nella mappa statica.
Parametri di percorso: maxSolutions maxSolns Non supportato Non supportato Non supportato L'API Azure Maps Get Maps Static Image non offre nativamente funzionalità di mappa percorso. Per ottenere una mappa statica con un percorso su di essa, è possibile usare le API Ottieni indicazioni stradali o Pubblica indicazioni stradali di Mappe di Azure per ottenere le coordinate di un determinato percorso e quindi usare l'API Ottieni immagine statica mappa con la funzionalità drawCurve per sovrapporre le coordinate del percorso nella mappa statica.
Parametri di percorso: ottimizzare optmz Non supportato Non supportato Non supportato L'API Azure Maps Get Maps Static Image non offre nativamente funzionalità di mappa percorso. Per ottenere una mappa statica con un percorso su di essa, è possibile usare le API Ottieni indicazioni stradali o Pubblica indicazioni stradali di Mappe di Azure per ottenere le coordinate di un determinato percorso e quindi usare l'API Ottieni immagine statica mappa con la funzionalità drawCurve per sovrapporre le coordinate del percorso nella mappa statica.
Parametri di percorso: timeType tt Non supportato Non supportato Non supportato L'API Azure Maps Get Maps Static Image non offre nativamente funzionalità di mappa percorso. Per ottenere una mappa statica con un percorso su di essa, è possibile usare le API Ottieni indicazioni stradali o Pubblica indicazioni stradali di Mappe di Azure per ottenere le coordinate di un determinato percorso e quindi usare l'API Ottieni immagine statica mappa con la funzionalità drawCurve per sovrapporre le coordinate del percorso nella mappa statica.
Parametri di percorso: travelMode nessuno Non supportato Non supportato Non supportato L'API Azure Maps Get Maps Static Image non offre funzionalità di mappe itinerario in modo nativo. Per ottenere una mappa statica con un percorso su di essa, è possibile usare le API Ottieni indicazioni stradali o Pubblica indicazioni stradali di Mappe di Azure per ottenere le coordinate di un determinato percorso e quindi usare l'API Ottieni immagine statica mappa con la funzionalità drawCurve per sovrapporre le coordinate del percorso nella mappa statica.
Parametri di percorso: waypoint.n wp.n Non supportato Non supportato Non supportato L'API Azure Maps Get Maps Static Image non offre nativamente funzionalità di mappa percorso. Per ottenere una mappa statica con un percorso su di essa, è possibile usare le API Ottieni indicazioni stradali o Pubblica indicazioni stradali di Mappe di Azure per ottenere le coordinate di un determinato percorso e quindi usare l'API Ottieni immagine statica mappa con la funzionalità drawCurve per sovrapporre le coordinate del percorso nella mappa statica.
style st Non supportato Non supportato Non supportato
userRegion ur visualizzazione FALSO String Stringa che rappresenta un codice regione/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 definito nella richiesta. Per altre informazioni, vedere Viste supportate.
livello di zoom Zoom FALSO Stringa Livello di zoom desiderato della mappa. Il valore di zoom deve essere compreso nell'intervallo: 0-20 (incluso). Il valore predefinito è 12.
highlightEntity lui Non supportato Non supportato Non supportato Nell'API Get a Static Map di Bing Mappe, questo parametro viene usato per ottenere un poligono dell'input di posizione (entità) visualizzato sulla mappa in modo nativo. L'API Ottieni immagine statica mappa di Mappe di Azure non supporta questa funzionalità, ma è possibile ottenere un poligono di una posizione (località) dall'API Ottieni poligono di Mappe di Azure e quindi visualizzare tale posizione sulla mappa statica.

Per ulteriori informazioni sui parametri di richiesta dell'API Recupero immagine statica della mappa di Azure Maps, vedere Parametri URI.

Esempi di richiesta

Richiesta GET di esempio dell'API Ottieni mappa statica di Bing Mappe:

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}

Richiesta GET di esempio per l'API di Mappe di Azure Ottieni immagine mappa statica:

https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=15&center=-0.113629,51.504810&height=500&Width=500&pins=default||-0.113629 51.504810||&subscription-key={Your-Azure-Maps-Subscription-key}

Esempi di risposta

Lo screenshot seguente mostra cosa viene restituito nel corpo della risposta HTTP durante l'esecuzione della richiesta Ottieni una mappa statica di Bing Mappe:

Screenshot della mappa che mostra i risultati della richiesta Ottieni mappa statica di Bing Mappe.

L'esempio JSON seguente mostra cosa viene restituito nel corpo della risposta HTTP durante l'esecuzione di una richiesta Ottieni immagine statica mappa di Mappe di Azure:

Screenshot della mappa che mostra i risultati della richiesta "Get Map Static Image" di Azure Maps.

Utilizzo delle transazioni

Analogamente all'API Get a Static Map di Bing Maps, l'API Get Map Static Image di Azure Maps 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

Supporto tecnico

  • Last updated on