Panoramica dell'API Directions

L'API Directions è un servizio che accetta una richiesta HTTP e restituisce indicazioni in formato JSON o XML tra le posizioni.

Perché utilizzare l'API Directions

Con l'API Directions puoi ottenere le indicazioni stradali per diverse modalità di trasporto, ad esempio con il trasporto pubblico, in auto, a piedi o in bicicletta.

Cosa puoi fare con l'API Directions?

Con l'API Directions, puoi calcolare le indicazioni stradali tra le località, inclusi i seguenti dettagli:

  • Indicazioni stradali per diverse modalità di trasporto, tra cui trasporto pubblico, in auto, a piedi o in bicicletta.
  • Indicazioni stradali multiple utilizzando una serie di waypoint.
  • Specifica origini, destinazioni e waypoint in diversi modi, ad esempio come stringhe di testo (ad esempio "Chicago, IL" o "Darwin, NT, Australia"), ID luogo o coordinate di latitudine e longitudine.

Come funziona l'API Directions

L'API Directions restituisce i percorsi più efficienti durante il calcolo delle indicazioni stradali. Per determinare il percorso più efficiente, il prodotto tiene conto dei seguenti elementi di viaggio:

  • Tempo di percorrenza (principale)
  • Distanza
  • Numero di svolte

La seguente richiesta di esempio restituisce indicazioni stradali in formato JSON da Toronto, Ontario a Montreal, Québec:

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

Risorse

La seguente tabella riassume le risorse disponibili tramite l'API Directions insieme ai dati che restituisce.

Risorse di dati Dati restituiti Formato restituito
trasporto pubblico

Fornisci i luoghi di partenza e di destinazione sotto forma di ID luogo, indirizzi o coordinate di latitudine e longitudine. Per informazioni dettagliate, consulta i parametri obbligatori.

Indicazioni stradali dettagliate, suddivise in percorsi, tappe e passi. Per maggiori dettagli, vedi Risposte con indicazioni stradali.
  • JSON
  • XML

Come utilizzare l'API Directions

1 Preparati. Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione che seguono.
2 Prova la demo Dopo aver ottenuto una chiave API e un progetto cloud, puoi provare la demo delle indicazioni senza costi aggiuntivi. Guarda la demo dell'API Directions.
3 Crea una richiesta Consulta le richieste di esempio e scopri le opzioni disponibili che puoi fornire, ad esempio modalità di viaggio, waypoint e limitazioni di percorso. Guarda gli esempi di indicazioni stradali.
4 Informazioni di base sulle risposte Esplora le risposte sui dati per prepararti a utilizzare i dati delle indicazioni stradali per la tua app. Per informazioni dettagliate, consulta la pagina relativa alle risposte alle indicazioni stradali.
5 Incorpora i dati delle indicazioni stradali nella tua app. Puoi utilizzare questi dati per calcolare la distanza e il tempo da percorrere.

Librerie client disponibili

Chiama questa API nel linguaggio 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 e open source secondo la licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare istruzioni per l'installazione e codice di esempio.

Passaggi successivi