REST Resource: providers.vehicles

資源：Vehicle

車輛中繼資料。

JSON 表示法 
{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}
欄位
name

string

僅供輸出。這輛車輛的專屬名稱。格式為 providers/{provider}/vehicles/{vehicle}。
vehicleState

enum (VehicleState)

車輛狀態。
supportedTripTypes[]

enum (TripType)

這輛車輛支援的行程類型。
currentTrips[]

string

僅供輸出。目前指派給這輛車輛的行程的 tripId 清單。
lastLocation

object (VehicleLocation)

車輛上次回報的位置。
maximumCapacity

integer

這輛車輛可載運的乘客總數。這個值不包含驅動程式。這個值必須大於或等於 1。
attributes[]

object (VehicleAttribute)

車輛屬性清單。車輛最多可有 100 個屬性，且每個屬性都必須有專屬索引鍵。
vehicleType

object (VehicleType)

必要欄位。這個車輛的類型。可用於篩選 vehicles.search 結果中的車輛。也會影響預估到達時間和路線計算。
licensePlate

object (LicensePlate)

車輛的車牌資訊。
route[]
(deprecated)

object (TerminalLocation)

已淘汰：請改用 Vehicle.waypoints。
currentRouteSegment

string

折線會指定駕駛人應用程式要前往下一個路標的路線。系統也會在 Trip.current_route_segment 中，針對指派給車輛的所有有效行程傳回這份清單。

注意：這個欄位僅供 Driver SDK 使用。尚未支援解碼。
currentRouteSegmentTraffic

object (TrafficPolylineData)

僅限輸入。Fleet Engine 會利用這些資訊改善行程分享功能。注意：這個欄位僅供 Driver SDK 使用。
currentRouteSegmentVersion

string (Timestamp format)

僅供輸出。currentRouteSegment 的設定時間。用戶端可以儲存此值，並在日後的 vehicles.get 要求中傳遞，以免傳回未變更的路線。

使用 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"。
currentRouteSegmentEndPoint

object (TripWaypoint)

currentRouteSegment 的終點路徑點。司機可在 vehicles.update 呼叫中提供這項資訊，做法是提供完整行程路徑點、路徑點 LatLng，或是 currentRouteSegment 的最後一個 LatLng。如果未完全指定實際路徑點，Fleet Engine 會盡力插補。除非同時指定 currentRouteSegment，否則系統會在 vehicles.update 呼叫中忽略這個欄位。
remainingDistanceMeters

integer

currentRouteSegment 的剩餘行車距離。對於指派給車輛的所有有效行程，Trip.remaining_distance_meters 也會傳回這個值。如果 currentRouteSegment 欄位為空白，則未指定值。
etaToFirstWaypoint

string (Timestamp format)

waypoints 欄位中第一個項目的預估到達時間。如果 waypoints 欄位或 Vehicle.current_route_segment 欄位為空白，則值未指定。

更新車輛時，remainingTimeSeconds 會優先於同一要求中的 etaToFirstWaypoint。

使用 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"。
remainingTimeSeconds

integer

僅限輸入。currentRouteSegment 的剩餘行車時間。如果 waypoints 欄位或 Vehicle.current_route_segment 欄位為空白，則值未指定。如果所有參與者都使用相同的時鐘，這個值應與 etaToFirstWaypoint - current_time 相符。

更新車輛時，remainingTimeSeconds 會優先於同一要求中的 etaToFirstWaypoint。
waypoints[]

object (TripWaypoint)

指派給這輛車的其餘路線點。
waypointsVersion

string (Timestamp format)

僅供輸出。上次更新 waypoints 欄位的時間。用戶端應將這個值快取，並在 GetVehicleRequest 中傳遞，確保只有在 waypoints 欄位更新時才會傳回。

使用 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"。
backToBackEnabled

boolean

指出駕駛人是否接受接連行程。如果是 true，vehicles.search 可能會包含車輛，即使該車輛目前已指派給行程也一樣。預設值為 false。
navigationStatus

enum (NavigationStatus)

車輛的導航狀態。
deviceSettings

object (DeviceSettings)

僅限輸入。駕駛人使用的行動裝置設定資訊。

VehicleState

Vehicle 的狀態。

列舉
UNKNOWN_VEHICLE_STATE 預設值，用於未指定或未識別的車輛狀態。
OFFLINE 車輛不接受新的行程。注意：車輛在完成指派的行程時，可能會繼續處於這個狀態。
ONLINE 車輛正在接受新行程。

VehicleAttribute

以鍵/值組合描述車輛屬性。「key:value」字串長度不得超過 256 個半形字元。

JSON 表示法 
{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}
欄位
key

string

屬性鍵。金鑰不得包含冒號字元 (:)。
value

string

屬性的值。
聯集欄位 vehicle_attribute_value。屬性的值可以是字串、布林值或雙精度值。vehicle_attribute_value 只能是下列其中一項：
stringValue

string

字串類型屬性值。

注意：這與最終會淘汰的 value 欄位相同。如要使用建立或更新方法，可以使用任一欄位，但強烈建議使用 stringValue。如果同時設定 stringValue 和 value，兩者必須相同，否則系統會擲回錯誤。回應中會填入這兩個欄位。
boolValue

boolean

布林型屬性值。
numberValue

number

雙精度浮點型屬性值。

VehicleType

車輛類型。

JSON 表示法 
{
  "category": enum (Category)
}
欄位
category

enum (Category)

車輛類型

類別

車輛類型類別

列舉
UNKNOWN 預設值，用於未指定或未識別的車輛類別。
AUTO 汽車。
TAXI 任何計程車 (通常須取得執照或受監管)。
TRUCK 一般來說，車輛的儲存空間容量越大越好。
TWO_WHEELER 機車、輕型機車或其他兩輪車輛
BICYCLE 人力運輸。
PEDESTRIAN 人類運輸工具，通常是步行或跑步，沿著行人道移動。

LicensePlate

車輛的車牌資訊。為避免儲存個人識別資訊，實體中只會儲存車牌的必要資訊。

JSON 表示法 
{
  "countryCode": string,
  "lastCharacter": string
}
欄位
countryCode

string

必要欄位。CLDR 國家/地區代碼。例如 US (美國) 或 IN (印度)。
lastCharacter

string

車牌的最後一個號碼或「-1」，表示車牌中沒有數字值。

  • "ABC 1234" -> "4"
  • "AB 123 CD" -> "3"
  • 「ABCDEF」->「-1」

TrafficPolylineData

車輛預期路線的路況。

JSON 表示法 
{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}
欄位
trafficRendering

object (VisualTrafficReportPolylineRendering)

多邊形線條圖，顯示客戶行程沿途所有區域的車流速度。

VisualTrafficReportPolylineRendering

說明用戶端應如何為沿路多邊形的一部分著色。

JSON 表示法 
{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}
欄位
roadStretch[]

object (RoadStretch)

選用設定。應沿著折線算繪的道路路段。系統會保證不重疊區塊，但不一定會跨越整個路線。

如果沒有要設定樣式的路段，用戶端應為路線套用預設值。

RoadStretch

應算繪的道路路段。

JSON 表示法 
{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}
欄位
style

enum (Style)

必要欄位。要套用的樣式。
offsetMeters

integer

必要欄位。樣式應套用至 [offsetMeters, offsetMeters + lengthMeters) 之間。
lengthMeters

integer

必要欄位。要套用樣式的路徑長度。

樣式

路況樣式，用於顯示車流速度。

列舉
STYLE_UNSPECIFIED 未選取任何樣式。
SLOWER_TRAFFIC 車流量正在減緩。
TRAFFIC_JAM 交通壅塞。

DeviceSettings

行動裝置上的各種設定相關資訊。

JSON 表示法 
{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}
欄位
locationPowerSaveMode

enum (LocationPowerSaveMode)

省電模式開啟時，裝置上的位置資訊功能的設定行為。
isPowerSaveMode

boolean

裝置目前是否處於省電模式。
isInteractive

boolean

裝置是否處於互動狀態。
batteryInfo

object (BatteryInfo)

電池狀態的相關資訊。

LocationPowerSaveMode

當行動裝置開啟「省電模式」功能時，如何設定位置功能的行為。(https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

列舉
UNKNOWN_LOCATION_POWER_SAVE_MODE Undefined LocationPowerSaveMode
LOCATION_MODE_NO_CHANGE 位置資訊供應器不受省電模式影響，或是省電模式已關閉。
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF 省電模式啟用且裝置處於非互動狀態時，應停用以 GPS 為基礎的位置資訊供應器。
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF 省電模式開啟且裝置處於非互動狀態時，應停用所有位置資訊供應器。
LOCATION_MODE_FOREGROUND_ONLY 所有位置資訊供應器都會保持可用，但位置資訊修正資訊應只提供給前景應用程式。
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF 定位功能不會關閉，但 LocationManager 會在裝置處於非互動狀態時，限制對提供者的所有要求。

BatteryInfo

裝置電池的相關資訊。

JSON 表示法 
{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}
欄位
batteryStatus

enum (BatteryStatus)

電池狀態 (電量是否已充飽或正在充電等)
powerSource

enum (PowerSource)

電池電源狀態。
batteryPercentage

number

目前的電量百分比 [0-100]。

BatteryStatus

電池狀態 (電量是否已充飽或正在充電等)

列舉
UNKNOWN_BATTERY_STATUS 電池狀態不明。
BATTERY_STATUS_CHARGING 電池正在充電。
BATTERY_STATUS_DISCHARGING 電池正在放電。
BATTERY_STATUS_FULL 電池電量已滿。
BATTERY_STATUS_NOT_CHARGING 電池無法充電。
BATTERY_STATUS_POWER_LOW 電池電量不足。

PowerSource

用來為電池充電的充電器類型。

列舉
UNKNOWN_POWER_SOURCE 電源來源不明。
POWER_SOURCE_AC 電源為 AC 充電器。
POWER_SOURCE_USB 電源是 USB 連接埠。
POWER_SOURCE_WIRELESS 電源為無線。
POWER_SOURCE_UNPLUGGED 電池已拔除。

方法

create

 將與隨選共乘或外送服務供應商相關的新車輛例項化。

get

 傳回車隊引擎中的車輛。

list

 傳回與要求選項相符的供應商相關聯車輛的分頁清單。
傳回符合要求選項的車輛清單。

update

 將更新後的車輛資料寫入 Fleet Engine。

updateAttributes

 部分更新車輛屬性。