Questo prodotto o questa funzionalità è in stato legacy. Per ulteriori informazioni sullo stato legacy e su come eseguire la migrazione dai servizi legacy a quelli più recenti, consulta
Prodotti e funzionalità legacy.
Panoramica dell'API Directions (legacy)
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Sviluppatori dello Spazio economico europeo (SEE)
L'API Directions (legacy) è un servizio che accetta una richiesta HTTP e restituisce indicazioni stradali tra località in formato JSON o XML.
Perché utilizzare l'API Directions
Con l'API Directions, puoi ottenere indicazioni stradali per diverse modalità di trasporto, ad esempio trasporto pubblico, auto, percorsi a piedi o in bicicletta.
Che 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 mezzi pubblici, auto,
a piedi o in bicicletta.
- Indicazioni in più parti che utilizzano una serie di waypoint.
- Specifica origini, destinazioni e tappe in vari 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
L'API Directions restituisce i percorsi più efficienti quando
calcola le indicazioni stradali. Il prodotto prende in considerazione i seguenti elementi di viaggio
quando determina il percorso più efficiente:
- Tempo di percorrenza (principale)
- 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 e i dati che restituisce.
| Risorse di dati |
Dati restituiti |
Formato del reso |
| Indicazioni
Origini e destinazioni della fornitura sotto forma di ID luogo, indirizzi o coordinate di latitudine/longitudine. Per ulteriori dettagli, consulta i parametri obbligatori.
|
Indicazioni stradali dettagliate, suddivise in itinerari, tratte e passaggi. Consulta la sezione
Risposte sugli itinerari per i dettagli.
|
|
Come utilizzare l'API Directions
| 1 |
Inizia la configurazione. |
Inizia con Configurare il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito. |
| 2 |
Prova la demo |
Una volta ottenuta una chiave API e un progetto cloud, puoi provare
la demo delle indicazioni senza costi. Consulta la demo dell'API Directions.
|
| 3 |
Creare una richiesta |
Consulta le richieste di esempio e scopri le opzioni disponibili che puoi fornire, come modalità di viaggio, waypoint e limitazioni del percorso. Vedi esempi di indicazioni stradali.
|
| 4 |
Informazioni di base sulle risposte |
Esplora le risposte ai dati per prepararti a utilizzare i dati sulle indicazioni per la tua app. Per maggiori dettagli, consulta la sezione
Risposte alle indicazioni.
|
| 5 |
Integra i dati sulle indicazioni nella tua app. |
Puoi utilizzare questi dati per calcolare la distanza e il tempo di percorrenza.
|
Librerie client disponibili
Chiama questa API nella lingua di tua scelta tramite una delle seguenti librerie client:
I client Java, Python, Go e Node.js per i servizi Google Maps sono librerie client supportate dalla community, open source con licenza Apache 2.0.
Scaricali da GitHub, dove puoi trovare anche le istruzioni di installazione e il codice campione.
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 2025-08-31 UTC."],[[["\u003cp\u003eThe Directions API provides route information between locations using various transportation modes like driving, walking, transit, or bicycling.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize your requests by specifying origins, destinations, waypoints, and travel preferences.\u003c/p\u003e\n"],["\u003cp\u003eThe API calculates the most efficient routes based on travel time, distance, and the number of turns.\u003c/p\u003e\n"],["\u003cp\u003eResults are available in JSON or XML format and include detailed directions, routes, legs, and steps.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js for easy integration into your applications.\u003c/p\u003e\n"]]],[],null,["# Directions API (Legacy) overview\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Directions API (Legacy) is a service that accepts an HTTP request and returns JSON or XML-formatted directions between locations.\n\nWhy use the Directions API\n--------------------------\n\nWith the Directions API, you can get directions for several modes of\ntransportation, such as transit, driving, walking, or bicycling.\n\nWhat you can do with the Directions API?\n----------------------------------------\n\nWith the Directions API, you can calculate directions between locations,\nincluding the following details:\n\n- Directions for several modes of transportation, including transit, driving, walking or bicycling.\n- Multipart directions using a series of waypoints.\n- Specify origins, destinations, and waypoints in multiple ways, including as text strings (for example, \"Chicago, IL\" or \"Darwin, NT, Australia\"), place IDs, or latitude/longitude coordinates.\n\nHow the Directions API works\n----------------------------\n\nThe Directions API returns the most efficient routes when\ncalculating directions. The product factors in the following travel elements\nwhen determining the most efficient route:\n\n- Travel time (primary)\n- Distance\n- Number of turns\n\nThe following example request returns driving directions from Toronto, Ontario to Montreal, Quebec in JSON format: \n\n```scdoc\nhttps://maps.googleapis.com/maps/api/directions/json\n ?destination=Montreal\n &origin=Toronto\n &key=YOUR_API_KEY\n```\n\n### Resources\n\nThe following table summarizes the resources available through the\nDirections API along with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| [Directions](/maps/documentation/directions/get-directions#DirectionsRequests) Supply origins and destinations in the form of place IDs, addresses, or latitude/longitude coordinates. See [required parameters](/maps/documentation/directions/get-directions#required-parameters) for details. | Detailed directions, broken into routes, legs, and steps. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. | - JSON - XML |\n\n\u003cbr /\u003e\n\nHow to use the Directions API\n-----------------------------\n\n|---|---------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/directions/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try the demo** | Once you have an API key and a cloud project you try out the directions demo at no charge. See [The Directions API demo](/maps/documentation/directions/start). |\n| 3 | **Build a request** | See the example requests and learn about the available options you can supply, such as travel modes, waypoints, and route restrictions. See [Directions examples](/maps/documentation/directions/get-directions#ExampleRequests). |\n| 4 | **Understand response basics** | Explore the data responses to prepare to use directions data for your app. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. |\n| 5 | **Incorporate direction data into your own app!** | You can use this data to calculate travel distance and time. |\n\n#### Available client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n-----------\n\n- **Start using the Directions API** : Go to [Get started](/maps/documentation/directions/start).\n- **Start making Directions requests** : Go to [Get\n directions](/maps/documentation/directions/get-directions).\n- **Follow best practices** : Go to [Web service best\n practices](/maps/documentation/directions/web-service-best-practices)."]]
