OBU上报BSM
功能介绍
OBU上报bsm消息到平台。车辆基本安全消息，用来在车辆之间交换安全状态数据。车辆通过该消息的广播，将自身的实时状态告知周围车辆，以此支持一系列协同安全等应用。
上行TOPIC
oc/devices/{vehicle_id}/user/obu/bsm/up
topic中{vehicle_id}替换为创建车辆时填写的vehicle_id（车辆唯一标识符）。例如vehicle_id为test123，topic：oc/devices/test123/user/obu/bsm/up。
Message参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
vehicle_id |
是 |
String |
参数说明：车辆唯一标识符。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 |
|
time_stamp |
是 |
String |
"参数说明：数据采集UTC时间。格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'，例如 2021-01-08T02:03:41.907Z。 |
|
speed |
是 |
Integer |
参数说明：车辆或其他交通参与者的速度大小。单位为0.02米每秒。值为8191时代表无效数值。 最小值：0 最大值：8191 |
|
heading |
是 |
Integer |
参数说明：车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 最小值：0 最大值：28800 |
|
transmission |
是 |
Integer |
参数说明：车辆档位状态。 取值范围： 最小值：0 最大值：7 |
|
pos |
是 |
ReportedPosition3D object |
参数说明：位置信息。 |
|
brakes |
否 |
Brakes object |
参数说明：车辆的刹车系统状态，包括7种不同类型的状态。 |
|
vehicle_class |
是 |
VehicleClass object |
参数说明：车辆类型，包含车辆基本类型以及燃料动力类型。 |
|
accel_set |
是 |
AccelSet object |
参数说明：车辆四轴加速度。 |
|
size |
是 |
ReportedVehicleSize object |
参数说明：定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸，其中高度数值为可选项。 |
|
motion_cfd |
否 |
MotionCfd object |
参数说明：车辆运行状态的精度。包括车速精度、航向精度。 |
|
pos_confidence |
否 |
Integer |
参数说明：数值描述了95%置信水平的车辆位置精度。位置精度说明参见“API参考 > 附录 > 参数说明列表 > 位置精度”。 最小值：0 最大值：15 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
lat |
是 |
Object |
参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 |
|
lon |
是 |
Object |
参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 |
|
ele |
否 |
Object |
参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
abs |
否 |
Integer |
参数说明：刹车防抱死系统（ABS）状态。 取值范围： 最小值：0 最大值：3 |
|
scs |
否 |
Integer |
参数说明：车辆动态稳定控制系统状态。 取值范围： 最小值：0 最大值：3 |
|
brake_boost |
否 |
Integer |
参数说明：刹车助力系统作用情况。通过刹车辅助系统的状态，指示车辆紧急刹车状态。刹车辅助系统通过判断紧急情况是否需要急刹车，从而接管刹车系统，在驾驶员未来得及做出反应时进行刹车。辅助系统可能通过监测油门踏板的突然松开或前置检测器，来判断紧急刹车的需求。 取值范围： 最小值：0 最大值：2 |
|
aux_brakes |
否 |
Integer |
参数说明：辅助制动系统（一般指手刹）情况。 取值范围： 最小值：0 最大值：3 |
|
brake_pedal |
否 |
Integer |
参数说明：指示刹车踏板状态，是否处在被踩下状态。 取值范围： 最小值：0 最大值：2 |
|
traction |
否 |
Integer |
参数说明：牵引力控制系统实时状态。 取值范围： 最小值：0 最大值：3 |
|
wheel_brakes |
否 |
Array of integers |
参数说明：车辆车轮制动情况，定义四轮分别的刹车状态。 将车辆的轮胎分为左前、右前、左后、右后四组。当车辆进行刹车时，对应值分别指示了四组轮胎的刹车情况。 当车辆为单排轮胎（摩托车等）时，以左前和左后表示其前后轮。 当车辆某一组轮胎由多个组成时，其状态将等效到一个数值来表示。 取值范围：数组长度固定为5，数组元素类型为0或1的整数。例如：[1,0,0,1,1]，表示含义：车辆整体车轮制动可用；左前轮刹车未激活；左后轮刹车未激活；右前轮刹已激活；右后轮刹车已激活。 第1个元素取值含义：车辆整体车轮制动是否可用。0：不可用，1：可用。 第2个元素取值含义：左前轮刹车是否处于激活状态。0：否，1：是。 第3个元素取值含义：左后轮刹车是否处于激活状态。0：否，1：是。 第4个元素取值含义：右前轮刹车是否处于激活状态。0：否，1：是。 第5个元素取值含义：右后轮刹车是否处于激活状态。0：否，1：是。 最小值：0 最大值：1 数组长度：5 - 5 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
classification |
否 |
Integer |
参数说明：定义车辆基本类型。车辆基本类型说明参见“API参考 > 附录 > 参数说明列表 > 车辆基本类型”。 最小值：0 最大值：255 |
|
fuel_type |
否 |
Integer |
参数说明：定义车辆的燃料动力类型，10-15暂未定义。 取值范围： 最小值：0 最大值：15 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
long |
否 |
Integer |
参数说明：车辆纵向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 |
|
lat |
否 |
Integer |
参数说明：车辆横向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 |
|
vert |
否 |
Integer |
参数说明：定义Z轴方向的加速度大小，Z轴方向竖直向下，沿着Z轴方向为正。 分辨率为0.02G，G为重力加速度值9.80665m/s2。 最小值：-127 最大值：127 |
|
yaw |
否 |
Integer |
参数说明：车辆横摆角速度。指汽车绕垂直轴的偏转，该偏转的大小代表汽车的稳定程度。如果偏转角速度达 到一个阈值，说明汽车发生侧滑或者甩尾等危险工况。 顺时针旋转为正，逆时针为负。 数据分辨率为0.01°/s。 最小值：-127 最大值：127 |
Message示例
{
"vehicle_id" : "test_v_001",
"time_stamp" : "2021-01-08T02:03:41.907Z",
"speed" : 3000,
"heading" : 10000,
"transmission" : 2,
"pos" : {
"lat" : 40.1234567,
"lon" : 116.1234567,
"ele" : 1000
},
"brakes" : {
"abs" : 1,
"scs" : 1,
"brake_boost" : 1,
"aux_brakes" : 1,
"brake_pedal" : 1,
"traction" : 1,
"wheel_brakes" : [ 1, 0, 0, 1, 1 ]
},
"vehicle_class" : {
"classification" : 54,
"fuel_type" : 5
},
"accel_set" : {
"long" : 0,
"lat" : 0,
"vert" : 0,
"yaw" : 0
},
"size" : {
"width" : 200,
"length" : 3000,
"height" : 40
},
"motion_cfd" : {
"speed_cfd" : 5,
"heading_cfd" : 5
},
"pos_confidence" : 10
}
