Panoramica di Compute Routes
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Sviluppatori nello Spazio economico europeo (SEE)
Introduzione
CalcolaPercorsi è un metodo del servizio dell'API Routes che accetta una richiesta HTTPS e restituisce il percorso ideale tra due località.
Fornisci indicazioni stradali con traffico in tempo reale su come spostarsi tra più luoghi con mezzi di trasporto pubblico, in bicicletta, in auto, con veicoli a motore a due ruote o a piedi.
Hai bisogno di matrici di percorsi? Se ti interessa una matrice di percorsi, consulta la Panoramica di Compute Routes Matrix.
Esegui la migrazione? Se esegui la migrazione dall'API Distance Matrix (legacy), consulta le istruzioni per la migrazione che iniziano con Perché eseguire la migrazione all'API Routes.
Perché utilizzare Compute Routes
Con Calcola percorsi, grazie a un'ampia gamma di dettagli dei percorsi, puoi pianificare i percorsi dei veicoli o dei pacchetti in base alle tue preferenze, ottimizzando al contempo il costo e la qualità.
Che cosa puoi fare con Compute Routes?
Con il metodo Compute Routes dell'API Routes, puoi svolgere le seguenti operazioni:
Ricevi indicazioni stradali per diversi modi di viaggiare e per una o più destinazioni:
Modalità di trasporto: trasporto pubblico, auto, veicoli a due ruote,
a piedi o in bicicletta.
Una serie di waypoint che puoi ottimizzare per l'ordine più efficiente in cui raggiungerli.
Utilizza più modi per specificare origini, destinazioni e waypoint:
Stringhe di testo. Ad esempio: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" o "CWF6+FWX Mountain View, California"
ID luogo
Coordinate di latitudine e longitudine, eventualmente con la direzione del veicolo
Perfeziona le opzioni di percorso in base alle tue esigenze e ai tuoi obiettivi:
Seleziona percorsi a basso consumo di carburante o a basso consumo energetico in base al tipo di motore del tuo veicolo:
Diesel, Elettrico, Ibrido, Benzina. Per ulteriori informazioni, consulta la sezione Ricevere un percorso ecosostenibile.
Imposta opzioni granulari per il calcolo del traffico, in modo da poter fare scelte in termini di qualità e latenza. Per maggiori dettagli, consulta
Specificare come e se includere i dati sul traffico.
Imposta la direzione di marcia del veicolo e le informazioni sul lato della strada per le tappe per aumentare l'accuratezza dell'orario di arrivo stimato. Per maggiori dettagli, consulta
Specificare la direzione e il lato della strada del veicolo.
Specifica le località di transito rispetto a quelle dei terminal e le località di sosta sicure. Per maggiori dettagli, vedi Impostare una fermata lungo un percorso e
Impostare un punto di passaggio per un percorso.
Richiedi informazioni sui pedaggi, oltre alla distanza del percorso e all'orario di arrivo stimato. Per maggiori dettagli, consulta Calcolare i pedaggi per un percorso.
Controlla la latenza e la qualità richiedendo solo i dati di cui hai bisogno utilizzando una maschera di campo, che ti aiuta a evitare tempi di elaborazione non necessari e tariffe di fatturazione delle richieste più elevate. Per maggiori dettagli, consulta
Scegliere le informazioni da restituire.
Come funzionano i percorsi di calcolo
Il metodo ComputeRoutes dell'API Routes accetta una richiesta POST HTTP con un corpo della richiesta JSON contenente i dettagli della richiesta. Sono obbligatori un'origine, una destinazione, travelMode e una maschera di campo per specificare i campi da restituire.
Esempio
curl -X POST -d '{
"origin": {
"address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
},
"destination": {
"address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
},
"travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
Il servizio calcola quindi il percorso richiesto e restituisce i campi che hai richiesto.
Risorse
La tabella seguente riassume le risorse disponibili tramite il metodo Compute Routes dell'API Routes, nonché i dati restituiti.
| Risorse di dati |
Dati restituiti |
Formato di reso |
| ComputeRoutes |
Restituisce percorsi, tratti e passaggi per un percorso, con percorsi alternativi,
se richiesti. |
JSON |
Come utilizzare Compute Routes
Librerie client disponibili
Per un elenco delle librerie client disponibili per Compute Routes, consulta Librerie client.
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-06-20 UTC.
[null,null,["Ultimo aggiornamento 2025-06-20 UTC."],[],[],null,["# Compute Routes 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\n[](/maps/documentation/routes/demo)\n\nIntroduction\n------------\n\nCompute Routes is a method in the Routes API service that accepts\nan HTTPS request and returns the ideal route between two locations.\nProvide directions with real-time traffic for transit, biking, driving,\n2-wheel motorized vehicles, or walking between multiple locations.\n\n**Need Route Matrixes?** If you are interested in a route matrix, see\n[Compute Route Matrix Overview](/maps/documentation/routes/compute-route-matrix-over).\n\n**Migrating?** If you are migrating from the Distance Matrix API (Legacy),\nsee migration instructions starting with\n[Why migrate to the Routes API](/maps/documentation/routes/migrate-routes-why).\n\nWhy use Compute Routes\n----------------------\n\nWith Compute Routes, with a wide\nrange of route details you can route your vehicles or packages according to\nyour preferences while optimizing for cost and quality.\n\nWhat you can do with Compute Routes?\n------------------------------------\n\nWith the Routes API `Compute Routes` method, you can\ndo the following things:\n\n- **Get directions for different ways to travel**, and for a single or\n multiple destinations:\n\n - Modes of transportation: transit, driving, two-wheel vehicles,\n walking, or bicycling.\n\n - A series of waypoints that you can optimize for the most efficient\n order in which to travel to them.\n\n- **Use multiple ways to specify origins, destinations, and waypoints**:\n\n - Text strings. For example: \"Chicago, IL\", \"Darwin, NT, Australia\", \"1800\n Amphitheatre Parkway, Mountain View, CA 94043\", or \"CWF6+FWX Mountain\n View, California\"\n\n - Place IDs\n\n - Latitude and longitude coordinates, optionally with vehicle heading\n\n- **Fine-tune your route options** based on your needs and goals:\n\n - Select fuel or energy-efficient routes for your vehicle's engine type:\n Diesel, Electric, Hybrid, Gas. For more information, see\n [Get an eco-friendly route](/maps/documentation/routes/eco-routes#request_an_eco-friendly_route).\n\n - Set fine-grained options for traffic calculation, letting you make\n quality versus latency trade off decisions. For details, see\n [Specify how and if to include traffic data](/maps/documentation/routes/config_trade_offs).\n\n - Set vehicle heading (direction of travel) and side-of-road information\n for waypoints to increase ETA accuracy. For details, see\n [Specify vehicle heading and side of road](/maps/documentation/routes/location_modifiers).\n\n - Specify pass-through versus terminal locations and safe stopover\n locations. For details, see [Set a stop along a route](/maps/documentation/routes/stop_over) and\n [Set a point for a route to pass through](/maps/documentation/routes/pass-through).\n\n - Request toll information, along with route distance and ETA. For\n details, see\n [Calculate toll fees for a route](/maps/documentation/routes/calculate_toll_fees).\n\n- **Control your latency and quality** by requesting only the data you need\n using a field mask, which helps you avoid unnecessary processing time and\n higher request billing rates. For details, see\n [Choose what information to return](/maps/documentation/routes/choose_fields).\n\nHow Compute Routes works\n------------------------\n\nThe Routes API `ComputeRoutes` method accepts an HTTP POST request with\na JSON request body that contains the request details. Required are an origin,\ndestination, `travelMode`, and a field mask to specify which fields to return. \n\n#### Example\n\n```json\ncurl -X POST -d '{\n \"origin\": {\n \"address\": \"1800 Amphitheatre Parkway, Mountain View, CA 94043\"\n },\n \"destination\": {\n \"address\": \"Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132\"\n },\n \"travelMode\": \"DRIVE\"\n }' \\\n -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \\\n -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \\\n 'https://routes.googleapis.com/directions/v2:computeRoutes'\n```\n\nThe service then calculates the requested route, and returns the fields you've\nrequested.\n\n### Resources\n\nThe following table summarizes the resources available through the\nRoutes API Compute Routes method,\nalong with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|----------------------------------------------------------------------|-----------------------------------------------------------------------------------|---------------|\n| [ComputeRoutes](/maps/documentation/routes/compute_route_directions) | Returns routes, legs, and steps for a route, with alternate routes, if requested. | JSON |\n\n\u003cbr /\u003e\n\n### How to use Compute Routes\n\n|---|---------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/routes/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Understand how the Routes API bills** | For information, see [Usage and billing](/maps/documentation/routes/usage-and-billing). |\n| 3 | **Compute a route and review the response** | For more information, see [Get a route](/maps/documentation/routes/compute_route_directions) and [Review the route responses](/maps/documentation/routes/understand-route-response). |\n\n### Available client libraries\n\nFor a list of the available client libraries for\nCompute Routes, see\n[Client libraries](/maps/documentation/routes/client-libraries).\n\nWhat's next\n-----------\n\n- [Get a route](/maps/documentation/routes/compute_route_directions)\n- [Available route options](/maps/documentation/routes/route-opt)\n- [Choose what information to return](/maps/documentation/routes/choose_fields)\n- [Migrate from Directions API (Legacy)](/maps/documentation/routes/migrate-routes)\n- [Migrate from the Routes API preview to GA](/maps/documentation/routes/migrate-routes-preview)"]]
