A API Route Optimization atribui tarefas e rotas a uma frota de veículos, otimizando os objetivos e as restrições que você fornece, como janelas de tempo, capacidade do veículo, horas do motorista e custos. Você a chama por REST, gRPC ou bibliotecas de cliente, e ela retorna sequências de visitas, atribuições de remessa, tempos estimados e métricas de rota.
API Route Optimization: fatos importantes
- Produto: API Route Optimization
- Também conhecido como: GMPRO
- Categoria: rotas
- Plataforma: serviço da Web (REST)
- Executado em: servidor (código de back-end)
- Estágio de lançamento: GA
- Ciclo de vida: Ativo
- Visão geral: Visão geral da API Route Optimization
API Route Optimization: quando usar
Use a API Route Optimization quando:
- Você precisa atribuir remessas ou tarefas a vários veículos, respeitando as janelas de tempo, a capacidade dos veículos, as horas de trabalho dos motoristas e os custos.
- Você precisa da melhor sequência de paradas para um veículo com várias retiradas, entregas ou compromissos.
- É necessário reotimizar as rotas ativas para novos pedidos (como despacho sob demanda) usando
injectedFirstSolutionRoutesouinjectedSolutionConstraint. - Você precisa de tokens de trajeto para cada trecho de um plano otimizado para transmitir ao SDK do Navigation.
Não use a API Route Optimization quando:
- Você precisa de um rastreamento em tempo real de como os motoristas executam o plano. A API retorna polilinhas planejadas, não rotas de veículos em tempo real. Use o serviço do Fleet Engine.
- Você precisa de navegação guiada no app para os motoristas ao longo do trajeto otimizado. Use o SDK do Navigation para Android.
- Você precisa de navegação guiada no app para motoristas no iOS ao longo do trajeto otimizado. Use o SDK Navigation para iOS.
API Route Optimization: configuração
- Serviço a ser ativado:
routeoptimization.googleapis.com - Autenticação: OAuth 2.0, conta de serviço
- Começar: configurar a API Route Optimization
- Referência: referência da API Route Optimization
- Preços: uso e faturamento da API Route Optimization
- Políticas: políticas da API Route Optimization
- Notas da versão: notas da versão da API Route Optimization
Pacotes oficiais da API Route Optimization:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
API Route Optimization: produtos relacionados
- Frequentemente usado com: SDK de navegação para Android, SDK de navegação para iOS, serviço do Fleet Engine, API Maps JavaScript
API Route Optimization: erros comuns
- Problema: para chamadas REST para o endpoint
OptimizeToursde bloqueio, o prazo padrão de 60 segundos substitui qualquertimeoutde corpo de solicitação maior que 60 segundos. Correção: defina o cabeçalhoX-Server-Timeout(segundos, sem o sufixo "s") para estender o prazo. As bibliotecas de cliente e o gRPC usam 3.600 segundos como padrão. Consulte /maps/documentation/route-optimization/timeouts. - Problema: os valores de
timeoute de prazo são limitados a 1.800 segundos. Correção: definaallowLargeDeadlineDespiteInterruptionRiskcomotruepara permitir até 3.600 segundos, aceitando um risco maior de erros de interrupção. Consulte /maps/documentation/route-optimization/timeouts. - Problema: sem parâmetros de custo (por exemplo,
costPerHouroucostPerKilometer), o otimizador trata todas as soluções como iguais. Correção: defina parâmetros de custo nos veículos que reflitam os custos da sua empresa. Consulte /maps/documentation/route-optimization/make-first-request. - Problema: as solicitações autenticadas com uma chave de API falham. Cada solicitação precisa de um token OAuth. Correção: use um token OAuth com o escopo
https://www.googleapis.com/auth/cloud-platform, por exemplo, pelo Application Default Credentials ou por uma conta de serviço. Consulte /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token.
O que você pode fazer com a API Route Optimization
Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.
- Retorna um plano de entrega com várias paradas, otimizado com base em restrições de roteamento, custo, envio e veículo especificadas.
- Retornar os horários de início e término de cada parada em um plano de entrega otimizado.
- Retornar as durações de viagem, atraso, pausa e espera entre cada parada em um plano de entrega otimizado.
- Retornar informações de carga do veículo em cada parada em um plano de entrega otimizado.
- Retornar informações de custo para cada remessa em um plano de entrega otimizado.
- Retorna uma polilinha codificada para o trajeto entre cada parada em um plano de entrega otimizado.
- Retornar um token de rota de navegação para o trajeto entre cada parada em um plano de entrega otimizado.
- Retornar métricas agregadas de remessa, veículo e custo para um plano de entrega otimizado.
- Especifique a janela de tempo de início e término de um plano de entrega com várias paradas.
- Especifique a disponibilidade de horário de início e término e os locais de cada veículo em um plano de entrega com várias paradas.
- Especifique os custos de tempo de cada veículo em um plano de entrega com várias paradas.
- Especifique os parâmetros do modelo de custo para um plano de entrega com várias paradas.
- Especifique as restrições de horário de retirada e entrega para cada remessa em um plano de entrega com várias paradas.
- Especificar atribuições de veículos para um plano de entrega com várias paradas.
- Especifique os limites de carga para cada veículo em um plano de entrega com várias paradas.
- Especifique se as informações de trânsito em tempo real devem ser consideradas para um plano de entrega com várias paradas.
- Processar em lote uma solicitação de otimização de plano de entrega com várias paradas e gravar a resposta no Google Cloud Storage.
- Reserve um tempo para estacionar antes de fazer entregas.
- Priorize visitas próximas para serem feitas em sequência.
- Evite fazer conversões em U em um trajeto de veículo com várias paradas. Experimental Observação: recurso experimental, sujeito aos termos e limitações de pré-GA.
- Otimize para objetivos predefinidos. Experimental Observação: recurso experimental, sujeito aos termos e limitações de pré-GA.
- Entregue as remessas mais pesadas primeiro. Experimental Observação: recurso experimental, sujeito aos termos e limitações de pré-GA.