Panoramica dell'API Distance Matrix

L'API Distance Matrix è un servizio che accetta una richiesta HTTPS contenente origini e destinazioni per una determinata modalità di trasporto. Per ogni combinazione di partenza 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 di viaggio 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 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 sulle distanze:

  • Distanza per una modalità di viaggio selezionata
  • Distanza in chilometri o miglia
  • Tempo di percorrenza stimato in base al traffico

mappa che mostra la stazione di partenza e le destinazioni su una mappa e nella risposta dell'API

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 gradualmente alla 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 le origini e le destinazioni sotto forma di ID luogo, indirizzi o coordinate di latitudine/longitudine.

  • Distanza e tempo di percorrenza tra ogni origine e ogni destinazione
  • Durata nel traffico se hai specificato la modalità di guida e un momento di partenza
  • JSON
  • XML

Come utilizzare l'API Distance Matrix

1 Esegui la configurazione. Per iniziare, consulta la sezione Configurare il 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 browser. Per esempi, consulta la sezione Richieste di esempio nella guida Guida introduttiva.
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'ora di partenza specificata o le restrizioni del percorso. Consulta la sezione Parametri facoltativi nella guida Richiesta e risposta di Distance Matrix.
4 Informazioni di base sulle risposte Esplora le risposte dei dati per prepararti a utilizzare i dati della matrice di distanza per la tua app. Per maggiori dettagli, consulta Risposte della matrice di distanza.
5 Incorpora i dati della matrice di distanza 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 tuo interesse tramite una delle seguenti librerie client:

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