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.
Verwenden Sie SearchTripsRequest für gRPC oder trips.Search für REST.
Aktive Fahrten für ein Fahrzeug ermitteln
Wenn Sie die aktiven Fahrten für bestimmte Felder finden möchten, verwenden Sie die SearchTripsRequest-Nachricht, um vehicle_id auf das betreffende Fahrzeug und active_trips_only auf true festzulegen.
Fahrzeugverfügbarkeit zwischen Ihrem System und der 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 finden, können Sie Fahrzeuge prüfen, um sicherzustellen, dass TripStatus in Ihrem System mit dem der Fleet Engine übereinstimmt.
Wenn Sie SearchTrips auf diese Weise verwenden möchten, legen Sie Folgendes in der SearchTripsRequest-Nachricht fest:
vehicle_idsollte leer sein.active_trips_onlysolltetruelauten.minimum_stalenesssollte eine Zeitspanne sein, die länger als die meisten Fahrtdauern ist, z. B. eine Stunde.
Die Ergebnisse einer solchen Anfrage enthalten 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 Fleet Engine korrekt aktualisiert wurde.