Rechercher des voyages

Fleet Engine fournit le point de terminaison SearchTripsRequest que vous pouvez utiliser pour trouver des trajets. Ce document décrit deux scénarios dans lesquels vous pouvez utiliser cette fonctionnalité.

Consultez SearchTripsRequest pour gRPC ou trips.Search pour REST.

Déterminer les trajets actifs d'un véhicule

Pour trouver les trajets actifs pour un champ spécifique, utilisez le message SearchTripsRequest pour définir vehicle_id sur le véhicule concerné et définir active_trips_only sur true.

Réconcilier la disponibilité des véhicules entre votre système et Fleet Engine

Dans certains cas, les résultats renvoyés par SearchVehicles peuvent ne pas correspondre aux véhicules que vous savez disponibles dans votre système et votre parc. Cela se produit parce que SearchVehicles n'affiche pas les véhicules avec des trajets actifs ou les fait descendre dans le classement des résultats. Cela peut se produire lorsque les véhicules ont terminé des trajets, mais que l'état du trajet n'a pas été correctement défini sur COMPLETE ou CANCELED. En utilisant SearchTrips pour trouver les trajets ouverts, vous pouvez évaluer les véhicules pour vous assurer que TripStatus dans votre système correspond à celui de Fleet Engine.

Pour utiliser SearchTrips de cette manière, définissez les éléments suivants dans le message SearchTripsRequest:

  • vehicle_id doit être vide.
  • active_trips_only doit être true.
  • minimum_staleness doit être une durée supérieure à la plupart des durées de trajet, par exemple une heure.

Les résultats d'une telle requête incluent les trajets qui ne sont ni COMPLETE ni CANCELED et qui n'ont pas été mis à jour depuis plus d'une heure. Vous pouvez ensuite examiner ces trajets pour vous assurer que leur état dans Fleet Engine est correctement mis à jour.

Étape suivante