Referência rápida da API Route Optimization

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 injectedFirstSolutionRoutes ou injectedSolutionConstraint.
  • 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

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: erros comuns

  • Problema: para chamadas REST para o endpoint OptimizeTours de bloqueio, o prazo padrão de 60 segundos substitui qualquer timeout de corpo de solicitação maior que 60 segundos. Correção: defina o cabeçalho X-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 timeout e de prazo são limitados a 1.800 segundos. Correção: defina allowLargeDeadlineDespiteInterruptionRisk como true para 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, costPerHour ou costPerKilometer), 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.