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参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
id |
否 |
String |
参数说明：消息的唯一标识，用于区分与查找消息。 取值范围：长度不超过100，只允许字母、数字、以及_-等字符的组合。 |
|
name |
否 |
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示例
{
"id": "494d83b1-3a2b-408b-9eac-a49872fb8623",
"name": "name",
"content": "{\"topic\":\"obu.rsi.down\",\"payload\":{\"vehicle_id\":\"test_vehicle_001\",\"rtes\":[{\"rte_id\":100,\"event_type\":100,\"event_source\":\"v2xServer\",\"event_pos\":{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},\"event_radius\":100,\"description\":\"string\",\"time_details\":{\"start_time\":666,\"end_time\":666,\"end_time_confidence\":10},\"priority\":5,\"reference_paths\":[{\"active_path\":[{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000}],\"path_radius\":1000}],\"reference_links\":[{\"upstream_node_id\":[{\"region\":100,\"id\":100},{\"region\":100,\"id\":100}],\"downstream_node_id\":[{\"region\":100,\"id\":100},{\"region\":100,\"id\":100}],\"reference_lanes\":[true,true]}],\"event_confidence\":100,\"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\":666,\"end_time\":666,\"end_time_confidence\":10},\"priority\":5,\"reference_paths\":[{\"active_path\":[{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000}],\"path_radius\":1000}],\"reference_links\":[{\"upstream_node_id\":[{\"region\":100,\"id\":100},{\"region\":100,\"id\":100}],\"downstream_node_id\":[{\"region\":100,\"id\":100},{\"region\":100,\"id\":100}],\"reference_lanes\":[true,true]}]}]}}"
}
