Perché utilizzare l'API Distance Matrix
Puoi utilizzare l'API Distance Matrix per determinare i percorsi di viaggio più efficienti tra più origini e destinazioni possibili. ad esempio quali worker inviare ai siti di lavoro o da quali magazzini inviare 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 guidare, andare in bicicletta, utilizzare il trasporto pubblico o camminare, nonché le modalità di trasporto pubblico, ad esempio autobus, metropolitana, treno, tram o ferrovia.
L'API Distance Matrix fornisce informazioni in base al percorso 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 in base al 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 proseguendo gradualmente a quella successiva.
Ad esempio, se la richiesta specifica A e B come origini e C e D come destinazioni, restituisce le distanze e il tempo di percorrenza in questo ordine:
- Dalla A alla C
- Dalla A alla D
- B to C
- Da B a D
L'esempio seguente mostra una richiesta per due città di partenza: Washington DC e Boston, con una singola destinazione, New York, 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 riassume le risorse disponibili tramite l'API Distance Matrix e i dati restituiti.
Risorse di dati | Dati restituiti | Formato di reso |
---|---|---|
Matrice di distanza
Fornisci origini e destinazioni sotto forma di ID luogo, indirizzi o coordinate di latitudine/longitudine. |
|
|
Come utilizzare l'API Distance Matrix
1 | Esegui la configurazione. | Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito. |
2 | Prova una richiesta di matrice di distanza | Una volta ottenuta una chiave API, puoi iniziare a testare l'API Distance Matrix direttamente dal tuo browser. Consulta Richieste di esempio nella guida Inizia per alcuni esempi. |
3 | Creare una richiesta più complessa | Prova una richiesta che fornisca più origini e destinazioni. Scopri di più sui parametri facoltativi per limitare i calcoli, ad esempio un orario di partenza specificato o limitazioni di percorso. Consulta Parametri facoltativi nella guida Richiesta e risposta di Matrice delle distanze. |
4 | Informazioni di base sulle risposte | Esplora le risposte dei 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 nel linguaggio che preferisci tramite una delle seguenti librerie client:
- Client Java per i servizi Google Maps
- Client Python per i servizi Google Maps
- Go Client per i servizi Google Maps
- Client Node.js per i servizi Google Maps
Il client Java, il client Python, il client Go e il client Node.js per i servizi Google Maps sono librerie client supportate dalla community, open source ai sensi della licenza Apache 2.0. Scaricali da GitHub, dove puoi trovare anche le istruzioni di installazione e il codice di esempio.
Passaggi successivi
- Inizia a utilizzare la Matrice delle distanze: vai a Inizia.
- Inizia a utilizzare richieste e risposte di esempio: vai a Richiesta e risposta della matrice di distanza
- Segui le best practice: vai a Best practice per i servizi web.