Zum Hauptinhalt springen

Update GPS tracking position

POST 
/truckers/deliveries/tracking/:service_code

Dieser Endpunkt registriert die aktuelle GPS-Position des Fahrzeugs für eine laufende Lieferung und aktualisiert den Sendungsstatus.

Wesentliche Funktionen:

  • Registriert präzise GPS-Koordinaten (Breitengrad, Längengrad)
  • Speichert den genauen Zeitstempel der Position (UTC)
  • Aktualisiert die letzte bekannte Position des Transporteurs
  • Ordnet die Position automatisch der angegebenen Lieferung zu
  • Führt einen Positionsverlauf für die Rückverfolgbarkeit

Hauptanwendungsfälle:

  • Echtzeit-Nachverfolgung während des Transports
  • Generierung optimierter Routen basierend auf der aktuellen Position
  • Berechnung dynamischer geschätzter Ankunftszeiten (ETA)
  • Geografische Verifizierung für Be- und Entladevorgänge
  • Flottenüberwachung und Asset-Management

Validierungen und Anforderungen:

  • Funktioniert nur für Lieferungen im Status 'collected' (abgeholt)
  • GPS-Koordinaten müssen gültig sein (lat: -90 bis 90, lng: -180 bis 180)
  • Zeitstempel muss aktuell sein (max. 5 Minuten Differenz)
  • Maximal 1 Aktualisierung pro Minute, um Spam zu vermeiden

Beispielablauf:

  1. Mobile App erfasst die GPS-Position des Geräts
  2. Sendet die Position alle 2-5 Minuten an den Endpunkt
  3. System aktualisiert die Position und berechnet die ETA neu
  4. Unternehmen kann die Position in Echtzeit visualisieren

Technische Hinweise:

  • Koordinaten werden im GeoJSON-Format gespeichert
  • Der Zeitstempel wird automatisch in UTC konvertiert
  • Alte Positionen werden nach 30 Tagen archiviert

Request​

Responses​

Position erfolgreich registriert.

Response Headers
    X-RateLimit-Remaining

    Anzahl der verbleibenden Aktualisierungen im aktuellen Zeitraum

    Example: 58