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. |
|
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:
- Client Java per i servizi Google Maps
- Client Python per i servizi Google Maps
- Go Client per i servizi Google Maps
- Client Node.js per i servizi Google Maps
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
- Inizia a utilizzare l'API Directions: vai a Inizia.
- Inizia a inviare richieste di indicazioni stradali: vai alla sezione Indicazioni stradali.
- Seguire le best practice: vai a Best practice per i servizi web.