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à di trasporto pubblico, come autobus, metropolitana, treno, tram o ferrovia.

L'API Distance Matrix (legacy) fornisce informazioni basate sul percorso consigliato tra i punti di partenza e di arrivo. Puoi richiedere questi tipi di dati sulla distanza:

  • Distanza per una modalità di spostamento 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 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:

  • Da A a C
  • Da A a D
  • Da B a 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 dati Dati restituiti Formato di restituzione
Matrice delle distanze

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à di 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 di matrice delle distanze Una volta ottenuta una chiave API, puoi iniziare a testare l'API Distance Matrix (legacy) direttamente dal browser. Per esempi, consulta Richieste di esempio nella guida Per iniziare.
3 Scrivi 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 Parametri facoltativi nella guida Richiesta e risposta di Distance Matrix (legacy).
4 Comprendi le nozioni 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 che preferisci 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 con licenza Apache 2.0. Scaricale da GitHub, dove puoi trovare anche le istruzioni di installazione e il codice campione.

Passaggi successivi