Method: providers.trips.search

Xem tất cả chuyến đi của một loại xe cụ thể.

Yêu cầu HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Phải ở định dạng providers/{provider}. Nhà cung cấp phải là Mã dự án (ví dụ: sample-cloud-project) của Dự án Google Cloud mà tài khoản dịch vụ thực hiện lệnh gọi này là thành viên.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
Trường
header

object (RequestHeader)

Tiêu đề tiêu chuẩn của yêu cầu Fleet Engine.
vehicleId

string

Xe được liên kết với các chuyến đi trong yêu cầu. Nếu không chỉ định, các chuyến đi được trả về sẽ không chứa:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Nếu bạn đặt chính sách này thành true, thì phản hồi sẽ bao gồm những Chuyến đi ảnh hưởng đến tuyến đường của người lái xe.
pageSize

integer

Nếu bạn không đặt chính sách này, máy chủ sẽ quyết định số lượng kết quả trả về.
pageToken

string

Đặt giá trị này thành giá trị đã trả về trước đó trong SearchTripsResponse để tiếp tục từ các kết quả trước đó.
minimumStaleness

string (Duration format)

Nếu được chỉ định, sẽ trả về các chuyến đi chưa được cập nhật sau thời gian (current - minimumStaleness).

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

Nội dung phản hồi

Chuyến đi.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
Trường
trips[]

object (Trip)

Danh sách chuyến đi cho xe được yêu cầu.
nextPageToken

string

Truyền mã thông báo này trong SearchTripsRequest để phân trang qua kết quả danh sách. API sẽ trả về danh sách chuyến đi trên mỗi lệnh gọi và khi không còn kết quả nào nữa, danh sách chuyến đi sẽ bị trống.