Pular para o conteúdo principal

Get available deliveries for GPS tracking

GET 
/truckers/deliveries/trackable

Este endpoint retorna uma lista de entregas em andamento que podem ser rastreadas via GPS em tempo real.

Principais características:

  • Inclui apenas entregas com status 'collected' (coletadas, mas não entregues)
  • Exclui entregas associadas a leilões
  • Fornece informações essenciais para rastreamento:
    • Código de serviço único
    • Status atual da entrega
    • Endereços completos de coleta (ETL) e descarga (ETD)
    • Coordenadas geográficas, se disponíveis
    • Última posição conhecida do veículo (se disponível)

Casos de uso típicos:

  • Visualizar todas as entregas ativas no mapa do transportador
  • Selecionar uma entrega específica para iniciar rastreamento GPS
  • Verificar quais entregas estão atualmente em rota
  • Planejar rotas múltiplas quando há várias entregas ativas
  • Monitorar o progresso das entregas em andamento

Validações e restrições:

  • Requer autenticação JWT válida do transportador
  • Mostra apenas entregas atribuídas ao transportador autenticado
  • As entregas devem estar com status 'collected' para aparecer
  • Não inclui entregas concluídas ou canceladas
  • Frequência máxima de consulta: 1 vez por minuto

Exemplo de fluxo:

  1. O transportador faz login no aplicativo móvel
  2. O app consulta este endpoint periodicamente (a cada 2-5 minutos)
  3. As entregas ativas são exibidas no mapa com sua última posição
  4. O transportador seleciona uma para iniciar rastreamento detalhado

Notas técnicas:

  • As coordenadas são retornadas no formato [longitude, latitude] (GeoJSON)
  • O status 'collected' indica que a carga foi coletada, mas não entregue
  • Os endereços incluem cidade, código postal e província
  • A resposta inclui o cabeçalho X-Total-Count com o número total de entregas

Request​

Responses​

Lista de entregas disponíveis para rastreamento por GPS

Response Headers
    X-Total-Count

    Número total de entregas rastreáveis

    Example: 2
    X-RateLimit-Remaining

    Número de consultas restantes no período atual

    Example: 58