Zum Hauptinhalt springen

Get available deliveries for GPS tracking

GET 
/truckers/deliveries/trackable

Dieser Endpunkt liefert eine Liste von laufenden Sendungen, die per GPS in Echtzeit verfolgt werden können.

Hauptmerkmale:

  • Enthält nur Sendungen mit dem Status 'collected' (abgeholt, aber noch nicht zugestellt)
  • Sendungen im Zusammenhang mit Auktionen werden ausgeschlossen
  • Liefert wesentliche Informationen für die Verfolgung:
    • Eindeutiger Servicecode
    • Aktueller Sendungsstatus
    • Vollständige Adressen für Beladung (ETL) und Entladung (ETD)
    • Geografische Koordinaten, falls verfügbar
    • Letzte bekannte Position des Fahrzeugs (falls verfügbar)

Typische Anwendungsfälle:

  • Anzeige aller aktiven Sendungen in der Karte des Transporteurs
  • Auswahl einer bestimmten Sendung zur GPS-Verfolgung
  • Überprüfung, welche Sendungen sich aktuell auf der Route befinden
  • Planung mehrerer Routen bei mehreren aktiven Sendungen
  • Überwachung des Fortschritts laufender Sendungen

Validierungen und Einschränkungen:

  • Erfordert eine gültige JWT-Authentifizierung des Transporteurs
  • Zeigt nur dem authentifizierten Transporteur zugewiesene Sendungen an
  • Sendungen müssen den Status 'collected' haben, um aufzutauchen
  • Abgeschlossene oder stornierte Sendungen werden nicht berücksichtigt
  • Maximale Abfragehäufigkeit: 1 Mal pro Minute

Beispielablauf:

  1. Transporteur meldet sich in der mobilen App an
  2. Die App fragt diesen Endpunkt regelmäßig ab (alle 2-5 Minuten)
  3. Aktive Sendungen werden mit ihrer letzten Position auf der Karte angezeigt
  4. Der Transporteur wählt eine Sendung für die detaillierte Verfolgung aus

Technische Hinweise:

  • Koordinaten werden im Format [Längengrad, Breitengrad] (GeoJSON) zurückgegeben
  • Der Status 'collected' zeigt an, dass die Fracht abgeholt, aber noch nicht zugestellt wurde
  • Adressen enthalten Stadt, Postle

Request​

Responses​

Liste der verfügbaren Sendungen zur GPS-Verfolgung.

Response Headers
    X-Total-Count

    Gesamtzahl der nachverfolgbaren Lieferungen

    Example: 2
    X-RateLimit-Remaining

    Anzahl der verbleibenden Abfragen im aktuellen Zeitraum

    Example: 58