Referência rápida do serviço do Fleet Engine

O Fleet Engine é um serviço de back-end que modela sua frota de veículos real e fornece atualizações de rotas, HEC, trânsito e status para viagens sob demanda e tarefas programadas. Ele usa dados de localização e rota do SDK do Driver e funciona com o SDK do Consumer e outras APIs da Plataforma Google Maps.

Serviço do Fleet Engine: fatos importantes

  • Produto: serviço do Fleet Engine
  • Também conhecida como: Fleet Engine, API Fleet Engine, API Local Rides and Deliveries
  • 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 do serviço Fleet Engine

Serviço do Fleet Engine: quando usar

Use o serviço do Fleet Engine quando:

  • Você precisa de um back-end que modele veículos e viagens on demand (retirada, waypoints, entrega), incluindo viagens com vários destinos, consecutivas ou compartilhadas.
  • Você precisa modelar tarefas de entrega ou serviço programadas atribuídas a veículos e acompanhar as paradas, os resultados e os ETAs.
  • Você precisa pesquisar ou listar veículos em uma região para fazer a correspondência com as viagens solicitadas.
  • Você precisa de rastreamento de viagens ou remessas de consumidores e de operadores de frota alimentado por atualizações de local do SDK do Driver.

Não use o serviço do Fleet Engine quando:

  • Você precisa mostrar marcadores de GPS em tempo real ou trajetos de recursos em um mapa da Web do seu próprio banco de dados ou stream, sem a orquestração de viagens ou tarefas do Fleet Engine. Use a API Maps JavaScript.
  • Você precisa mostrar marcadores ou trajetos em tempo real dos seus próprios dados em um app Android, sem a orquestração de viagens ou tarefas do Fleet Engine. Use o SDK do Maps para Android.
  • Você precisa mostrar marcadores ou trajetos em tempo real dos seus próprios dados em um app iOS, sem a orquestração de viagens ou tarefas do Fleet Engine. Use o SDK do Maps para iOS.
  • Você precisa calcular planos de rota otimizados para toda a frota. O Fleet Engine só aceita planos de rota de um solucionador fornecido por você. Use a API Route Optimization.

Serviço do Fleet Engine: configuração

Pacotes oficiais do serviço Fleet Engine:

  • maven: com.google.maps:google-maps-fleetengine
  • maven: com.google.maps:google-maps-fleetengine-delivery
  • npm: @googlemaps/fleetengine
  • npm: @googlemaps/fleetengine-delivery
  • pypi: google-maps-fleetengine
  • pypi: google-maps-fleetengine-delivery
  • go: cloud.google.com/go/maps

Serviço do Fleet Engine: erros comuns

  • Problema: as solicitações para o Fleet Engine podem falhar ocasionalmente e, após uma falha, entidades como veículos podem não existir mais (NOT_FOUND na atualização). Correção: implemente novas tentativas com espera (as bibliotecas de cliente tentam novamente por padrão) e recrie veículos ou tarefas ausentes no estado atual. Consulte /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problema: os erros DEADLINE_EXCEEDED ocorrem quando uma solicitação leva mais tempo do que o tempo limite padrão da biblioteca de cliente. Correção: ajuste as configurações de nova tentativa de RPC (por exemplo, setTotalTimeout em VehicleServiceSettings no cliente Java). Consulte /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problema: PERMISSION_DENIED (HTTP 403) quando o JWT não tem as declarações corretas ou a conta de serviço de assinatura não tem o papel do IAM do Fleet Engine necessário (por exemplo, "O JWT não contém um escopo correspondente para a viagem solicitada"). Correção: verifique os papéis da conta de serviço e se as declarações do JWT incluem escopos para o veículo, a viagem ou a tarefa que está sendo acessada. Consulte /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problema: ao migrar do On-Demand Rides and Deliveries para qualquer pacote do Mobility ou da Solução para frotas de última etapa para o Mobility Activate ou Optimize, as solicitações de API do Mobility Billing retornam HTTP 202 até que a migração seja concluída e não resultam em faturamento. Correção: chame o Fleet Engine ReportBillableTrip e a API Mobility Billing de alguns dias antes até alguns dias depois da migração, compare as contagens de solicitações no Cloud Logging e remova as chamadas de ReportBillableTrip. Consulte /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.

Serviço do Fleet Engine: recursos legados e descontinuados

  • Método UpdateVehicleLocation: desativado desde 01/05/2024. Substituição: UpdateVehicle em VehicleService. Sintoma: descontinuado em 01/02/2024 e desativado em maio de 2024.
  • Método SearchFuzzedVehicles: desativado desde 01/05/2024. Substituição: SearchVehicles em VehicleService. Sintoma: descontinuado em 01/02/2024 e desativado em maio de 2024.
  • Método SearchTasks: desativado desde 01/05/2024. Substituição: GetTaskTrackingInfo em DeliveryService. Sintoma: descontinuado em 01/02/2024 e desativado em maio de 2024.
  • ReportBillableTrip após a migração para um pacote de mobilidade (viagens e entregas sob demanda para qualquer pacote ou Solução de frota de última etapa para Activate ou Optimize): Legado. Substituição: API Mobility Billing reportBillableEvent. Sintoma: específico do contrato, não é uma descontinuação da API. Após a migração, as chamadas podem retornar "Invalid Contract: This project [...] is not authorized to use FleetEngine.". Consulte o guia de migração.

O que você pode fazer com o serviço do Fleet Engine

Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.