OBU接收RSI
功能介绍
通过在平台创建即时交通事件下发rsi消息到指定的obu设备。
下行TOPIC
$oc/devices/{vehicle_id}/sys/messages/down
topic中{vehicle_id}替换为创建车辆时填写的vehicle_id（车辆唯一标识符）。例如vehicle_id为test123，topic：$oc/devices/test123/sys/messages/down。
Message参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
object_device_id |
是 |
String |
参数说明：车辆唯一标识符。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 |
content |
是 |
ObuReceivedRsiData object |
参数说明：下发rsi消息内容，格式为JSON字符串。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
topic |
是 |
String |
参数说明：topic名称，固定为obu.rsi.down。 最小长度：1 最大长度：256 |
payload |
是 |
ObuReceivedRsiPayload object |
参数说明：下发rsi消息内容。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
vehicle_id |
是 |
String |
参数说明：车辆唯一标识符。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 |
rtes |
否 |
Array of RtesDTO objects |
参数说明：道路交通事件集合。 数组长度：1 - 8 |
rtss |
是 |
Array of RtssDTO objects |
参数说明：道路交通标志集合。 数组长度：1 - 16 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
rte_id |
否 |
Integer |
参数说明：道路交通事件的本地id。 最小值：0 最大值：255 |
event_type |
否 |
Integer |
参数说明：GB/T 29100-2012定义的事件类型。 最小值：0 最大值：65535 |
event_source |
否 |
String |
参数说明：来源的具体类型描述。 取值范围： |
event_pos |
否 |
ReceivedPosition3D object |
参数说明：位置信息。 |
event_radius |
否 |
Integer |
参数说明：事件半径，单位分米。 最小值：0 最大值：1000 |
description |
否 |
String |
参数说明：道路交通事件的描述信息。 最小长度：0 最大长度：255 |
time_details |
否 |
OBUReceivedRSITimeDetails object |
参数说明：道路交通事件和道路交通标志信息的生效时间属性。 |
priority |
否 |
Integer |
参数说明：道路交通事件的紧急程度。数字越大，级别越高。 最小值：0 最大值：7 |
reference_paths |
否 |
Array of OBUReceivedReferencePath objects |
参数说明：标志的参考路径集合。 数组长度：1 - 8 |
reference_links |
否 |
Array of ObuReceivedReferenceLink objects |
参数说明：标志的参考路径集合。 数组长度：1 - 16 |
event_confidence |
否 |
Integer |
参数说明：道路交通事件的信息来源提供的事件置信度水平，帮助接收端判断是否相信该事件信息，单位为0.5%。 最小值：0 最大值：200 |
duration |
否 |
Integer |
参数说明：告警持续时长，过期自动删除，0表示只广播一次，非0值按照时长和RSU本地广播频率确定广播次数。 最小值：0 最大值：20000 |
event_status |
否 |
Integer |
参数说明：1 active；0 cancel；激活或取消对应eventId的事件，默认激活，显式带0取消。 最小值：0 最大值：1 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
rts_id |
是 |
Integer |
参数说明：标志信息编号。 最小值：0 最大值：255 |
sign_type |
是 |
Integer |
参数说明：标志类型，如：2代表急转弯，38代表道路施工，定义参考国标5768.2。 最小值：0 最大值：65535 |
sign_pos |
是 |
ReceivedPosition3D object |
参数说明：位置信息。 |
description |
是 |
String |
参数说明：标志信息的描述。 最小长度：1 最大长度：512 |
time_details |
否 |
OBUReceivedRSITimeDetails object |
参数说明：道路交通事件和道路交通标志信息的生效时间属性。 |
priority |
否 |
Integer |
参数说明：道路交通标志紧急程度。数字越大，级别越高。 最小值：0 最大值：7 |
reference_paths |
是 |
Array of OBUReceivedReferencePath objects |
参数说明：标志的参考路径集合。 数组长度：1 - 8 |
reference_links |
否 |
Array of ObuReceivedReferenceLink objects |
参数说明：标志的参考路径集合。 数组长度：1 - 16 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
lat |
是 |
Number |
参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 最小值：-90 最大值：90 |
lon |
是 |
Number |
参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 最小值：-180 最大值：180 |
ele |
否 |
Number |
参数说明：定义海拔高程，可选，单位为分米。 最小值：-4095 最大值：61439 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
start_time |
否 |
Integer |
参数说明：开始时间。数值用来表示当前年份，已经过去的总分钟数（UTC时间）。 最小值：0 最大值：527040 |
end_time |
否 |
Integer |
参数说明：结束时间。数值用来表示当前年份，已经过去的总分钟数（UTC时间）。 最小值：0 最大值：527040 |
end_time_confidence |
否 |
Integer |
参数说明：数值描述了95%置信水平的结束时间置信度。该精度理论上只考虑了当前计时系统本身传感器的误差。时间置信度说明参见“API参考 > 附录 > 参数说明列表 > 时间精度”。 最小值：0 最大值：39 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
active_path |
是 |
Array of ReceivedPosition3D objects |
参数说明：影响区域中心线点集，参考路径上有序的位置点集。 数组长度：2 - 32 |
path_radius |
是 |
Integer |
参数说明：事件的影响区域半径，可选，单位为分米。用半径表示影响区域边界离中心线的垂直距离，反映该区域的宽度以覆盖实际路段。 最小值：0 最大值：65535 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
upstream_node_id |
否 |
Array of NodeID objects |
参数说明：路段的上游节点。 数组长度：2 - 32 |
downstream_node_id |
否 |
Array of NodeID objects |
参数说明：路段的下游节点。 数组长度：2 - 32 |
reference_lanes |
否 |
Array of booleans |
参数说明：将指定车道号对应的boolean值为TRUE表示该车道为有效的参考车道。最多支持15条车道。车道号，以该车道行驶方向为参考，自左向右从1开始编号。 数组长度：2 - 32 |
Message示例
{
"object_device_id" : "test_vehicle_001",
"content" : "{\"topic\":\"obu.rsi.down\",\"payload\":{\"vehicle_id\": \"test_vehicle_001\",\"rtes\":[{\"rte_id\":10,\"event_type\":2,\"event_source\":2,\"event_pos\":{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},\"event_radius\":2,\"description\":\"123456789\",\"time_details\":{\"start_time\":2,\"end_time\":2,\"end_time_confidence\":2},\"priority\":2,\"reference_paths\":[{\"active_path\":[{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000}],\"path_radius\":2}],\"reference_links\":[{\"upstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"downstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"reference_lanes\":[true,true]}],\"event_confidence\":2,\"duration\":0,\"event_status\":0}],\"rtss\":[{\"rts_id\":10,\"sign_type\":2,\"sign_pos\":{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},\"description\":\"123456789\",\"time_details\":{\"start_time\":2,\"end_time\":2,\"end_time_confidence\":2},\"priority\":2,\"reference_paths\":[{\"active_path\":[{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000}],\"path_radius\":2}],\"reference_links\":[{\"upstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"downstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"reference_lanes\":[true,true]},{\"upstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"downstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"reference_lanes\":[true,true]}]}]}}"
}
