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 locais.
O Fleet Engine fornece atualizações de status e roteamento 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, o Fleet Engine usa informações de localização e roteamento do veículo em tempo real fornecidas pelo SDK do Driver para gerar relatórios precisos sobre as jornadas do veículo: HECs, informações de tráfego e disponibilidade do veículo.
O serviço do Fleet Engine funciona com as duas ofertas de serviço de mobilidade a seguir:
- Viagens sob demanda: nessa oferta, o Fleet Engine modela o ciclo de vida de uma viagem, da origem, passando por paradas, até o destino. Em um ciclo de vida de viagem, um veículo passa por locais de embarque, pontos de referência 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 mais detalhes sobre viagens sob demanda.
- 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 chamada de serviço. Consulte a documentação de tarefas programadas para mais detalhes.
O que você pode fazer com o Fleet Engine
Usando os componentes do Fleet Engine, você pode fazer o seguinte:
- Ativar o rastreamento de viagens do consumidor: para viagens sob demanda, você pode usar os recursos de experiência do consumidor do Fleet Engine e integrar o SDK do consumidor aos seus apps para dispositivos móveis ou da Web. Dessa forma, os consumidores podem usar o mesmo app para fazer uma solicitação de viagem e rastrear o trajeto.
- Fornecer informações de pacotes em tempo real para os clientes: para tarefas programadas, você pode usar os recursos de experiência do consumidor do Fleet Engine e integrar o SDK do consumidor do JavaScript 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 de operador de frota: para tarefas programadas, use a biblioteca de rastreamento de frota do JavaScript para que os operadores de frota possam coordenar e gerenciar melhor as atribuições de veículos ao longo do dia.
- Melhorar a experiência dos motoristas: o SDK do Driver é um kit de ferramentas de apps para dispositivos móveis e um componente fundamental do Fleet Engine. Ele usa funcionalidades dos veículos. Com esse SDK, o app de direção pode gerenciar atribuições de trabalho e ativar recursos de navegação e roteamento do motorista. Basicamente, o SDK usa um listener de eventos para enviar atualizações de localização 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 do 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 na estrada em tempo real.
- O trajeto real do motorista com informações de trânsito em tempo real.
- O horário previsto de chegada para locais de retirada e desembarque.
- Rastreamento de viagens únicas, com vários destinos e consecutivas.
- 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 viagens solicitadas.
Tarefas programadas
- Atualizações de localização em tempo real renderizadas no mapa.
- Horários previstos de chegada 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 visualização simplificada do gerenciamento de viagens usando 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 programadas
O diagrama a seguir mostra uma matriz de um dia de trabalho de envio típico para um único motorista, além de como o trabalho é 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 as informações de remessa e do motorista para que o cliente veja apenas as informações relevantes para a remessa.
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: viagens sob demanda e tarefas programadas dependem de um veículo como um meio de modelar os veículos reais da sua empresa usados para realizar suas operações. No Fleet Engine, uma entidade de veículo recebe informações de localização fornecidas pelo veículo real associado a ela pelo app do motorista integrado ao SDK do 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.
- O 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 stream de atualizações de localização, além de 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 o horário previsto de chegada e dados de trânsito.
- O SDK do consumidor: um benefício fundamental para tarefas sob demanda e programadas é o SDK do consumidor, usado para informar ao consumidor o status da viagem, da entrega de comida ou da entrega de pacotes programada.
Viagens sob demanda
Para uma explicação sobre veículos, viagens e SDKs, consulte a documentação relacionada para viagens sob demanda:
Tarefas programadas
Para uma explicação sobre veículos de entrega, tarefas e SDKs, consulte a documentação relacionada 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 programadas
| 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} |
|
Nomes 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 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 IDs de recursos, estruturados de uma maneira que indica 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 programadas
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 sob demanda
{provider}: o ID do projeto do Cloud. Criado uma vez por projeto.{vehicle}: o recurso do veículo, usado para cada criação de veículo, normalmente reutilizado para o mesmo par motorista-veículo.{trip}: o recurso de viagem, usado para cada viagem e normalmente não reutilizado.
Tarefas programadas
{provider}: o ID do projeto do Cloud. Criado uma vez por projeto.{vehicle}: o recurso do veículo de entrega, usado para cada criação de veículo criação, normalmente reutilizado para o mesmo par motorista-veículo.{task}: o recurso de tarefa, usado para cada tarefa e normalmente não reutilizado.
Consulte Nomes de recursos na documentação das APIs do Cloud do Google para mais detalhes.
Registros do Google Cloud para o Fleet Engine
O Fleet Engine oferece um serviço de registro básico que permite salvar as solicitações de API e os payloads de resposta. Com esses registros, você pode 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 | Configure seu projeto na nuvem. | 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) que foram assinados usando contas de serviço criadas no Cloud Console. Siga instruções em Criar seu projeto do Fleet Engine. Para entender melhor esses papéis, leia os Papéis de contas de serviço. |
| 2 | Verifique sua configuração | Depois de criar contas de serviço, verifique se a configuração está concluída e se você pode 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 | Crie 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 da visão geral de viagens sob demanda ou tarefas programadas para saber mais. |
| 4 | Teste sua integração | Os serviços e componentes do Fleet Engine exigem dados em tempo real de uma frota de veículos. A criação, o desenvolvimento e a implantação de apps para uma frota de motoristas podem levar tempo. Por esse motivo, é 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
- Entenda os veículos do Fleet Engine.
- Saiba mais sobre viagens sob demanda ou tarefas programadas.
- Configure o Fleet Engine.