- 資源:交通工具
- VehicleState
- VehicleAttribute
- VehicleType
- 類別
- LicensePlate
- TrafficPolylineData
- VisualTrafficReportPolylineRendering
- RoadStretch
- 樣式
- NavigationStatus
- DeviceSettings
- LocationPowerSaveMode
- BatteryInfo
- BatteryStatus
- PowerSource
- 方法
資源:交通工具
車輛中繼資料。
JSON 表示法 |
---|
{ "name": string, "vehicleState": enum ( |
欄位 | |
---|---|
name |
僅供輸出。這輛車的專屬名稱。格式為 |
vehicleState |
車輛狀態。 |
supportedTripTypes[] |
這輛車支援的行程類型。 |
currentTrips[] |
僅供輸出。目前指派給這輛車的行程的 |
lastLocation |
上次回報車輛位置。 |
maximumCapacity |
這輛車的乘客總數。此值中不會考量驅動程式。這個值必須大於或等於 1。 |
attributes[] |
車輛屬性清單。每輛車最多有 100 個屬性,且每個屬性都必須有專屬索引鍵。 |
vehicleType |
必要欄位。這輛車的類型。可用於篩選「 |
licensePlate |
車輛的車牌資訊。 |
route[] |
已淘汰:請改用 |
currentRouteSegment |
指定駕駛應用程式前往下一個路線控點的路線的折線。對於指派給車輛的所有進行中行程,這份清單也會在 注意:這個欄位僅適用於驅動程式 SDK。目前不支援解碼功能。 |
currentRouteSegmentTraffic |
僅限輸入。Fleet Engine 會利用這項資訊改善分享歷程。注意:這個欄位僅適用於驅動程式 SDK。 |
currentRouteSegmentVersion |
僅供輸出。設定 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
currentRouteSegmentEndPoint |
|
remainingDistanceMeters |
|
etaToFirstWaypoint |
到 更新車輛時,在相同要求中, 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
remainingTimeSeconds |
僅限輸入。 更新車輛時,在相同要求中, |
waypoints[] |
指派給這輛車的其餘路線控點。 |
waypointsVersion |
僅供輸出。上次更新 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
backToBackEnabled |
指出駕駛人是否接受連續行程。如果為 |
navigationStatus |
車輛的導航狀態。 |
deviceSettings |
僅限輸入。驅動程式所用行動裝置的設定資訊。 |
VehicleState
Vehicle
的狀態。
列舉 | |
---|---|
UNKNOWN_VEHICLE_STATE |
預設,用於不明或無法辨識的車輛狀態。 |
OFFLINE |
車輛不接受新行程。注意:車輛在完成指派的行程時,車輛可能會繼續處於這個狀態。 |
ONLINE |
車輛正在接受新的行程。 |
VehicleAttribute
將車輛屬性描述為鍵/值組合。「key:value」字串長度不得超過 256 個字元。
JSON 表示法 |
---|
{ "key": string, "value": string, // Union field |
欄位 | |
---|---|
key |
屬性的鍵。鍵不得包含冒號字元 (:)。 |
value |
屬性值。 |
聯集欄位 vehicle_attribute_value 。屬性的值可以是字串、布林值或雙精度浮點數。vehicle_attribute_value 只能是下列其中一項: |
|
stringValue |
字串類型的屬性值。 注意:這與最終將會淘汰的 |
boolValue |
布林值類型的屬性值。 |
numberValue |
雙重類型的屬性值。 |
VehicleType
交通工具類型。
JSON 表示法 |
---|
{
"category": enum ( |
欄位 | |
---|---|
category |
交通工具類型類別 |
類別
交通工具類型類別
列舉 | |
---|---|
UNKNOWN |
預設,用於未指定或無法辨識的車輛類別。 |
AUTO |
汽車。 |
TAXI |
任何搭乘計程車 (通常有執照或管制) 的車輛。 |
TRUCK |
通常是指儲存容量大的車輛。 |
TWO_WHEELER |
摩托車、電動自行車或其他雙輪車輛 |
BICYCLE |
人電運輸。 |
PEDESTRIAN |
人類運輸工具,通常是步行或跑步,沿著人行道行駛。 |
LicensePlate
車輛的車牌資訊。為了避免儲存個人識別資訊,系統只會將車牌的最少資訊儲存為實體的一部分。
JSON 表示法 |
---|
{ "countryCode": string, "lastCharacter": string } |
欄位 | |
---|---|
countryCode |
必要欄位。CLDR 國家/地區代碼。例如, |
lastCharacter |
車牌的最後一位數或「-1」代表車牌上沒有數值。
|
TrafficPolylineData
預期車輛路線沿途的路況。
JSON 表示法 |
---|
{
"trafficRendering": {
object ( |
欄位 | |
---|---|
trafficRendering |
以折線呈現客戶行程中,所有區域的車速變化。 |
VisualTrafficReportPolylineRendering
說明用戶端應如何在路線上為折線的某一部分加上顏色。
JSON 表示法 |
---|
{
"roadStretch": [
{
object ( |
欄位 | |
---|---|
roadStretch[] |
選用設定。應沿著折線呈現的道路。彈性路線保證不會重疊,而且不一定橫跨整個路線。 如果沒有為樣式設定延伸的道路,用戶端應套用該路線的預設值。 |
RoadStretch
應該轉譯的一條公路。
JSON 表示法 |
---|
{
"style": enum ( |
欄位 | |
---|---|
style |
必要欄位。要套用的樣式。 |
offsetMeters |
必要欄位。樣式應在 |
lengthMeters |
必要欄位。要套用樣式的路徑長度。 |
樣式
流量樣式,代表流量速度。
列舉 | |
---|---|
STYLE_UNSPECIFIED |
未選取任何樣式。 |
SLOWER_TRAFFIC |
流量變慢。 |
TRAFFIC_JAM |
路上有壅塞。 |
DeviceSettings
行動裝置上不同設定的資訊。
JSON 表示法 |
---|
{ "locationPowerSaveMode": enum ( |
欄位 | |
---|---|
locationPowerSaveMode |
位置資訊功能設定在省電模式開啟時,裝置會如何運作。 |
isPowerSaveMode |
裝置目前是否處於省電模式。 |
isInteractive |
裝置是否處於互動狀態。 |
batteryInfo |
電池狀態的相關資訊。 |
LocationPowerSaveMode
裝置開啟「省電模式」功能時,位置資訊功能在行動裝置上的運作方式。(https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
列舉 | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
未定義 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 |
位置資訊功能不會關閉,但位置管理工具會在裝置非互動時,限制向供應商發出的所有要求。 |
BatteryInfo
裝置電池的相關資訊。
JSON 表示法 |
---|
{ "batteryStatus": enum ( |
欄位 | |
---|---|
batteryStatus |
電池狀態,例如充飽電或充電等。 |
powerSource |
電池電源狀態。 |
batteryPercentage |
目前的電量百分比 [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 |
電池未插電。 |
方法 |
|
---|---|
|
將與隨選代僱駕駛服務或配送服務供應商相關聯的新車輛例項化。 |
|
從機群引擎傳回車輛。 |
|
傳回與要求選項符合的供應商相關聯之分頁式分頁清單。 |
|
傳回與要求選項相符的車輛清單。 |
|
將更新後的車輛資料寫入 Fleet Engine。 |
|
部分更新車輛屬性。 |