Perché utilizzare l'API Distance Matrix
Puoi utilizzare l'API Distance Matrix per determinare qual è la soluzione più efficiente itinerari di viaggio tra più possibili origini e destinazioni. Per ad esempio quali lavoratori inviare ai siti di lavoro o da quali magazzini inviare .
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: mezzo di trasporto, ad esempio auto, bicicletta, trasporto pubblico o a piedi, nonché Modalità di trasporto pubblico, come autobus, metropolitana, treno, tram o treno.
L'API Distance Matrix fornisce informazioni basate sul percorso consigliato tra il punto di partenza e quello 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 loro e tutte le destinazioni richieste, a partire dalla prima in la richiesta e procedere con il passo successivo.
Ad esempio, se la tua 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
- Da B a C
- Da B a D
L'esempio seguente mostra una richiesta per due origini: Washington, DC e Boston con un'unica destinazione, New York City, NY, nel 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 API Distance Matrix insieme ai dati che restituisce.
Risorse di dati | Dati restituiti | Formato di reso |
---|---|---|
Matrice delle distanze
Origini e destinazioni delle forniture sotto forma di ID luogo, indirizzi, o coordinate di latitudine/longitudine. |
|
|
Come utilizzare l'API Distance Matrix
1 | Configurazione. | Inizia con l'articolo Configura il tuo Progetto Google Cloud e completare la configurazione istruzioni che seguono. |
2 | Prova una richiesta di matrice delle distanze | Una volta ottenuta una chiave API, puoi iniziare a testare l'API Distance Matrix direttamente dal tuo browser. Vedi Richieste di esempio nella Guida introduttiva per vedere alcuni esempi. |
3 | Scrivere una richiesta più complessa | Prova una richiesta che fornisca più origini e destinazioni. Impara sui parametri facoltativi per vincolare i calcoli, come orario di partenza o limitazioni del percorso. Vedi Parametri facoltativi nella guida Richiesta e risposta di Distance Matrix. |
4 | Nozioni di base sulle risposte | Esplora le risposte dei dati per prepararti a utilizzare i dati della matrice delle distanze per la tua app. Consulta Risposte della matrice delle distanze per maggiori dettagli. |
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 la tua scelta tramite una delle seguenti librerie client:
- Java Client per i servizi Google Maps
- Python Client per i servizi Google Maps
- Client Go per i servizi Google Maps
- Node.js Client per i servizi Google Maps
Client Java, client Python, client Go e client Node.js per Google Maps I servizi sono librerie client supportate dalla community, open source secondo Licenza Apache 2.0. Scaricale da GitHub, dove puoi trovare anche le istruzioni per l'installazione e il codice di esempio.
Passaggi successivi
- Inizia a utilizzare la matrice delle distanze: vai a Inizia.
- Per iniziare a utilizzare richieste e risposte di esempio, vai a Distance Matrix. richiesta e risposta
- Segui le best practice: vai a Web Service Best Pratiche.