Passa al contenuto principale

Get available deliveries for GPS tracking

GET 
/truckers/deliveries/trackable

Questo endpoint restituisce un elenco di consegne in corso che possono essere tracciate tramite GPS in tempo reale.

Caratteristiche principali:

  • Include solo consegne nello stato 'collected' (ritirate ma non consegnate)
  • Esclude consegne associate ad aste
  • Fornisce informazioni essenziali per il tracciamento:
    • Codice servizio univoco
    • Stato attuale della consegna
    • Indirizzi completi di carico (ETL) e scarico (ETD)
    • Coordinate geografiche se disponibili
    • Ultima posizione nota del veicolo (se disponibile)

Casi d'uso tipici:

  • Visualizzare tutte le consegne attive sulla mappa del trasportatore
  • Selezionare una consegna specifica per avviare il tracciamento GPS
  • Verificare quali consegne sono attualmente in viaggio
  • Pianificare percorsi multipli quando ci sono più consegne attive
  • Monitorare il progresso delle consegne in corso

Validazioni e restrizioni:

  • Richiede autenticazione JWT valida del trasportatore
  • Mostra solo consegne assegnate al trasportatore autenticato
  • Le consegne devono essere nello stato 'collected' per apparire
  • Non include consegne completate o annullate
  • Frequenza massima di interrogazione: 1 volta al minuto

Esempio di flusso:

  1. Il trasportatore accede all'app mobile
  2. L'app interroga questo endpoint periodicamente (ogni 2-5 minuti)
  3. Le consegne attive vengono mostrate sulla mappa con la loro ultima posizione
  4. Il trasportatore ne seleziona una per avviare il tracciamento dettagliato

Note tecniche:

  • Le coordinate vengono restituite nel formato [longitudine, latitudine] (GeoJSON)
  • Lo stato 'collected' indica che il carico è stato ritirato ma non consegnato
  • Gli indirizzi includono città, codice postale e provincia
  • La risposta include l'int

Request​

Responses​

Elenco delle consegne disponibili per il monitoraggio GPS

Response Headers
    X-Total-Count

    Numero totale di consegne tracciabili

    Example: 2
    X-RateLimit-Remaining

    Numero di consultazioni rimanenti nel periodo corrente

    Example: 58