Fleet Engine bietet den Endpunkt SearchTripsRequest, mit dem Sie Fahrten suchen können. In diesem Dokument werden zwei Szenarien beschrieben, in denen Sie diese Funktion verwenden können.
Weitere Informationen finden Sie unter 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 ermitteln möchten, legen Sie in der Nachricht SearchTripsRequest für vehicle_id das betreffende Fahrzeug fest und setzen Sie active_trips_only auf true.
Fahrzeugverfügbarkeit zwischen Ihrem System und Fleet Engine abgleichen
In einigen Fällen werden von SearchVehicles Ergebnisse zurückgegeben, die nicht mit den Fahrzeugen übereinstimmen, die in Ihrem System und Ihrer Flotte als verfügbar bekannt sind. Das liegt daran, dass SearchVehicles entweder keine Fahrzeuge mit aktiven Fahrten anzeigt oder sie in der Rangfolge der Ergebnisse nach unten verschiebt. Ein Grund dafür ist, dass Fahrten abgeschlossen wurden, der Fahrtstatus aber nicht ordnungsgemäß auf COMPLETE oder CANCELED gesetzt wurde. Mit SearchTrips können Sie offene Fahrten suchen und so prüfen, ob der TripStatus in Ihrem System mit dem in Fleet Engine übereinstimmt.
Wenn Sie SearchTrips auf diese Weise verwenden möchten, legen Sie in der SearchTripsRequest
Nachricht Folgendes fest:
vehicle_idsollte leer sein.active_trips_onlysolltetruesein.minimum_stalenesssollte eine Zeit 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 mehr als einer Stunde nicht aktualisiert wurden. Sie können diese Fahrten dann prüfen, um sicherzustellen, dass ihr Status in Fleet Engine ordnungsgemäß aktualisiert wird.