- 资源:Vehicle
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VehicleState
- VehicleAttribute
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VehicleType
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 类别
- LicensePlate
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TrafficPolylineData
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- VisualTrafficReportPolylineRendering
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- RoadStretch
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 样式
- NavigationStatus
- DeviceSettings
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- LocationPowerSaveMode
- BatteryInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- BatteryStatus
- PowerSource
- 方法
资源:Vehicle
车辆元数据。
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 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
currentRouteSegmentEndPoint |
|
remainingDistanceMeters |
|
etaToFirstWaypoint |
到达 更新车辆时,在同一请求中, 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
remainingTimeSeconds |
仅限输入。 更新车辆时,在同一请求中, |
waypoints[] |
分配给此车辆的其余航点。 |
waypointsVersion |
仅限输出。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
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 。该属性的值可以是字符串、bool 或双精度类型。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 |
电源是交流电源充电器。 |
POWER_SOURCE_USB |
电源是 USB 端口。 |
POWER_SOURCE_WIRELESS |
电源为无线电源。 |
POWER_SOURCE_UNPLUGGED |
电池已拔出。 |
方法 |
|
---|---|
|
实例化与按需拼车或配送服务提供商关联的新车。 |
|
从 Fleet Engine 中退回车辆。 |
|
返回与提供商关联的与请求选项匹配的车辆的分页列表。 |
|
返回与请求选项匹配的车辆列表。 |
|
将更新后的车辆数据写入 Fleet Engine。 |
|
部分更新车辆的属性。 |