Informações gerais sobre o rastreamento de frotas

A biblioteca de rastreamento de frotas do JavaScript funciona para os seguintes casos de uso:

  • Viagens sob demanda
  • Tarefas agendadas

Este guia discute como usar essa biblioteca para os dois serviços.

Usando a biblioteca de rastreamento de frotas do JavaScript, você pode permitir que os operadores de frotas visualizem os locais dos veículos em tempo quase real. Se a rota de um veículo for conhecida, o componente de visualização do mapa vai animar esse veículo conforme ele se move ao longo do caminho previsto.

Exemplo de visualização de mapa de rastreamento de frotas

O que é o rastreamento de frotas?

O rastreamento de frota é um recurso do Fleet Engine projetado para operadores de frota. Ele oferece interfaces que modelam e seguem os dados da frota no Fleet Engine e oferece classes que você usa para criar uma exibição de mapa rica e baseada na Web das informações de jornada para os administradores da frota. Exemplo:

  • Permitir que os operadores de viagens sob demanda acompanhem o progresso da viagem em vários veículos.
  • Permita que operadores de envios programados acessem o progresso dos envios da frota em um mapa baseado na Web quase em tempo real.

Você integra a biblioteca ao seu app da Web e define os perfis de função adequados no Fleet Engine para compartilhar jornadas com o consumidor. Para mais informações sobre papéis no Fleet Engine, consulte Papéis de contas de serviço.

Por que usar o rastreamento de frotas?

Ao integrar o rastreamento de frota às operações de frota, você tem uma experiência abrangente de monitoramento de veículos, com atualizações de local quase em tempo real. É possível conferir um ou todos os locais dos veículos da frota em um mapa, incluindo detalhes de paradas ou pontos de passagem que ajudam a entender o desempenho da frota.

O que você pode fazer com o rastreamento de frotas?

Com as informações da biblioteca de rastreamento de frota, é possível criar visualizações detalhadas das operações da frota com os seguintes recursos:

  • Personalize as personalizações da interface do mapa de rastreamento de frotas de acordo com suas necessidades.

  • Confira o local atual de um, vários ou todos os veículos à medida que eles percorrem as rotas, com as posições atualizadas periodicamente.

  • Calcule os horários previstos de chegada para a viagem ou entrega, além da distância restante.

  • Confira o progresso do veículo, incluindo viagens concluídas ou status da tarefa.

Componentes

A tabela a seguir descreve os componentes usados no rastreamento de frotas e o que eles fazem.

Viagens sob demanda

Componente Descrição
Visualização do mapa de compartilhamento da jornada A visualização do mapa de compartilhamento de trajetos mostra a localização dos veículos e das viagens. Se o Fleet Engine souber o trajeto de um veículo, o componente de visualização do mapa vai animar esse veículo à medida que ele se move pelo caminho previsto.
Provedor de local do veículo

O provedor de localização do veículo mostra as informações de localização de um único veículo. Ele tem informações sobre a localização do veículo, os waypoints e as viagens atribuídas a ele.

Confira a seguir as regras de visibilidade para veículos e os marcadores de ponto de passagem deles:

  • Veículo: um veículo fica visível assim que é criado no Fleet Engine e quando o vehicle_state é Online. Isso significa que um veículo pode ficar visível mesmo quando não há uma viagem atual atribuída a ele.
  • Marcadores de waypoint: os waypoints planejados do veículo são mostrados no mapa como marcadores de origem, intermediário e destino.
Opções de personalização As opções do provedor de local do veículo permitem personalizar polilinhas e marcadores. É possível colorir e estilizar polilinhas para mostrar vários cenários reais do veículo, como rotas percorridas e tráfego. É possível personalizar marcadores para diferentes finalidades. Também é possível adicionar o processamento de cliques a polilinhas e marcadores.
Listener de eventos do veículo O listener de eventos permite que o operador receba informações sobre as viagens concluídas por um veículo.
Provedor de localização da frota de veículos O provedor de localização da frota mostra informações de localização de vários veículos de entrega. Ao rastrear uma frota, você define limites geográficos e também tem a opção de filtrar por IDs de veículos.

Tarefas agendadas

Componente Descrição
Visualização do mapa de compartilhamento da jornada A visualização do mapa de compartilhamento de trajeto mostra a localização dos veículos de entrega e das tarefas. Se o Fleet Engine souber o trajeto de um veículo, o componente de visualização do mapa vai animar esse veículo à medida que ele se move pelo caminho previsto.
Provedor de localização do veículo de entrega

O provedor de localização do veículo de entrega mostra as informações de localização de um único veículo de entrega. Ele tem informações sobre a localização do veículo, as paradas e as tarefas concluídas pelo veículo de entrega.

Confira a seguir as regras de visibilidade para veículos de entrega, paradas e tarefas:

  • Veículo: um veículo de entrega fica visível assim que é criado no Fleet Engine e durante todo o percurso, independentemente das tarefas.
  • Paradas: as paradas planejadas de veículos são mostradas no mapa como marcadores de parada de veículos. Os marcadores de tarefas concluídas são exibidos com um estilo diferente das paradas planejadas de um veículo.
  • Tarefas: o local dos resultados de tarefas é mostrado com marcadores de resultado de tarefa. As tarefas com um resultado SUCCEEDED são mostradas com marcadores de sucesso, enquanto todas as outras são mostradas com marcadores de falha.
Opções de personalização As opções do provedor de local do veículo de entrega permitem personalizar polilinhas e marcadores. É possível colorir e estilizar polilinhas para mostrar vários cenários reais do veículo, como a rota ativa dele. É possível personalizar marcadores para diferentes finalidades, como para um veículo de entrega. Também é possível adicionar o processamento de cliques a polilinhas e marcadores.
Filtro de tarefas de entrega O filtro de tarefas permite que o operador filtre a visualização de tarefas concluídas antes ou depois de um horário especificado, além de filtrar por tarefas abertas ou fechadas.
Listener de eventos do veículo de entrega O listener de eventos permite que o operador receba informações sobre os segmentos da jornada concluídos por um veículo de entrega, além de uma lista de tarefas atendidas pelo veículo.
Provedor de localização da frota de entrega O provedor de localização da frota de entrega mostra informações de local de vários veículos de entrega. Você pode filtrar para mostrar um veículo de entrega específico e seu local ou mostrar os locais dos veículos de toda a frota.

Como usar o rastreamento de frota

1 Configurar o rastreamento de frotas em JavaScript. Para mais informações, consulte Configurar a biblioteca de rastreamento de frotas do JavaScript.
2 Carregue a biblioteca e inicialize o mapa. Para mais informações, consulte Carregar a biblioteca e inicializar a visualização do mapa.
3 Forneça a localização do veículo e defina a visualização do mapa. Para começar a seguir um veículo, você instancia um provedor de localização com o ID correto do veículo e o usa para inicializar a visualização do mapa. Para mais informações, consulte Fornecer a localização do veículo.
5 Atualizar o progresso da frota e lidar com erros de viagem. Para mais informações, consulte Atualizar o progresso da frota e Lidar com erros.
5 Quando o dia terminar, pare de seguir os veículos da frota. Para mais informações, consulte Parar de acompanhar um veículo de entrega.

A seguir