Passa al contenuto principale

Update GPS tracking position

POST 
/truckers/deliveries/tracking/:service_code

Questo endpoint registra la posizione GPS attuale del veicolo per una consegna in corso e aggiorna lo stato di tracciamento.

Funzionalità chiave:

  • Registra coordinate GPS precise (latitudine, longitudine)
  • Memorizza il timestamp esatto della posizione (UTC)
  • Aggiorna l'ultima posizione nota del corriere
  • Associa automaticamente la posizione alla consegna specificata
  • Mantiene la cronologia delle posizioni per la tracciabilità

Casi d'uso principali:

  • Tracciamento in tempo reale durante il trasporto
  • Generazione di percorsi ottimizzati basati sulla posizione attuale
  • Calcolo dinamico dei tempi stimati di arrivo (ETA)
  • Verifica geografica per i processi di carico/scarico
  • Monitoraggio della flotta e gestione degli asset

Validazioni e requisiti:

  • Funziona solo per consegne nello stato 'collected'
  • Le coordinate GPS devono essere valide (lat: -90 a 90, lng: -180 a 180)
  • Il timestamp deve essere attuale (non più di 5 minuti di differenza)
  • Massimo 1 aggiornamento al minuto per evitare spam

Esempio di flusso:

  1. L'app mobile ottiene la posizione GPS del dispositivo
  2. Invia la posizione all'endpoint ogni 2-5 minuti
  3. Il sistema aggiorna la posizione e ricalcola l'ETA
  4. L'azienda può visualizzare la posizione in tempo reale

Note tecniche:

  • Le coordinate vengono memorizzate in formato GeoJSON
  • Il timestamp viene convertito automaticamente in UTC
  • Le posizioni vecchie vengono archiviate dopo 30 giorni

Request​

Responses​

Posizione registrata correttamente.

Response Headers
    X-RateLimit-Remaining

    Numero di aggiornamenti rimanenti nel periodo corrente

    Example: 58