Che cos'è l'API Route Optimization
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Sviluppatori dello Spazio economico europeo (SEE)
L'ottimizzazione del percorso è un'API Google Maps Platform che genera piani di percorso ottimizzati per uno o più veicoli e le relative fermate.
Perché utilizzare l'API Route Optimization
Migliora l'efficienza operativa della tua flotta di trasporti con l'aiuto dei piani di percorso. Modifica i tuoi percorsi in base a costi, vincoli di tempo, esigenze dei clienti e qualsiasi altro obiettivo commerciale. Ad esempio:
- Una società di logistica può risparmiare tempo e risorse pianificando le spedizioni per il giorno successivo, ottimizzando al contempo le consegne in termini di efficienza temporale, risparmio sui costi, consegna puntuale e soddisfazione del conducente e del cliente finale.
- Un'azienda di consegna di cibo on demand può rendere il processo di spedizione
più rapido ed efficace scegliendo il miglior autista attivo per ritirare i nuovi
ordini e inserirli nei suoi itinerari esistenti.
- Un fornitore di servizi sul campo può migliorare la propria efficienza e la soddisfazione dei clienti assegnando i fornitori agli appuntamenti e trovando la sequenza di fermate ottimale per più di un appuntamento, il tutto riottimizzando i percorsi quando si presentano problemi.
Cosa puoi fare con l'API Route Optimization
Utilizza l'API Route Optimization per ottimizzare i percorsi e le assegnazioni di attività della tua flotta in base ai tuoi obiettivi e ai tuoi vincoli.
- Obiettivi:i tuoi obiettivi commerciali.
- Vincoli:le limitazioni delle tue risorse fisiche.
| Obiettivi
|
Vincoli
|
| Efficienza dei viaggi
|
Ottimizza gli itinerari di base utilizzando parametri quali distanza e tempo di percorrenza.
|
Orario di lavoro dei conducenti
|
Assegna i percorsi agli autisti in base al loro orario di lavoro e alle pause.
|
| Arrivo puntuale
|
Dai la priorità a un ritiro, una consegna o un servizio in modo che arrivi prima di un orario specifico.
|
Capacità del veicolo
|
Assegna un veicolo a un'attività in base alla quantità di carico che può trasportare.
|
| Costo di utilizzo del veicolo
|
Riduci al minimo il numero di veicoli necessari per eseguire un'attività.
|
Finestre temporali
|
Ricevere una spedizione o un'attività in una fascia oraria specifica.
|
| Bilanciamento del carico
|
Distribuire equamente le attività tra una flotta di veicoli e il personale.
|
Dipendenze e compatibilità
|
Ottimizza i percorsi della flotta in base ai tipi di veicolo, alla sequenza delle attività o alle condizioni di spedizione.
|
Come funziona l'API Route Optimization
È possibile accedere all'API Route Optimization utilizzando REST, gRPC e
librerie client.
Corpo della richiesta
Il corpo della richiesta accetta informazioni sulle spedizioni e sui veicoli
disponibili per la consegna. Sono inclusi dettagli quali:
- Località di ritiro e consegna
- Finestre temporali
- Dimensioni e peso della spedizione
- Capacità del veicolo
Corpo della risposta
Il corpo della risposta fornisce un piano di itinerario dettagliato che include:
- Sequenza di fermate
- Spedizioni assegnate
- Metriche generali
Leggi ulteriori dettagli sulla creazione di una richiesta in Creare un messaggio di richiesta e sull'interpretazione di una risposta in Interpretare la risposta.
Risorse
La seguente tabella riepiloga le risorse disponibili tramite l'API Route Optimization e i dati che restituisce.
| Risorse di dati
|
Descrizione e dati restituiti
|
Formato del reso
|
optimizeTours
|
Questo metodo restituisce un percorso ottimizzato, con i dettagli delle visite e delle metriche.
|
JSON o gRPC proto
|
batchOptimizeTours
|
Questo metodo restituisce il nome della risorsa di un'operazione a lunga esecuzione, che indica quando l'elaborazione è completata.
|
JSON o gRPC proto
|
Come utilizzare l'API Route Optimization
Librerie client disponibili
Per un elenco delle librerie client disponibili per l'API Route Optimization, 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-08-10 UTC.
[null,null,["Ultimo aggiornamento 2025-08-10 UTC."],[[["\u003cp\u003eRoute Optimization API leverages Google Maps data and custom parameters to generate efficient routes for fleets, considering factors like time, cost, and vehicle capacity.\u003c/p\u003e\n"],["\u003cp\u003eBusinesses like logistics companies, on-demand delivery services, and field service providers can use the API to automate dispatch, optimize delivery routes, and improve overall operational efficiency.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers synchronous and asynchronous options for route calculation and provides detailed route plans with assigned tasks, vehicle routes, and performance metrics.\u003c/p\u003e\n"],["\u003cp\u003eUsers can define objectives such as travel efficiency, on-time arrival, and load balancing, along with constraints like driver work hours and vehicle capacity for tailored optimization.\u003c/p\u003e\n"],["\u003cp\u003eTo begin, set up a Google Cloud project, construct a basic request, and explore advanced scenarios to create customized route optimization solutions.\u003c/p\u003e\n"]]],["The Route Optimization API optimizes routes for single or multiple vehicles, enhancing operational efficiency. Users define business objectives (e.g., travel efficiency, on-time arrival) and constraints (e.g., driver hours, vehicle capacity) to guide the optimization. The API accepts shipment and vehicle details, such as locations, time windows, and capacity. It returns a detailed route plan with stop sequences and assigned shipments via JSON or gRPC. Users can construct requests and interpret responses using provided guidelines and resources.\n"],null,["# What is the Route Optimization API\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\nRoute Optimization is a Google Maps Platform API that generates optimized route\nplans for single or multiple vehicles and their stops.\n\nWhy use the Route Optimization API\n----------------------------------\n\nImprove the operational efficiency of your transportation fleet with the help of\nroute plans. Adjust your routes for cost, time constraints, customer needs, and\nany other business objective. For example:\n\n- A **logistics company** can save time and resources by scheduling next-day shipments while optimizing the deliveries for time efficiency, cost saving, on-time delivery, and driver and end customer satisfaction.\n- An **on-demand food delivery** company can make their dispatch process quicker and more effective by choosing the best active driver to pick up new orders and inserting them in their existing routes.\n- A **field service provider** can improve their efficiency and customer satisfaction by assigning providers to appointments and finding the optimal stop sequence for more than one appointment, all while re-optimizing routes when challenges come up.\n\nWhat you can do with the Route Optimization API\n-----------------------------------------------\n\nUse Route Optimization API to optimize your fleet's routes and tasks\nassignments based on your own *objectives* and\n*constraints*.\n\n- **Objectives:** Your business goals.\n- **Constraints:** The limitations of your physical assets.\n\n| Objectives || Constraints ||\n|-----------------------|--------------------------------------------------------------------------------------|------------------------------------|---------------------------------------------------------------------------------------------------|\n| **Travel efficiency** | Optimize basic travel routes using parameters like distance and time-to-destination. | **Drivers work hours** | Assign routes to drivers based on their work hours and breaks. |\n| **On-time arrival** | Prioritize a pickup, delivery, or service to arrive before a specific time. | **Vehicle capacity** | Assign a vehicle to a task based on the amount of load it can carry. |\n| **Vehicle use cost** | Minimize the number of vehicles required to perform a task. | **Time windows** | Have a shipment or task arrive in a specific time slot. |\n| **Load balancing** | Fairly distribute tasks across a fleet of vehicles and personnel. | **Dependencies and compatibility** | Optimize your fleet routes based on your types of vehicle, task sequence, or shipment conditions. |\n\nHow the Route Optimization API works\n------------------------------------\n\nThe Route Optimization API can be accessed using [REST](/maps/documentation/route-optimization/reference/rest/v1/operations), [gRPC](/maps/documentation/route-optimization/reference/rpc), and\n[client libraries](/maps/documentation/route-optimization/client-libraries).\n\n### Request body\n\nThe request body accepts information about your shipments and the vehicles\navailable to deliver them. This includes details such as:\n\n- Pickup and delivery locations\n- Time windows\n- Shipment size and weight\n- Vehicle capacity\n\n### Response body\n\nThe response body provides a detailed route plan which includes:\n\n- Sequence of stops\n- Assigned shipments\n- Overall metrics\n\nRead more details about constructing a request in [Construct a Request\nMessage](/maps/documentation/route-optimization/construct-request)\nand interpreting a response in [Interpret the\nResponse](/maps/documentation/route-optimization/interpret-response).\n\n### Resources\n\nThe following table summarizes the resources available through the\nRoute Optimization API along with the data it returns.\n\n| **Data resources** | **Description and data returned** | **Return format** |\n|----------------------|-----------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `optimizeTours` | This method returns an optimized route, with details of the visits and metrics. | [JSON](/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours) or [gRPC proto](/maps/documentation/route-optimization/reference/rpc/google.maps.routeoptimization.v1#google.maps.routeoptimization.v1.RouteOptimization.OptimizeTours) |\n| `batchOptimizeTours` | This method returns the resource name of a Long Running Operation, which indicates when processing is complete. | [JSON](/maps/documentation/route-optimization/reference/rest/v1/projects/batchOptimizeTours) or [gRPC proto](/maps/documentation/route-optimization/reference/rpc/google.maps.routeoptimization.v1#google.maps.routeoptimization.v1.RouteOptimization.BatchOptimizeTours) |\n\nHow to use the Route Optimization API\n-------------------------------------\n\n|---|----------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/route-optimization/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Run a basic request and receive a response** | After setup, start with sending a basic request and get the response, following [Construct a Request](/maps/documentation/route-optimization/construct-request) and [Interpret the Response](/maps/documentation/route-optimization/interpret-response). |\n| 3 | **Try a more advanced scenario and start creating your own request** | Explore example scenarios starting with [Pickup and Delivery Stop Order Optimization](/maps/documentation/route-optimization/pickup-delivery-order-optimization) and start building requests that match your use cases. |\n\n### Available client libraries\n\nFor a list of the available client libraries for Route Optimization API, see\n[Client Libraries](/maps/documentation/route-optimization/client-libraries).\n\nWhat's next\n-----------\n\n- **Start using the Route Optimization API** : Go to [Run a Basic Request](/maps/documentation/route-optimization/construct-request).\n- **Understand billing** : [Usage and Billing](/maps/documentation/route-optimization/usage-and-billing)\n- **See sample code and libraries** : [Client Libraries](/maps/documentation/route-optimization/client-libraries) and [Open Source](https://github.com/googleapis/google-cloud-java/tree/main/java-maps-routeoptimization).\n- **Follow best practices** : [Best Practices Using Route Optimization API Web\n Services](/maps/documentation/route-optimization/web-service-best-practices)"]]
