Pular para o conteúdo principal

Posições e Serviços de Rota

Esta página explica como obter posições de veículos e histórico de rotas com a Fleet API, para públicos de negócio e técnicos.

Acrónimos e Termos​

  • API: Application Programming Interface.
  • GPS: Global Positioning System.

Que Endpoint Devo Usar?​

Use este mapeamento quando os clientes pedirem dados de localização:

1) Todas as Posições GPS​

O que Significa​

Obter eventos de posição histórica num período para reconstruir por onde o veículo passou.

Melhores Endpoints​

Interpretação de Negócio​

  • Use para investigação, replay de rota, prova de presença e auditorias operacionais.
  • É a melhor fonte quando o utilizador pede "todos os pontos" num intervalo temporal.

Interpretação para Programadores​

  • Trate eventos como pontos de telemetria histórica.
  • Faça queries por janelas temporais e paginação conforme necessário.
  • Para períodos longos, faça fetch por blocos para evitar respostas demasiado grandes.

2) Tracking Contínuo (Tempo Quase Real)​

O que Significa​

Mostrar continuamente a última posição conhecida dos veículos, de forma semelhante a um mapa de frota em tempo real.

Melhor Endpoint​

Interpretação de Negócio​

  • Use para operação diária em tempo real e monitorização por equipas de despacho.
  • É a melhor opção para casos de uso "onde está o veículo agora?".

Interpretação para Programadores​

  • Implemente polling (por exemplo, a cada 10 a 30 segundos) para atualizar os estados mais recentes.
  • Isto é polling de estado em tempo quase real, não um stream websocket.
  • Combine com endpoints de events quando precisar de detalhe histórico ao nível de breadcrumb.

3) Histórico Completo de Rota​

O que Significa​

Dependendo da intenção do cliente, "histórico de rota" pode significar:

  • Pontos breadcrumb completos de uma viagem, ou
  • Resumos de viagem com local de início e fim.

Seleção de Endpoint​

Interpretação de Negócio​

  • Use trips para reporting e análise de KPIs ao nível da viagem.
  • Use events quando analistas precisarem de detalhe ao nível do percurso.

Interpretação para Programadores​

  • Trips são registos de resumo e não devem ser tratados como datasets completos de pontos de rota.
  • Para replay completo da rota, construa a partir de dados de events no intervalo temporal selecionado.

Padrão de Implementação Recomendado​

Para a maioria das aplicações de frota:

  1. Faça polling do endpoint de estado de veículos para o estado atual no mapa.
  2. Use endpoints de events para reprodução histórica de rotas.
  3. Use endpoints de trips para reporting de viagens (início/fim e contexto da viagem).