Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 pour un véhicule
Pour trouver les trajets actifs pour des champs spécifiques, utilisez le message SearchTripsRequest pour définir vehicle_id sur le véhicule concerné et active_trips_only sur true.
Rapprocher la disponibilité des véhicules entre votre système et Fleet Engine
Dans certains cas, vous pouvez voir des résultats renvoyés par SearchVehicles qui ne correspondent pas aux véhicules que vous savez être disponibles dans votre système et votre flotte. En effet, 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 des 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 des 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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eFleet Engine's \u003ccode\u003eSearchTripsRequest\u003c/code\u003e helps find trips, useful for identifying active trips and reconciling vehicle availability.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003eSearchTripsRequest\u003c/code\u003e with \u003ccode\u003evehicle_id\u003c/code\u003e and \u003ccode\u003eactive_trips_only\u003c/code\u003e to find a specific vehicle's active trips.\u003c/p\u003e\n"],["\u003cp\u003eDiscrepancies between your system and Fleet Engine's vehicle availability can be addressed by using \u003ccode\u003eSearchTripsRequest\u003c/code\u003e to identify open trips and ensure trip statuses are synchronized.\u003c/p\u003e\n"],["\u003cp\u003eTrips older than 7 days are automatically deleted in Fleet Engine.\u003c/p\u003e\n"]]],["The `SearchTripsRequest` endpoint in Fleet Engine allows finding trips, focusing on two scenarios. First, setting `vehicle_id` and `active_trips_only` to `true` identifies active trips for a specific vehicle. Second, to reconcile vehicle availability, `vehicle_id` is left empty, `active_trips_only` is `true`, and `minimum_staleness` is set to over an hour. This identifies open, outdated trips (neither `COMPLETE` nor `CANCELED`) for status reconciliation. Trips are only searchable for seven days.\n"],null,["Fleet Engine provides the `SearchTripsRequest` endpoint that you can use to find\ntrips. This document describes two scenarios where you might use this feature.\n\nSee `SearchTripsRequest` for [gRPC](/maps/documentation/mobility/fleet-engine/reference/trips/rpc/maps.fleetengine.v1#searchtripsrequest) or `trips.Search` for [REST](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips/search).\n| **Note:** Trips remain active in Fleet Engine for 7 days, after which they are deleted, so `SearchTrips` only shows trips that have been active within the past 7 days.\n\nDetermine active trips for a vehicle\n\nTo do find the active trips for a specific fields, use the `SearchTripsRequest`\nmessage to set the `vehicle_id` to the vehicle under consideration and set\n`active_trips_only` to `true`.\n\nReconcile vehicle availability between your system and Fleet Engine\n\nIn some situations, you might see results returned by `SearchVehicles` that\ndon't correspond with the vehicles you know to be available in your system and\nyour fleet. This happens because `SearchVehicles` either doesn't show vehicles\nwith active trips, or pushes them down in the results ranking. One cause of this\nis when vehicles have completed trips, but the trip status not been properly set\nto either `COMPLETE` or `CANCELED`. By using `SearchTrips` to find open trips,\nyou can evaluate vehicles to ensure that `TripStatus` in your system matches\nthat of Fleet Engine.\n\nTo use `SearchTrips` in this way, set the following in the `SearchTripsRequest`\nmessage:\n\n- `vehicle_id` should be empty.\n- `active_trips_only` should be `true`.\n- `minimum_staleness` should be a time greater than most trip durations; for example, one hour.\n\nThe results of such a request include Trips that are neither `COMPLETE` nor\n`CANCELED`, and have not been updated in over an hour. You can then examine\nthese trips to ensure that their status in Fleet Engine is properly updated.\n\nWhat's next\n\n- [Delete Trip](/maps/documentation/mobility/fleet-engine/journeys/trips/delete-trip)"]]
