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

Tham 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 trê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 bạn chưa chỉ định, các chuyến đi 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

Hãy thiết lập thành một giá trị được 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, hàm 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 các chuyến đi của xe được yêu cầu.

nextPageToken

string

Chuyển mã thông báo này vào SearchTripsRequest đến trang thông qua kết quả của 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.