SearchVehiclesLog

關於 SearchVehicles 要求和回應的詳細資料。

注意：如果記錄總大小超過 256 KB，系統會依照相符項目欄位分割此記錄。詳情請參閱「分割記錄檔」。

JSON 表示法 
{
  "request": {
    object (SearchVehiclesRequestLog)
  },
  "response": {
    object (SearchVehiclesResponseLog)
  },
  "errorResponse": {
    object (ErrorResponseLog)
  }
}
欄位
request

object (SearchVehiclesRequestLog)

傳送至 Fleet Engine 的要求。
response

object (SearchVehiclesResponseLog)

傳回給用戶端的回應。如果 RPC 呼叫導致錯誤，則不會設定回應。
errorResponse

object (ErrorResponseLog)

傳回給用戶端的錯誤回應。如果 RPC 呼叫成功，就會取消設定。

SearchVehiclesRequestLog

SearchVehicles 要求的詳細資料。

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
}
欄位
header

object (RequestHeaderLog)

要求標頭。
pickupPoint

object (TerminalLocationLog)

要搜尋附近的取貨地點。
dropoffPoint

object (TerminalLocationLog)

客戶的下車地點。
pickupRadiusMeters

integer

指定上車地點附近的車輛搜尋半徑。
count

integer

指定要傳回的車輛數量上限。
minimumCapacity

integer

指定車輛的必要最小容量。
searchTripTypes[]

enum (TripTypeLog)

將搜尋範圍限制在至少支援一種指定行程類型的車輛。
maximumStaleness

string (Duration format)

將搜尋範圍限制在從現在往回指定時間內，位置曾經更新過的車輛。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。
vehicleTypes[]

object (VehicleTypeLog)

要搜尋的車輛類型。
requiredAttributes[]

object (VehicleAttributeLog)

只搜尋具有指定屬性的車輛。
requiredOneOfAttributes[]

object (VehicleAttributeListLog)

將搜尋範圍限制為至少有一個指定屬性套用至每個 VehicleAttributeList 的車輛。
requiredOneOfAttributeSets[]

object (VehicleAttributeListLog)

將搜尋範圍限制為至少在 VehicleAttributeList 中含有一組指定屬性的車輛。
matchOrderBy

enum (VehicleMatchOrderLog)

搜尋結果的排序順序。
includeBackToBack

boolean

指出有行程的車輛是否符合其他配對條件。
tripId

string

與搜尋車輛要求相關聯的行程 ID。
filter

string

AIP-160 查詢，可根據車輛屬性限制傳回的車輛。

VehicleAttributeListLog

VehicleAttributeLog 的清單清單資料類型。

JSON 表示法 
{
  "attributes": [
    {
      object (VehicleAttributeLog)
    }
  ]
}
欄位
attributes[]

object (VehicleAttributeLog)

這個集合中的屬性清單。

SearchVehiclesResponseLog

SearchVehicles 回應的詳細資料。

JSON 表示法 
{
  "matchIds": [
    string
  ],
  "matches": [
    {
      object (VehicleMatchLog)
    }
  ]
}
欄位
matchIds[]
(deprecated)

string

已淘汰：傳回車輛的車輛 ID 清單。請使用 matches.vehicle.name 取得這個 ID。
matches[]

object (VehicleMatchLog)

已退還車輛的 VehicleMatch 清單。

VehicleMatchLog

SearchVehicles 車輛比對結果的記錄。

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)
}
欄位
vehicle

object (VehicleLog)

符合要求的車輛。
vehiclePickupEta

string (Timestamp format)

車輛行駛至要求中指定的接送地點所需的預估時間。如果值為空白，表示無法計算車輛的預估抵達時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
vehiclePickupDistanceMeters

integer

車輛行駛至要求中指定上車地點的距離，包括任何現有行程的中途上車或下車地點。空值表示無法計算車輛的距離。
vehiclePickupStraightLineDistanceMeters

integer

車輛與要求中指定的接送點之間的直線距離，包括現有行程的中途路線控點。
vehicleDropoffEta

string (Timestamp format)

車輛從要求中指定的下車地點出發，到達目的地的預估車程時間。預估抵達時間會納入所有必要的行程停靠站，這些停靠站必須在車輛抵達要求中指定的下車地點前完成。只有在要求中指定了下車點時，系統才會填入這個值。空值表示無法計算車輛抵達下車地點的預估到達時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
vehiclePickupToDropoffDistanceMeters

integer

車輛從取車點到要求中指定的下車點的駕駛距離 (以公尺為單位)。距離僅計算兩個點之間的距離，不包含車輛抵達上車/下車地點前的車輛位置或任何其他路線點。只有在要求中指定了下車點時，系統才會填入這個值。如果值為空白，表示無法計算從要求中指定的接送點到下車點的距離。
tripType

enum (TripTypeLog)

用於計算上車地點預估抵達時間的請求行程類型。
vehicleMatchType

enum (VehicleMatchTypeLog)

車輛比對類型。
requestedOrderedBy

enum (VehicleMatchOrderLog)

呼叫端要求用於排序車輛比對結果的方法。
orderedBy

enum (VehicleMatchOrderLog)

實際用於訂購這輛車輛的方法。通常，這會與要求中的「order_by」欄位相符。不過，在 Google 地圖後端發生錯誤等特定情況下，系統可能會使用其他方法 (例如 PICKUP_POINT_STRAIGHT_DISTANCE)。