- 资源:车辆
- 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 世界协调时间 (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 。属性的值,可以是字符串、布尔值或双精度类型。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 |
未定义的位置 PowerSaveMode |
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。 |
|
部分更新车辆的属性。 |