Reisen suchen

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_id sollte leer sein.
  • active_trips_only sollte true sein.
  • minimum_staleness sollte 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.

Nächste Schritte