Pular para o conteúdo principal

Update GPS tracking position

POST 
/truckers/deliveries/tracking/:service_code

Este endpoint registra a posição GPS atual do veículo para uma entrega em andamento e atualiza o status de rastreamento.

Funcionalidades principais:

  • Registra coordenadas GPS precisas (latitude, longitude)
  • Armazena timestamp exato da posição (UTC)
  • Atualiza a última posição conhecida do transportador
  • Associa automaticamente a posição à entrega especificada
  • Mantém histórico de posições para rastreabilidade

Casos de uso principais:

  • Rastreamento em tempo real durante o transporte
  • Geração de rotas otimizadas baseadas na posição atual
  • Cálculo de tempos estimados de chegada (ETA) dinâmicos
  • Verificação geográfica para processos de carga/descarga
  • Monitoramento de frota e gestão de ativos

Validações e requisitos:

  • Funciona apenas para entregas no status 'collected'
  • Coordenadas GPS devem ser válidas (lat: -90 a 90, lng: -180 a 180)
  • Timestamp deve ser atual (não mais que 5 minutos de diferença)
  • Máximo de 1 atualização por minuto para evitar spam

Exemplo de fluxo:

  1. App móvel obtém posição GPS do dispositivo
  2. Envia posição ao endpoint a cada 2-5 minutos
  3. Sistema atualiza posição e recalcula ETA
  4. Empresa pode visualizar posição em tempo real

Notas técnicas:

  • As coordenadas são armazenadas no formato GeoJSON
  • O timestamp é convertido automaticamente para UTC
  • As posições antigas são arquivadas após 30 dias

Request​

Responses​

Posição registrada corretamente

Response Headers
    X-RateLimit-Remaining

    Número de atualizações restantes no período atual

    Example: 58