SearchVehiclesLog

Thông tin chi tiết về yêu cầu và phản hồi SearchVehicles.

Lưu ý: Nhật ký này có thể bị phân tách theo trường kết quả trùng khớp nếu tổng kích thước nhật ký vượt quá 256 KB. Hãy xem phần Nhật ký phân tách để biết thêm thông tin chi tiết.

Biểu diễn dưới dạng JSON
{
  "request": {
    object (SearchVehiclesRequestLog)
  },
  "response": {
    object (SearchVehiclesResponseLog)
  },
  "errorResponse": {
    object (ErrorResponseLog)
  }
}
Trường
request

object (SearchVehiclesRequestLog)

Yêu cầu được gửi đến Công cụ quản lý đội xe.

response

object (SearchVehiclesResponseLog)

Phản hồi được trả về cho ứng dụng khách. Nếu lệnh gọi RPC dẫn đến lỗi, thì phản hồi sẽ không được đặt.

errorResponse

object (ErrorResponseLog)

Phản hồi lỗi được trả về cho ứng dụng khách. Giá trị này sẽ bị huỷ thiết lập nếu lệnh gọi RPC thành công.

SearchVehiclesRequestLog

Thông tin chi tiết về yêu cầu SearchVehicles.

Biểu diễn dưới dạng JSON
{
  "header": {
    object (RequestHeaderLog)
  },
  "pickupPoint": {
    object (TerminalLocationLog)
  },
  "dropoffPoint": {
    object (TerminalLocationLog)
  },
  "pickupRadiusMeters": integer,
  "count": integer,
  "minimumCapacity": integer,
  "searchTripTypes": [
    enum (TripTypeLog)
  ],
  "maximumStaleness": string,
  "vehicleTypes": [
    {
      object (VehicleTypeLog)
    }
  ],
  "requiredAttributes": [
    {
      object (VehicleAttributeLog)
    }
  ],
  "requiredOneOfAttributes": [
    {
      object (VehicleAttributeListLog)
    }
  ],
  "requiredOneOfAttributeSets": [
    {
      object (VehicleAttributeListLog)
    }
  ],
  "matchOrderBy": enum (VehicleMatchOrderLog),
  "includeBackToBack": boolean,
  "tripId": string,
  "filter": string
}
Trường
header

object (RequestHeaderLog)

Tiêu đề yêu cầu.

pickupPoint

object (TerminalLocationLog)

Điểm đến lấy hàng để tìm kiếm ở gần.

dropoffPoint

object (TerminalLocationLog)

Địa điểm giao hàng mà khách hàng dự định.

pickupRadiusMeters

integer

Chỉ định bán kính tìm kiếm xe xung quanh điểm đón.

count

integer

Chỉ định số lượng xe tối đa cần trả về.

minimumCapacity

integer

Chỉ định sức chứa tối thiểu bắt buộc của xe.

searchTripTypes[]

enum (TripTypeLog)

Chỉ cho phép tìm kiếm những xe hỗ trợ ít nhất một trong các loại chuyến đi đã chỉ định.

maximumStaleness

string (Duration format)

Chỉ cho phép tìm kiếm những xe đã cập nhật vị trí của chúng trong khoảng thời gian được chỉ định tính từ thời điểm hiện tại.

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

vehicleTypes[]

object (VehicleTypeLog)

Loại xe bạn đang tìm kiếm.

requiredAttributes[]

object (VehicleAttributeLog)

Chỉ cho phép tìm kiếm những chiếc xe có các thuộc tính được chỉ định.

requiredOneOfAttributes[]

object (VehicleAttributeListLog)

Chỉ cho phép tìm kiếm những chiếc xe có ít nhất một trong các thuộc tính được chỉ định áp dụng cho mỗi VehicleAttributeList.

requiredOneOfAttributeSets[]

object (VehicleAttributeListLog)

Chỉ cho phép tìm kiếm những chiếc xe có ít nhất một nhóm thuộc tính được chỉ định trong VehicleAttributeList.

matchOrderBy

enum (VehicleMatchOrderLog)

Thứ tự sắp xếp của kết quả tìm kiếm.

includeBackToBack

boolean

Cho biết liệu một xe có chuyến đi đang hoạt động có đủ điều kiện để so khớp với một chuyến đi khác hay không.

tripId

string

Mã của chuyến đi được liên kết với searchVehiclesRequest.

filter

string

Truy vấn AIP-160 giới hạn các xe được trả về dựa trên các thuộc tính của xe.

VehicleAttributeListLog

Loại dữ liệu danh sách-danh sách cho VehicleAttributeLog.

Biểu diễn dưới dạng JSON
{
  "attributes": [
    {
      object (VehicleAttributeLog)
    }
  ]
}
Trường
attributes[]

object (VehicleAttributeLog)

Danh sách các thuộc tính trong bộ sưu tập này.

SearchVehiclesResponseLog

Thông tin chi tiết về phản hồi SearchVehicles.

Biểu diễn dưới dạng JSON
{
  "matchIds": [
    string
  ],
  "matches": [
    {
      object (VehicleMatchLog)
    }
  ]
}
Trường
matchIds[]
(deprecated)

string

Đã ngừng sử dụng: Danh sách mã nhận dạng xe cho các xe được trả về. Vui lòng sử dụng matches.vehicle.name để lấy mã nhận dạng này.

matches[]

object (VehicleMatchLog)

Danh sách VehicleMatches cho các xe được trả về.

VehicleMatchLog

Nhật ký của kết quả VehicleMatch trong SearchVehicles.

Biểu diễn dưới dạng JSON
{
  "vehicle": {
    object (VehicleLog)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripTypeLog),
  "vehicleMatchType": enum (VehicleMatchTypeLog),
  "requestedOrderedBy": enum (VehicleMatchOrderLog),
  "orderedBy": enum (VehicleMatchOrderLog)
}
Trường
vehicle

object (VehicleLog)

Một chiếc xe phù hợp với yêu cầu.

vehiclePickupEta

string (Timestamp format)

Thời gian dự kiến đến điểm đón của xe theo đường bộ được chỉ định trong yêu cầu. Giá trị trống cho biết không tính toán được ETA cho xe.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

vehiclePickupDistanceMeters

integer

Khoảng cách lái xe của xe đến điểm đón được chỉ định trong yêu cầu, bao gồm mọi điểm đón hoặc trả khách trung gian cho một chuyến đi hiện tại. Giá trị trống cho biết không tính toán được quãng đường cho xe.

vehiclePickupStraightLineDistanceMeters

integer

Khoảng cách theo đường thẳng giữa xe và điểm đón được chỉ định trong yêu cầu, bao gồm cả các điểm trung gian cho các chuyến đi hiện có.

vehicleDropoffEta

string (Timestamp format)

Thời gian dự kiến hoàn tất hành trình của xe đến điểm trả khách được chỉ định trong yêu cầu. Thời gian đến dự kiến bao gồm mọi lượt ghé thăm bắt buộc cho các chuyến đi đang hoạt động mà bạn phải hoàn tất trước khi xe đến điểm trả khách được chỉ định trong yêu cầu. Giá trị này sẽ chỉ được điền khi điểm trả hàng được chỉ định trong yêu cầu. Giá trị trống cho biết không tính toán được ETA để xe đến điểm trả khách.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

vehiclePickupToDropoffDistanceMeters

integer

Quãng đường lái xe của xe (tính bằng mét) từ điểm đón đến điểm trả khách được chỉ định trong yêu cầu. Khoảng cách chỉ tính giữa hai điểm và không bao gồm vị trí của xe hoặc bất kỳ điểm trung gian nào khác trước khi xe đến điểm đón hoặc điểm trả khách. Giá trị này sẽ chỉ được điền khi điểm trả hàng được chỉ định trong yêu cầu. Giá trị trống cho biết không tính toán được khoảng cách từ điểm đón đến điểm trả khách được chỉ định trong yêu cầu.

tripType

enum (TripTypeLog)

Loại chuyến đi của yêu cầu được dùng để tính thời gian đến điểm đón.

vehicleMatchType

enum (VehicleMatchTypeLog)

Loại kiểu khớp xe.

requestedOrderedBy

enum (VehicleMatchOrderLog)

Phương thức mà phương thức gọi yêu cầu để sắp xếp các kết quả trùng khớp về xe.

orderedBy

enum (VehicleMatchOrderLog)

Phương thức thực tế được dùng để đặt xe này. Thông thường, giá trị này sẽ khớp với trường "order_by" trong yêu cầu. Tuy nhiên, trong một số trường hợp như khi phần phụ trợ của Google Maps gặp sự cố, bạn có thể sử dụng một phương thức khác (chẳng hạn như PICKUP_POINT_STRAIGHT_DISTANCE).