O Fleet Engine é um serviço de back-end que se integra ao sistema que você usa para gerenciar serviços de transporte para seus clientes. Ele interage com várias APIs e SDKs para melhorar o mapeamento, o roteamento e o gerenciamento de localizações.
O Fleet Engine fornece atualizações de roteamento e status para entidades de veículos modeladas na frota de veículos reais. À 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 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 Fleet Engine funciona com as seguintes ofertas de serviço de mobilidade:
- Viagens sob demanda: nessa oferta, o Motor de frota simula o ciclo de vida de uma viagem, desde a origem, passando pelas paradas, até o destino. No ciclo de vida de uma viagem, um veículo passa por locais de retirada, pontos intermediários e locais de entrega como forma de realizar uma viagem reservada por um pedido do consumidor. Consulte a documentação de Viagens sob demanda para saber mais sobre as 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 saber mais sobre o assunto.
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, você pode usar os recursos de experiência do consumidor do Motor de frota e integrar o SDK do consumidor aos seus apps para dispositivos móveis ou Web. Dessa forma, os consumidores podem usar o mesmo app para fazer uma solicitação de viagem e acompanhar a jornada.
- Fornecer 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 do consumidor 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 acessem apenas as informações relevantes para o pedido.
- Projetar soluções para operadores de frota: para tarefas programadas, use a biblioteca de rastreamento de frotas JavaScript para que os operadores de frotas possam coordenar e gerenciar melhor as atribuições de veículos ao longo do dia.
- Melhorar a experiência dos motoristas: o SDK do motorista é um kit de ferramentas para apps para dispositivos móveis e um componente fundamental do Motor de frota. Ele usa a funcionalidade dos veículos. Com esse SDK, seu app de direção pode gerenciar atribuições de trabalho e ativar os recursos de navegação e roteamento 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 para o Fleet Engine sobre o status do veículo. Com esse SDK, o motorista pode usar um único app para gerenciar as alocaçõ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 em tempo real.
- O trajeto do motorista com informações de trânsito em tempo real.
- O horário estimado de chegada para os locais de retirada e entrega.
- Rastreamento para viagens únicas, com vários destinos e consecutivas.
- Viagens compartilhadas 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 viagens solicitadas.
Tarefas agendadas
- Atualizações de local em tempo real renderizadas no mapa.
- Tempos estimados de chegada 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
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 importantes das viagens sob demanda: o início do dia, quando os motoristas ativam o compartilhamento de local para 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 de envio típico para um único motorista e como o trabalho dele é processado no sistema do Fleet Engine usando a biblioteca Fleet Tracking.
Observação: seu sistema pode usar o rastreamento de remessas ou de frota. Com o rastreamento de frete, o Fleet Engine filtra as informações do envio e do motorista para que o cliente veja apenas informações relevantes para o envio.
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 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 local fornecidas pelo veículo real associado pelo app de 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 motorista se integra ao seu app de motorista e fornece ao Fleet Engine um fluxo de atualizações de local e informações de trajeto que ele usa para informar o status em tempo real da viagem, além de outras informações, como tempo estimado de chegada e dados de trânsito.
- O SDK do consumidor: um dos principais benefícios para tarefas sob demanda e programadas é o SDK do consumidor, usado para informar ao consumidor o status da viagem, entrega de comida ou entrega de pacotes programada.
Viagens sob demanda
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 os veículos de entrega, as tarefas e os SDKs, consulte a documentação relacionada às 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} |
|
Como nomear 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 em 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 de recurso, estruturados de uma maneira que indica a hierarquia deles.
- 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 colchetes no campo de nome. São variáveis para os IDs fornecidos 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, geralmente reutilizado para o mesmo par motorista-veículo.{trip}: seu recurso de viagem, usado para todas as viagens e normalmente não reutilizado.
Tarefas agendadas
{provider}: é o ID do projeto do Cloud. Criada uma vez por projeto.{vehicle}: seu recurso de veículo de entrega, usado para cada criação de veículo, geralmente 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 registro básico que permite salvar as solicitações de API e os payloads de resposta. Com esses registros, você pode 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. | Você cria vários papéis de conta de serviço nesta etapa, 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 as instruções em Criar seu projeto do Fleet Engine. Para entender melhor esses papéis, leia Papéis da conta de serviço. |
| 2 | Verificar a configuração | Depois de criar contas de serviço, verifique se a configuração foi 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 a 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 das Viagens sob demanda ou das 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 fictícios para analisar a 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.
- Configurar o Fleet Engine.