Aller au contenu principal

Update GPS tracking position

POST 
/truckers/deliveries/tracking/:service_code

Cet endpoint enregistre la position GPS actuelle du véhicule pour une livraison en cours et met à jour l'état du suivi.

Fonctionnalités clés :

  • Enregistre des coordonnées GPS précises (latitude, longitude)
  • Stocke l'horodatage exact de la position (UTC)
  • Met à jour la dernière position connue du transporteur
  • Associe automatiquement la position à la livraison spécifiée
  • Conserve l'historique des positions pour la traçabilité

Cas d'utilisation principaux :

  • Suivi en temps réel pendant le transport
  • Génération d'itinéraires optimisés basés sur la position actuelle
  • Calcul des temps d'arrivée estimés (ETA) dynamiques
  • Vérification géographique pour les processus de chargement/déchargement
  • Surveillance de flotte et gestion des actifs

Validations et exigences :

  • Fonctionne uniquement pour les livraisons à l'état 'collecté'
  • Les coordonnées GPS doivent être valides (lat : -90 à 90, lng : -180 à 180)
  • L'horodatage doit être actuel (pas plus de 5 minutes de différence)
  • Maximum 1 mise à jour par minute pour éviter le spam

Exemple de flux :

  1. L'application mobile obtient la position GPS de l'appareil
  2. Envoie la position à l'endpoint toutes les 2-5 minutes
  3. Le système met à jour la position et recalcule l'ETA
  4. L'entreprise peut visualiser la position en temps réel

Notes techniques :

  • Les coordonnées sont stockées au format GeoJSON
  • L'horodatage est automatiquement converti en UTC
  • Les positions anciennes sont archivées après 30 jours

Request​

Responses​

Position enregistrée correctement

Response Headers
    X-RateLimit-Remaining

    Nombrebre de mises à jour restantes dans la période actuelle

    Example: 58