O que é a API Route Optimization
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Desenvolvedores do Espaço Econômico Europeu (EEE)
A API Route Optimization é uma API da Plataforma Google Maps que gera planos de rotas otimizadas para um ou vários veículos e as paradas deles.
Por que usar a API Route Optimization
Melhore a eficiência operacional da sua frota de transporte com planos de rotas. Ajuste os trajetos de acordo com custos, restrições de tempo, necessidades dos clientes e qualquer outro objetivo de negócios. Exemplo:
- Uma empresa de logística pode economizar tempo e recursos ao programar envios para o dia seguinte e otimizar as entregas para eficiência de tempo, economia de custos, entrega no prazo e satisfação do motorista e do cliente final.
- Uma empresa de entrega de comida sob demanda pode tornar o processo de despacho
mais rápido e eficaz escolhendo o melhor motorista ativo para retirar novos
pedidos e inserindo-os nas rotas atuais.
- Um provedor de serviços de campo pode melhorar a eficiência e a satisfação do cliente ao atribuir provedores a agendamentos e encontrar a sequência de paradas ideal para mais de um agendamento, tudo isso enquanto reotimiza as rotas quando surgem desafios.
O que você pode fazer com a API Route Optimization
Use a API Route Optimization para otimizar as rotas e atribuições de tarefas da sua frota com base nos seus próprios objetivos e restrições.
- Objetivos:as metas da sua empresa.
- Restrições:as limitações dos seus recursos físicos.
| Objetivos
|
Restrições
|
| Eficiência de viagem
|
Otimize rotas de viagem básicas usando parâmetros como distância e tempo até o destino.
|
Horário de trabalho dos motoristas
|
Atribua rotas aos motoristas com base no horário de trabalho e nos intervalos.
|
| Chegada no horário
|
Priorizar uma retirada, entrega ou serviço para chegar antes de um horário específico.
|
Capacidade do veículo
|
Atribua um veículo a uma tarefa com base na quantidade de carga que ele pode transportar.
|
| Custo de uso do veículo
|
Minimizar o número de veículos necessários para realizar uma tarefa.
|
Janelas de tempo
|
Receber uma entrega ou tarefa em um período específico.
|
| Balanceamento de carga
|
Distribuir tarefas de maneira justa em uma frota de veículos e pessoal.
|
Dependências e compatibilidade
|
Otimize os trajetos da frota com base nos tipos de veículo, na sequência de tarefas ou nas condições de envio.
|
Como a API Route Optimization funciona
É possível acessar a API Route Optimization usando REST, gRPC e bibliotecas de cliente.
Corpo da solicitação
O corpo da solicitação aceita informações sobre seus envios e os veículos
disponíveis para entrega. Isso inclui detalhes como:
- Locais de retirada e entrega
- Janelas de tempo
- Tamanho e peso da remessa
- Capacidade do veículo
Corpo da resposta
O corpo da resposta fornece um plano de rota detalhado que inclui:
- Sequência de paradas
- Remessas atribuídas
- Métricas gerais
Leia mais detalhes sobre como criar uma solicitação em Criar uma mensagem de solicitação e interpretar uma resposta em Interpretar a resposta.
Recursos
A tabela a seguir resume os recursos disponíveis na API Route Optimization e os dados que ela retorna.
| Recursos de dados
|
Descrição e dados retornados
|
Formato de retorno
|
optimizeTours
|
Esse método retorna um trajeto otimizado, com detalhes das visitas e métricas.
|
JSON ou gRPC proto
|
batchOptimizeTours
|
Esse método retorna o nome do recurso de uma operação de longa duração, que indica quando o processamento é concluído.
|
JSON ou gRPC proto
|
Como usar a API Route Optimization
Bibliotecas de clientes disponíveis
Para uma lista das bibliotecas de cliente disponíveis para a API Route Optimization, consulte
Bibliotecas de cliente.
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-05 UTC.
[null,null,["Última atualização 2025-09-05 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)"]]
