SearchVehiclesResponse

vehicles.search 响应消息。

JSON 表示法 
{
  "matches": [
    {
      object (VehicleMatch)
    }
  ]
}
字段
matches[]

object (VehicleMatch)

符合 SearchVehiclesRequest 条件的车辆列表，根据 SearchVehiclesRequest.order_by 字段排序。

VehicleMatch

包含与车辆 SearchVehiclesRequest 的有效行程点匹配的车辆以及相关估算值。

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)
}
字段
vehicle

object (Vehicle)

必需。与请求匹配的车辆。
vehiclePickupEta

string (Timestamp format)

车辆预计到达请求中指定的上车点的预计到达时间。空值表示计算车辆预计到达时间失败。如果 SearchVehiclesRequest.include_back_to_back 为 true，并且这辆车有进行中的行程，vehiclePickupEta 包含完成当前有效行程所需的时间。

采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
vehiclePickupDistanceMeters

integer

从车辆当前位置到请求中指定的上车点的距离，包括现有行程的任何中间上车点或下车点。此距离包括计算出的驾车（路线）距离，以及导航终点和请求的上车点之间的直线距离。（导航端点和请求的上车点之间的距离通常很小。）空值表示计算距离时出错。
vehiclePickupStraightLineDistanceMeters

integer

必需。车辆与请求中指定的上车点之间的直线距离。
vehicleDropoffEta

string (Timestamp format)

整辆车的预计到达时间到达请求中指定的下车点。预计到达时间包括在请求中指定的 dropoffPoint 之前的任何航点处停靠。只有在请求中指定下车点时，系统才会填充此值。空值表示计算预计到达时间时出错。

采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
vehiclePickupToDropoffDistanceMeters

integer

车辆从上车点到请求中指定的下车点的行驶距离（以米为单位）。该距离仅在两点之间计算，不包括车辆位置或车辆到达上车点或下车点之前必须到达的任何其他点。仅当在请求中指定 dropoffPoint 时，系统才会填充此值。如果值为空，则表示无法计算请求中指定的上车点与下车点之间的距离。
tripType

enum (TripType)

必需。用于计算上车点预计到达时间的请求的行程类型。
vehicleTripsWaypoints[]

object (Waypoint)

用于计算预计到达时间的有序航点列表。该列表包括车辆位置、车辆的有效行程的上车点，以及请求中提供的取车点。空列表表示计算车辆预计到达时间失败。
vehicleMatchType

enum (VehicleMatchType)

车辆匹配的类型。
requestedOrderedBy

enum (VehicleMatchOrder)

为车辆匹配项排序时请求的顺序。
orderedBy

enum (VehicleMatchOrder)

此车辆的实际订单。通常，这将匹配请求中的“orderBy”字段；但在某些情况下（例如发生内部服务器错误），也可以使用其他方法（例如 PICKUP_POINT_STRAIGHT_DISTANCE）。

关键点

描述 SearchVehiclesResponse 中 VehicleMatch 的路线沿途的中间点。此概念在所有其他端点中表示为 TripWaypoint。

JSON 表示法 
{
  "latLng": {
    object (LatLng)
  },
  "eta": string
}
字段
latLng

object (LatLng)

此航点的位置。
eta

string (Timestamp format)

车辆到达此航点的预计时间。

采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

VehicleMatchType

车辆匹配项的类型。

枚举
UNKNOWN 未知的车辆匹配类型
EXCLUSIVE 这辆车目前未分配任何行程，可以前往上车点。
BACK_TO_BACK 车辆目前已分配给行程，但在完成进行中的行程后可以前往上车点。预计到达时间和距离计算会将现有行程考虑在内。
CARPOOL 车辆的载客量足以容纳共享行程。
CARPOOL_BACK_TO_BACK 车辆将结束当前正在进行的行程，然后再前往上车点。预计到达时间和距离计算会将现有行程考虑在内。