Introduzione
L'API Distance Matrix (legacy) è un servizio che accetta una richiesta HTTPS contenente origini e destinazioni per una determinata modalità di trasporto. Per ogni
combinazione di origine e destinazione, restituisce la distanza e la durata del viaggio.
Perché utilizzare l'API Distance Matrix
Puoi utilizzare l'API Distance Matrix per determinare i percorsi più efficienti tra più origini e destinazioni possibili. Ad esempio, quali lavoratori inviare ai cantieri o da quali magazzini spedire i pacchi.
Cosa puoi fare con l'API Distance Matrix
Con l'API Distance Matrix, puoi fornire la distanza e il tempo di percorrenza per una matrice di origini e destinazioni. Puoi specificare diverse opzioni, tra cui la modalità di trasporto, ad esempio auto, bicicletta, trasporto pubblico o a piedi, nonché le modalità di trasporto pubblico, ad esempio autobus, metro, treno, tram o ferrovia.
L'API Distance Matrix fornisce informazioni basate sull'itinerario consigliato tra i punti di partenza e di arrivo. Puoi richiedere i seguenti tipi di dati sulla distanza:
- Distanza per una modalità di viaggio selezionata
- Distanza in chilometri o miglia
- Tempo di percorrenza stimato nel traffico
Come funziona l'API Distance Matrix
L'API Distance Matrix utilizza un numero qualsiasi di origini (punti di partenza) e destinazioni e restituisce la distanza e il tempo di percorrenza tra ogni origine e tutte le destinazioni richieste, a partire dalla prima origine nella richiesta e procedendo passo dopo passo alla successiva.
Ad esempio, se la richiesta specifica A e B come origini e C e D come destinazioni, restituisce distanze e tempo di percorrenza in questo ordine:
- Da A a C
- Da A a D
- B2C
- Da B a D
L'esempio seguente mostra una richiesta per due origini: Washington, DC e Boston, con una singola destinazione, New York City, NY, in formato JSON:
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=New%20York%20City%2C%20NY &origins=Washington%2C%20DC%7CBoston &units=imperial &key=YOUR_API_KEY
Risorse
La tabella seguente riepiloga le risorse disponibili tramite l'API Distance Matrix e i dati che restituisce.
Risorse di dati | Dati restituiti | Formato del reso |
---|---|---|
Distance Matrix
Origini e destinazioni della fornitura sotto forma di ID luogo, indirizzi o coordinate di latitudine/longitudine. |
|
|
Come utilizzare l'API Distance Matrix
1 | Configurazione | Inizia con Configurare il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito. |
2 | Prova una richiesta di matrice delle distanze | Una volta ottenuta una chiave API, puoi iniziare a testare l'API Distance Matrix direttamente dal browser. Per esempi, consulta la sezione Richieste di esempio della guida Guida introduttiva. |
3 | Scrivere una richiesta più complessa | Prova una richiesta che fornisca più origini e destinazioni. Scopri i parametri facoltativi per vincolare i calcoli, ad esempio un orario di partenza specificato o restrizioni del percorso. Consulta la sezione Parametri facoltativi nella guida Richiesta e risposta della matrice delle distanze. |
4 | Informazioni di base sulle risposte | Esplora le risposte ai dati per prepararti a utilizzare i dati della matrice delle distanze per la tua app. Per maggiori dettagli, consulta Risposte della matrice delle distanze. |
5 | Incorpora i dati della matrice delle distanze nella tua app. | Puoi utilizzare questi dati per calcolare la distanza e il tempo di percorrenza. |
Librerie client disponibili
Chiama questa API nella lingua di tua scelta tramite una delle seguenti librerie client:
- Java Client per i servizi Google Maps
- Client Python per i servizi Google Maps
- Go Client per i servizi Google Maps
- Node.js Client per i servizi Google Maps
I client Java, Python, Go e Node.js per i servizi Google Maps sono librerie client supportate dalla community, open source con licenza Apache 2.0. Scaricali da GitHub, dove puoi trovare anche le istruzioni di installazione e il codice campione.
Passaggi successivi
- Inizia a utilizzare Distance Matrix: vai a Inizia.
- Inizia a utilizzare richieste e risposte di esempio: vai a Richiesta e risposta di Distance Matrix.
- Segui le best practice: vai a Best practice per i servizi web.