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
- Serviço a ser ativado:
fleetengine.googleapis.com - Autenticação: conta de serviço, JSON Web Token (JWT), OAuth 2.0
- Atribuição de uso: recurso Beta opcional. Defina o cabeçalho HTTP
X-Goog-Maps-Experience-IDcomo o ID da transação do Mobility (ou um ID relacionado, como um ID de sessão) em chamadas para serviços do pacote Mobility. Separe vários IDs com vírgulas. Transmita todos os IDs relacionados emrelated_idsao informar a transação. - Começar: configurar o serviço do Fleet Engine
- Referência: Referência do serviço Fleet Engine
- Políticas: políticas de serviço do Fleet Engine
- Notas da versão: notas da versão do serviço Fleet Engine
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: produtos relacionados
- Costuma ser usado com: SDK do Driver para Android, SDK do Driver para iOS, SDK do Consumidor para Android, SDK do Consumidor para iOS, SDK do Consumidor para JavaScript, API Route Optimization
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_FOUNDna 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_EXCEEDEDocorrem 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,setTotalTimeoutemVehicleServiceSettingsno 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
ReportBillableTripe 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 deReportBillableTrip. 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:UpdateVehicleemVehicleService. Sintoma: descontinuado em 01/02/2024 e desativado em maio de 2024. - Método
SearchFuzzedVehicles: desativado desde 01/05/2024. Substituição:SearchVehiclesemVehicleService. Sintoma: descontinuado em 01/02/2024 e desativado em maio de 2024. - Método
SearchTasks: desativado desde 01/05/2024. Substituição:GetTaskTrackingInfoemDeliveryService. Sintoma: descontinuado em 01/02/2024 e desativado em maio de 2024. ReportBillableTripapó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 BillingreportBillableEvent. 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.
- Informar o uso faturável de viagens do Fleet Engine.
- Cria e retorna uma nova viagem do Fleet Engine.
- Retornar informações sobre uma viagem do Fleet Engine.
- Retorna uma lista de todas as viagens do Fleet Engine para um veículo específico.
- Atualizar os dados de uma viagem do Fleet Engine.
- Instanciar um novo veículo no Fleet Engine associado a um provedor de viagens compartilhadas ou entregas sob demanda.
- Retorna um veículo do serviço do Fleet Engine.
- Retorna uma lista paginada de veículos no Fleet Engine associados a um provedor que correspondem aos critérios especificados.
- Retorna uma lista de veículos no Fleet Engine que correspondem aos critérios especificados.
- Atualizar os dados de um veículo no Fleet Engine.
- Atualizar os atributos de um veículo no Fleet Engine.
- Retornar informações de viagem de um veículo do serviço Fleet Engine.