华为云用户手册

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 body 是 OpenV2XSPATTopicBodyDTO object 参数说明：信号灯消息。 header 是 OpenSPATTopicHeaderDTO object 参数说明：信号灯消息的附加信息。 表2 OpenV2XSPATTopicBodyDTO 参数 是否必选 参数类型 描述 spat_source 否 SPATSource object 参数说明：消息来源。 intersections 是 Array of IntersectionStateDTO objects 参数说明：路口信号灯集合。 time_stamp 否 String 参数说明：平台推送消息的UTC时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。 例如2021-12-18T07:20:51.683Z。 name 否 String 参数说明：供理解的名称描述。 最小长度：1 最大长度：63 表3 SPATSource 参数 是否必选 参数类型 描述 spat_source_type 是 String 参数说明：来源的具体类型。 枚举值： unknown police government meteorological internet detection v2xServer rsu obu signalMachine spat_source_id 否 String 参数说明：来源的唯一标识码ID。 最小长度：0 最大长度：255 表4 IntersectionStateDTO 参数 是否必选 参数类型 描述 intersection_id 是 NodeReferenceId object 参数说明：节点属性ID。 intersection_status_object 否 IntersectionStatusObject object 参数说明：路口信号机的工作状态指示。 time_stamp 否 String 参数说明：信号机发送信号时携带的UTC时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。 如2021-12-18T07:20:51.683Z。 time_confidence 否 Integer 参数说明：数值描述了95%置信水平的时间精度。参考时间精度参数说明。 最小值：0 最大值：39 phases 是 Array of PhaseDTO objects 参数说明：信号灯各道路方向的灯态列表。 表5 NodeReferenceId 参数 是否必选 参数类型 描述 region 否 Integer 参数说明：所在区域在地图中的编号，数值0仅用于测试。 最小值：0 最大值：65535 node_id 是 Integer 参数说明：节点编号。路网最基本的构成即节点和节点之间连接的路段。节点可以是路口，也可以是一条 路的端点。一个节点的ID在同一个区域内是唯一的。数值 0~255 预留为测试使用。 最小值：0 最大值：65535 表6 IntersectionStatusObject 参数 是否必选 参数类型 描述 manual_control_is_enabled 否 Boolean 参数说明：手动控制状态开启。 stop_time_is_activated 否 Boolean 参数说明：停止计时状态激活。 failure_flash 否 Boolean 参数说明：用于硬件故障检测。 preempt_is_active 否 Boolean 参数说明：优先状态激活。 signal_priority_is_active 否 Boolean 参数说明：信号优先级状态激活。 fixed_time_operation 否 Boolean 参数说明：固定配时。 traffic_dependent_operation 否 Boolean 参数说明：基于交通流状态的配时。 standby_operation 否 Boolean 参数说明：备用操作，可部分关闭或闪烁。 failure_mode 否 Boolean 参数说明：故障模式。 controller_off 否 Boolean 参数说明：控制状态关闭。 recent_map_message_update 否 Boolean 参数说明：近期地图内容数据更新。 recent_change_in_map_assigned_lanes_ids_used 否 Boolean 参数说明：近期地图道路id数据更新。 no_valid_map_is_available_at_this_time 否 Boolean 参数说明：此时无有效地图。 no_valid_spat_is_available_at_this_time 否 Boolean 参数说明：此时无有效spat信息。 表7 PhaseDTO 参数 是否必选 参数类型 描述 phase_id 是 Integer 参数说明：定义信号灯相位ID。数值0表示无效ID。 最小值：0 最大值：255 phase_states 是 Array of PhaseStateDTO objects 参数说明：一个信号灯的一个相位状态列表。列表中每一个相位状态物理上对应了一种相位灯色，其属性包括了该状态的实时计时信息。 表8 PhaseStateDTO 参数 是否必选 参数类型 描述 light_state 是 Integer 参数说明：定义信号灯相位的灯色状态。支持GB14886规定的红绿黄三种信号灯灯色，以及亮灯、 闪烁和熄灭三种状态。 取值范围： 0：不可用 1：黑色 2：红色闪烁 3：红色 4：绿色闪烁 5：通行允许相位（通行绿） 6：通行保护相位（保护绿） 7：黄色 8：黄色闪烁 最小值：0 最大值：8 timing 否 TimeChangeDetailsDTO object 参数说明：定义一个信号灯相位的计时状态。提供了两种可选的计时状态格式，一种是倒计时形式，另一种是UTC世界标准时间的形式。在实际使用时，由路侧设施根据实际情况选用。 表9 TimeChangeDetailsDTO 参数 是否必选 参数类型 描述 counting 否 TimeCountingDownDTO object 参数说明：用倒计时形式，描述一个信号灯相位状态的完整计时状态。 utc_timing 否 UTCTimingDTO object 参数说明：用UTC世界标准时间形式，描述一个信号灯相位状态的完整计时状态。 表10 TimeCountingDownDTO 参数 是否必选 参数类型 描述 start_time 是 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 min_end_time 否 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 max_end_time 否 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 likely_end_time 是 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 time_confidence 否 Integer 参数说明：定义置信度。单位为0.5%。 最小值：0 最大值：200 next_start_time 否 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 next_duration 否 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 表11 UTCTimingDTO 参数 是否必选 参数类型 描述 start_utc_time 是 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 min_end_utc_time 否 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 max_end_utc_time 否 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 likely_end_utc_time 是 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 time_confidence 否 Integer 参数说明：定义置信度。单位为0.5%。 最小值：0 最大值：200 next_start_utc_time 否 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 next_end_utc_time 否 TimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 表12 TimeMark 参数 是否必选 参数类型 描述 time_mark 是 Integer 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 最小值：0 最大值：36001 表13 OpenSPATTopicHeaderDTO 参数 是否必选 参数类型 描述 instance_id 是 String 参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 event 是 String 参数说明：操作描述。" 取值范围： MODIFIED：修改 ADDED：新增 DELETED：删除 枚举值： MODIFIED ADDED DELETED

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 vehicle_id String 参数说明：车辆唯一标识符。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 plate_no String 参数说明：车牌号。 取值范围：长度最小1最大64，支持中文、阿拉伯文、字母、数字、下划线（_）、横杠（-）的组合。 vin String 参数说明：VIN码，车辆的17位VIN码。 取值范围：长度不超过17，只允许字母、数字字符的组合。 obu_id String "参数说明：车载OBU的唯一标识。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 imei String 参数说明：IMEI，OBU上电子序列号。 取值范围：长度最小1最大255，支持纯数字的组合。 brand String 参数说明：车辆品牌。 取值范围：长度最小1最大64，支持中文、字母、数字、下划线（_）、横杠（-）的组合。 model String 参数说明：车牌型号。 取值范围：长度最小1最大64，支持字母、数字、下划线（_）、横杠（-）的组合。 style String 参数说明：车辆年款。 取值范围：长度最小1最大64，支持纯数字的组合。 fuel_type String 参数说明：定义车辆的燃料动力类。 取值范围： unknownFuel：未知 gasoline：汽油 ethanol：乙醇 diesel：柴油 electric：电动 hybrid：混合燃料类型 hydrogen：氢气 natGasLiquid：液化天然气 natGasComp：压缩天然气 propane：丙烷 color String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 gray：灰色 red：红色 blue：蓝色 yellow：黄色 orange：橙色 brown：棕色 green：绿色 purple：紫色 cyan：青色 pink：粉红色 transparent：透明色 other：其他 plate_color String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 blue：蓝色 yellow：黄色 green：绿色 access_type String 参数说明：车辆接入网络的方式。 取值范围： 5g 4g 3g 2g pc5Only pc5And5g pc5And4g pc5And3g pc5And2g description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 last_modified_time String 参数说明：最后修改的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_time String 参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化

响应示例 状态码： 201 Created { "vehicle_id" : "13229397084005974033576909202199", "plate_no" : "粤B12345", "vin" : "vin121456", "obu_id" : "112412", "imei" : "2313523162", "brand" : "polo", "model" : "model", "style" : "2020", "fuel_type" : "gasoline", "color" : "blue", "plate_color" : "black", "access_type" : "5g", "description" : "description", "status" : "INITIAL", "created_time" : "2022-01-06T09:30:24Z"}

请求示例 POST https://{endpoint}/v1/{project_id}/vehiclesContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "vehicle_id" : "13229397084005974033576909202199", "plate_no" : "粤B12345", "vin" : "vin121456", "obu_id" : "112412", "imei" : "2313523162", "brand" : "polo", "model" : "model", "style" : "2020", "fuel_type" : "gasoline", "color" : "blue", "plate_color" : "black", "access_type" : "5g", "secret" : "secret123456", "description" : "description"}

响应示例 状态码： 200 OK { "count" : 1, "vehicles" : [ { "vehicle_id" : "12302463411926825917269660281057", "plate_no" : "Huawei", "vin" : "74512845126", "obu_id" : "OBU_007", "imei" : "987954asdfasdf", "brand" : "Huawei", "model" : "Huawei", "style" : "2022", "fuel_type" : "gasoline", "color" : "white", "plate_color" : "black", "access_type" : "5g", "description" : "description", "last_modified_time" : "2020-09-01T01:37:01Z", "created_time" : "2020-09-01T01:37:01Z", "last_online_time" : "2020-11-01T01:37:01Z", "status" : "OFFLINE" } ]}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：返回车辆的总体数量。 vehicles Array of VehicleDTO objects 参数说明：数据列表。 表5 VehicleDTO 参数 参数类型 描述 vehicle_id String 参数说明：车辆唯一标识符。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 plate_no String 参数说明：车牌号。 取值范围：长度最小1最大64，支持中文、阿拉伯文、字母、数字、下划线（_）、横杠（-）的组合。 vin String 参数说明：VIN码，车辆的17位VIN码。 取值范围：长度不超过17，只允许字母、数字字符的组合。 obu_id String "参数说明：车载OBU的唯一标识。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 imei String 参数说明：IMEI，OBU上电子序列号。 取值范围：长度最小1最大255，支持纯数字的组合。 brand String 参数说明：车辆品牌。 取值范围：长度最小1最大64，支持中文、字母、数字、下划线（_）、横杠（-）的组合。 model String 参数说明：车牌型号。 取值范围：长度最小1最大64，支持字母、数字、下划线（_）、横杠（-）的组合。 style String 参数说明：车辆年款。 取值范围：长度最小1最大64，支持纯数字的组合。 fuel_type String 参数说明：定义车辆的燃料动力类。 取值范围： unknownFuel：未知 gasoline：汽油 ethanol：乙醇 diesel：柴油 electric：电动 hybrid：混合燃料类型 hydrogen：氢气 natGasLiquid：液化天然气 natGasComp：压缩天然气 propane：丙烷 color String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 gray：灰色 red：红色 blue：蓝色 yellow：黄色 orange：橙色 brown：棕色 green：绿色 purple：紫色 cyan：青色 pink：粉红色 transparent：透明色 other：其他 plate_color String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 blue：蓝色 yellow：黄色 green：绿色 access_type String 参数说明：车辆接入网络的方式。 取值范围： 5g 4g 3g 2g pc5Only pc5And5g pc5And4g pc5And3g pc5And2g description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 last_modified_time String 参数说明：最后修改的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_time String 参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化

Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "rsm_source" : { "rsm_source_type" : "rsu", "rsm_source_id" : "RSU0123456789", "esn" : "2102312ETX10K7000037" }, "id" : "12345678", "send_time" : "2020-09-01T01:37:01.123Z", "ref_pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "participant_list" : [ { "ptc_type" : "unknown", "ptc_id" : 3, "global_track_id" : 3, "source" : "rsu", "id" : "1234567890", "sec_mark" : 0, "pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "pos_confidence" : { "position_confidence" : 10, "ele_confidence" : 10 }, "transmission" : 2, "speed" : 3000, "heading" : 10000, "angle" : 0, "vehicle_color" : "black", "vehicle_model" : "朗逸", "vehicle_brand" : "红旗", "vehicle_style" : "2018,2019,2020", "lane_no" : 1, "gat_vehicle_class" : "K33", "cross_id" : "cross0123456789", "plate_no" : "粤B1234567", "motion_cfd" : { "speed_confidence" : 5, "heading_confidence" : 5, "steer_confidence" : 2 }, "accel_set" : { "long_accel" : 0, "lat_accel" : 0, "vert_accel" : 0, "yaw_rate" : 0 }, "size" : { "width" : 200, "length" : 3000, "height" : 40 }, "vehicle_class" : { "basic_vehicle_class" : 54, "fuel_type" : 5 } } ] }}

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 body 是 OpenV2XRSMTopicBodyDTO object 参数说明：路侧动态目标物消息，参考路侧安全消息。来源于边缘感知计算单元分析生成的路侧动态目标物状态数据。 header 是 OpenRSMTopicHeaderDTO object 参数说明：路侧动态目标物数据的附加信息。 表2 OpenV2XRSMTopicBodyDTO 参数 是否必选 参数类型 描述 rsm_source 否 R SMS ource object 参数说明：消息来源。 ref_pos 是 Position3D object 参数说明：位置信息。 participant_list 否 Array of ParticipantData objects 参数说明：交通参与者列表。应用于RSM消息，表示当前探测到的所有或者部分交通参与者信息。 表3 RSMSource 参数 是否必选 参数类型 描述 rsm_source_type 是 String 参数说明：信息来源的具体类型描述。 枚举值： rsu obu detection rsm_source_id 否 String 参数说明：信息来源的唯一标识码ID。 最小长度：1 最大长度：255 esn 是 String 参数说明：设备编码。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 表4 ParticipantData 参数 是否必选 参数类型 描述 ptc_type 是 String 参数说明：路侧单元检测到的交通参与者类型。 取值范围： unknown：未知类型 motor：机动车 non-motor：非机动车 pedestrian：行人 rsu：RSU设备 枚举值： unknown motor non-motor pedestrian rsu ptc_id 是 Integer 参数说明：检测单元设置的临时ID。 最小值：0 最大值：65535 global_track_id 否 Long 参数说明：ITS800通过GlobalTrackID字段标识了车辆唯一ID。 最小值：0 最大值：9223372036854775807 source 是 String 参数说明：定义交通参与者数据的来源。 枚举值： unknown rsu v2x video microwaveRadar loop lidar integrated id 否 String 参数说明：对应BSM消息中车辆ID。 最小长度：8 最大长度：8 sec_mark 是 Integer 参数说明：以0.1 秒为单位，定义1分钟中的毫秒级时刻。分辨率为1毫秒，有效范围是0~59999。 60000及以上表示未知或无效数值。 最小值：0 最大值：65535 pos 是 Position3D object 参数说明：位置信息。 pos_confidence 是 PositionalConfidence object 参数说明：定义当前实时位置（经纬度和高程）的精度大小，包括水平位置精度和高程精度， 由系统自身进行实时计算和更新。 transmission 否 Integer 参数说明：车辆档位状态。 0：空档 1：停止档 2：前进档 3：倒档 7：不可用 4~6：预留 最小值：0 最大值：7 speed 是 Integer 参数说明：车辆或其他交通参与者的速度大小。单位为0.02米每秒。值为8191时代表无效数值。 最小值：0 最大值：8191 heading 是 Integer 参数说明：车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 最小值：0 最大值：28800 angle 否 Integer 参数说明：定义车辆转向轮角度。向右为正，向左为负。单位为1.5°，值为127时代表无效值。 最小值：-126 最大值：127 vehicle_color 否 String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 gray：灰色 red：红色 blue：蓝色 yellow：黄色 orange：橙色 brown：棕色 green：绿色 purple：紫色 cyan：青色 pink：粉红色 transparent：透明色 other：其他 最小长度：0 最大长度：100 vehicle_model 否 String 参数说明：车辆型号。 最小长度：0 最大长度：31 vehicle_brand 否 String 参数说明：车辆品牌。 最小长度：0 最大长度：31 vehicle_style 否 String 参数说明：车辆年款，通过年份来表示，多个年份通过逗号分隔。 最小长度：0 最大长度：63 lane_no 否 Integer 参数说明：车辆所在车道。默认不携带。 最小值：0 最大值：99 gat_vehicle_class 否 String 参数说明：机动车车辆类型。参考机动车车辆类型。 cross_id 否 String 参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 最小长度：0 最大长度：64 plate_no 否 String 参数说明：车牌号。 最小长度：0 最大长度：32 motion_cfd 否 MotionConfidenceSet object 参数说明：描述车辆运行状态的精度。包括车速精度、航向精度和方向盘转角的精度。 accel_set 否 AccelerationSet4Way object 参数说明：定义车辆四轴加速度。 size 是 VehicleSize object 参数说明：定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸，其中高度数值为可选项。 vehicle_class 否 VehicleClassification object 参数说明：定义车辆类型。包含车辆基本类型以及燃料动力类型。 表5 Position3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表6 PositionalConfidence 参数 是否必选 参数类型 描述 position_confidence 是 Integer 参数说明：数值描述了95%置信水平的车辆位置精度。参考 位置精度参数说明。 最小值：0 最大值：15 ele_confidence 否 Integer 参数说明：数值描述了95%置信水平的车辆高程精度。参考 高程精度参数说明。 最小值：0 最大值：15 表7 MotionConfidenceSet 参数 是否必选 参数类型 描述 speed_confidence 否 Integer 参数说明：数值描述了95%置信水平的速度精度。 取值范围： 0：不可用 1：100m/s 2：10m/s 3：5m/s 4：1m/s 5：0.1m/s 6：0.05m/ 7：0.01m/s 最小值：0 最大值：7 heading_confidence 否 Integer 参数说明：数值描述了95%置信水平的航向精度。 取值范围： 0：不可用 1：10° 2：5° 3：1° 4：0.1° 5：0.05° 6：0.01° 7：0.0125° 最小值：0 最大值：7 steer_confidence 否 Integer 参数说明：数值描述了95%置信水平的车辆转向轮角度精度。 取值范围： 0：不可用 1：2° 2：1° 3：0.02° 最小值：0 最大值：3 表8 AccelerationSet4Way 参数 是否必选 参数类型 描述 long_accel 是 Integer 参数说明：车辆纵向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 lat_accel 是 Integer 参数说明：车辆横向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 vert_accel 是 Integer 参数说明：定义Z轴方向的加速度大小，Z轴方向竖直向下，沿着Z轴方向为正。 分辨率为0.02G，G为重力加速度值9.80665m/s2。 最小值：-127 最大值：127 yaw_rate 是 Integer 参数说明：车辆横摆角速度。指汽车绕垂直轴的偏转，该偏转的大小代表汽车的稳定程度。如果偏转角速度达 到一个阈值，说明汽车发生侧滑或者甩尾等危险工况。 顺时针旋转为正，逆时针为负。 数据分辨率为0.01°/s。 最小值：-127 最大值：127 表9 VehicleSize 参数 是否必选 参数类型 描述 width 是 Integer 参数说明：车辆车身宽度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：1023 length 是 Integer 参数说明：车辆车身长度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：4095 height 否 Integer 参数说明：车辆车身高度。单位为0.05米。值为0时代表无效数值。 最小值：0 最大值：127 表10 VehicleClassification 参数 是否必选 参数类型 描述 basic_vehicle_class 否 Integer 参数说明：定义车辆基本类型。参考 车辆基本类型参数说明。 最小值：0 最大值：255 fuel_type 否 Integer 参数说明：定义车辆的燃料动力类型，10-15暂未定义。 取值范围： 0：未知 1：汽油 2：乙醇 3：柴油 4：电动 5：混合燃料类型 6：氢气 7：液化天然气 8：压缩天然气 9：丙烷 最小值：0 最大值：15 表11 OpenRSMTopicHeaderDTO 参数 是否必选 参数类型 描述 instance_id 是 String 参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 event 是 String 参数说明：操作描述。" 取值范围： MODIFIED：修改 ADDED：新增 DELETED：删除 枚举值： MODIFIED ADDED DELETED

Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "source" : { "source_type" : "detection", "source_id" : "EDGE0123456789", "esn" : "2102312ETX10K7000037" }, "time" : "2020-09-01T01:37:01.123Z", "cross_id" : "cross0123456789", "track_list" : [ { "track_id" : 50, "ptc_type" : "motor", "ptc_id" : 3, "source" : "rsu", "global_track_id" : 3, "vehicle_class" : 10, "vehicle_color" : "black", "vehicle_model" : "朗逸", "vehicle_brand" : "红旗", "vehicle_style" : "2018,2019,2020", "gat_vehicle_class" : "K33", "plat_no" : "浙A12345", "heading" : 158.23, "speed" : 10.2, "car_direction" : 1, "fuel_type" : 5, "camera_list" : [ { "id" : 0, "ip" : "127.0.0.1" } ], "size" : { "width" : 200, "length" : 400, "height" : 200 }, "location_list" : [ { "lon" : 123.123, "lat" : 11.123, "speed" : 10.2, "accel_set" : { "long_accel" : 3, "lat_accel" : 4, "vert_accel" : 0, "yaw_rate" : 0 }, "heading" : 158.23, "angle" : 0, "car_direction" : 1, "time_stamp" : 1626243657123 } ] } ] }}

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 header 是 OpenV2XTracksHeader object 参数说明：轨迹数据信息的附加描述。 body 是 OpenV2XTracksBody object 参数说明：轨迹数据信息。 表2 OpenV2XTracksHeader 参数 是否必选 参数类型 描述 instance_id 是 String 参数说明：实例ID。dris物理实例的唯一标识。 event 是 String 参数说明：操作描述。" 取值范围： MODIFIED：修改 ADDED：新增 DELETED：删除 枚举值： MODIFIED ADDED DELETED 表3 OpenV2XTracksBody 参数 是否必选 参数类型 描述 source 否 TracksSource object 参数说明：消息来源。 time 否 String 参数说明：数据上报的时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。 例如 2021-01-08T02:03:41.907Z。 cross_id 否 String 参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 最小长度：0 最大长度：64 track_list 否 Array of TrackList objects 参数说明：轨迹列表。 数组长度：0 - 100 表4 TracksSource 参数 是否必选 参数类型 描述 source_type 否 String 参数说明：信息来源的具体类型描述。 枚举值： rsu obu detection sne source_id 否 String 参数说明：信息来源的唯一标识码ID。 最小长度：1 最大长度：255 esn 否 String 参数说明：设备编码。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 表5 TrackList 参数 是否必选 参数类型 描述 track_id 否 Long 参数说明：轨迹id。 最小值：0 最大值：9223372036854775807 ptc_type 否 String 参数说明：路侧单元检测到的交通参与者类型。 取值范围： unknown：未知类型 motor：机动车 non-motor：非机动车 pedestrian：行人 rsu：RSU设备 ptc_id 否 Integer 参数说明：检测单元设置的临时ID。 最小值：0 最大值：65535 source 否 String 参数说明：定义交通参与者数据的来源。 取值范围： unknown：未知数据源类型 rsu：RSU自身信息 v2x：参与者自身的v2x广播消息 video：视频传感器 microwaveRadar：微波雷达传感器 loop：地磁线圈传感器 lidar：激光雷达传感器 integrated：一类或以上感知数据的融合结果 global_track_id 否 Long 参数说明：ITS800通过GlobalTrackID字段标识了车辆唯一ID。 最小值：0 最大值：9223372036854775807 vehicle_class 否 Integer 参数说明：车辆类型。参考车辆基本类型。 最小值：0 最大值：1000 gat_vehicle_class 否 String 参数说明：机动车车辆类型。参考机动车车辆类型。 vehicle_color 否 String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 gray：灰色 red：红色 blue：蓝色 yellow：黄色 orange：橙色 brown：棕色 green：绿色 purple：紫色 cyan：青色 pink：粉红色 transparent：透明色 other：其他 vehicle_model 否 String 参数说明：车辆型号。 最小长度：0 最大长度：63 vehicle_brand 否 String 参数说明：车辆品牌。 最小长度：0 最大长度：31 vehicle_style 否 String 参数说明：车辆年款，通过年份来表示，多个年份通过逗号分隔。 最小长度：0 最大长度：63 plat_no 否 String 参数说明：车牌。 最小长度：0 最大长度：63 heading 否 Number 参数说明：车的航向角，正北为0度，顺时针增加。单位° 最小值：0 最大值：360 speed 否 Number 参数说明：速度，单位km/h。 最小值：0 最大值：1000 car_direction 否 Integer 参数说明：车辆方向。 取值范围： -1：未知方向 0：车头 1：车尾 最小值：-1 最大值：1 fuel_type 否 Integer 参数说明：定义车辆的燃料动力类型，10-15暂未定义。 取值范围： 0：未知 1：汽油 2：乙醇 3：柴油 4：电动 5：混合燃料类型 6：氢气 7：液化天然气 8：压缩天然气 9：丙烷 最小值：0 最大值：15 size 否 SizeDTO object 参数说明：车辆尺寸。 camera_list 否 Array of TrackCameraInfo objects 拍摄到事件的摄像头信息。 数组长度：0 - 10 location_list 否 Array of LocationList objects 参数说明：位置列表。 数组长度：0 - 100 表6 SizeDTO 参数 是否必选 参数类型 描述 width 否 Integer 参数说明：车辆宽度，单位厘米。 最小值：0 最大值：300 length 否 Integer 参数说明：车辆长度，单位厘米。 最小值：0 最大值：3000 height 否 Integer 参数说明：车辆高度，单位厘米。 最小值：0 最大值：500 表7 TrackCameraInfo 参数 是否必选 参数类型 描述 id 否 Integer 参数说明：SNE的摄像头id,编号从0开始。 最小值：0 最大值：128 ip 否 String 参数说明：摄像头ip。 最小长度：0 最大长度：15 表8 LocationList 参数 是否必选 参数类型 描述 lon 否 Number 参数说明：经度。东经为正，西经为负，单位°，精度小数点后7位。 最小值：-180 最大值：180 lat 否 Number 参数说明：纬度。北纬为正，南纬为负，单位°，精度小数点后7位。 最小值：-90 最大值：90 speed 否 Number 参数说明：速度，单位km/h。 最小值：0 最大值：1000 accel_set 否 AccelerationSet4Way object 参数说明：定义车辆四轴加速度。 heading 否 Number 参数说明：车的航向角，正北为0度，顺时针增加。单位° 最小值：0 最大值：360 angle 否 Integer 参数说明：定义车辆转向轮角度。向右为正，向左为负。单位为1.5°，值为127时代表无效值。 最小值：-126 最大值：127 car_direction 否 Integer 参数说明：车辆方向。 取值范围： -1：未知方向 0：车头 1：车尾 最小值：-1 最大值：1 lane_no 否 Integer 参数说明：车辆所处车道。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。 最小值：-32 最大值：32 time_stamp 否 Long 参数说明：采集车辆数据的毫秒时间戳。 表9 AccelerationSet4Way 参数 是否必选 参数类型 描述 long_accel 是 Integer 参数说明：车辆纵向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 lat_accel 是 Integer 参数说明：车辆横向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 vert_accel 是 Integer 参数说明：定义Z轴方向的加速度大小，Z轴方向竖直向下，沿着Z轴方向为正。 分辨率为0.02G，G为重力加速度值9.80665m/s2。 最小值：-127 最大值：127 yaw_rate 是 Integer 参数说明：车辆横摆角速度。指汽车绕垂直轴的偏转，该偏转的大小代表汽车的稳定程度。如果偏转角速度达 到一个阈值，说明汽车发生侧滑或者甩尾等危险工况。 顺时针旋转为正，逆时针为负。 数据分辨率为0.01°/s。 最小值：-127 最大值：127

Message示例 { "name" : "testRsi", "content" : "{\"rsiSourceId\":\"string\",\"ack\":true,\"seqNum\":\"string\",\"rsiDatas\":[{\"id\":\"string\",\"timeStamp\":27344635,\"refPos\":{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},\"rtss\":[{\"rtsId\":100,\"signType\":1,\"signPosition\":{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},\"signDescription\":\"test\",\"timeDetails\":{\"startTime\":666,\"endTime\":666,\"endTimeConfidence\":10},\"signPriority\":5,\"referencePaths\":[{\"activePath\":[{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000}],\"pathRadius\":100}],\"description\":\"test\"}],\"rtes\":[{\"rteId\":100,\"eventType\":100,\"eventSource\":\"unknown\",\"eventPosition\":{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},\"eventRadius\":100,\"eventDescription\":\"test\",\"eventPriority\":5,\"referencePaths\":[{\"activePath\":[{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000}],\"pathRadius\":100}],\"eventConfidence\":100,\"duration\":100}]}]}"}

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 参数说明：消息名称。 最小长度：1 最大长度：255 content 是 RsuReceivedRsiData object 参数说明：下发的rsi消息内容。该参数值为JSON字符串 表2 RsuReceivedRsiData 参数 是否必选 参数类型 描述 rsiSourceId 否 String 参数说明：事件来源设备的唯一ID。 最小长度：1 最大长度：64 ack 否 Boolean 参数说明：是否需要确认。true需要，不带或false不需要。 seqNum 否 String 参数说明：当需要确认时必填，用于匹配响应。 最小长度：1 最大长度：32 rsiDatas 否 Array of OpenRSURSIData objects 参数说明：道路交通标志。 数组长度：1 - 16 表3 OpenRSURSIData 参数 是否必选 参数类型 描述 id 否 String 参数说明：RSU ID。 timeStamp 否 Integer 参数说明：构造消息的分钟数时间戳，数值用来表示当前年份已经过去的总分钟数（UTC时间）。527040表示无效时间戳。 最小值：0 最大值：527040 refPos 否 ReceivedPosition3D object 参数说明：位置信息。 rtss 否 Array of RSUReceivedRTSData objects 参数说明：道路交通标志。 数组长度：1 - 16 rtes 否 Array of OpenRSURTEData objects 参数说明：道路交通事件。 数组长度：1 - 8 表4 RSUReceivedRTSData 参数 是否必选 参数类型 描述 rtsId 否 Integer 参数说明：RTS的本地id。 最小值：0 最大值：255 signType 否 Integer 参数说明：道路交通标志类型，参考国标 GB 5768.2-2009。 最小值：1 最大值：520 signPosition 否 ReceivedPosition3D object 参数说明：位置信息。 signDescription 否 String 参数说明：道路交通标志的附加说明。 最小长度：1 最大长度：255 timeDetails 否 RSUReceivedRSITimeDetails object 参数说明：定义道路交通事件和道路交通标志信息的生效时间属性。 signPriority 否 Integer 参数说明：道路交通标志紧急程度。数字越大，级别越高。 最小值：0 最大值：7 referencePaths 否 Array of RSUReceivedReferencePath objects 参数说明：道路交通事件的关联路径。 数组长度：1 - 8 description 否 String 参数说明：道路交通标志的附加说明。 最小长度：1 最大长度：255 表5 RSUReceivedRSITimeDetails 参数 是否必选 参数类型 描述 startTime 否 Integer 参数说明：开始时间。数值用来表示当前年份，已经过去的总分钟数（UTC时间）。 最小值：0 最大值：527040 endTime 否 Integer 参数说明：结束时间。数值用来表示当前年份，已经过去的总分钟数（UTC时间）。 最小值：0 最大值：527040 endTimeConfidence 否 Integer 参数说明：数值描述了95%置信水平的结束时间置信度。该精度理论上只考虑了当前计时系统本身传感器的误差。参考时间精度。 最小值：0 最大值：39 表6 OpenRSURTEData 参数 是否必选 参数类型 描述 rteId 否 Integer 参数说明：道路交通事件的本地id。 最小值：0 最大值：255 eventType 否 Integer 参数说明：GB/T 29100-2012定义的事件类型。 最小值：0 最大值：65535 eventSource 否 String 参数说明：来源的具体类型。 枚举值： unknown police government meteorological internet detection v2xServer rsu obu eventPosition 否 ReceivedPosition3D object 参数说明：位置信息。 eventRadius 否 Integer 参数说明：事件半径，如果存在的话，单位分米。 最小值：0 最大值：1000 eventDescription 否 String 参数说明：道路交通事件的描述信息。 最小长度：1 最大长度：255 eventPriority 否 Integer 参数说明：道路交通事件的紧急程度。数字越大，级别越高。 最小值：0 最大值：7 referencePaths 否 Array of RSUReceivedReferencePath objects 参数说明：道路交通事件的关联路径。 数组长度：1 - 8 eventConfidence 否 Integer 参数说明：道路交通事件的信息来源提供的事件置信度水平，帮助接收端判断是否相信该事件信息，单位为0.5%。 最小值：0 最大值：200 duration 否 Integer 参数说明：事件持续时间，单位：秒。即时事件的duration=0；长期事件的duration=（事件结束时间-事件开始时间）。 最小值：0 最大值：100000 表7 ReceivedPosition3D 参数 是否必选 参数类型 描述 lat 是 Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 最小值：-90 最大值：90 lon 是 Number 参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 最小值：-180 最大值：180 ele 否 Number 参数说明：定义海拔高程，可选，单位为分米。 最小值：-4095 最大值：61439 表8 RSUReceivedReferencePath 参数 是否必选 参数类型 描述 activePath 否 Array of ReceivedPosition3D objects 参数说明：与当前情况关联的有效点集。 数组长度：1 - 8 pathRadius 否 Integer 参数说明：单位为0.1米。用半径表示影响区域边界离中心线的垂直距离，反映该区域的宽度以覆盖实际路段。 最小值：0 最大值：1000

Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "bsm_source" : { "bsm_source_type" : "rsu", "bsm_source_id" : "RSU0123456789" }, "vehicle_id" : "01234567", "time_stamp" : "2021-11-24T11:41:15.964Z", "time_confidence" : 5, "pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "pos_accuracy" : { "semi_major" : 100, "semi_minor" : 100, "orientation" : 1000 }, "pos_confidence" : { "position_confidence" : 10, "ele_confidence" : 10 }, "transmission" : 2, "speed" : 3000, "heading" : 10000, "angle" : 0, "motion_confidence" : { "speed_confidence" : 5, "heading_confidence" : 5, "steer_confidence" : 2 }, "accel_set" : { "long_accel" : 0, "lat_accel" : 0, "vert_accel" : 0, "yaw_rate" : 0 }, "brakes" : { "brake_pedal_status" : 1, "wheel_brakes_status" : { "set_status" : false, "left_front" : false, "left_rear" : false, "right_front" : false, "right_rear" : false }, "traction_status" : 1, "abs_status" : 1, "scs_status" : 1, "brake_boost_status" : 1, "aux_brakes_status" : 1 }, "vehicle_class" : { "basic_vehicle_class" : 54, "fuel_type" : 5 }, "size" : { "width" : 200, "length" : 3000, "height" : 40 } }}

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 body 是 OpenV2XBSMTopicBodyDTO object 参数说明：车辆基本安全信息。 header 是 OpenBSMTopicHeaderDTO object 参数说明：车辆基本安全信息的附加描述。 表2 OpenV2XBSMTopicBodyDTO 参数 是否必选 参数类型 描述 bsm_source 否 BSMSource object 参数说明：消息来源。 vehicle_id 是 String 参数说明：车辆自己生成的临时ID，ID值会定期变化。 最小长度：8 最大长度：8 time_stamp 是 String 参数说明：采集数据的UTC时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。 例如2021-12-18T07:20:51.683Z。 最大长度：32 time_confidence 否 Integer 参数说明：数值描述了95%置信水平的时间精度。参考 时间精度参数说明。 最小值：0 最大值：39 pos 是 Position3D object 参数说明：位置信息。 pos_accuracy 否 PositionalAccuracy object 参数说明：基于椭圆模型定义， 一个定位系统自身的精度。 pos_confidence 是 PositionalConfidence object 参数说明：定义当前实时位置（经纬度和高程）的精度大小，包括水平位置精度和高程精度， 由系统自身进行实时计算和更新。 transmission 否 Integer 参数说明：车辆档位状态。 取值范围： 0：空档 1：停止档 2：前进档 3：倒档 7：不可用 4-6：预留 最小值：0 最大值：7 speed 是 Integer 参数说明：车辆或其他交通参与者的速度大小。单位为0.02米每秒。值为8191时代表无效数值。 最小值：0 最大值：8191 heading 是 Integer 参数说明：车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 最小值：0 最大值：28800 angle 否 Integer 参数说明：定义车辆转向轮角度。向右为正，向左为负。单位为1.5°。值为127时代表无效值。 最小值：-126 最大值：127 motion_confidence 否 MotionConfidenceSet object 参数说明：描述车辆运行状态的精度。包括车速精度、航向精度和方向盘转角的精度。 accel_set 是 AccelerationSet4Way object 参数说明：定义车辆四轴加速度。 brakes 是 BrakeSystemStatus object 参数说明：定义车辆的刹车系统状态。包括7种不同类型的状态。 vehicle_class 否 VehicleClassification object 参数说明：定义车辆类型。包含车辆基本类型以及燃料动力类型。 size 是 VehicleSize object 参数说明：定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸，其中高度数值为可选项。 表3 BSMSource 参数 是否必选 参数类型 描述 bsm_source_type 是 String 参数说明：来源的具体类型。 枚举值： rsu obu detection bsm_source_id 否 String 参数说明：来源的唯一标识码ID。 最小长度：1 最大长度：255 表4 Position3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负，单位为0.0000001°即1e-7°。 最小值：-900000000 最大值：900000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位为0.0000001°，即1e-7°。 最小值：-1799999999 最大值：1800000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表5 PositionalAccuracy 参数 是否必选 参数类型 描述 semi_major 是 Integer 参数说明：定义用椭圆模型表示的GNSS系统精度中半长轴的大小，单位为0.05米。 最小值：0 最大值：255 semi_minor 是 Integer 参数说明：定义用椭圆模型表示的GNSS系统精度中半短轴的大小，单位为0.05米。 最小值：0 最大值：255 orientation 是 Integer 参数说明：定义用椭圆模型表示的GNSS系统精度中正北方向顺时针到最近半长轴的夹角大小，单位为0.0054932479°。 最小值：0 最大值：65535 表6 PositionalConfidence 参数 是否必选 参数类型 描述 position_confidence 是 Integer 参数说明：数值描述了95%置信水平的车辆位置精度。参考 位置精度参数说明。 最小值：0 最大值：15 ele_confidence 否 Integer 参数说明：数值描述了95%置信水平的车辆高程精度。参考 高程精度参数说明。 最小值：0 最大值：15 表7 MotionConfidenceSet 参数 是否必选 参数类型 描述 speed_confidence 否 Integer 参数说明：数值描述了95%置信水平的速度精度。 取值范围： 0：不可用 1：100m/s 2：10m/s 3：5m/s 4：1m/s 5：0.1m/s 6：0.05m/ 7：0.01m/s 最小值：0 最大值：7 heading_confidence 否 Integer 参数说明：数值描述了95%置信水平的航向精度。 取值范围： 0：不可用 1：10° 2：5° 3：1° 4：0.1° 5：0.05° 6：0.01° 7：0.0125° 最小值：0 最大值：7 steer_confidence 否 Integer 参数说明：数值描述了95%置信水平的车辆转向轮角度精度。 取值范围： 0：不可用 1：2° 2：1° 3：0.02° 最小值：0 最大值：3 表8 AccelerationSet4Way 参数 是否必选 参数类型 描述 long_accel 是 Integer 参数说明：车辆纵向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 lat_accel 是 Integer 参数说明：车辆横向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 vert_accel 是 Integer 参数说明：定义Z轴方向的加速度大小，Z轴方向竖直向下，沿着Z轴方向为正。 分辨率为0.02G，G为重力加速度值9.80665m/s2。 最小值：-127 最大值：127 yaw_rate 是 Integer 参数说明：车辆横摆角速度。指汽车绕垂直轴的偏转，该偏转的大小代表汽车的稳定程度。如果偏转角速度达 到一个阈值，说明汽车发生侧滑或者甩尾等危险工况。 顺时针旋转为正，逆时针为负。 数据分辨率为0.01°/s。 最小值：-127 最大值：127 表9 BrakeSystemStatus 参数 是否必选 参数类型 描述 brake_pedal_status 否 Integer 参数说明：指示刹车踏板状态，是否处在被踩下状态。 取值范围： 0：不可用 1：非踩下状态 2：踩下状态 最小值：0 最大值：2 wheel_brakes_status 否 WheelBrakesStatus object 参数说明：车辆车轮制动情况，定义四轮分别的刹车状态。 将车辆的轮胎分为左前、右前、左后、右后四组。当车辆进行刹车时，对应值分别指示了四组轮胎的刹车情况。 当车辆为单排轮胎（摩托车等）时，以左前和左后表示其前后轮。 当车辆某一组轮胎由多个组成时，其状态将等效到一个数值来表示。 traction_status 否 Integer 参数说明：牵引力控制系统实时状态。 取值范围： 0：系统未装备或不可用 1：系统处于关闭状态 2：系统处于开启状态，但未触发 3：系统被触发，处于作用状态 最小值：0 最大值：3 abs_status 否 Integer 参数说明：刹车防抱死系统（ABS）状态。 取值范围： 0：系统未装备或不可用 1：系统处于关闭状态 2：系统处于开启状态，但未触发 3：系统被触发，处于作用状态 最小值：0 最大值：3 scs_status 否 Integer 参数说明：车辆动态稳定控制系统状态。 取值范围： 0：系统未装备或不可用 1：系统处于关闭状态 2：系统处于开启状态，但未触发 3：系统被触发，处于作用状态 最小值：0 最大值：3 brake_boost_status 否 Integer 参数说明：刹车助力系统作用情况。通过刹车辅助系统的状态，指示车辆紧急刹车状态。刹车辅助系统通过判断紧急情况是否需要急刹车，从而接管刹车系统，在驾驶员未来得及做出反应时进行刹车。辅助系统可能通过监测油门踏板的突然松开或前置检测器，来判断紧急刹车的需求。 取值范围： 0：系统未装备或不可用 1：系统处于关闭状态 2：系统处于开启状态 最小值：0 最大值：2 aux_brakes_status 否 Integer 参数说明：辅助制动系统（一般指手刹）情况。 取值范围： 0：系统未装备或不可用 1：系统处于关闭状态 2：代表系统处于开启状态 3：预留 最小值：0 最大值：3 表10 WheelBrakesStatus 参数 是否必选 参数类型 描述 set_status 否 Boolean 参数说明：车辆整体车轮制动是否可用。 缺省值：false left_front 否 Boolean 参数说明：左前轮刹车是否处于激活状态。 缺省值：false left_rear 否 Boolean 参数说明：左后轮刹车是否处于激活状态。 缺省值：false right_front 否 Boolean 参数说明：右前轮刹车是否处于激活状态。 缺省值：false right_rear 否 Boolean 参数说明：右后轮刹车是否处于激活状态。 缺省值：false 表11 VehicleClassification 参数 是否必选 参数类型 描述 basic_vehicle_class 否 Integer 参数说明：定义车辆基本类型。参考 车辆基本类型参数说明。 最小值：0 最大值：255 fuel_type 否 Integer 参数说明：定义车辆的燃料动力类型，10-15暂未定义。 取值范围： 0：未知 1：汽油 2：乙醇 3：柴油 4：电动 5：混合燃料类型 6：氢气 7：液化天然气 8：压缩天然气 9：丙烷 最小值：0 最大值：15 表12 VehicleSize 参数 是否必选 参数类型 描述 width 是 Integer 参数说明：车辆车身宽度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：1023 length 是 Integer 参数说明：车辆车身长度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：4095 height 否 Integer 参数说明：车辆车身高度。单位为0.05米。值为0时代表无效数值。 最小值：0 最大值：127 表13 OpenBSMTopicHeaderDTO 参数 是否必选 参数类型 描述 instance_id 是 String 参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 event 是 String 参数说明：操作描述。" 取值范围： MODIFIED：修改 ADDED：新增 DELETED：删除 枚举值： MODIFIED ADDED DELETED

概述 西北原则指对于一段道路，选择西、北的点作为起点，先西后北。 道路走向按照西北原则选择“起点”和“终点”，整体的“起点”和“终点”确定后，道路的整体走向就确定了。从起点”到“终点”为正向，从“终点”到“起点”为逆向，匝道的走向和道路的走向相同，即： 汇入正向，则为正向； 从正向流出，为正向； 汇入逆向，则为逆向； 从逆向流出，为逆向； 如果遇到高架桥，存在匝道绕行后，从正向到逆向的情况，则需要针对这种匝道做特殊处理，数据拆分成两份，一份作为正向的流出，一份作为逆向的汇入，不影响流量预测模型的分析处理。 图1 西北原则确定起点终点示意图

Message示例 { "bsmDatas" : [ { "vehicleId" : "01234567", "plateNo" : "01234567", "timeStamp" : 1639812051683, "timeConfidence" : 5, "pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "posAccuracy" : { "semiMajor" : 100, "semiMinor" : 100, "orientation" : 1000 }, "posConfidence" : { "positionConfidence" : 10, "eleConfidence" : 10 }, "transmission" : 2, "speed" : 3000, "heading" : 10000, "angle" : 0, "motionConfidence" : { "speedConfidence" : 5, "headingConfidence" : 5, "steerConfidence" : 2 }, "accelSet" : { "longAccel" : 0, "latAccel" : 0, "vertAccel" : 0, "yawRate" : 0 }, "brakes" : { "brakePadelStatus" : 1, "wheelBrakesStatus" : { "setStatus" : false, "leftFront" : false, "leftRear" : false, "rightFront" : false, "rightRear" : false }, "tractionStatus" : 1, "absStatus" : 1, "scsStatus" : 1, "brakeBoostStatus" : 1, "auxBrakesStatus" : 1 }, "vehicleClass" : { "basicVehicleClass" : 54, "fuelType" : 5 }, "size" : { "width" : 200, "length" : 3000, "height" : 40 } } ]}

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 bsmDatas 否 Array of RSUBSMData objects 参数说明：车辆基础安全信息列表。 表2 RSUBSMData 参数 是否必选 参数类型 描述 vehicleId 否 String 参数说明：车辆临时ID。 最小长度：0 最大长度：32 plateNo 否 String 参数说明：车牌。 最小长度：0 最大长度：16 timeStamp 否 Long 参数说明：采集数据的毫秒时间戳。例如：1639812051683，转换后代表北京时间2021-12-18 15:20:51。 timeConfidence 否 Integer 参数说明：数值描述了95%置信水平的时间精度。参考时间精度。 最小值：0 最大值：39 pos 否 ReportedPosition3D object 参数说明：位置信息。 posAccuracy 否 RSUPositionalAccuracy object 参数说明：基于椭圆模型定义， 一个定位系统自身的精度。 posConfidence 否 ReportedPositionalConfidence object 参数说明：定义当前实时位置（经纬度和高程）的精度大小，包括水平位置精度和高程精度， 由系统自身进行实时计算和更新。 transmission 否 Integer 参数说明：车辆档位状态。 取值范围： 0：空档 1：停止档 2：前进档 3：倒档 7：不可用 4~6：预留 最小值：0 最大值：7 speed 否 Integer 参数说明：对应车辆被检测到超速或者慢行时的速度，单位：km/h。 最小值：0 最大值：8191 heading 否 Integer 参数说明：车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 最小值：0 最大值：28800 angle 否 Integer 参数说明：定义车辆转向轮角度。向右为正，向左为负。单位为1.5°。值为127时代表无效值。 最小值：-126 最大值：127 motionConfidence 否 ReportedMotionConfidenceSet object 参数说明：描述车辆运行状态的精度。包括车速精度、航向精度和方向盘转角的精度。 accelSet 否 ReportedAccelerationSet4Way object 参数说明：定义车辆四轴加速度。 brakes 否 RSUBrakeSystemStatus object 参数说明：定义车辆的刹车系统状态。包括7种不同类型的状态。 vehicleClass 否 ReportedVehicleClassification object 参数说明：定义车辆类型。包含车辆基本类型以及燃料动力类型。 size 否 RSUVehicleSize object 参数说明：定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸，其中高度数值为可选项。 表3 ReportedPosition3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表4 RSUPositionalAccuracy 参数 是否必选 参数类型 描述 semiMajor 否 Integer 参数说明：定义用椭圆模型表示的GNSS系统精度中半长轴的大小,单位为0.05米。 最小值：0 最大值：255 semiMinor 否 Integer 参数说明：定义用椭圆模型表示的GNSS系统精度中半短轴的大小,单位为0.05米。 最小值：0 最大值：255 orientation 否 Integer 参数说明：定义用椭圆模型表示的GNSS系统精度中正北方向顺时针到最近半长轴的夹角大小。单位为0.0054932479°。 最小值：0 最大值：65535 表5 ReportedPositionalConfidence 参数 是否必选 参数类型 描述 positionConfidence 否 Integer 参数说明：数值描述了95%置信水平的车辆位置精度。参考位置精度。 最小值：0 最大值：15 eleConfidence 否 Integer 参数说明：数值描述了95%置信水平的车辆高程精度。参考车辆高程精度。 最小值：0 最大值：15 表6 ReportedMotionConfidenceSet 参数 是否必选 参数类型 描述 speedConfidence 否 Integer 参数说明：数值描述了95%置信水平的速度精度。 取值范围： 0：不可用 1：100m/s 2：10m/s 3：5m/s 4：1m/s 5：0.1m/s 6：0.05m/s 7：0.01m/s 最小值：0 最大值：7 headingConfidence 否 Integer 参数说明：数值描述了95%置信水平的航向精度。 取值范围： 0：不可用 1：10° 2：5° 3：1° 4：0.1° 5：0.05° 6：0.01° 7：0.0125° 最小值：0 最大值：7 steerConfidence 否 Integer 参数说明：数值描述了95%置信水平的车辆转向轮角度精度。 取值范围： 0：不可用 1：2° 2：1° 3：0.02° 最小值：0 最大值：3 表7 ReportedAccelerationSet4Way 参数 是否必选 参数类型 描述 longAccel 否 Integer 参数说明：车辆纵向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 latAccel 否 Integer 参数说明：车辆横向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 vertAccel 否 Integer 参数说明：定义Z轴方向的加速度大小，Z轴方向竖直向下，沿着Z轴方向为正。 分辨率为0.02G，G 为重力加速度值 9.80665m/s2。 最小值：-127 最大值：127 yawRate 否 Integer 参数说明：车辆横摆角速度。指汽车绕垂直轴的偏转，该偏转的大小代表汽车的稳定程度。如果偏转角速度达 到一个阈值，说明汽车发生侧滑或者甩尾等危险工况。 顺时针旋转为正，逆时针为负 数据分辨率为 0.01°/s。 最小值：-127 最大值：127 表8 RSUBrakeSystemStatus 参数 是否必选 参数类型 描述 brakePadelStatus 否 Integer 参数说明：指示刹车踏板状态，是否处在被踩下状态。 取值范围： 0：不可用 1：非踩下状态 2：踩下状态 最小值：0 最大值：2 wheelBrakesStatus 否 RSUWheelBrakesStatus object 参数说明：车辆车轮制动情况，定义四轮分别的刹车状态。 将车辆的轮胎分为左前、右前、左后、右后四组。当车辆进行刹车时，对应值分别指示了四组轮胎的刹车情况。 当车辆为单排轮胎（摩托车等）时，以左前和左后表示其前后轮。 当车辆某一组轮胎由多个组成时，其状态将等效到一个数值来表示。 tractionStatus 否 Integer 参数说明：牵引力控制系统实时状态。 取值范围： 0：系统未装备或不可用 1：系统处于关闭状态 2：系统处于开启状态，但未触发 3：系统被触发，处于作用状态 最小值：0 最大值：3 absStatus 否 Integer 参数说明：刹车防抱死系统（ABS）状态。 取值范围： 0：系统未装备或不可用 1：系统处于关闭状态 2：系统处于开启状态，但未触发 3：系统被触发，处于作用状态 最小值：0 最大值：3 scsStatus 否 Integer 参数说明：车辆动态稳定控制系统状态。 取值范围： 0：系统未装备或不可用 1：系统处于关闭状态 2：系统处于开启状态，但未触发 3：系统被触发，处于作用状态 最小值：0 最大值：3 brakeBoostStatus 否 Integer 参数说明：刹车助力系统作用情况。通过刹车辅助系统的状态，指示车辆紧急刹车状态。刹车辅助系统通过判断紧急情况是否需要急刹车，从而接管刹车系统，在驾驶员未来得及做出反应时进行刹车。辅助系统可能通过监测油门踏板的突然松开或前置检测器，来判断紧急刹车的需求。 取值范围： 0：系统未装备或不可用 1：系统处于关闭状态 2：系统处于开启状态 最小值：0 最大值：2 auxBrakesStatus 否 Integer 参数说明：辅助制动系统（一般指手刹）情况。 取值范围： 0：系统未装备或不可用 1：系统处于关闭状态 2：代表系统处于开启状态 3：预留 最小值：0 最大值：3 表9 RSUWheelBrakesStatus 参数 是否必选 参数类型 描述 setStatus 否 Boolean 参数说明：车辆整体车轮制动是否可用。 缺省值：false leftFront 否 Boolean 参数说明：左前轮刹车是否处于激活状态。 缺省值：false leftRear 否 Boolean 参数说明：左后轮刹车是否处于激活状态。 缺省值：false rightFront 否 Boolean 参数说明：右前轮刹车是否处于激活状态。 缺省值：false rightRear 否 Boolean 参数说明：右后轮刹车是否处于激活状态。 缺省值：false 表10 ReportedVehicleClassification 参数 是否必选 参数类型 描述 basicVehicleClass 否 Integer 参数说明：定义车辆基本类型。参考车辆基本类型。 最小值：0 最大值：255 fuelType 否 Integer 参数说明：定义车辆的燃料动力类型，10-15暂未定义。 取值范围： 0：未知 1：汽油 2：乙醇 3：柴油 4：电动 5：混合燃料类型 6：氢气 7：液化天然气 8：压缩天然气 9：丙烷 最小值：0 最大值：15 表11 RSUVehicleSize 参数 是否必选 参数类型 描述 width 否 Integer 参数说明：车辆车身宽度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：1023 length 否 Integer 参数说明：车辆车身长度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：4095 height 否 Integer 参数说明：车辆车身高度。单位为0.05米。值为0时代表无效数值。 最小值：0 最大值：127

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]}]}]}}"}

Message示例 { "rsiSourceId" : "string", "ack" : true, "seqNum" : "string", "rsiDatas" : [ { "id" : "string", "refPos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "rtss" : [ { "rtsId" : 100, "signType" : 1, "crossId" : "cross0123456789", "signPosition" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "signDescription" : "string", "timeDetails" : { "startTime" : 666, "endTime" : 666, "endTimeConfidence" : 10 }, "signPriority" : 5, "referencePaths" : [ { "activePath" : [ { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 } ], "pathRadius" : 100 } ], "referenceLinks" : [ { "upStreamNodeId" : { "region" : 100, "id" : 100 }, "downStreamNodeId" : { "region" : 100, "id" : 100 }, "referenceLane" : { "reserve0" : false, "lane1" : false, "lane2" : false, "lane3" : false, "lane4" : false, "lane5" : false, "lane6" : false, "lane7" : false, "lane8" : false, "lane9" : false, "lane10" : false, "lane11" : false, "lane12" : false, "lane13" : false, "lane14" : false, "lane15" : false } } ] } ], "rtes" : [ { "rteId" : 100, "crossId" : "cross0123456789", "eventType" : 100, "eventSource" : "unknown", "eventPosition" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "eventRadius" : 100, "eventDescription" : "string", "timeDetails" : { "startTime" : 666, "endTime" : 666, "endTimeConfidence" : 10 }, "eventPriority" : 5, "referencePaths" : [ { "activePath" : [ { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 } ], "pathRadius" : 100 } ], "referenceLinks" : [ { "upStreamNodeId" : { "region" : 100, "id" : 100 }, "downStreamNodeId" : { "region" : 100, "id" : 100 }, "referenceLane" : { "reserve0" : false, "lane1" : false, "lane2" : false, "lane3" : false, "lane4" : false, "lane5" : false, "lane6" : false, "lane7" : false, "lane8" : false, "lane9" : false, "lane10" : false, "lane11" : false, "lane12" : false, "lane13" : false, "lane14" : false, "lane15" : false } } ], "eventConfidence" : 100 } ] } ]}

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 rsiSourceId 否 String 参数说明：事件来源设备的唯一ID。 最小长度：1 最大长度：64 ack 否 Boolean 参数说明：是否需要确认。true需要，不带或false不需要。 seqNum 否 String 参数说明：当需要确认时必填，用于匹配响应。 最小长度：1 最大长度：32 rsiDatas 否 Array of RSURSIData objects 参数说明：道路交通标志。 数组长度：1 - 16 表2 RSURSIData 参数 是否必选 参数类型 描述 id 否 String - refPos 否 ReportedPosition3D object 参数说明：位置信息。 rtss 否 Array of RSURTSData objects 参数说明：道路交通标志。 数组长度：1 - 16 rtes 否 Array of RSURTEData objects 参数说明：道路交通事件。 数组长度：1 - 8 表3 RSURTSData 参数 是否必选 参数类型 描述 rtsId 否 Integer 参数说明：RTS的本地id。 最小值：0 最大值：255 signType 否 Integer 参数说明：道路交通标志类型,参考国标 GB 5768.2-2009。 最小值：1 最大值：520 crossId 否 String 参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 最小长度：0 最大长度：64 signPosition 否 ReportedPosition3D object 参数说明：位置信息。 signDescription 否 String 参数说明：道路交通标志的附加说明。 最小长度：0 最大长度：255 timeDetails 否 RSURSITimeDetails object 参数说明：定义道路交通事件和道路交通标志信息的生效时间属性。 signPriority 否 Integer 参数说明：道路交通标志紧急程度。数字越大，级别越高。 最小值：0 最大值：7 referencePaths 否 Array of RSUReferencePath objects 参数说明：道路交通事件的关联路径。 数组长度：1 - 8 referenceLinks 否 Array of RSUReferenceLink objects 参数说明：道路交通事件的关联路段集合。 数组长度：1 - 16 表4 RSURTEData 参数 是否必选 参数类型 描述 rteId 否 Integer 参数说明：道路交通事件的本地id。 最小值：0 最大值：255 crossId 否 String 参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 最小长度：0 最大长度：64 eventType 否 Integer 参数说明：GB/T 29100-2012定义的事件类型。 最小值：0 最大值：65535 eventSource 否 String 参数说明：来源的具体类型。 枚举值： unknown police government meteorological internet detection v2xServer rsu obu eventPosition 否 ReportedPosition3D object 参数说明：位置信息。 eventRadius 否 Integer 参数说明：事件半径，单位分米。 最小值：0 最大值：1000 eventDescription 否 String 参数说明：道路交通事件的描述信息。 最小长度：0 最大长度：255 timeDetails 否 RSURSITimeDetails object 参数说明：定义道路交通事件和道路交通标志信息的生效时间属性。 eventPriority 否 Integer 参数说明：道路交通事件的紧急程度。数字越大，级别越高。 最小值：0 最大值：7 referencePaths 否 Array of RSUReferencePath objects 参数说明：道路交通事件的关联路径。 数组长度：1 - 8 referenceLinks 否 Array of RSUReferenceLink objects 参数说明：道路交通事件的关联路段集合。 数组长度：1 - 16 eventConfidence 否 Integer 参数说明：道路交通事件的信息来源提供的事件置信度水平，帮助接收端判断是否相信该事件信息，单位为0.5%。 最小值：0 最大值：200 表5 ReportedPosition3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表6 RSURSITimeDetails 参数 是否必选 参数类型 描述 startTime 否 Integer 参数说明：数值用来表示当前年份，已经过去的总分钟数（UTC时间）。 最小值：0 最大值：527040 endTime 否 Integer 参数说明：数值用来表示当前年份，已经过去的总分钟数（UTC时间）。 最小值：0 最大值：527040 endTimeConfidence 否 Integer 参数说明：数值描述了95%置信水平的结束时间置信度。该精度理论上只考虑了当前计时系统本身传感器的误差。参考时间精度。 最小值：0 最大值：39 表7 RSUReferencePath 参数 是否必选 参数类型 描述 activePath 否 Array of ReportedPosition3D objects 参数说明：与当前情况关联的有效点集。 数组长度：1 - 8 pathRadius 否 Integer 参数说明：单位为0.1米。用半径表示影响区域边界离中心线的垂直距离，反映该区域的宽度以覆盖实际路段。 最小值：0 最大值：200 表8 RSUReferenceLink 参数 是否必选 参数类型 描述 upStreamNodeId 否 RSUNodeReferenceID object 参数说明：节点ID是由一个全局唯一的地区ID和一个地区内部唯一的节点ID组成。 downStreamNodeId 否 RSUNodeReferenceID object 参数说明：节点ID是由一个全局唯一的地区ID和一个地区内部唯一的节点ID组成。 referenceLane 否 ReportedReferenceLanes object 参数说明：关联车道,将指定车道号对应的比特位置1表示该车道为有效的关联车道。最多支持15条车道。车道号，以该车道行驶方向为参考，自左向右从1开始编号。 表9 RSUNodeReferenceID 参数 是否必选 参数类型 描述 region 否 Integer 参数说明：所在区域的编号,数值0仅用于测试。 最小值：0 最大值：65535 id 否 Integer 参数说明：节点编号，路网最基本的构成即节点和节点之间连接的路段。节点可以是路口，也可以是一条 路的端点。一个节点的ID在同一个区域内是唯一的。数值 0~255 预留为测试使用。 最小值：0 最大值：65535 表10 ReportedReferenceLanes 参数 是否必选 参数类型 描述 reserve0 否 Boolean 参数说明：保留参数。 缺省值：false lane1 否 Boolean 参数说明：左侧第1车道。 缺省值：false lane2 否 Boolean 参数说明：左侧第2车道。 缺省值：false lane3 否 Boolean 参数说明：左侧第3车道。 缺省值：false lane4 否 Boolean 参数说明：左侧第4车道。 缺省值：false lane5 否 Boolean 参数说明：左侧第5车道。 缺省值：false lane6 否 Boolean 参数说明：左侧第6车道。 缺省值：false lane7 否 Boolean 参数说明：左侧第7车道。 缺省值：false lane8 否 Boolean 参数说明：左侧第8车道。 缺省值：false lane9 否 Boolean 参数说明：左侧第9车道。 缺省值：false lane10 否 Boolean 参数说明：左侧第10车道。 缺省值：false lane11 否 Boolean 参数说明：左侧第11车道。 缺省值：false lane12 否 Boolean 参数说明：左侧第12车道。 缺省值：false lane13 否 Boolean 参数说明：左侧第13车道。 缺省值：false lane14 否 Boolean 参数说明：左侧第14车道。 缺省值：false lane15 否 Boolean 参数说明：左侧第15车道。 缺省值：false

时间精度（time_confidence） 数值 含义 0 不具备或不可用 1 100 2 50 3 20 4 10 5 2 6 1 7 0.5 8 0.2 9 0.1 10 0.05 11 0.02 12 0.01 13 0.005 14 0.002 15 0.001 16 0.000,5 17 0.000,2 18 0.000,1 19 0.000,05 20 0.000,02 21 0.000,01 22 0.000,005 23 0.000,002 24 0.000,001 25 0.000,000,5 26 0.000,000,2 27 0.000,000,1 28 0.000,000,05 29 0.000,000,02 30 0.000,000,01 31 0.000,000,005 32 0.000,000,002 33 0.000,000,001 34 0.000,000,000,5 35 0.000,000,000,2 36 0.000,000,000,1 37 0.000,000,000,05 38 0.000,000,000,02 39 0.000,000,000,01 父主题： 参数说明列表

Message示例 { "map" : { "timeStamp" : 1234567890, "nodes" : [ { "name" : "Elon", "id" : { "region" : 1, "id" : 301 }, "refPos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "inLinks" : [ { "name" : "Musk", "upstreamNodeId" : { "region" : 1, "id" : 301 }, "speedLimits" : [ { "type" : "unknown", "speed" : 10 } ], "linkWidth" : 200, "points" : [ { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 } ], "movements" : [ { "remoteIntersection" : { "region" : 1, "id" : 301 }, "phaseId" : 2 } ], "lanes" : [ { "laneId" : 2, "laneWidth" : 200, "laneAttributes" : { "shareWith" : 24 }, "maneuvers" : 5, "connectsTo" : [ { "remoteIntersection" : { "region" : 1, "id" : 301 }, "connectingLane" : { "laneId" : 1, "maneuvers" : 5 }, "phaseId" : 2 } ], "speedLimits" : [ { "type" : "unknown", "speed" : 10 } ], "points" : [ { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 } ] } ] } ] } ] }, "mapSlice" : "string", "eTag" : "naviInfo_v2x_phase1_ext_1628560321993", "ack" : false, "seqNum" : "string"}

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 map 是 RSUMAPData object 参数说明：MAP数据。 mapSlice 否 String 参数说明：MAP切片。 最小长度：0 最大长度：255 eTag 否 String 参数说明：标识MAP版本。 最小长度：0 最大长度：255 ack 否 Boolean 参数说明：是否需要返回确认消息，true需要，不带或false不需要。 seqNum 否 String 参数说明：当需要确认时必填，用于匹配响应。 最小长度：0 最大长度：32 表2 RSUMAPData 参数 是否必选 参数类型 描述 timeStamp 否 Long 参数说明：采集数据的毫秒时间戳。例如：1639812051683，转换后代表北京时间2021-12-18 15:20:51。 nodes 否 Array of RSUNodeData objects 参数说明：定义地图点列表。 数组长度：0 - 100 表3 RSUNodeData 参数 是否必选 参数类型 描述 name 否 String 参数说明：节点属性名称。 最小长度：1 最大长度：100 id 是 ReportedNodeReferenceId object 参数说明：节点属性ID。 refPos 是 ReportedPosition3D object 参数说明：位置信息。 inLinks 否 Array of ReportedLink objects 参数说明：节点上下游路段集合。 数组长度：0 - 100 表4 ReportedPosition3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表5 ReportedLink 参数 是否必选 参数类型 描述 name 否 String 参数说明：名称。 最小长度：1 最大长度：100 upstreamNodeId 是 ReportedNodeReferenceId object 参数说明：节点属性ID。 speedLimits 否 Array of ReportedSpeedLimit objects 参数说明：限速集合。 数组长度：0 - 100 linkWidth 是 Integer 参数说明：车道宽度，分辨率为1cm。 最小值：0 最大值：400 points 否 Array of ReportedPosition3D objects 参数说明：点集合。 数组长度：0 - 100 movements 否 Array of ReportedMovement objects 参数说明：Movement集合。 数组长度：0 - 100 lanes 是 Array of ReportedLane objects 参数说明：Lane集合。 数组长度：0 - 100 表6 ReportedMovement 参数 是否必选 参数类型 描述 remoteIntersection 是 ReportedNodeReferenceId object 参数说明：节点属性ID。 phaseId 否 Integer 参数说明：信号灯相位ID，数值0表示无效ID。 最小值：0 最大值：100 表7 ReportedLane 参数 是否必选 参数类型 描述 laneId 是 Integer 参数说明：车道ID。 最小值：0 最大值：20 laneWidth 否 Integer 参数说明：车道宽度,分辨率1cm。 最小值：0 最大值：400 laneAttributes 否 ReportedLaneAttributes object 参数说明：定义车道属性。包括车道共享情况以及车道本身所属的类别特性。 maneuvers 否 Integer 参数说明：定义一个（机动车）车道的允许转向行为。例如：如果参数含义表示'允许直行'和'允许右转向'，那么二进制为000000000101，对应十进制为5，该参数值填写5。 二进制第x位数字为1对应的含义： 1：允许直行 2：允许左转向 3：允许右转向 4：允许掉头转向 5：红灯情况下允许左转向 6：红灯情况下允许右转向 7：允许变道 8：不允许停车 9：非保护车道状态，如永久黄灯状态 10：停车，再前行 11：小心前行 12：保留数值 最小值：0 最大值：4096 connectsTo 否 Array of ReportedConnection objects 参数说明：车道与下游路段车道的连接关系列表。 数组长度：0 - 100 speedLimits 否 Array of ReportedSpeedLimit objects 参数说明：限速列表。 数组长度：0 - 100 points 否 Array of ReportedPosition3D objects 参数说明：车道中间点列表。 数组长度：0 - 1000 表8 ReportedLaneAttributes 参数 是否必选 参数类型 描述 shareWith 否 Integer 参数说明：定义车道被共享的情况。在已有的车道属性定义基础上，该数据表示此车道还会有其他的交通参与者出现，并可能拥有相同的路权。例如：如果参数含义表示'个人机动车共享'和'公交车共享'，那么二进制为0000011000，对应十进制为24，该参数值填写24。 二进制第x位数字为1对应的含义： 1：当存在其他车道时，描述重叠共享车道的路径。不适用简单交叉车道。 2：当车道对象的路径和宽度细节表示多个车道的情况下，使用该参数判断是否为多个车道。各种模式和交通类型都可以共享该车道。 3：其他非机动车类型的共享车道情况。 4：个人机动车共享车道情况。 5：公交车共享车道情况。 6：出租车共享车道情况。 7：人群共享车道情况。 8：自行车共享车道情况。 9：履带车共享车道情况。 10：行人共享车道情况。 最小值：0 最大值：1024 表9 ReportedConnection 参数 是否必选 参数类型 描述 remoteIntersection 是 ReportedNodeReferenceId object 参数说明：节点属性ID。 connectingLane 否 ReportedConnectingLane object 参数说明：用于定位上游车道转向连接的下游车道。包括下游车道 ID 以及该转向的允许行驶行为下游车道 ID 的作用范围是该车道所在的路段。 phaseId 否 Integer 参数说明：定义信号灯相位ID。数值0表示无效。 最小值：0 最大值：100 表10 ReportedNodeReferenceId 参数 是否必选 参数类型 描述 region 否 Integer 参数说明：所在区域在地图中的编号，数值0仅用于测试。 最小值：0 最大值：65535 id 否 Integer 参数说明：节点编号。路网最基本的构成即节点和节点之间连接的路段。节点可以是路口，也可以是一条 路的端点。一个节点的ID在同一个区域内是唯一的。 数值0~255预留为测试使用。 最小值：0 最大值：65535 表11 ReportedConnectingLane 参数 是否必选 参数类型 描述 laneId 是 Integer 参数说明：车道定义在每一条有向路段上，同一条有向路段上的每个车道，都拥有一个单独的ID。车道号以该车道行驶方向为参考，自左向右从1开始编号。 最小值：1 最大值：255 maneuvers 否 Integer 参数说明：定义一个（机动车）车道的允许转向行为。例如：如果参数含义表示'允许直行'和'允许右转向'，那么二进制为000000000101，对应十进制为5，该参数值填写5。 二进制第x位数字为1对应的含义： 1：允许直行 2：允许左转向 3：允许右转向 4：允许掉头转向 5：红灯情况下允许左转向 6：红灯情况下允许右转向 7：允许变道 8：不允许停车 9：非保护车道状态，如永久黄灯状态 10：停车，再前行 11：小心前行 12：保留数值 最小值：0 最大值：4096 表12 ReportedSpeedLimit 参数 是否必选 参数类型 描述 type 是 String 参数说明：限速类型。 最小长度：1 最大长度：100 speed 是 Integer 参数说明：限速大小，分辨率为0.02m/s。数值8191表示无效数值。 最小值：0 最大值：10000

Message示例 { "name": "testpat", "content": "{\"intersections\":[{\"intersection_id\":{\"region\":12,\"node_id\":11},\"status\":{\"manual_control_is_enabled\":true,\"stop_time_is_activated\":true,\"preempt_is_active\":true,\"signal_priority_is_active\":true,\"traffic_dependent_operation\":true,\"standby_operation\":true,\"recent_map_message_update\":true,\"recent_change_in_map_assigned_lanes_ids_used\":true,\"no_valid_map_is_available_at_this_time\":true,\"no_valid_spat_is_available_at_this_time\":true},\"time_stamp\":\"1970-01-08T22:05:13.553Z\",\"time_confidence\":1,\"phases\":[{\"phase_id\":123,\"phase_states\":[{\"light_state\":1,\"timing\":{\"utc_timing\":{\"start_utc_time\":{\"time_mark\":0},\"min_end_utc_time\":{\"time_mark\":0},\"max_end_utc_time\":{\"time_mark\":0},\"likely_end_utc_time\":{\"time_mark\":0},\"next_start_utc_time\":{\"time_mark\":0},\"next_end_utc_time\":{\"time_mark\":0}},\"start_time\":0,\"likely_end_time\":123}}]}]}],\"time_stamp\":\"2021-12-18T07:20:51.683Z\",\"name\":\"name\"}"}

请求示例 PUT https://{endpoint}/v1/{project_id}/traffic-controllers/{traffic_controller_id}Content-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road2", "link_id" : "12345678"}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 traffic_controller_id String 参数说明：信号机设备ID，全局唯一。 esn String 参数说明：序列号。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 name String 参数说明：名称。 description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 lon Number 参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 ele Number 参数说明：定义海拔高程，可选，单位为分米。 pos_description String 参数说明：位置说明。 取值范围：长度不超过128，只允许字母、数字、以及_等字符的组合。 installation_mode String 参数说明：架设方式。 取值范围： columnar：柱式 road-side-attach：路侧附着式 cantilever：悬臂式 gantry：门架式 lane-above-attach：车行道上方附着式 road_name String 参数说明：所属道路名称，比如高速名称。 取值范围：长度不超过64，只允许汉字、字母、数字、以及_-等字符的组合。 link_id String 参数说明：信号机设备所属路段ID。 取值范围：长度等于30，只允许大写字母、数字。 status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 last_modified_time String 参数说明：最后修改的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_time String 参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

响应示例 状态码： 200 OK { "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road2", "link_id" : "12345678", "status" : "INITIAL", "last_modified_time" : "2022-01-06T09:30:24Z", "created_time" : "2022-01-06T09:30:24Z", "last_online_time" : null}

Message示例 { "intersections" : [ { "intersectionId" : { "region" : 1, "id" : 301 }, "status" : 6, "timeStamp" : 1639812051683, "timeConfidence" : 5, "phases" : [ { "phaseId" : 11, "phaseStates" : [ { "light" : "3", "timing" : { "counting" : { "startTime" : { "timeMark" : 0 }, "minEndTime" : { "timeMark" : 0 }, "maxEndTime" : { "timeMark" : 0 }, "likelyEndTime" : { "timeMark" : 0 }, "timeConfidence" : 180, "nextStartTime" : { "timeMark" : 0 }, "nextDuration" : { "timeMark" : 0 } }, "utcTiming" : { "startUtcTime" : { "timeMark" : 0 }, "minEndUtcTime" : { "timeMark" : 0 }, "maxEndUtcTime" : { "timeMark" : 0 }, "likelyEndUtcTime" : { "timeMark" : 0 }, "timeConfidence" : 180, "nextStartUtcTime" : { "timeMark" : 0 }, "nextEndUtcTime" : { "timeMark" : 0 } }, "startTime" : 1234567890, "likelyEndTime" : 1234567890 } } ] } ] } ], "name" : "12345"}

车辆基本类型（basic_vehicle_class） 表1 车辆基本类型（basic_vehicle_class） 数值 含义 0 未知类型或不可用 1 特殊类型车辆 10 通用类型的乘用车 11 其他类型的乘用车 20 通用类型的轻型货车 21 其他类型的轻型货车 25 通用类型的卡车 26 其他类型的卡车 27 单机组2轴6轮卡车 28 单机组3轴卡车 29 单机组4轴（或多余4轴）卡车 30 4轴（或少于4轴）单挂拖车 31 5轴（或少于5轴）单挂拖车 32 6轴（或多于6轴）单挂拖车 33 5轴（或少于5轴）多挂拖车 34 6轴多挂拖车 35 7轴（或多于7轴）多挂拖车 40 通用类型的摩托车 41 其他类型的摩托车 42 标准巡航车 43 无涂层运动摩托车 44 运动旅行摩托车 45 超级运动摩托车 46 旅行摩托车 47 三轮摩托车 48 载客摩托车 50 通用类型的客车 51 其他类型的客车 52 快速公交（BRT） 53 快递运输货车 54 公交巴士 55 校车 56 有轨列车 57 辅助公交 58 辅助救援车辆 60 通用类型的紧急车辆 61 其他类型的紧急车辆 62 消防轻型车辆 63 消防重型车辆 64 消防辅助救护车辆 65 消防救护车 66 警用轻型车辆 67 警用重型车辆 68 其他紧急情况响应车辆 69 其他紧急情况救护车 80 未知交通参与者 81 其他交通参与者 82 行人 83 视力障碍人士 84 身体残障人士 85 自行车 86 道路施工人员 90 未知类型的基础设施 91 固定的基础设施 92 可移动的基础设施 93 配备货物拖车 父主题： 参数说明列表

设备连接鉴权 接口说明 设备鉴权通过后建立设备与平台间的MQTT连接。 参数说明 参数 必选/可选 类型 参数描述 ClientId 必选 String(256) clientId由4个部分组成：设备编码（esn）、设备身份标识类型、密码签名类型、时间戳，通过下划线“_”分隔。 设备编码：在平台创建RSU时填写的esn。 设备身份标识类型：固定值为0，表示设备编码（esn）。 密码签名类型：长度1字节，当前仅支持“0”，代表HMA CS HA256不校验时间戳。 时间戳：为设备连接平台时的UTC时间，格式为YYYYMMDDHH，如UTC 时间2018/7/24 17:56:20 则应表示为2018072417。 Username 必选 String(256) 设备编码（esn） Password 必选 String(256) 加密后的设备密钥。设备密钥为创建RSU时填写的secret。 1. 可访问参数生成工具，填写DeviceId（设备编码）和DeviceSecret（设备密钥），生成设备连接鉴权所需的参数（ClientId、Username、Password）。 2. 可使用MQTT.fx 工具模拟RSU设备建链。 原生MQTT协议接入建链返回码 原生MQTT协议设备和平台建链时，常见返回码如下： 返回码 返回码描述 原因 0x00 连接成功 连接成功 0x01 请求拒绝，协议版本错误 服务器不支持客户端请求MQTT协议版本 0x02 请求拒绝，无效的客户端标识符 clientId不符合格式要求或者心跳时间间隔不满足平台要求 0x03 请求拒绝，服务器不可用 平台服务不可用 0x04 请求拒绝，用户名或密码错误 用户名或密码错误 0x05 请求拒绝，没有授权 客户端没有权限连接 父主题： 设备侧MQTT接口参考