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 các chuyến đi của bạn. 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.

Xem SearchTripsRequest để biết gRPC hoặc trips.Search cho REST.

Xác định các chuyến đi đang hoạt động của xe

Để tìm các chuyến đi đang hoạt động cho một trường cụ thể, hãy sử dụng SearchTripsRequest thông báo để đặt vehicle_id thành chiếc xe đang được xem xét và thiết lập active_trips_only đến true.

Điều chỉnh tình trạng 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 xe mà bạn biết có trong hệ thống của mình và hệ thống thiết bị của bạn. Điều này xảy ra vì SearchVehicles không cho thấy phương tiện với các chuyến đi đang hoạt động hoặc đẩy chúng xuống trong bảng xếp hạng kết quả. Một trong những nguyên nhân này là khi phương tiện đã hoàn tất chuyến đi nhưng trạng thái chuyến đi không được đặt đúng đến COMPLETE hoặc CANCELED. Bằng cách sử dụng SearchTrips để tìm các chuyến đi chưa xác định, 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 của Fleet Engine.

Để dùng SearchTrips theo cách này, hãy thiết lập các mục sau trong SearchTripsRequest thông báo:

  • vehicle_id phải trống.
  • active_trips_only phải là true.
  • minimum_staleness phải là thời gian lớn hơn hầu hết thời lượng chuyến đi; với chẳng hạn như 1 giờ.

Kết quả của yêu cầu đó sẽ bao gồm các Chuyến đi không thuộc COMPLETE hoặc hoặc CANCELED và chưa được cập nhật trong hơn một giờ. Sau đó, bạn có thể tìm hiểu để đảm bảo rằng trạng thái của chúng trong Fleet Engine được cập nhật chính xác.

Các bước tiếp theo