Skip to main content
Trip Tracking cobre duas leituras diferentes da localização de uma viagem:
LeituraEntidadeUso
Último ping aceitoTripTrackingRealtime, mapa ao vivo e detecção de tracking desatualizado.
Histórico completoTripTrackingPointTrajeto percorrido, auditoria, análise de quilometragem e investigação.

​
Fluxo

​
Regras

RegraDescrição
Status da TripGPS só é aceito quando a Trip está IN_PROGRESS.
Motorista autorizadoO ping precisa vir do Driver vinculado à Trip.
Última posiçãoTripTracking mantém apenas a posição mais recente aceita.
Histórico completoCada ping aceito cria um TripTrackingPoint append-only.
OrdenaçãoO trajeto é reconstruído por sequence e acceptedAt.
RejeiçõesPings inválidos não entram no histórico aceito.
EncerramentoAo concluir ou cancelar a Trip, novos pings deixam de ser aceitos.

​
Consultas

GET /api/v1/ops/trips/{tripId}/tracking
GET /api/v1/ops/trips/{tripId}/tracking-points
GET /api/v1/customer/trips/{tripId}/tracking
GET /api/v1/customer/trips/{tripId}/tracking-points
OPS usa o histórico para operação, auditoria e análise. Customer pode usar a leitura permitida para acompanhar uma viagem comprada, respeitando autorização pelo ticket/order.

​
Relação com auditoria de quilometragem

O histórico não calcula fraude sozinho. Ele fornece a base factual para comparar:
  • trajeto planejado da Route;
  • pings aceitos durante a Trip;
  • distância estimada da rota;
  • distância reconstruída pelo histórico;
  • eventos operacionais registrados na viagem.