Tìm chuyến đi

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.

Hãy xem SearchTripsRequest để biết gRPC hoặc trips.Search để biết 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 xe để đả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.

Bước tiếp theo