Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Fleet Engine cung cấp điểm cuối SearchTripsRequest mà bạn có thể dùng để tìm chuyến đi. Tài liệu này mô tả 2 trường hợp mà bạn có thể sử dụng tính năng này.
Xem SearchTripsRequest cho gRPC hoặc trips.Search cho REST.
Xác định các chuyến đi đang hoạt động của một chiếc xe
Để tìm các chuyến đi đang hoạt động cho một trường cụ thể, hãy sử dụng thông báo SearchTripsRequest để đặt vehicle_id thành xe đang được xem xét và đặt active_trips_only thành true.
Đối chiếu tình trạng còn xe giữa hệ thống của bạn và Fleet Engine
Trong một số trường hợp, bạn có thể thấy kết quả do SearchVehicles trả về không tương ứng với những chiếc xe mà bạn biết là có trong hệ thống và đội xe của mình. Điều này xảy ra vì SearchVehicles không hiển thị xe có chuyến đi đang hoạt động hoặc đẩy những xe đó xuống thứ hạng kết quả. Một nguyên nhân của vấn đề này là khi xe đã hoàn thành chuyến đi, nhưng trạng thái chuyến đi chưa được đặt đúng thành COMPLETE hoặc CANCELED. Bằng cách sử dụng SearchTrips để tìm các chuyến đi chưa kết thúc, bạn có thể đánh giá các phương tiện để đảm bảo rằng TripStatus trong hệ thống của bạn khớp với TripStatus của Fleet Engine.
Để sử dụng SearchTrips theo cách này, hãy đặt nội dung sau trong thông báo SearchTripsRequest:
vehicle_id phải trống.
active_trips_only phải là true.
minimum_staleness phải là thời gian dài hơn hầu hết thời lượng chuyến đi; ví dụ: một giờ.
Kết quả của yêu cầu như vậy bao gồm những Chuyến đi không phải là COMPLETE cũng không phải là CANCELED và chưa được cập nhật trong hơn một giờ. Sau đó, bạn có thể kiểm tra các chuyến đi này để đảm bảo rằng trạng thái của chúng trong Fleet Engine được cập nhật đúng cách.
[null,null,["Cập nhật lần gần đây nhất: 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)"]]
