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 viaggio 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, 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 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 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 di distanza

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 di Distance Matrix 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 di più sui 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 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 viaggio.

Librerie client disponibili

Chiama questa API nella lingua che preferisci tramite una delle seguenti librerie client:

Java Client, Python Client, Go Client e Node.js Client for Google Maps Services sono librerie client supportate dalla community, open source con licenza Apache 2.0. Scaricale da GitHub, dove puoi trovare anche istruzioni di installazione e codice di esempio.

Passaggi successivi