Method: providers.vehicles.search

{
  "header": {
    object (RequestHeader)
  },
  "pickupPoint": {
    object (TerminalLocation)
  },
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "pickupRadiusMeters": integer,
  "count": integer,
  "minimumCapacity": integer,
  "tripTypes": [
    enum (TripType)
  ],
  "maximumStaleness": string,
  "vehicleTypes": [
    {
      object (VehicleType)
    }
  ],
  "requiredAttributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "requiredOneOfAttributes": [
    {
      object (VehicleAttributeList)
    }
  ],
  "requiredOneOfAttributeSets": [
    {
      object (VehicleAttributeList)
    }
  ],
  "orderBy": enum (VehicleMatchOrder),
  "includeBackToBack": boolean,
  "tripId": string,
  "currentTripsPresent": enum (CurrentTripsPresent),
  "filter": string
}

object (RequestHeader)

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

object (TerminalLocation)

Bắt buộc. Điểm đón khách để tìm kiếm gần.

object (TerminalLocation)

Vị trí trả xe dự kiến của khách hàng. Đây là trường bắt buộc nếu tripTypes chứa TripType.SHARED.

integer

Bắt buộc. Xác định bán kính tìm kiếm xe xung quanh điểm đón khách. Hệ thống sẽ chỉ trả lại những xe trong phạm vi bán kính tìm kiếm. Giá trị phải nằm trong khoảng từ 400 đến 10.000 mét (bao gồm).

integer

Bắt buộc. Chỉ định số lượng xe tối đa cần trả lại. Giá trị phải nằm trong khoảng từ 1 đến 50 (bao gồm).

integer

Bắt buộc. Xác định số lượng hành khách được cân nhắc cho một chuyến đi. Giá trị phải lớn hơn hoặc bằng 1. Trình điều khiển không được xem xét trong giá trị sức chứa.

enum (TripType)

Bắt buộc. Đại diện cho loại chuyến đi đề xuất. Phải bao gồm chính xác một loại. UNKNOWN_TRIP_TYPE là không được phép. Giới hạn tìm kiếm chỉ cho những xe có thể hỗ trợ loại chuyến đi đó.

string (Duration format)

Giới hạn tìm kiếm ở những xe đã gửi thông tin cập nhật vị trí cho Fleet Engine trong khoảng thời gian quy định. Những phương tiện cố định vẫn đang truyền vị trí của chúng không bị coi là lỗi thời. Nếu bạn không đặt trường này, máy chủ sẽ sử dụng giá trị mặc định là 5 phút.

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

object (VehicleType)

Bắt buộc. Giới hạn tìm kiếm trong những xe thuộc một trong các loại đã chỉ định. Bạn phải chỉ định ít nhất một loại xe. Không được phép sử dụng các loại xe có danh mục UNKNOWN.

object (VehicleAttribute)

Phương thức gọi có thể tạo các phép toán logic phức tạp bằng cách sử dụng bất kỳ tổ hợp nào từ các trường requiredAttributes, requiredOneOfAttributes và requiredOneOfAttributeSets.

requiredAttributes là một danh sách; requiredOneOfAttributes sử dụng một thông báo cho phép tạo một danh sách các danh sách. Khi kết hợp, hai trường sẽ cho phép cấu thành biểu thức này:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(requiredOneOfAttributes[0][0] OR requiredOneOfAttributes[0][1] OR
...)
AND
(requiredOneOfAttributes[1][0] OR requiredOneOfAttributes[1][1] OR
...)

Chỉ tìm kiếm những chiếc xe có các thuộc tính đã chỉ định. Trường này là toán tử liên kết/AND. Chỉ cho phép tối đa 50 requiredAttributes. Thuộc tính này khớp với số lượng thuộc tính tối đa được phép trên xe.

object (VehicleAttributeList)

Chỉ tìm kiếm những xe có ít nhất một trong các thuộc tính được chỉ định trong mỗi VehicleAttributeList. Trong mỗi danh sách, một chiếc xe phải khớp với ít nhất một trong các thuộc tính. Trường này là một phép toán phân ly/HOẶC bao gồm trong mỗi VehicleAttributeList và là một phép toán tử/AND trên tập hợp VehicleAttributeList.

object (VehicleAttributeList)

requiredOneOfAttributeSets cung cấp chức năng bổ sung.

Tương tự như requiredOneOfAttributes, requiredOneOfAttributeSets sử dụng thông báo để chấp nhận danh sách các danh sách, cho phép các biểu thức như sau:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(
  (requiredOneOfAttributeSets[0][0] AND
  requiredOneOfAttributeSets[0][1] AND
  ...)
  OR
  (requiredOneOfAttributeSets[1][0] AND
  requiredOneOfAttributeSets[1][1] AND
  ...)
)

Chỉ tìm kiếm những xe có tất cả các thuộc tính trong một VehicleAttributeList. Trong mỗi danh sách, một chiếc xe phải phù hợp với tất cả các thuộc tính. Trường này là một toán tử liên kết/AND trong mỗi VehicleAttributeList và bao gồm toán tử phân ly/OR (hoặc) trên tập hợp VehicleAttributeList.

enum (VehicleMatchOrder)

Bắt buộc. Chỉ định tiêu chí sắp xếp mong muốn cho kết quả.

boolean

Cột này cho biết những phương tiện có một chuyến đi đang hoạt động có đủ điều kiện cho nội dung tìm kiếm này hay không. Trường này chỉ được dùng khi chưa chỉ định currentTripsPresent. Nếu bạn không chỉ định currentTripsPresent và trường này là false, thì những chiếc xe có chuyến đi được chỉ định sẽ bị loại trừ khỏi kết quả tìm kiếm. Nếu bạn không chỉ định currentTripsPresent và trường này là true, thì kết quả tìm kiếm có thể bao gồm cả những phương tiện có một chuyến đi đang hoạt động có trạng thái là ENROUTE_TO_DROPOFF. Khi currentTripsPresent được chỉ định, bạn không thể đặt trường này thành true.

Giá trị mặc định là false.

string

Cho biết chuyến đi được liên kết với SearchVehicleRequest này.

enum (CurrentTripsPresent)

Cột này cho biết những phương tiện có chuyến đi đang hoạt động có đủ điều kiện xuất hiện trong nội dung tìm kiếm này hay không. Thuộc tính này phải được thiết lập thành giá trị khác CURRENT_TRIPS_PRESENT_UNSPECIFIED nếu tripType bao gồm SHARED.

string

Không bắt buộc. Một cụm từ tìm kiếm để áp dụng bộ lọc khi tìm kiếm xe. Hãy truy cập vào http://aip.dev/160 để xem các ví dụ về cú pháp bộ lọc.

Trường này được thiết kế để thay thế các trường requiredAttributes, requiredOneOfAttributes và required_one_of_attributes_sets. Nếu một giá trị không trống được chỉ định ở đây thì các trường sau đây phải trống: requiredAttributes, requiredOneOfAttributes và required_one_of_attributes_sets.

Bộ lọc này hoạt động dưới dạng mệnh đề AND với các quy tắc ràng buộc khác, chẳng hạn như minimumCapacity hoặc vehicleTypes.

Xin lưu ý rằng những cụm từ tìm kiếm duy nhất được hỗ trợ là về thuộc tính xe (ví dụ: attributes.<key> = <value> hoặc attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Số lượng quy định hạn chế tối đa được phép trong một truy vấn bộ lọc là 50.

Ngoài ra, tất cả thuộc tính đều được lưu trữ dưới dạng chuỗi, do đó, phép so sánh duy nhất được hỗ trợ so với các thuộc tính là so sánh chuỗi. Để so sánh với các giá trị số hoặc boolean, các giá trị phải được trích dẫn rõ ràng để được coi là chuỗi (ví dụ: attributes.<key> = "10" hoặc attributes.<key> = "true").