SearchVehiclesResponse

vehicles.search tin nhắn phản hồi.

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

object (VehicleMatch)

Danh sách xe đáp ứng các tiêu chí của SearchVehiclesRequest, sắp xếp theo trường SearchVehiclesRequest.order_by.

VehicleMatch

Chứa thông tin về xe và các thông tin ước tính liên quan cho một chiếc xe phù hợp với các điểm của các chuyến đi đang hoạt động của chiếc xe SearchVehiclesRequest.

Biểu diễn dưới dạng JSON 
{
  "vehicle": {
    object (Vehicle)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripType),
  "vehicleTripsWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "vehicleMatchType": enum (VehicleMatchType),
  "requestedOrderedBy": enum (VehicleMatchOrder),
  "orderedBy": enum (VehicleMatchOrder)
}
Trường
vehicle

object (Vehicle)

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

string (Timestamp format)

Thời gian đến dự kiến của xe tới điểm đón được chỉ định trong yêu cầu. Giá trị trống cho biết xe không tính được thời gian đến dự kiến. Nếu giá trị SearchVehiclesRequest.include_back_to_back là true và xe này có một chuyến đi đang hoạt động, thì vehiclePickupEta sẽ bao gồm thời gian cần thiết để hoàn tất chuyến đi hiện tại.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
vehiclePickupDistanceMeters

integer

Khoảng cách từ vị trí hiện tại của xe đến điểm đón được chỉ định trong yêu cầu, bao gồm cả các điểm đón khách hoặc trả khách trung gian đối với các chuyến đi hiện tại. Khoảng cách này bao gồm quãng đường lái xe (tuyến đường) đã tính toán, cùng với khoảng cách theo đường thẳng giữa điểm cuối của lộ trình và điểm đón được yêu cầu. (Khoảng cách giữa điểm cuối điều hướng và điểm đón được yêu cầu thường nhỏ.) Giá trị trống cho biết có lỗi khi tính khoảng cách.
vehiclePickupStraightLineDistanceMeters

integer

Bắt buộc. Khoảng cách theo đường thẳng giữa xe và điểm đón được chỉ định trong yêu cầu.
vehicleDropoffEta

string (Timestamp format)

Thời gian dự kiến lái xe hoàn chỉnh của xe đến điểm trả khách được chỉ định trong yêu cầu. ETA bao gồm việc dừng tại bất kỳ điểm tham chiếu nào trước dropoffPoint được chỉ định trong yêu cầu. Giá trị này sẽ chỉ được điền khi điểm bỏ ngang được chỉ định trong yêu cầu. Giá trị trống cho biết đã xảy ra lỗi khi tính thời gian đến dự kiến.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
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ả xe được chỉ định trong yêu cầu. Khoảng cách chỉ giữa hai điểm và không bao gồm vị trí của xe hoặc bất kỳ điểm nào khác mà bạn phải ghé thăm trước khi xe đến điểm đón hoặc điểm trả xe. Giá trị này sẽ chỉ được điền khi dropoffPoint được chỉ định trong yêu cầu. Giá trị trống cho biết không tính được khoảng cách từ điểm đến lấy hàng đến điểm trả xe được chỉ định trong yêu cầu.
tripType

enum (TripType)

Bắt buộc. Loại chuyến đi của yêu cầu dùng để tính thời gian đến dự kiến tới điểm đón khách.
vehicleTripsWaypoints[]

object (Waypoint)

Danh sách các điểm tham chiếu theo thứ tự dùng để tính toán ETA. Danh sách này bao gồm vị trí của xe, điểm đón của các chuyến đi đang hoạt động của xe và điểm đón được cung cấp trong yêu cầu. Danh sách trống cho biết xe không tính được thời gian đến dự kiến.
vehicleMatchType

enum (VehicleMatchType)

Loại kết quả trùng khớp với xe.
requestedOrderedBy

enum (VehicleMatchOrder)

Đơn đặt hàng đã yêu cầu để sắp xếp các kết quả trùng khớp với xe.
orderedBy

enum (VehicleMatchOrder)

Đơn đặt hàng thực tế được dùng cho xe này. Thông thường, giá trị này sẽ khớp với trường "orderBy" từ yêu cầu; tuy nhiên, trong một số trường hợp nhất định như lỗi máy chủ nội bộ, có thể sử dụng một phương thức khác (chẳng hạn như PICKUP_POINT_STRAIGHT_DISTANCE).

Waypoint

Mô tả các điểm trung gian dọc theo một tuyến cho VehicleMatch trong SearchVehiclesResponse. Khái niệm này được biểu thị dưới dạng TripWaypoint trong tất cả các điểm cuối khác.

Biểu diễn dưới dạng JSON 
{
  "latLng": {
    object (LatLng)
  },
  "eta": string
}
Trường
latLng

object (LatLng)

Vị trí của điểm tham chiếu này.
eta

string (Timestamp format)

Thời gian dự kiến mà xe sẽ đến điểm tham chiếu này.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

VehicleMatchType

Loại xe trùng khớp.

Enum
UNKNOWN Kiểu khớp xe không xác định
EXCLUSIVE Xe này hiện chưa được chỉ định chuyến đi và có thể đi tới điểm đón.
BACK_TO_BACK Xe hiện được chỉ định cho một chuyến đi, nhưng có thể tiếp tục đến điểm đón sau khi hoàn tất chuyến đi đang diễn ra. Việc tính toán thời gian đến dự kiến và khoảng cách sẽ có tính đến chuyến đi hiện tại.
CARPOOL Xe có đủ chỗ cho một chuyến đi chung.
CARPOOL_BACK_TO_BACK Xe sẽ kết thúc chuyến đi hiện tại, đang hoạt động trước khi đi đến điểm đón. Việc tính toán thời gian đến dự kiến và khoảng cách sẽ có tính đến chuyến đi hiện tại.