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 uma variedade de APIs e SDKs para melhorar o mapeamento, o roteamento e o gerenciamento de locais.
O Fleet Engine fornece atualizações de trajeto e status para entidades de veículos modeladas na sua frota de veículos real. À medida que o sistema envia atualizações de progresso do veículo para o Fleet Engine, ele usa a localização em tempo real do veículo e as informações de trajeto fornecidas pelo SDK do Driver para fornecer relatórios precisos sobre as viagens do veículo: ETAs, informações de trânsito e disponibilidade do veículo.
O serviço do Fleet Engine funciona com as seguintes ofertas do serviço de mobilidade:
- Viagens sob demanda: nessa oferta, o Fleet Engine modela o ciclo de vida de uma jornada, desde a origem, passando pelas paradas, até o desembarque. No ciclo de vida de uma viagem, um veículo passa por locais de retirada, pontos de passagem intermediários e locais de desembarque para atender a uma viagem reservada por uma solicitação do consumidor. Consulte a documentação sobre viagens sob demanda para mais detalhes.
- 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 jornada 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 chamada de serviço. Consulte a documentação sobre tarefas programadas para mais detalhes.
O que você pode fazer com o Fleet Engine
Com os componentes do Fleet Engine, é possível:
- Ativar o acompanhamento de viagens do consumidor: para viagens sob demanda, use os recursos de experiência do consumidor do Fleet Engine e integre o SDK do consumidor aos seus apps para dispositivos móveis ou da Web. Dessa forma, os consumidores podem usar o mesmo app para solicitar uma viagem e acompanhar o trajeto.
- Fornecer informações em tempo real sobre pacotes para os clientes: para tarefas programadas, use os recursos de experiência do consumidor do Fleet Engine e integre o SDK do JavaScript para consumidor ao seu app da Web. Isso pode fornecer aos consumidores atualizações quase em tempo real sobre o status dos pacotes. O SDK oferece filtros integrados e privacidade de dados 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 JavaScript de rastreamento de frotas 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 do Driver é um kit de ferramentas para apps para dispositivos móveis e um componente fundamental do Fleet Engine. Ele usa a funcionalidade dos veículos. Com esse SDK, seu app de direção pode gerenciar as atribuições de trabalho e ativar os recursos de navegação e trajeto do motorista. 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 usando a versão para consumidor do Google Maps, mas sem precisar mudar para outro app.
Mais especificamente, você pode oferecer o seguinte com essas soluções:
Viagens on demand
- A posição em tempo real do veículo do motorista ajustada à via.
- O trajeto real do motorista com informações de trânsito em tempo real.
- O horário previsto de chegada para os locais de retirada e entrega.
- Rastreamento de viagens com um ou 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 correspondências para as corridas solicitadas.
Tarefas agendadas
- Atualizações de localização em tempo real renderizadas no mapa.
- HECs ajustados automaticamente que refletem mudanças nas circunstâncias, como o 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
Nesta seção, descrevemos uma visão geral das operações dos sistemas do Fleet Engine para cada oferta de mobilidade.
Viagens on demand
O diagrama a seguir mostra duas partes importantes das viagens on demand: o início do dia, quando os motoristas ativam o compartilhamento de local com o Fleet Engine, e uma visualização simplificada do gerenciamento de viagens usando os componentes do Fleet Engine. Para uma visualizaçã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 entrega para um único motorista, além de como o trabalho é processado no sistema do Fleet Engine usando a biblioteca de rastreamento de frotas.
Observação: seu sistema pode usar o rastreamento de remessas ou de frotas. Com o rastreamento de remessas, o Fleet Engine filtra as informações de remessa e do motorista para que o cliente veja apenas as informações relevantes para a remessa dele.
Arquitetura do Fleet Engine
Nesta seção, apresentamos uma arquitetura de sistema para as diferentes ofertas do Fleet Engine. Os dois serviços usam o seguinte:
- Um veículo: as viagens sob demanda e as tarefas programadas dependem de um veículo como uma forma de modelar os veículos reais da sua empresa usados para realizar as operações. No Fleet Engine, uma entidade de veículo recebe informações de localização fornecidas pelo veículo real associado por meio do app do motorista integrado ao SDK do Driver. Os veículos do Fleet Engine são, em grande parte, entidades paralelas entre os dois serviços, com algumas diferenças. Leia a Introdução aos veículos para entender os veículos no Fleet Engine.
- SDK do Driver: para tarefas sob demanda e programadas, o SDK do Driver é um componente fundamental. O SDK do Driver se integra ao app do motorista e fornece ao Fleet Engine um fluxo de atualizações de local, além de informações de trajeto que o Fleet Engine usa para informar o status em tempo real da viagem, além de outras informações, como o HEC e dados de trânsito.
- O SDK do consumidor: um benefício importante para tarefas sob demanda e programadas é o SDK do consumidor, usado para informar ao consumidor o status da corrida, da entrega de comida ou da entrega programada de pacotes.
Viagens on demand
Para uma explicação sobre veículos, viagens e SDKs, consulte a documentação relacionada a viagens sob demanda:
Tarefas agendadas
Para uma explicação sobre veículos de entrega, tarefas e SDKs, consulte a documentação relacionada a tarefas programadas:
Recursos
Viagens on demand
| 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, 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 de recurso é 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 sim 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 de recurso, estruturados de modo a indicar a hierarquia.
- Um ID de coleção: uma coleção contém recursos ou outras coleções.
Viagens on demand
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 de nome. Essas são variáveis para os IDs que você fornece ao emitir uma solicitação de criação.
Viagens on demand
{provider}: o ID do projeto na nuvem. Criado uma vez por projeto.{vehicle}: o recurso de veículo, usado para cada criação de veículo, normalmente reutilizado para o mesmo par de motorista e veículo.{trip}: o recurso de viagem, usado para cada viagem e que não costuma ser reutilizado.
Tarefas agendadas
{provider}: o ID do projeto na nuvem. Criado uma vez por projeto.{vehicle}: o recurso de veículo de entrega, usado para cada criação de veículo, normalmente reutilizado para o mesmo par de motorista e veículo.{task}: o recurso de tarefa, usado para cada tarefa e que 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 básico de geração de registros que permite salvar as solicitações de API e os payloads de resposta. Com esses registros, é possível depurar sua 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 | Configurar o projeto na nuvem. | Nesta etapa, você vai criar 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 conta de serviço. |
| 2 | Verificar sua configuração | Depois de criar contas de serviço, verifique se a configuração foi 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 on demand ou tarefas programadas. Para saber mais, consulte o conteúdo de visão geral sobre Viagens sob demanda ou Tarefas programadas. |
| 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 conhecer sua integração antes de fazer uma implantação em grande escala. Consulte Configurar o Fleet Engine para mais detalhes. |
A seguir
- Entenda os veículos do Fleet Engine.
- Aprenda mais sobre viagens on demand ou tarefas programadas.
- Configure o Fleet Engine.