Tìm chuyến đi

Công cụ quản lý đội xe 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ả hai 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 cho một 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 cho xe đang được xem xét và đặt active_trips_only thành true.

Đối chiếu tình trạng còn hàng của 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 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ị các xe có chuyến đi đang hoạt động hoặc đẩy các xe đó xuống trong bảng xếp hạng kết quả. Một nguyên nhân gây ra vấn đề này là khi các phương tiện đã 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 đang diễn ra, 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 thông tin trong Fleet Engine.

Để sử dụng SearchTrips theo cách này, hãy đặt các giá trị 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 lớn 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 các 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