O que é o serviço Fleet Engine?

O Fleet Engine é um serviço de back-end que se integra ao sistema usado para gerenciar serviços de transporte para seus clientes. Ele interopera com várias APIs e SDKs para melhorar o mapeamento, o roteamento e o gerenciamento de localização.

O Fleet Engine oferece atualizações de status e rotas para entidades de veículos modeladas na sua frota real. À medida que seu sistema envia atualizações de progresso do veículo para o Fleet Engine, ele usa a localização do veículo em tempo real e as informações de roteamento fornecidas pelo SDK Driver para gerar relatórios precisos sobre as viagens do veículo: ETAs, informações de trânsito e disponibilidade do veículo.

Fleet Engine

O serviço Fleet Engine funciona com as duas ofertas a seguir do Mobility Service:

  • Viagens sob demanda: nessa oferta, o Motor de frota modela o ciclo de vida de uma viagem, desde a origem, passando por paradas, até o desembarque. Em um ciclo de vida de viagem, um veículo passa por locais de coleta, pontos de parada intermediários e locais de desembarque como forma de atender a uma viagem reservada por uma solicitação do consumidor. Consulte a documentação de viagens sob demanda para saber mais sobre esse tipo de viagem.
  • Tarefas programadas: nessa oferta, o Fleet Engine modela o ciclo de vida de uma tarefa de entrega ou serviço, em que cada parada ao longo de uma viagem exige que o motorista conclua uma ou mais tarefas programadas. As tarefas podem incluir a entrega de um pacote ou a conclusão de uma visita técnica. Consulte a documentação Tarefas programadas para mais detalhes.

O que você pode fazer com o Fleet Engine

Com os componentes do Fleet Engine, você pode fazer o seguinte:

  • Ativar o acompanhamento de viagens do consumidor: para viagens sob demanda, use os recursos de experiência do consumidor do Motor de frota e integre o SDK do consumidor aos seus apps para dispositivos móveis ou da Web. Assim, os consumidores podem usar o mesmo app para fazer um pedido de viagem e acompanhar o trajeto.
  • Forneça informações de pacotes em tempo real para os clientes: para tarefas programadas, use os recursos de experiência do consumidor do Fleet Engine e integre o SDK JavaScript Consumer ao seu web app. Assim, os consumidores recebem atualizações quase em tempo real sobre o status dos pacotes. O SDK oferece filtros e privacidade de dados integrados para que os consumidores vejam apenas as informações relevantes para o pedido.
  • Projetar soluções para operadores de frota: para tarefas programadas, use a biblioteca de rastreamento de frota em JavaScript para que os operadores possam coordenar e gerenciar melhor as atribuições de veículos ao longo do dia.
  • Melhore a experiência dos motoristas: o SDK Driver é um kit de ferramentas de apps para dispositivos móveis e um componente fundamental do Motor de frota. Ele usa funcionalidades do vehicles. Com esse SDK, seu app de direção pode gerenciar tarefas de trabalho e ativar recursos de navegação e rotas para motoristas. Basicamente, o SDK usa um listener de eventos para enviar atualizações de local ao Fleet Engine quando o motorista começa a dirigir. Ele também envia sinais ao Fleet Engine sobre o status do veículo. Com esse SDK, o motorista pode usar um único app para gerenciar atribuições e navegar como faria com a versão para consumidor do Google Maps, mas sem precisar mudar para outro app.

Mais especificamente, você pode fornecer o seguinte com essas soluções:

Viagens sob demanda

  • A posição do veículo do motorista ajustada à via em tempo real.
  • O trajeto real do motorista com informações de trânsito em tempo real.
  • A hora estimada de chegada para locais de embarque e desembarque.
  • Rastreamento de viagens únicas, com vários destinos e consecutivas.
  • Viagens de carona para vários clientes no mesmo trajeto.
  • Listar todos os veículos em uma região específica para encontrar as melhores opções de viagens solicitadas.

Tarefas agendadas

  • Atualizações de local em tempo real renderizadas no mapa.
  • ETAs ajustados automaticamente que refletem mudanças nas circunstâncias, como trânsito.
  • Tarefas concluídas e paradas pendentes para fornecer insights sobre possíveis problemas.
  • O número de paradas e a distância para que os clientes tenham mais confiança.

Como o Fleet Engine funciona

Esta seção descreve uma visão geral das operações dos sistemas do Fleet Engine para cada oferta de mobilidade.

Viagens sob demanda

O diagrama a seguir mostra duas partes principais das viagens sob demanda: o início do dia, quando os motoristas ativam o compartilhamento de local com o Fleet Engine, e uma visão simplificada do gerenciamento de viagens usando componentes do Fleet Engine. Para uma visão detalhada do processo de viagem, consulte O que é uma viagem? na documentação de Viagens sob demanda.

Tarefas agendadas

O diagrama a seguir mostra uma matriz de um dia de trabalho típico de um único motorista e como o trabalho dele é processado no sistema do Fleet Engine usando a biblioteca de rastreamento de frota.

Observação: seu sistema pode usar o rastreamento de remessas ou de frota. Com o rastreamento de remessas, o Fleet Engine filtra informações de remessa e do motorista para que um cliente veja apenas informações relevantes para a remessa dele.

Arquitetura do Fleet Engine

Esta seção fornece uma arquitetura de sistema para as diferentes ofertas do Fleet Engine. Ambos os serviços usam o seguinte:

  • Um veículo: as viagens sob demanda e as tarefas programadas dependem de um veículo como meio de modelar os veículos do mundo real usados na sua empresa para realizar as operações. No Fleet Engine, uma entidade de veículo recebe informações de localização fornecidas pelo veículo associado no mundo real pelo app para motoristas integrado ao SDK Driver. Os veículos do Fleet Engine são entidades paralelas entre os dois serviços, com algumas diferenças. Leia Introdução aos veículos para entender os veículos no Fleet Engine.
  • SDK do driver: para tarefas programadas e sob demanda, o SDK do driver é um componente fundamental. O SDK Driver se integra ao app do motorista e fornece ao Fleet Engine um fluxo de atualizações de local e informações de rota que o Fleet Engine usa para informar o status em tempo real da viagem, além de outras informações, como ETA e dados de trânsito.
  • SDK do consumidor: um dos principais benefícios para tarefas programadas e sob demanda é o SDK do consumidor, usado para informar ao consumidor o status da viagem, da entrega de comida ou da entrega de pacote programada.

Viagens sob demanda

Para uma explicação sobre veículos, viagens e os SDKs, consulte a documentação relacionada para viagens sob demanda:

  1. Introdução aos veículos
  2. Viagens sob demanda
  3. SDK do Driver para viagens sob demanda
  4. SDK do consumidor para viagens sob demanda

Tarefas agendadas

Para uma explicação sobre veículos de entrega, tarefas e SDKs, consulte a documentação relacionada para tarefas programadas:

  1. Introdução aos veículos
  2. Tarefas agendadas
  3. SDK do Driver para tarefas agendadas
  4. SDK do consumidor para tarefas programadas

Recursos

Viagens sob demanda

Veículo
Serviços REST: v1.providers.vehicles
gRPC: maps.fleetengine.v1.VehicleService
Nome do recurso providers/{provider}/vehicles/{vehicle}
Viagem
Serviços REST: v1.providers.trips
gRPC: maps.fleetengine.v1.TripService
Nome do recurso providers/{provider}/trips/{trip}

Tarefas agendadas

Veículo de entrega
Recursos REST: providers.deliveryVehicles
gRPC: maps.delivery.v1
Nome do recurso providers/{provider}/deliveryVehicles/{vehicle}
Tarefa
Serviços REST: providers.tasks
gRPC: maps.fleetengine.delivery.v1.Task
Nome do recurso providers/{provider}/tasks/{task}

Nomeação de recursos no Fleet Engine

No Fleet Engine, assim como em todos os serviços baseados no Google Cloud, os recursos têm identificadores exclusivos chamados names, fornecidos no formato de string. Parte desse nome é um ID de recurso, que você fornece ao emitir uma solicitação de criação. No entanto, os recursos do Fleet Engine não têm um campo de ID, mas um campo de nome somente de saída, que inclui o ID do recurso.

O Fleet Engine usa nomes de recursos relativos. Eles consistem em IDs de coleção e recurso, estruturados de forma a indicar a hierarquia.

  • Um ID de coleção: uma coleção contém recursos ou outras coleções.

Viagens sob demanda

Três coleções: providers, vehicles e trips.

Tarefas agendadas

Três coleções: providers, deliveryVehicles e tasks.

Um ID de recurso: os identificadores de recursos na documentação de referência são indicados por chaves no campo "name". Essas são variáveis para os IDs que você fornece ao emitir uma solicitação de criação.

Viagens sob demanda

  • {provider}: o ID do projeto do Cloud. Criado uma vez por projeto.
  • {vehicle}: seu recurso de veículo, usado para cada criação de veículo, normalmente reutilizado para o mesmo par motorista-veículo.
  • {trip}: seu recurso de viagem, usado para todas as viagens e não reutilizado normalmente.

Tarefas agendadas

  • {provider}: o ID do projeto do Cloud. Criado uma vez por projeto.
  • {vehicle}: seu recurso de veículo de entrega, usado para cada criação de veículo, normalmente reutilizado para o mesmo par motorista-veículo.
  • {task}: seu recurso de tarefa, usado para todas as tarefas e normalmente não reutilizado.

Consulte Nomes de recursos na documentação das APIs do Google Cloud para mais detalhes.

Registros do Google Cloud para o Fleet Engine

O Fleet Engine oferece um serviço de geração de registros básico que permite salvar as solicitações de API e os payloads de resposta. Com esses registros, é possível depurar a integração, criar métricas de monitoramento e analisar padrões de tráfego.

Consulte Cloud Logging para mais detalhes.

Como usar o Fleet Engine

1 Configure seu projeto do Cloud.

Nesta etapa, você cria vários papéis de conta de serviço, além de ativar as APIs relacionadas.

As APIs e os SDKs do Fleet Engine exigem o uso de JSON Web Tokens (JWTs) assinados com contas de serviço criadas no Console do Cloud. Siga as instruções em Criar seu projeto do Fleet Engine. Para entender melhor esses papéis, leia Papéis de contas de serviço.

2 Verificar sua configuração Depois de criar as contas de serviço, verifique se a configuração está concluída e se é possível criar um veículo. Essa etapa garante que você tenha resolvido problemas comuns de autorização que podem surgir durante a configuração do projeto. Siga as orientações em Verificar sua configuração.
3 Criar sua primeira jornada Isso envolve a criação de um único veículo com um conjunto de coordenadas que representam paradas ao longo de uma viagem sob demanda ou tarefas programadas. Consulte o conteúdo de visão geral sobre Viagens sob demanda ou Tarefas programadas para saber mais.
4 Testar sua integração Os serviços e componentes do Fleet Engine exigem dados em tempo real de uma frota de veículos. Projetar, desenvolver e implantar apps para uma frota de motoristas pode levar tempo. Por isso, é melhor usar dados simulados para explorar sua integração antes de fazer uma implantação em grande escala. Consulte Configurar o Fleet Engine para mais detalhes.

A seguir

  1. Entenda os veículos do Fleet Engine.
  2. Saiba mais sobre viagens sob demanda ou tarefas programadas.
  3. Configure o Fleet Engine.