- 資源:Vehicle
- 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」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
currentRouteSegmentEndPoint |
|
remainingDistanceMeters |
|
etaToFirstWaypoint |
預計到達 更新車輛時,在同一項要求中, RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
remainingTimeSeconds |
僅限輸入。 更新車輛時,在同一項要求中, |
waypoints[] |
指派給這輛車的其餘路線控點。 |
waypointsVersion |
僅供輸出。上次更新 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
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 |
定位功能不會關閉,但 LocationManager 會在裝置沒有互動的情況下,限制所有向供應商發出的要求。 |
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 傳回車輛。 |
|
傳回與要求選項相符之供應商相關聯的分頁清單。 |
|
傳回與要求選項相符的車輛清單。 |
|
將更新後的車輛資料寫入 Fleet Engine。 |
|
部分更新車輛屬性。 |