Esercitazione - Eseguire la migrazione di un servizio Web da Google Maps

Sia Azure Maps che Google Maps forniscono l'accesso alle API spaziali tramite i servizi web REST. Le interfacce API di queste piattaforme eseguono funzionalità simili. Tuttavia, ognuna di esse usa convenzioni di denominazione e oggetti di risposta diversi.

Questa esercitazione illustra come:

• Geocodifica diretta e inversa
• Cercare i punti di interesse
• Calcolare percorsi e indicazioni
• Ottenere un'immagine della mappa
• Calcolare una matrice di distanze
• Ottenere dettagli sul fuso orario

Imparerai anche:

• Quale servizio REST di Mappe di Azure usare per la migrazione da un servizio Web di Google Maps
• Suggerimenti su come sfruttare al meglio i servizi di Mappe di Azure
• Informazioni dettagliate su altri servizi di Mappe di Azure correlati

La tabella seguente illustra le API del servizio Mappe di Azure che forniscono funzionalità simili alle API del servizio Google Maps elencate.

API del servizio Google Maps	API del servizio Mappe di Azure
Indicazioni	Itinerario
Matrice di distanze	Post Route Matrix
Geocodifica	Ricerca
Ricerca luoghi	Ricerca
Completamento automatico luoghi	Ricerca
Blocca sulla strada	Vedere la sezione Calcolare percorsi e indicazioni.
Limiti di velocità	Vedere la sezione Geocodifica inversa di una coordinata.
Mappa statica	Render
Fuso orario	TimeZone

Le API dei servizi seguenti non sono attualmente disponibili in Mappe di Azure:

• Geolocalizzazione: Le Mappe di Azure dispongono di un servizio chiamato Geolocalizzazione, che fornisce informazioni sulla posizione in base all'indirizzo IP, ma attualmente non supporta la triangolazione tramite ripetitori cellulari o Wi-Fi.
• Dettagli e foto dei luoghi: i numeri di telefono e l'URL del sito Web sono disponibili nell'API Ricerca mappe di Azure.
• URL mappa
• Strade più vicine: è possibile usare Web SDK, come illustrato nell'esempio Logica di base di Blocca sulla strada, ma non è attualmente disponibile come servizio.
• Visualizzazione statica della strada

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

• Un account di Mappe di Azure
• Una chiave di sottoscrizione

Nota

Per altre informazioni sull'autenticazione in Mappe di Azure, vedere Gestire l'autenticazione in Mappe di Azure.

Geocodifica di indirizzi

La geocodifica è il processo di conversione di un indirizzo in una coordinata. Ad esempio, "1 Microsoft Way, Redmond, WA" viene convertito in longitudine: -122.1298, latitudine 47.64005. Le coordinate possono quindi essere usate per diversi tipi di scopi, ad esempio, per posizionare e centrare un indicatore su una mappa.

Mappe di Azure offre numerosi metodi per la geocodifica degli indirizzi:

• Get Search Address: la georilevazione dell’indirizzo in formato libero viene usata per specificare una singola stringa di indirizzo (ad esempio "1 Microsoft way, Redmond, WA") ed elaborare immediatamente la richiesta. Questo servizio è consigliato se è necessario geocodificare rapidamente singoli indirizzi.
• Get Search Address Structured: consente di specificare le parti di un singolo indirizzo, ad esempio via, città, paese e codice postale, e di elaborare immediatamente la richiesta. Questa API è consigliata se è necessario eseguire rapidamente la geocodifica di singoli indirizzi e i dati sono già analizzati nelle singole parti dell'indirizzo.
• Post Search Address Batch: consente di creare una richiesta contenente fino a 10.000 indirizzi e di elaborarla in un certo periodo di tempo. Viene eseguita la geocodifica di tutti gli indirizzi in parallelo nel server e, al termine dell'operazione, è possibile scaricare il set di risultati completo. Questa opzione è consigliata per la geocodifica di set di dati di grandi dimensioni.
• Get Search Fuzzy: questa API di ricerca fuzzy combina la geocodifica degli indirizzi con la ricerca di punti di interesse. Accetta una stringa in formato libero che può essere un indirizzo, un luogo, un punto di riferimento, un punto di interesse o una categoria di punti di interesse ed elabora immediatamente la richiesta. Questa API è consigliata per le applicazioni in cui gli utenti possono cercare indirizzi o punti di interesse dalla stessa casella di testo.
• Post Search Fuzzy Batch: usare una ricerca fuzzy batch per creare una richiesta contenente fino a 10.000 indirizzi, luoghi, punti di riferimento o punti di interesse e elaborarli in un certo periodo di tempo. Tutti i dati vengono elaborati in parallelo nel server e, al termine dell'operazione, è possibile scaricare il set di risultati completo.

La tabella seguente offre un riferimento incrociato dei parametri dell'API Google Maps e dei parametri equivalenti dell'API in Mappe di Azure.

Parametro API di Google Maps	Parametro API di Mappe di Azure equivalente
address	query
bounds	topLeft e btmRight
components	streetNumber streetName crossStreet postalCode municipality: città / paese municipalitySubdivision: quartiere, zona urbana/area metropolitana countrySubdivision: stato o provincia countrySecondarySubdivision: contea countryTertiarySubdivision: distretto countryCode: codice paese/area geografica di due lettere
key	subscription-key - Per altre informazioni, vedere Autenticazione con Mappe di Azure.
language	language - Per altre informazioni, vedere Supporto della localizzazione in Mappe di Azure.
region	countrySet

Per altre informazioni sull'uso del servizio di ricerca, vedere Cercare una posizione con i servizi di ricerca di Mappe di Azure. Assicurarsi di esaminare le procedure consigliate per la ricerca.

Suggerimento

Le API per la ricerca fuzzy e la geocodifica degli indirizzi in formato libero possono essere usate con la modalità di completamento automatico aggiungendo &typeahead=true all'URL della richiesta. Questo comunica al server che è probabile che il testo di input sia parziale e che la ricerca passerà quindi alla modalità predittiva.

Geocodifica inversa di una coordinata

La geocodifica inversa è il processo di conversione delle coordinate geografiche in un indirizzo approssimativo. Le coordinate con "longitudine: -122.1298, latitudine: 47.64005" vengono convertite in "1 Microsoft way, Redmond, WA".

Mappe di Azure offre numerosi metodi di geocodifica inversa:

• Get Search Address Reverse: consente di specificare una singola coordinata geografica per ottenere l'indirizzo approssimativo corrispondente alla coordinata. La richiesta viene elaborata quasi in tempo reale.
• Get Search Address Reverse Cross Street: consente di specificare una singola coordinata geografica per ottenere le informazioni sugli incroci adiacenti e di elaborare immediatamente la richiesta. Ad esempio, è possibile ottenere l'incrocio tra 1st Ave e Main St.
• Post Search Address Reverse Batch: crea una richiesta contenente fino a 10.000 coordinate da elaborare nel tempo. Tutti i dati verranno elaborati in parallelo nel server. Al termine della richiesta, è possibile scaricare l'intero set di risultati.

Questa tabella offre un riferimento incrociato dei parametri dell'API Google Maps e dei parametri equivalenti dell'API in Mappe di Azure.

Parametro API di Google Maps	Parametro API di Mappe di Azure equivalente
key	subscription-key - Per altre informazioni, vedere Autenticazione con Mappe di Azure.
language	language - Per altre informazioni, vedere Supporto della localizzazione in Mappe di Azure.
latlng	query
location_type	Non Applicabile
result_type	entityType

Per altre informazioni, vedere Procedure consigliate per la ricerca.

L'API di geocodifica inversa di Mappe di Azure include alcune funzionalità aggiuntive che non sono disponibili in Google Maps. Potrebbe risultare utile integrare queste funzionalità nell'applicazione durante la migrazione dell'app:

• Recupero dei dati sui limiti di velocità
• Recupero delle informazioni specifiche della strada: strada locale, arteria stradale, accesso limitato, rampa e così via
• Recupero del lato della strada in cui si trova una coordinata

Cercare i punti di interesse

È possibile cercare i dati del punto di interesse in Google Maps usando l'API di ricerca luoghi. Questa API offre tre modi diversi per cercare i punti di interesse:

• Ricerca un luogo dal testo: consente di cercare un punto di interesse in base al nome, all'indirizzo o al numero di telefono.
• Ricerca nelle vicinanze: consente di cercare i punti di interesse che si trovano entro una certa distanza da una posizione.
• Ricerca testuale: consente di cercare i luoghi usando un testo in formato libero contenente informazioni sul punto di interesse e sulla posizione. Ad esempio: "pizza a New York" o "ristoranti vicino a Main St".

Mappe di Azure offre numerose API di ricerca per i punti di interesse:

• Get Search POI: consente di cercare i punti di interesse in base al nome. Ad esempio: "Starbucks".
• Get Search POI Category: consente di cercare i punti di interesse in base alla categoria. Ad esempio: "ristorante".
• Get Search Nearby: consente di cercare i punti di interesse che si trovano entro una certa distanza da una posizione.
• Get Search Fuzzy: questa API di ricerca fuzzy combina la geocodifica degli indirizzi con la ricerca di punti di interesse. Accetta una stringa in formato libero che può essere un indirizzo, un luogo, un punto di riferimento, un punto di interesse o una categoria di punti di interesse ed elabora immediatamente la richiesta. Questa API è consigliata per le applicazioni in cui gli utenti possono cercare indirizzi o punti di interesse dalla stessa casella di testo.
• Post Search Inside Geometry: consente di cercare i punti di interesse all'interno di una geometria specificata. Ad esempio, cercare un punto di interesse all'interno di un poligono.
• Post Search Along Route: consente di cercare i punti di interesse lungo un percorso specificato.
• Post Search Fuzzy Batch: usare una ricerca fuzzy batch per creare una richiesta contenente fino a 10.000 indirizzi, luoghi, punti di riferimento o punti di interesse e elaborarli in un certo periodo di tempo. Tutti i dati vengono elaborati in parallelo nel server e, al termine dell'operazione, è possibile scaricare il set di risultati completo.

Attualmente Mappe di Azure non dispone di un'API equivalente all'API di ricerca testuale in Google Maps.

Suggerimento

Le API per la ricerca di punti di interesse, la ricerca per categoria di punti di interesse e la ricerca fuzzy possono essere usate con la modalità di completamento automatico aggiungendo &typeahead=true all'URL della richiesta. Questo comunica al server che è probabile che il testo di input sia parziale, quindi l'API eseguirà la ricerca nella modalità predittiva.

Per altre informazioni, vedere Procedure consigliate per la ricerca.

Trova il luogo dal testo

Usare Get Search POI e Get Search Fuzzy di Mappe di Azure per cercare i punti di interesse in base al nome o all’indirizzo.

La tabella offre un riferimento incrociato dei parametri dell'API Google Maps e dei parametri equivalenti dell'API di Mappe di Azure.

Parametro API di Google Maps	Parametro API di Mappe di Azure equivalente
fields	N/D
input	query
inputtype	N/D
key	subscription-key - Per altre informazioni, vedere Autenticazione con Mappe di Azure.
language	language - Per altre informazioni, vedere Supporto della localizzazione in Mappe di Azure.
locationbias	lat, lon e radius topLeft e btmRight countrySet

Ricerca nelle vicinanze

Usare l’API Get Search Nearby per recuperare i punti di interesse nelle vicinanze in Mappe di Azure.

La tabella mostra i parametri dell'API Google Maps e i parametri equivalenti dell'API di Mappe di Azure.

Parametro API di Google Maps	Parametro API di Mappe di Azure equivalente
key	subscription-key - Per altre informazioni, vedere Autenticazione con Mappe di Azure.
keyword	categorySet e brandSet
language	language - Per altre informazioni, vedere Supporto della localizzazione in Mappe di Azure.
location	lat e lon
maxprice	N/D
minprice	N/D
name	categorySet e brandSet
opennow	N/D
pagetoken	ofs e limit
radius	radius
rankby	N/D
type	categorySet – - Per altre informazioni, vedere Categorie di ricerca supportate.

Calcolare percorsi e indicazioni

Calcolare percorsi e indicazioni usando Mappe di Azure. Mappe di Azure offre numerose funzionalità equivalenti a quelle del servizio di pianificazione percorso di Google Maps, ad esempio:

• Orari di arrivo e di partenza.
• Percorsi basati sul traffico in tempo reale e predittivi.
• Modalità di trasporto diverse, Ad esempio, in auto, a piedi o in bicicletta.

Nota

Mappe di Azure richiede che tutti i punti di tragitto siano coordinate. Gli indirizzi devono prima essere geocodificati.

Il servizio di pianificazione percorso di Mappe di Azure fornisce le API seguenti per il calcolo dei percorsi:

• Get Route Directions: consente di calcolare un percorso e di elaborare immediatamente la richiesta. Questa API supporta le richieste GET e POST. Le richieste POST sono consigliate quando si specifica un numero elevato di punti di tragitto o quando si usano molte opzioni per il percorso per assicurarsi che la richiesta URL non diventi troppo lunga e causi problemi. La direzione del percorso POST in Mappe di Azure offre un'opzione che può contenere migliaia di punti di supporto e li usa per ricreare un percorso logico tra di essi (blocca sulla strada).
• Post Route Directions Batch: consente di creare una richiesta contenente fino a 1.000 richieste di percorso e di elaborarle in un certo periodo di tempo. Tutti i dati vengono elaborati in parallelo nel server e, al termine dell'operazione, è possibile scaricare il set di risultati completo.

La tabella offre un riferimento incrociato dei parametri dell'API Google Maps e dei parametri equivalenti dell'API in Mappe di Azure.

Parametro API di Google Maps	Parametro API di Mappe di Azure equivalente
alternatives	maxAlternatives
arrival_time	arriveAt
avoid	avoid
departure_time	departAt
destination	query: coordinate nel formato "lat0,lon0:lat1,lon1…."
key	subscription-key - Per altre informazioni, vedere Autenticazione con Mappe di Azure.
language	language - Per altre informazioni, vedere Supporto della localizzazione in Mappe di Azure.
mode	travelMode
optimize	computeBestOrder
origin	query
region	N/D: si tratta di una funzionalità relativa alla geocodifica. Usare il parametro countrySet quando si usa l'API di geocodifica di Mappe di Azure.
traffic_model	N/D: può specificare solo se usare o meno i dati del traffico con il parametro traffic.
units	N/A: Mappe di Azure usano solo il sistema metrico.
waypoints	query

Suggerimento

Per impostazione predefinita, l'API route di Mappe di Azure restituisce solo un riepilogo. Restituisce la distanza, i tempi e le coordinate dell'itinerario. Usare il parametro instructionsType per recuperare le istruzioni dettagliate. E usare il parametro routeRepresentation per filtrare il riepilogo e il percorso.

L'API di pianificazione percorso di Mappe di Azure include altre funzionalità che non sono disponibili in Google Maps. Quando si esegue la migrazione dell'app, valutare la possibilità di includere queste funzionalità:

• Supporto per il tipo di percorso: più breve, più veloce, più interessante/panoramico e con minore consumo di carburante.
• Supporto per altre modalità di viaggio: autobus, motocicletta, taxi, autocarro e furgone.
• Supporto per 150 punti di tragitto.
• Calcolo di più tempi di viaggio in un'unica richiesta. Traffico cronologico, traffico in tempo reale, senza traffico.
• Evitare altri tipi di strade: strade per il carpooling, strade non asfaltate, strade già usate.
• Possibilità di specificare aree personalizzate da evitare.
• Limitare l'elevazione consentita per il percorso.
• Percorso basato sulle specifiche del motore. Calcolo dei percorsi per veicoli a combustione o elettrici in base alle specifiche del motore e al carburante o alla carica rimanente.
• Supporto per i parametri dei percorsi per veicoli commerciali. Ad esempio, dimensioni del veicolo, peso, numero di assi e tipo di carico.
• Possibilità di specificare la velocità massima del veicolo.

Inoltre, il servizio di pianificazione del percorso in Mappe di Azure supporta Get Route Range. Il calcolo dei punti raggiungibili prende anche il nome di isocrone. Comporta la generazione di un poligono che copre un'area percorribile in qualsiasi direzione da un punto di partenza, Tutto entro una quantità di tempo, carburante o carica specificata.

Per altre informazioni, vedere Procedure consigliate per la pianificazione percorso.

Ottenere un'immagine della mappa

Mappe di Azure fornisce un'API per il rendering delle immagini statiche della mappa con i dati sovrapposti. L'API Get Map Static Image di Mappe di Azure è simile all'API mappa statica in Google Maps.

Nota

Mappe di Azure richiede che il centro, tutti i marker e le posizioni del percorso siano coordinate nel formato "longitudine, latitudine". mentre Google Maps usa il formato "latitudine,longitudine". È quindi prima necessario eseguire la geocodifica degli indirizzi.

La tabella offre un riferimento incrociato dei parametri dell'API Google Maps e dei parametri equivalenti dell'API in Mappe di Azure.

Parametro API di Google Maps	Parametro API di Mappe di Azure equivalente
center	center
format	format: specificato come parte del percorso URL. Attualmente è supportato solo il formato PNG.
key	subscription-key - Per altre informazioni, vedere Autenticazione con Mappe di Azure.
language	language - Per altre informazioni, vedere Supporto della localizzazione in Mappe di Azure.
maptype	layer e style - Per altre informazioni, vedere Stili mappa supportati.
markers	pins
path	path
region	N/D: funzionalità relativa alla geocodifica. Usare il parametro countrySet quando si usa l'API di geocodifica di Mappe di Azure.
scale	Non applicabile
size	width e height: le dimensioni massime sono 8192 x 8192.
style	N/D
visible	Non Disponibile
zoom	zoom

Nota

Nel sistema di tile di Azure Maps, i tile sono di dimensioni doppie rispetto alle tile di mappa utilizzate in Google Maps. Di conseguenza, il valore del livello di zoom in Mappe di Azure sarà maggiore di uno rispetto a Google Maps. Ridurre il livello di zoom di uno nelle richieste di cui si esegue la migrazione per compensare la differenza.

Per altre informazioni, vedere Eseguire il rendering di dati personalizzati in una mappa raster.

Oltre a poter generare un'immagine di mappa statica, il servizio Rendering mappe di Azure consente l'accesso diretto ai riquadri della mappa in formato raster (PNG) e vettoriale:

• Get Map Static Image: consente di recuperare le tessere raster (PNG) e vettoriali per le mappe di base (strade, confini, sfondo).
• Get Map Tile: consente di recuperare le tessere di immagini aeree e satellitari.

Suggerimento

Qualche anno fa, molte applicazioni di Google Maps sono passate da esperienze mappa interattive a immagini mappa statiche. per risparmiare sui costi. In Mappe di Azure è spesso più conveniente usare il controllo mappa interattivo in Web SDK, perché viene addebitato in base al numero di caricamenti delle tessere mappa. Le tessere mappa in Mappe di Azure sono di grandi dimensioni. Spesso sono necessarie solo poche tessere per ricreare la stessa visualizzazione di una mappa statica. Le tessere mappa vengono automaticamente memorizzate nella cache dal browser. Di conseguenza, il controllo mappa interattivo spesso genera solo una frazione di una transazione quando riproduce una visualizzazione mappa statica. Le operazioni di panoramica e zoom caricheranno più tessere, tuttavia nel controllo mappa sono disponibili opzioni per disabilitare questo comportamento. Il controllo mappa interattivo fornisce anche numerose altre opzioni di visualizzazione rispetto a quelle dei servizi mappa statici.

Confronto tra il formato dei parametri URL per i marcatori

In passato: Google Maps

Aggiungere gli indicatori usando il parametro markers nell'URL. Il parametro markers accetta uno stile e un elenco di posizioni in base a cui verrà eseguito il rendering sulla mappa, come illustrato di seguito:

&markers=markerStyles|markerLocation1|markerLocation2|...

Per usare altri stili, aggiungere i parametri markers all'URL con uno stile e un set di posizioni diversi.

Specificare le posizioni dell'indicatore con il formato "latitudine,longitudine".

Aggiungere gli stili degli indicatori utilizzando il formato optionName:value, con più stili separati dalla barra verticale (|), ad esempio: "optionName1:value1|optionName2:value2". Si noti che i nomi e i valori delle opzioni sono separati da due punti (:). Usare i nomi delle opzioni di stile seguenti per applicare uno stile agli indicatori in Google Maps:

• color: colore dell'icona predefinita dell'indicatore. Può essere un colore esadecimale a 24 bit (0xrrggbb) o uno dei valori seguenti: black, brown, green, purple, yellow, blue, gray, orange, red, white.
• label: singolo carattere alfanumerico maiuscolo da visualizzare nella parte superiore dell'icona.
• size: dimensioni dell'indicatore. Può essere tiny, mid o small.

Usare i nomi delle opzioni di stile seguenti per le icone personalizzate in Google Maps:

• anchor: specifica come allineare l'immagine dell'icona alla coordinata. Può essere un valore in pixel (x, y) o uno dei valori seguenti: top, bottom, left, right, center, topleft, topright, bottomleft o bottomright.
• icon: URL che punta all'immagine dell'icona.

Ad esempio, si supponga di aggiungere alla mappa un indicatore rosso di medie dimensioni in corrispondenza delle coordinate di longitudine: -110, latitudine: 45:

&markers=color:red|size:mid|45,-110

Dopo: Mappe di Azure

Aggiungere gli indicatori a un'immagine mappa statica specificando il parametro pins nell'URL. Come in Google Maps, specificare uno stile e un elenco di posizioni nel parametro. Il parametro pins può essere specificato più volte per supportare gli indicatori con stili diversi.

&pins=iconType|pinStyles||pinLocation1|pinLocation2|...

Per usare altri stili, aggiungere altri parametri pins all'URL con uno stile e un set di posizioni diversi.

In Mappe di Azure la posizione del segnaposto deve essere espressa nel formato "longitudine latitudine". mentre Google Maps usa il formato "latitudine,longitudine". Nel formato di Mappe di Azure la longitudine e la latitudine sono separate da uno spazio, anziché da una virgola.

iconType specifica il tipo di pin da creare. I valori possibili sono i seguenti:

• default: icona predefinita del segnaposto.
• none: nessuna icona visualizzata. Verrà eseguito solo il rendering delle etichette.
• custom: specifica che è necessario usare un'icona personalizzata. È possibile aggiungere un URL che punta all'immagine dell'icona alla fine del parametro pins dopo le informazioni sulla posizione del segnaposto.

Aggiungere gli stili dei segnaposto con il formato optionNameValue. Separare più stili con la barra verticale (|). Ad esempio: iconType|optionName1Value1|optionName2Value2. I nomi e i valori delle opzioni non sono separati. Usare i nomi delle opzioni di stile seguenti per applicare lo stile agli indicatori:

• al: specifica l'opacità (alfa) dell'indicatore. Scegliere un numero compreso tra 0 e 1.
• an: specifica l'ancoraggio del segnaposto. Specificare i valori dei pixel x e y nel formato "x y".
• co – Il colore del perno. Specificare un colore esadecimale a 24 bit: da 000000 a FFFFFF.
• la – Specifica l'ancoraggio per l'etichetta. Specificare i valori dei pixel x e y nel formato "x y".
• lc: colore dell'etichetta. Specificare un colore esadecimale a 24 bit: da 000000 a FFFFFF.
• ls: dimensioni dell'etichetta in pixel. Scegliere un numero maggiore di 0.
• ro: valore in gradi per la rotazione dell'icona. Scegliere un numero compreso tra -360 e 360.
• sc: valore di scala per l'icona della puntina. Scegliere un numero maggiore di 0.

Specificare i valori delle etichette per ogni posizione del pin. Questo approccio è più efficiente rispetto all'applicazione di un singolo valore di etichetta a tutti gli indicatori nell'elenco di posizioni. Il valore dell'etichetta può essere una stringa di più caratteri. Racchiudere la stringa tra virgolette singole per assicurarsi che non venga scambiata per un valore di stile o di posizione.

Ora verrà aggiunta un'icona predefinita rossa (FF0000) con l'etichetta "Space Needle", posizionata sotto (15 50). L'icona è posizionata in corrispondenza delle coordinate di longitudine: -122.349300, latitudine: 47.620180:

&pins=default|coFF0000|la15 50||'Space Needle' -122.349300 47.620180

Aggiungere tre pin con le etichette con i valori "1", "2" e "3":

&pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

Confronto del formato dei parametri URL del percorso

In passato: Google Maps

Aggiungere linee e poligoni a un'immagine mappa statica usando il parametro path nell'URL. Il parametro path accetta uno stile e un elenco di posizioni il cui rendering verrà eseguito sulla mappa:

&path=pathStyles|pathLocation1|pathLocation2|...

Usare altri stili aggiungendo altri parametri path all'URL con uno stile e un set di posizioni diversi.

Le posizioni dei percorsi sono specificate con il formato latitude1,longitude1|latitude2,longitude2|…. I percorsi possono essere codificati o contenere gli indirizzi per i punti.

Aggiungere gli stili del percorso con il formato optionName:value e separare più stili con la barra verticale (|). Infine, separare i nomi e i valori delle opzioni con i due punti (:). Ad esempio: optionName1:value1|optionName2:value2. È possibile usare i nomi delle opzioni di stile seguenti per applicare uno stile ai percorsi in Google Maps:

• color: colore del percorso o del contorno del poligono. Può essere un colore esadecimale a 24 bit (0xrrggbb), un colore esadecimale a 32 bit (0xrrggbbbaa) o uno dei valori seguenti: nero, marrone, verde, viola, giallo, blu, grigio, arancione, rosso, bianco.
• fillColor: colore di riempimento dell'area del percorso (poligono). Può essere un colore esadecimale a 24 bit (0xrrggbb), un colore esadecimale a 32 bit (0xrrggbbbaa) o uno dei valori seguenti: nero, marrone, verde, viola, giallo, blu, grigio, arancione, rosso, bianco.
• geodesic: indica se il percorso deve essere una linea che segue la curvatura della terra.
• weight: spessore della linea del percorso in pixel.

Aggiungere alla mappa l'opacità della linea rossa e lo spessore in pixel tra le coordinate nel parametro URL. Nell'esempio seguente, la linea ha un'opacità del 50% e uno spessore di quattro pixel. Le coordinate sono longitudine: -110, latitudine: 45 e longitudine: -100, latitudine: 50.

&path=color:0xFF000088|weight:4|45,-110|50,-100

Dopo: Mappe di Azure

Aggiungere le linee e i poligoni a un'immagine mappa statica specificando il parametro path nell'URL. Come in Google Maps, specificare uno stile e un elenco di posizioni nel parametro. Specificare il parametro path più volte per eseguire il rendering di più cerchi, linee e poligoni con stili diversi.

&path=pathStyles||pathLocation1|pathLocation2|...

Per le posizioni dei percorsi, Mappe di Azure richiede che le coordinate siano espresse nel formato "longitudine latitudine". mentre Google Maps usa il formato "latitudine,longitudine". Nel formato di Mappe di Azure la longitudine e la latitudine sono separate da uno spazio, anziché da una virgola. Mappe di Azure non supporta percorsi o indirizzi codificati per i punti.

Aggiungere gli stili dei percorsi con il formato optionNameValue. Separare più stili con il carattere pipe (|), in questo modo: optionName1Value1|optionName2Value2. I nomi e i valori delle opzioni non sono separati. Usare i nomi delle opzioni di stile seguenti per applicare uno stile ai percorsi in Mappe di Azure:

• fa: opacità del colore di riempimento (alfa) usata per il rendering dei poligoni. Scegliere un numero compreso tra 0 e 1.
• fc: colore di riempimento usato per il rendering dell'area di un poligono.
• la: opacità del colore della linea (alfa) usata per il rendering delle linee e del contorno dei poligoni. Scegliere un numero compreso tra 0 e 1.
• lc: colore della linea usato per il rendering delle linee e del contorno dei poligoni.
• lw: larghezza della linea in pixel.
• ra: specifica il raggio di un cerchio in metri.

Aggiungere un'opacità della linea rossa e uno spessore in pixel tra le coordinate nel parametro URL. Nell'esempio seguente, la linea ha un'opacità del 50% e uno spessore di quattro pixel. Le coordinate hanno i valori seguenti: longitudine: -110, latitudine: 45 e longitudine: -100, latitudine: 50.

&path=lcFF0000|la.5|lw4||-110 45|-100 50

Calcolare una matrice di distanze

Mappe di Azure fornisce l'API della matrice di distanze. Usare questa API per calcolare i tempi di viaggio e le distanze tra un set di posizioni, con una matrice di distanze. È simile all'API per la matrice di distanze in Google Maps.

• Post Route Matrix: consente di calcolare in modo asincrono i tempi di percorrenza e le distanze per un set di origini e destinazioni. Supporta fino a 700 celle per richiesta ed equivale al numero di origini moltiplicato per il numero di destinazioni. Tenendo presente questo vincolo, gli esempi di possibili dimensioni della matrice sono: 700x1, 50x1, 10x10, 28x25, 10x70.

Nota

È possibile inviare una richiesta all'API della matrice di distanze solo usando una richiesta POST con le informazioni sull'origine e sulla destinazione nel corpo della richiesta. Mappe di Azure richiede inoltre che tutte le origini e le destinazioni siano coordinate. È quindi prima necessario eseguire la geocodifica degli indirizzi.

Questa tabella offre un riferimento incrociato dei parametri dell'API Google Maps e dei parametri equivalenti dell'API di Mappe di Azure.

Parametro API di Google Maps	Parametro API di Mappe di Azure equivalente
arrival_time	arriveAt
avoid	avoid
departure_time	departAt
destinations	destination: specificare come GeoJSON nel corpo della richiesta POST.
key	subscription-key - Per altre informazioni, vedere Autenticazione con Mappe di Azure.
language	language - Per altre informazioni, vedere Supporto della localizzazione in Mappe di Azure.
mode	travelMode
origins	origins: specificare nel corpo della richiesta POST come GeoJSON.
region	N/D: si tratta di una funzionalità relativa alla geocodifica. Usare il parametro countrySet quando si usa l'API di geocodifica di Mappe di Azure.
traffic_model	N/D: può specificare solo se usare o meno i dati del traffico con il parametro traffic.
transit_mode	N/D: le matrici di distanze basate su transito non sono attualmente supportate.
transit_routing_preference	N/D: le matrici di distanze basate su transito non sono attualmente supportate.
units	N/D: Azure Maps usa solo il sistema metrico.

Suggerimento

Tutte le opzioni di pianificazione percorso avanzate disponibili nell'API di pianificazione percorso di Mappe di Azure sono supportate nell'API della matrice di distanze di Mappe di Azure. Le opzioni di pianificazione percorso avanzate includono: percorso autocarro, specifiche del motore e così via.

Per altre informazioni, vedere Procedure consigliate per la pianificazione percorso.

Ottenere un fuso orario

Mappe di Azure fornisce un'API per il recupero del fuso orario di una coordinata. L'API fusi orari di Mappe di Azure è simile all'API fusi orari in Google Maps:

• Get TimeZone By Coordinates: consente di specificare una coordinata e ricevere i dettagli del fuso orario della coordinata.

Questa tabella offre un riferimento incrociato dei parametri dell'API Google Maps e dei parametri equivalenti dell'API in Mappe di Azure.

Parametro API di Google Maps	Parametro API di Mappe di Azure equivalente
key	subscription-key - Per altre informazioni, vedere Autenticazione con Mappe di Azure.
language	language - Per altre informazioni, vedere Supporto della localizzazione in Mappe di Azure.
location	query
timestamp	timeStamp

Oltre a questa API, Mappe di Azure fornisce diverse API per i fusi orari. Queste API convertono l'ora in base ai nomi o agli ID del fuso orario:

• Get Timezone By ID: restituisce le informazioni sul fuso orario correnti, cronologiche e future per l'ID del fuso orario IANA specificato.
• Get Timezone Enum IANA: restituisce un elenco completo di ID di fusi orari IANA. Gli aggiornamenti al servizio IANA si riflettono nel sistema entro un giorno.
• Get Timezone Enum Windows: restituisce un elenco completo degli ID di fusi orari Windows.
• Get Timezone IANA Version: Restituisce il numero di versione IANA corrente usato da Azure Maps.
• Get Timezone Windows to IANA: restituisce un ID IANA corrispondente se si specifica un ID di fuso orario Windows valido. Per un singolo ID Windows è possibile che vengano restituiti più ID IANA.

Librerie client

Mappe di Azure fornisce le librerie client per i linguaggi di programmazione seguenti:

• JavaScript, TypeScript, Node.js – Modulo dei servizi di Mappe di Azure | Pacchetto npm

Queste librerie client open source sono destinate ad altri linguaggi di programmazione:

• .NET Standard 2.0 - Progetto GitHub | Pacchetto NuGet

Pulire le risorse

Nessuna risorsa da pulire.

Passaggi successivi

Altre informazioni sui servizi REST di Mappe di Azure:

Procedure consigliate per la ricerca