Method: providers.trips.search

Xem tất cả cá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

Các 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 Google Cloud có tài khoản dịch vụ thực hiện lệnh gọi này.

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
}
Các trường
header

object (RequestHeader)

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

string

Xe 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 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 một giá trị được trả về trước đó trong SearchTripsResponse để tiếp tục xử lý các kết quả trước đó.
minimumStaleness

string (Duration format)

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

Thời lượng tính bằng giây có 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

thông báo phản hồi về Trip.search.

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
}
Các trường
trips[]

object (Trip)

Danh sách các chuyến đi của xe yêu cầu.
nextPageToken

string

Chuyển mã thông báo này trong SearchTripsRequest đến trang thông qua kết quả danh sách. API sẽ trả về danh sách chuyến đi cho mỗi lệnh gọi và khi không còn kết quả nào thì danh sách chuyến đi vẫn trống.