华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Instance-Id 否 String 参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和连接符（-）的组合，长度36。 X-Auth-Token 否 String 参数说明：用户Token，Token认证鉴权时必选。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度：1 最大长度：20000

URI DELETE /v1/{project_id}/v2x-edges/{v2x_edge_id}/apps/{edge_app_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID。获取方法请参见 获取项目ID。 取值范围：仅支持数字，a到f的小写字母组合，长度32。 edge_app_id 是 String 参数说明：用户自定义应用唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）、美元符号（$）的组合。 最小长度：1 最大长度：32 v2x_edge_id 是 String 参数说明：Edge ID，用于唯一标识一个Edge，创建Edge后获得。方法参见 创建Edge。 最大长度：255

请求示例 POST https://{endpoint}/v1/{project_id}/v2x-edges/{v2x_edge_id}/data-channelContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "platform_type" : "DRIS", "platform_para" : { "address" : "127.0.0.1:8080", "username" : "username", "passwd" : "password" }}

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 platform_type String 参数说明：平台类型。 取值范围： DRIS：华为路网数字化平台 LITONG：利通 ZHONGQIYAN：中汽研 platform_para PlatformPara object 参数说明：platform_type为非DRIS时有效，表示第三方平台的对接参数 channel_status String 参数说明：华为路网数字化平台或第三方业务平台连接状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 表6 PlatformPara 参数 参数类型 描述 address String 参数说明：第三方业务平台的ip地址和端口。 username String 参数说明：鉴权用户名。 最小长度：0 最大长度：255 passwd String 参数说明：鉴权密码，ITS800或者ATLAS500的密码 最小长度：0 最大长度：255

Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "spat_source" : { "spat_source_type" : "rsu", "spat_source_id" : "RSU0123456789" }, "intersections" : [ { "intersection_id" : { "region" : 1, "node_id" : 301 }, "intersection_status_object" : { "manual_control_is_enabled" : true, "stop_time_is_activated" : false, "failure_flash" : false, "preempt_is_active" : false, "signal_priority_is_active" : false, "fixed_time_operation" : false, "traffic_dependent_operation" : false, "standby_operation" : false, "failure_mode" : false, "controller_off" : false, "recent_map_message_update" : false, "recent_change_in_map_assigned_lanes_ids_used" : false, "no_valid_map_is_available_at_this_time" : false, "no_valid_spat_is_available_at_this_time" : false }, "time_stamp" : "2015-12-12T12:12:12.126Z", "time_confidence" : 5, "phases" : 5 } ], "time_stamp" : "2015-12-12T12:12:12.126Z", "name" : "12345" }}

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

URI DELETE /v1/{project_id}/v2x-edges/{v2x_edge_id}/data-channel 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID。获取方法请参见 获取项目ID。 取值范围：仅支持数字，a到f的小写字母组合，长度32。 v2x_edge_id 是 String 参数说明：Edge ID，用于唯一标识一个Edge。 最小长度：1 最大长度：255

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Instance-Id 否 String 参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 X-Auth-Token 否 String 参数说明：用户Token，Token认证鉴权时必选。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度：1 最大长度：20000

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 platform_type String 参数说明：平台类型。 取值范围： DRIS：华为路网数字化平台 LITONG：利通 ZHONGQIYAN：中汽研 platform_para PlatformPara object 参数说明：platform_type为非DRIS时有效，表示第三方平台的对接参数 channel_status String 参数说明：华为路网数字化平台或第三方业务平台连接状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 表4 PlatformPara 参数 参数类型 描述 address String 参数说明：第三方业务平台的ip地址和端口。 username String 参数说明：鉴权用户名。 最小长度：0 最大长度：255 passwd String 参数说明：鉴权密码，ITS800或者ATLAS500的密码 最小长度：0 最大长度：255

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Instance-Id 否 String 参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 X-Auth-Token 否 String 参数说明：用户Token，Token认证鉴权时必选。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度：1 最大长度：20000

请求示例 PUT https://{endpoint}/v1/{project_id}/v2x-edges/{v2x_edge_id}/data-channelContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "platform_type" : "DRIS", "platform_para" : { "address" : "127.0.0.1:8080", "username" : "username", "passwd" : "password1" }}

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 platform_type String 参数说明：平台类型。 取值范围： DRIS：华为路网数字化平台 LITONG：利通 ZHONGQIYAN：中汽研 platform_para PlatformPara object 参数说明：platform_type为非DRIS时有效，表示第三方平台的对接参数 channel_status String 参数说明：华为路网数字化平台或第三方业务平台连接状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 表6 PlatformPara 参数 参数类型 描述 address String 参数说明：第三方业务平台的ip地址和端口。 username String 参数说明：鉴权用户名。 最小长度：0 最大长度：255 passwd String 参数说明：鉴权密码，ITS800或者ATLAS500的密码 最小长度：0 最大长度：255

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 否 RSMSource 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" : { "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

请求示例 POST https://{endpoint}/v1/{project_id}/spat/sendContent-Type:application/jsonX-Auth-Token:********Instance-Id:********{ "rsu_id" : "834bdeb2-66cf-4c44-badf-74764a93eab1", "spat_content" : { "name" : "spat", "intersections" : [ { "intersection_id" : { "region" : 1, "id" : 15 }, "status" : 0, "phases" : [ { "phase_id" : 1, "phase_states" : [ { "light" : 1, "timing" : { "counting" : { "start_time" : { "time_mark" : 0 }, "min_end_time" : { "time_mark" : 1500 }, "max_end_time" : { "time_mark" : 1540 }, "likely_end_time" : { "time_mark" : 1500 }, "time_confidence" : 180, "next_start_time" : { "time_mark" : 6000 }, "next_duration" : { "time_mark" : 150 } }, "start_time" : 0, "likely_end_time" : 255 } } ] }, { "phase_id" : 2, "phase_states" : [ { "light" : 1, "timing" : { "counting" : { "start_time" : { "time_mark" : 0 }, "min_end_time" : { "time_mark" : 1500 }, "max_end_time" : { "time_mark" : 1540 }, "likely_end_time" : { "time_mark" : 1500 }, "time_confidence" : 180, "next_start_time" : { "time_mark" : 6000 }, "next_duration" : { "time_mark" : 150 } }, "start_time" : 0, "likely_end_time" : 255 } } ] } ] } ] }}

Message示例 { "name" : "test001", "id" : "12", "content" : { "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" }}

时间精度（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 父主题： 参数说明列表

车辆基本类型（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”，代表HMACSHA256不校验时间戳。 时间戳：为设备连接平台时的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接口参考

Message示例 { "body" : { "name" : "spatName", "content" : { "name" : "name", "time_stamp" : "2021-12-18T07:20:51.683Z", "intersections" : [ { "intersection_id" : { "region" : 12, "node_id" : 11 }, "intersection_status_object" : { "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" : 684313553, "time_confidence" : 1, "phases" : [ { "phase_id" : 123, "phase_states" : [ { "light_state" : 423, "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 } } ] } ] } ] } }}

机动车车辆类型（gat_vehicle_class） 机动车车辆类型代码 含义 K10 大型客车 K11 大型普通客车 K12 大型双层客车 K13 大型卧铺客车 K14 大型铰接客车 K15 大型越野客车 K16 大型轿车 K17 大型专用客车 K20 中型客车 K21 中型普通客车 K22 中型双层客车 K23 中型卧铺客车 K24 中型铰接客车 K25 中型越野客车 K27 中型专用客车 K30 小型客车 K31 小型普通客车 K32 小型越野客车 K33 小型轿车 K34 小型专用客车 K40 微型客车 K41 微型普通客车 K42 微型越野客车 K43 微型轿车 H10 重型货车 H11 重型普通货车 H12 重型厢式货车 H13 重型封闭货车 H14 重型罐式货车 H15 重型平板货车 H16 重型集装厢车 H17 重型自卸货车 H18 重型特殊结构货车 H19 重型仓栅式货车 H20 中型货车 H21 中型普通货车 H22 中型厢式货车 H23 中型封闭货车 H24 中型罐式货车 H25 中型平板货车 H26 中型集装厢车 H27 中型自卸货车 H28 中型特殊结构货车 H29 中型仓栅式货车 H30 轻型货车 H31 轻型普通货车 H32 轻型厢式货车 H33 轻型封闭货车 H34 轻型罐式货车 H35 轻型平板货车 H37 轻型自卸货车 H38 轻型特殊结构货车 H39 轻型仓栅式货车 H40 微型货车 H41 微型普通货车 H42 微型厢式货车 H43 微型封闭货车 H44 微型罐式货车 H45 微型自卸货车 H46 微型特殊结构货车 H47 微型仓栅式货车 H50 低速货车 H51 普通低速货车 H52 厢式低速货车 H53 罐式低速货车 H54 自卸低速货车 H55 仓栅式低速货车 Q10 重型牵引车 Q11 重型半挂牵引车 Q12 重型全挂牵引车 Q20 中型牵引车 Q21 中型半挂牵引车 Q22 中型全挂牵引车 Q30 轻型牵引车 Q31 轻型半挂牵引车 Q32 轻型全挂牵引车 Z11 大型专项作业车 Z21 中型专项作业车 Z31 小型专项作业车 Z41 微型专项作业车 Z51 重型专项作业车 Z71 轻型专项作业车 D11 无轨电车 D12 有轨电车 M10 三轮摩托车 M11 普通正三轮摩托车 M12 轻便正三轮摩托车 M13 正三轮载客摩托车 M14 正三轮载货摩托车 M15 侧三轮摩托车 M20 二轮摩托车 M21 普通二轮摩托车 M22 轻便二轮摩托车 N11 三轮汽车 T11 大型轮式拖拉机 T20 小型拖拉机 T21 小型轮式拖拉机 T22 手扶拖拉机 T23 手扶变形运输机 J11 轮式装载机械 J12 轮式挖掘机械 J13 轮式平底机械 G10 重型全挂车 G11 重型普通全挂车 G12 重型厢式全挂车 G13 重型罐式全挂车 G14 重型平板全挂车 G15 重型集装箱全挂车 G16 重型自卸全挂车 G17 重型仓栅式全挂车 G18 重型旅居全挂车 G19 重型专项作业全挂车 G20 中型全挂车 G21 中型普通全挂车 G22 中型厢式全挂车 G23 中型罐式全挂车 G24 中型平板全挂车 G25 中型集装箱全挂车 G26 中型自卸全挂车 G27 中型仓栅式全挂车 G28 中型旅居全挂车 G29 中型专项作业全挂车 G30 轻型全挂车 G31 轻型普通全挂车 G32 轻型厢式全挂车 G33 轻型罐式全挂车 G34 轻型平板全挂车 G35 轻型自卸全挂车 G36 轻型仓栅式全挂车 G37 轻型旅居全挂车 G38 轻型专项作业全挂车 B10 重型半挂车 B11 重型普通半挂车 B12 重型厢式半挂车 B13 重型罐式半挂车 B14 重型平板半挂车 B15 重型集装箱半挂车 B16 重型自卸半挂车 B17 重型特殊结构半挂车 B18 重型仓栅式半挂车 B19 重型旅居半挂车 B1A 重型专项作业半挂车 B1B 重型低平板半挂车 B20 中型半挂车 B21 中型普通半挂车 B22 中型厢式半挂车 B23 中型罐式半挂车 B24 中型平板半挂车 B25 中型集装箱半挂车 B26 中型自卸半挂车 B27 中型特殊结构半挂车 B28 中型仓栅式半挂车 B29 中型旅居半挂车 B2A 中型专项作业半挂车 B2B 中型低平板半挂车 B30 轻型半挂车 B31 轻型普通半挂车 B32 轻型厢式半挂车 B33 轻型罐式半挂车 B34 轻型平板半挂车 B35 轻型自卸半挂车 B36 轻型仓栅式半挂车 B37 轻型旅居半挂车 B38 轻型专项作业半挂车 B39 轻型低平板半挂车 X99 其他 机动车车辆类型定义参考GA/T 16.4-2012 《道路交通管理信息代码第4部分：机动车车辆类型代码》标准要求。 父主题： 参数说明列表

请求示例 GET https://{endpoint}/v1/{project_id}/traffic-controllers?limit={limit}&offset={offset}&status={status}&esn={esn}&traffic_controller_id={traffic_controller_id}Content-Type:application/jsonX-Auth-Token:********Instance-Id:********"

响应示例 状态码： 200 OK { "count" : 1, "traffic_controller_devices" : [ { "traffic_controller_id" : "13229397084005974033576909202199", "esn" : "17598448011929637214623971962555", "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road1", "link_id" : "12345676", "status" : "INITIAL", "last_modified_time" : "2022-01-06T09:30:24Z", "created_time" : "2022-01-06T09:30:24Z", "last_online_time" : null } ]}

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：条件查询返回的总条数。 最小值：0 最大值：2147483647 statistics Array of OpenV2XStatisticsBody objects 参数说明：车辆流量，平均速度等统计信息列表 表5 OpenV2XStatisticsBody 参数 参数类型 描述 source StatisticsSourceDTO object 参数说明：消息来源。 time String 参数说明：数据上报的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z'。 例如：2021-01-08T02:03:41Z。 period Integer 参数说明：统计周期，单位秒。 最小值：0 最大值：100000000 direction Number 参数说明：道路路的角度，区分道路方向，向东为0度，逆时针增加。 最小值：0 最大值：360 flow Integer 参数说明：统计周期内的车辆数。 最小值：0 最大值：100000000 average_speed Number 参数说明：车辆平均速度，单位km/h。 最小值：0 最大值：1000 esn String 参数说明：设备编码。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 cross_id String 参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 最小长度：0 最大长度：64 traffic_direction Integer 参数说明：路段的交通流方向，交通流方向按照“西北规则”进行定义，即尽量选择西北的点作为正向起点，先西后北。西北规则具体说明请参见 “西北规则”说明。 0：正向 1：逆向 2：正向转逆向的连接线 3：逆向转正向的连接线 9：为方向未确定 最小值：0 最大值：10 road_kind Integer 参数说明：道路特征，0为主路，1为汇入匝道，2为汇出匝道，3为辅道 最小值：0 最大值：10 vehicle_class_flow Array of ModelFlow objects 参数说明：不同车辆类型的流量统计。 occupancy Array of LaneOccupancy objects 参数说明：分车道统计的占有率列表。 表6 StatisticsSourceDTO 参数 参数类型 描述 source_type String 参数说明：信息来源的具体类型描述。 枚举值： rsu obu detection source_id String 参数说明：信息来源的唯一标识码ID。 最小长度：1 最大长度：255 表7 ModelFlow 参数 参数类型 描述 vehicle_class Integer 参数说明：车辆类型。参考车辆基本类型。 最小值：0 最大值：2000 flow Integer 参数说明：统计周期内的车辆数。 最小值：0 最大值：100000000 average_speed Number 参数说明：车辆平均速度，单位km/h。 最小值：0 最大值：1000 表8 LaneOccupancy 参数 参数类型 描述 lane_id Integer 参数说明：车道编号。车道从左到右，从0开始编号 最小值：0 最大值：8 space_occupancy Double 参数说明：车道的空间占有率。 最小值：0 最大值：1 time_occupancy Double 参数说明：车道的时间占有率。 最小值：0 最大值：1

请求示例 GET https://{endpoint}/v1/{project_id}/edge-flow?limit={limit}&offset={offset}&from_date={from_date}&to_date={to_date}&edge_id={edge_id}Content-Type:application/jsonX-Auth-Token:********Instance-Id:********

响应示例 状态码： 200 OK { "count" : 1, "statistics" : [ { "source" : { "source_type" : "detection", "source_id" : "EDGE0123456789" }, "time" : "2022-09-01T13:10:21Z", "period" : 300, "direction" : 180.5, "flow" : 50, "average_speed" : 70.8, "esn" : "2102312ETX10K7000037", "cross_id" : "cross0123456789", "traffic_direction" : 0, "road_kind" : 10, "vehicle_class_flow" : [ { "vehicle_class" : 10, "flow" : 50, "average_speed" : 70.8 } ], "occupancy" : [ { "lane_id" : 1, "space_occupancy" : 1, "time_occupancy" : 1 } ] } ]}

URI DELETE /v1/{project_id}/traffic-controllers/{traffic_controller_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID。获取方法请参见 获取项目ID。 取值范围：仅支持数字，a到f的小写字母组合，长度32。 traffic_controller_id 是 String traffic_controller_id 最小长度：1 最大长度：128

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Instance-Id 否 String 参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 X-Auth-Token 否 String 参数说明：用户Token，Token认证鉴权时必选。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度：1 最大长度：20000