Panoramica dell'API Distance Matrix (legacy)

Sviluppatori dello Spazio economico europeo (SEE)

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 (Legacy)

Puoi utilizzare l'API Distance Matrix (Legacy) 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 inviare i pacchi.

Cosa puoi fare con l'API Distance Matrix (legacy)

Con l'API Distance Matrix (Legacy), 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à Mezzi pubblici, ad esempio autobus, metropolitana, treno, tram o ferrovia.

L'API Distance Matrix (Legacy) 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 nel traffico

Mappa che mostra l'origine e le destinazioni su una mappa e nella risposta dell'API

Come funziona l'API Distance Matrix (legacy)

L'API Distance Matrix (Legacy) 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 verso la 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:

  • Da A a C
  • Da A a D
  • B to C
  • 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 riassume le risorse disponibili tramite l'API Distance Matrix (legacy) insieme ai dati che restituisce.

Risorse di dati Dati restituiti Formato di reso
Distance Matrix

Fornisci origini e 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à Guida e un orario di partenza
  • JSON
  • XML

Come utilizzare l'API Distance Matrix (legacy)

1 Configurazione Inizia con Configura il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito.
2 Prova una richiesta Distance Matrix Una volta ottenuta una chiave API, puoi iniziare a testare l'API Distance Matrix (Legacy) direttamente dal tuo browser. Per esempi, consulta Richieste di esempio nella guida Inizia.
3 Scrivi una richiesta più complessa Prova una richiesta che fornisca più origini e destinazioni. Scopri i parametri facoltativi per limitare i calcoli, ad esempio un orario di partenza specificato o limitazioni del percorso. Consulta la sezione Parametri facoltativi nella guida Richiesta e risposta di Distance Matrix (Legacy).
4 Nozioni di base sulle risposte Esplora le risposte dei dati per prepararti a utilizzare i dati di Distance Matrix per la tua app. Per maggiori dettagli, consulta Risposte di Distance Matrix.
5 Incorpora i dati di Distance Matrix nella tua app. Puoi utilizzare questi dati per calcolare la distanza e il tempo di viaggio.

Librerie client disponibili

Chiama questa API nel linguaggio che preferisci tramite una delle seguenti librerie client:

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