VehicleLog

Fleet Engine 中的車輛資源記錄檔。

JSON 表示法
{
  "name": string,
  "state": enum (VehicleStateLog),
  "supportedTrips": [
    enum (TripTypeLog)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocationLog)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttributeLog)
    }
  ],
  "vehicleType": {
    object (VehicleTypeLog)
  },
  "manualWaypointOrdering": boolean,
  "backToBackEnabled": boolean,
  "navStatus": enum (NavigationStatusLog),
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "currentRouteSegmentEndPoint": {
    object (TripWaypointLog)
  },
  "deviceSettings": {
    object (DeviceSettingsLog)
  },
  "waypoints": [
    {
      object (TripWaypointLog)
    }
  ],
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineDataLog)
  }
}
欄位
name

string

車輛資源名稱,格式為 providers/{providerId}/vehicles/{vehicleId}

state

enum (VehicleStateLog)

車輛狀態。

supportedTrips[]

enum (TripTypeLog)

這輛車支援的行程類型。

currentTrips[]

string

指派給車輛的行程清單 (tripId)。

lastLocation

object (VehicleLocationLog)

上次回報的車輛位置

maximumCapacity

integer

車輛最大容量。這是這輛車可包含的乘客總人數。這個值不含驅動程式。這個值必須大於或等於 1。

attributes[]

object (VehicleAttributeLog)

車輛服務屬性清單。

vehicleType

object (VehicleTypeLog)

交通工具類型。

manualWaypointOrdering

boolean

如為 true,Fleet Engine 不會重新排序路線控點,且提供者必須重新調整路線控點順序。否則,如果供應商沒有提供路點,Fleet Engine 會將路線控點設為最佳順序。

backToBackEnabled

boolean

指出駕駛是否接受返回行程。

navStatus

enum (NavigationStatusLog)

車輛的導航狀態。

remainingDistanceMeters

integer

currentRouteSegment剩餘的行車距離。系統也會針對指派給車輛的所有有效行程,在 Trip.remaining_distance_meters 中提供這個值。如果 currentRouteSegment 欄位空白,則系統不會指定該值。

etaToFirstWaypoint

string (Timestamp format)

下一個路線控點的預計到達時間,也就是 Vehicle.waypoint 欄位中的第一個項目。如果 waypoints 欄位空白或 Vehicle.current_route_segment 欄位為空白,則系統不會指定這個值。

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

remainingTimeSeconds

integer

currentRouteSegment的剩餘行車時間。如果 waypoints 欄位空白或 Vehicle.current_route_segment 欄位為空白,則系統不會指定這個值。這個值應與計算值時的值相符:etaToFirstWaypoint - current_time

currentRouteSegmentEndPoint

object (TripWaypointLog)

currentRouteSegment 結束的路線點。

deviceSettings

object (DeviceSettingsLog)

駕駛人所用行動裝置的設定相關資訊。

waypoints[]

object (TripWaypointLog)

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

currentRouteSegmentTraffic

object (TrafficPolylineDataLog)

Fleet Engine 會利用這項資訊提高對行程的理解程度,但不會在回應中填入該欄位。

DeviceSettingsLog

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

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

enum (LocationPowerSaveModeLog)

省電模式開啟時,裝置的位置資訊設定如何運作。

isPowerSaveMode

boolean

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

isInteractive

boolean

裝置是否處於互動狀態。

batteryInfo

object (BatteryInfoLog)

電池狀態相關資訊。

TrafficPolylineDataLog

預期車輛路線沿途的路況。

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

object (VisualTrafficReportPolylineRenderingLog)

顯示所有區域在顧客行程期間的車速折線。

VisualTrafficReportPolylineRenderingLog

說明用戶端應如何為沿途折線的一部分加上顏色。

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

object (RoadStretchLog)

應沿著折線算繪的道路延伸。請注意,延展線不能重疊,而且不一定會跨越整條路線。

RoadStretchLog

應該算繪的一條道路延伸。

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

enum (Style)

要套用的樣式。

offsetMeters

integer

樣式應在 [offsetMeters, offsetMeters + lengthMeters) 之間。

lengthMeters

integer

要套用樣式的路徑長度。