Fleet Engine bietet den SearchTripsRequest-Endpunkt, mit dem Sie Fahrten finden 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, verwenden Sie die Nachricht SearchTripsRequest, um vehicle_id auf das betreffende Fahrzeug und active_trips_only auf true festzulegen.
Fahrzeugverfügbarkeit zwischen Ihrem System und Fleet Engine abgleichen
In einigen Fällen werden möglicherweise Ergebnisse von SearchVehicles zurückgegeben, die nicht den Fahrzeugen entsprechen, die in Ihrem System und Ihrer Flotte verfügbar sind. Das liegt daran, dass in SearchVehicles entweder keine Fahrzeuge mit aktiven Fahrten angezeigt werden oder sie in der Ergebnisrangfolge nach unten verschoben werden. Eine Ursache dafür ist, dass Fahrzeuge Fahrten abgeschlossen haben, der Fahrtstatus aber nicht richtig auf COMPLETE oder CANCELED gesetzt wurde. Wenn Sie SearchTrips verwenden, um offene Fahrten zu finden, können Sie Fahrzeuge prüfen, um sicherzustellen, dass TripStatus in Ihrem System mit dem von 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 Zeit sein, die länger als die meisten Fahrten dauert, 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. Anschließend können Sie diese Fahrten untersuchen, um sicherzustellen, dass ihr Status in Fleet Engine richtig aktualisiert wird.