SearchVehiclesResponse

JSON 表示法
VehicleMatch
- JSON 表示法
Waypoint
- JSON 表示法
VehicleMatchType

vehicles.search 回應訊息。

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

欄位

欄位
`matches[]`	`object (VehicleMatch)` 符合 `SearchVehiclesRequest` 條件的車輛清單，依 `SearchVehiclesRequest.order_by` 欄位排序。

matches[]

object (VehicleMatch)

符合 SearchVehiclesRequest 條件的車輛清單，依 SearchVehiclesRequest.order_by 欄位排序。

VehicleMatch

包含車輛與 SearchVehiclesRequest 車輛的有效行程點相符的車輛和相關預估值。

JSON 表示法

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,
  "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 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例：`"2014-10-02T15:01:23Z"` 和 `"2014-10-02T15:01:23.045123456Z"`。
`vehiclePickupDistanceMeters`	`integer` 車輛目前位置與要求中指定的上車地點之間的距離，包括現有行程的任何中繼上車或下車地點。此距離包含計算的行車 (路線) 距離，以及導航終點和要求的上車地點之間的直線距離。(導航終點與要求的上車地點之間的距離通常很小)。空白值表示計算距離時發生錯誤。
`vehiclePickupStraightLineDistanceMeters`	`integer` 必要欄位。車輛與要求中指定的上車點之間的直線距離。
`vehicleDropoffEta`	`string (Timestamp format)` 完整車輛的行駛預計到達點，到達要求中指定的下車地點。預計到達時間包含在要求中指定的 `dropoffPoint` 之前任何路線控點停止。您必須在要求中指定下車點，系統才會填入這個值。如果值為空白，表示計算預計到達時間時發生錯誤。採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例：`"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 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例：`"2014-10-02T15:01:23Z"` 和 `"2014-10-02T15:01:23.045123456Z"`。

latLng

object (LatLng)

這個路線控點的位置。

eta

string (Timestamp format)

車輛抵達這個路線控點的預估時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

VehicleMatchType

車輛比對類型。

列舉
`UNKNOWN`	不明的車輛比對類型
`EXCLUSIVE`	車輛目前沒有指定行程，並可以繼續前往上車地點。
`BACK_TO_BACK`	車輛目前已指派給一趟行程，但你可以在行程結束後繼續前往上車地點。計算預計到達時間和距離時，系統會考量現有的行程。
`CARPOOL`	車輛有足夠的容量可供共同乘車。
`CARPOOL_BACK_TO_BACK`	車輛會先完成目前的進行中行程，再前往上車地點。計算預計到達時間和距離時，系統會考量現有的行程。