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.
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:
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.
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 sugli itinerari per la tua app. Per maggiori dettagli, consulta la sezione
Risposte agli itinerari.
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
Inizia a utilizzare l'API Directions: vai a
Inizia.
Inizia a effettuare richieste di indicazioni stradali: vai a Ottieni
indicazioni.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 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)."]]
