Tìm chuyến đi

Fleet Engine cung cấp điểm cuối SearchTripsRequest mà bạn có thể sử dụng để tìm chuyến đi. Tài liệu này mô tả hai tình huống 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 phương tiện

Để 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 phương tiện đang xem xét và đặt active_trips_only thành true.

Đối chiếu tình trạng xe có sẵn 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ả trả về của SearchVehicles không khớp với các xe mà bạn biết là có sẵn 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ị các phương tiện có chuyến đi đang hoạt động hoặc đẩy chúng xuống dưới trong bảng xếp hạng kết quả. Một nguyên nhân gây ra điều 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 mở, 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 Fleet Engine.

Để sử dụng SearchTrips theo cách này, hãy đặt thông tin 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à khoảng thời gian dài hơn hầu hết thời gian chuyến đi; ví dụ: một giờ.

Kết quả của yêu cầu như vậy bao gồm các Chuyến đi không phải là COMPLETE hoặc CANCELED và không đượ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 trạng thái của chúng trong Fleet Engine được cập nhật chính xác.

Bước tiếp theo