Fleet Engine stellt den Endpunkt SearchTripsRequest
bereit, mit dem Sie Fahrten finden können. In diesem Dokument werden zwei Szenarien beschrieben, in denen Sie diese Funktion verwenden können.
Sehen Sie unter SearchTripsRequest
nach, wenn es sich um gRPC handelt, oder unter trips.Search
, wenn es sich um REST handelt.
Aktive Fahrten für ein Fahrzeug ermitteln
Wenn Sie die aktiven Fahrten für bestimmte Felder ermitteln möchten, verwenden Sie die SearchTripsRequest
-Nachricht, um vehicle_id
auf das betreffende Fahrzeug und active_trips_only
auf true
festzulegen.
Fahrzeugverfügbarkeit in Ihrem System und in Fleet Engine abgleichen
In einigen Fällen werden von SearchVehicles
Ergebnisse zurückgegeben, die nicht den Fahrzeugen entsprechen, die in Ihrem System und Ihrer Flotte verfügbar sind. Das liegt daran, dass SearchVehicles
entweder keine Fahrzeuge mit aktiven Fahrten anzeigt oder sie im Ranking der Ergebnisse nach unten verschiebt. Eine mögliche Ursache dafür ist, dass Fahrzeuge Fahrten ausgeführt haben, der Fahrtstatus aber nicht richtig auf COMPLETE
oder CANCELED
festgelegt wurde. Wenn Sie mit SearchTrips
offene Fahrten suchen, können Sie Fahrzeuge prüfen, um sicherzustellen, dass TripStatus
in Ihrem System mit dem der Fleet Engine übereinstimmt.
Wenn du SearchTrips
auf diese Weise verwenden möchtest, musst du in der SearchTripsRequest
-Nachricht Folgendes festlegen:
vehicle_id
sollte leer sein.active_trips_only
solltetrue
lauten.minimum_staleness
sollte eine Zeitspanne sein, die länger als die meisten Fahrtdauern ist, z. B. eine Stunde.
Die Ergebnisse einer solchen Anfrage umfassen Fahrten, die weder COMPLETE
noch CANCELED
sind und seit über einer Stunde nicht aktualisiert wurden. Sie können dann prüfen, ob der Status dieser Fahrten in der Fleet Engine korrekt aktualisiert wurde.