Tìm chuyến đi

Công cụ xe cộ 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 của 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 thành xe đang được xem xét và đặt active_trips_only thành true.

Điều chỉnh tình trạng còn xe giữa hệ thống của bạn và Công cụ quản lý đội xe

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ị 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 xe đã hoàn tất chuyến đi, nhưng trạng thái chuyến đi không được đặt đúng cách thành COMPLETE hoặc CANCELED. Bằng cách sử dụng SearchTrips để tìm các chuyến đi đang mở, 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 Công cụ quản lý đội xe.

Để 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à khoảng 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 này bao gồm các Chuyến đi không phải là COMPLETE hay 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 trạng thái của chúng trong Công cụ quản lý đội xe được cập nhật đúng cách.

Bước tiếp theo