Panoramica dell'API Directions (legacy)

Sviluppatori dello Spazio economico europeo (SEE)

L'API Directions (legacy) è un servizio che accetta una richiesta HTTP e restituisce indicazioni stradali in formato JSON o XML tra le località.

Perché utilizzare l'API Directions (legacy)

Con l'API Directions (legacy), puoi ottenere indicazioni stradali per diverse modalità di trasporto, ad esempio trasporto pubblico, auto, percorsi a piedi o in bicicletta.

Cosa puoi fare con l'API Directions (legacy)?

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

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

Come funziona l'API Directions (legacy)

L'API Directions (legacy) restituisce i percorsi più efficienti quando calcola le indicazioni stradali. Il prodotto tiene conto dei seguenti elementi di viaggio quando determina il percorso più efficiente:

  • Tempo di percorrenza (primario)
  • Distanza
  • Numero di giri

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

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

Risorse

La tabella seguente riepiloga le risorse disponibili tramite l'API Directions (legacy) insieme ai dati che restituisce.

Risorse dati Dati restituiti Formato di restituzione
Indicazioni

Fornisci origini e destinazioni sotto forma di ID luogo, indirizzi, o coordinate di latitudine/longitudine. Per i dettagli, consulta i parametri obbligatori.

Indicazioni stradali dettagliate, suddivise in percorsi, tratte e passaggi. Per i dettagli, consulta Risposte di Directions.
  • JSON
  • XML

Come utilizzare l'API Directions (legacy)

1 Inizia la configurazione Inizia con Configura il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito.
2 Prova la demo Una volta che hai una chiave API e un progetto cloud, puoi provare la demo delle indicazioni stradali senza costi. Consulta la demo dell'API Directions (legacy).
3 Crea una richiesta Consulta le richieste di esempio e scopri le opzioni disponibili che puoi fornire, come modalità di viaggio, tappe e restrizioni del percorso. Consulta gli esempi di Directions.
4 Comprendi le nozioni di base sulle risposte Esplora le risposte ai dati per prepararti a utilizzare i dati delle indicazioni stradali per la tua app. Per i dettagli, consulta Risposte di Directions.
5 Incorpora i dati delle indicazioni stradali 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:

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 campione.

Passaggi successivi