华为云用户手册

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参数 表1 请求Body参数 参数 是否必选 参数类型 描述 rsms 否 Array of RSURSMData objects 参数说明：路侧动态目标物消息列表。 表2 RSURSMData 参数 是否必选 参数类型 描述 refPos 否 ReportedPosition3D object 参数说明：位置信息。 participants 否 Array of RSUParticipantData objects 参数说明：交通参与者列表。应用于RSM消息，表示当前探测到的所有或者部分交通参与者信息。 数组长度：1 - 16 表3 RSUParticipantData 参数 是否必选 参数类型 描述 ptcType 否 String 参数说明：路侧单元检测到的交通参与者类型。 取值范围： "0"：未知类型 "1"：机动车 "2"：非机动车 "3"：行人 "4"： RSU设备 ptcId 否 Integer 参数说明：检测单元设置的临时ID。 最小值：0 最大值：65535 global_track_id 否 Long 参数说明：感知设备生成的唯一车辆id。 最小值：0 最大值：9223372036854775807 source 否 Integer 参数说明：定义交通参与者数据的来源。 取值范围： 0：unknown（未知数据源类型） 1：rsu（RSU自身信息） 2：v2x（参与者自身的v2x广播消息） 3：video（视频传感器） 4：microwaveRadar（微波雷达传感器） 5：loop（地磁线圈传感器） 6：lidar（激光雷达传感器） 7：integrated（类或以上感知数据的融合结果） 最小值：0 最大值：7 secMark 否 Integer 参数说明：以0.1 秒为单位，定义1分钟中的毫秒级时刻。分辨率为1毫秒，有效范围是0~59999。 60000及以上表示未知或无效数值。 最小值：0 最大值：65535 pos 否 ReportedPosition3D object 参数说明：位置信息。 speed 否 Integer 参数说明：车辆或其他交通参与者的速度大小。单位为0.02米每秒。值为8191时代表无效数值。 最小值：0 最大值：8191 heading 否 Integer 参数说明：车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 最小值：0 最大值：28800 size 否 ReportedVehicleSize object 参数说明：定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸，其中高度数值为可选项。 表4 ReportedPosition3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表5 ReportedVehicleSize 参数 是否必选 参数类型 描述 width 否 Integer 参数说明：车辆车身宽度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：1023 length 否 Integer 参数说明：车辆车身长度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：4095 height 否 Integer 参数说明：车辆车身高度。单位为0.05米。值为0时代表无效数值。 最小值：0 最大值：127

Message示例 { "rsms" : [ { "refPos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "participants" : [ { "ptcType" : "4", "ptcId" : 3, "global_track_id" : 123, "source" : 1, "secMark" : 0, "pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "speed" : 3000, "heading" : 10000, "size" : { "width" : 200, "length" : 3000, "height" : 40 } } ] } ] }

请求示例 POST https://{endpoint}/v1/{project_id}/spat/send Content-Type:application/json X-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 } } ] } ] } ] } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 v2x_edge_id String 参数说明：Edge ID，用于唯一标识一个Edge。 最小长度：0 最大长度：255 name String 参数说明：名称。 取值范围：长度不超过128，只允许中文、字母、数字、以及_.-等字符的组合。 最大长度：128 description String 参数说明：Edge描述。 最小长度：0 最大长度：255 esn String 参数说明：设备编码，全局唯一。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 ip String 参数说明：网络I，例如127.0.0.1。 port Integer ITS800,ATLAS 端口号 最小值：0 最大值：65535 hardware_type String 参数说明：硬件类型。 取值范围：ITS800 或者 ATLAS。 server_protocol_type String 参数说明：v2xedge作为服务端的协议类型。 取值范围：http 或者 https 缺省值：http server_cert String 参数说明：v2xedge作为服务端，pem格式的证书。 最小长度：0 最大长度：4096 position_description String 参数说明：安装位置编码，由用户自定义。 取值范围：长度不低于1不超过128，只允许字母、数字、下划线（_）的组合。 location Location object 参数说明：经纬度坐标。 cameras Array of CameraIdAndStatus objects 参数说明：Edge关联的摄像头列表。 数组长度：0 - 2147483647 radars Array of RadarIdAndStatus objects 参数说明：Edge关联的雷达列表。 数组长度：0 - 2147483647 local_rsus Array of RsuIdAndStatus objects 参数说明：Edge关联的本地RSU列表。 数组长度：0 - 32 local_segment_rsus Array of LocalSegmentRsu objects 参数说明：Edge管理的分段所关联的本地RSU列表。 数组长度：0 - 32 edge_general_config EdgeGeneralConfigInResponse object 参数说明：Edge通用配置。 edge_advance_config Object 参数说明：Edge高级配置，Json格式 最大长度：4096 status String 参数说明：状态。 取值范围： UNINSTALLED： 待部署 INSTALLED：部署中 OFFLINE：离线 ONLINE：在线： UPGRADING：升级中 DELETING：删除中 channel_status String 参数说明：业务通道状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 node_id String 参数说明：边缘管理服务返回的node_id，用于关联EdgeManager的资源。 最小长度：0 最大长度：255 created_time String 参数说明：创建时间。 格式：yyyy-MM-dd''T''HH:mm:ss''Z''。 例如 2020-09-01T01:37:01Z。 last_modified_time String 参数说明：创建时间。 格式：yyyy-MM-dd''T''HH:mm:ss''Z''。 例如 2020-09-01T01:37:01Z。 表4 Location 参数 参数类型 描述 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 最小值：-90 最大值：90 lon Number 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-180 最大值：180 表5 CameraIdAndStatus 参数 参数类型 描述 id String 参数说明：摄像头的ID。 最小长度：0 最大长度：255 status String 参数说明：摄像头的状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 表6 RadarIdAndStatus 参数 参数类型 描述 id String 参数说明：雷达的esn。 最小长度：0 最大长度：255 status String 参数说明：雷达的状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 表7 RsuIdAndStatus 参数 参数类型 描述 id String 参数说明：RSU的esn。 最小长度：0 最大长度：255 status String 参数说明：RSU的状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 表8 LocalSegmentRsu 参数 参数类型 描述 segment_id String 参数说明：分段Id，填写雷达设备对应序号（sequence_no）。 取值范围：数字字符串。 最小长度：1 最大长度：4 rsu_esn String 参数说明：RSU的设备序列号。 取值范围：只允许长度不小于1、最大为64，字母、数字、下划线（_）的组合。 最小长度：1 最大长度：64 表9 EdgeGeneralConfigInResponse 参数 参数类型 描述 avp_enabled Boolean 参数说明：AVP场景。 rsm_enabled Boolean 参数说明：RSM上报：默认不上报。 time_compensate Boolean 参数说明：时延补偿：是否启动Edge时延补偿功能。 rsi_positioning_enabled Boolean 参数说明：RSI事件定位功能。 log_level String 参数说明：应用日志级别 取值范围：on/off，默认关闭。 缺省值：off road_detection_length Double 参数说明：道路检测长度，单位：米。 最小值：1 最大值：1000 ramp_detection_length Double 参数说明：匝道检测长度，单位：米。 最小值：1 最大值：1000 gat1400_username String 参数说明：1400接口用户名。 取值范围：长度不小于8，不大于32，只允许数字字母下划线组合，且不能以数字下划线开头，不能有中文和特殊字符，gat1400用户名不能与gat1400密码相同。 user_name String 参数说明：ITS800鉴权用的用户名。 取值范围：长度不超过255，只允许字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。

响应示例 状态码： 200 OK { "v2x_edge_id" : "ab6cb4ca-bc7a-4b3d-8629-7212c5d9a6b0", "name" : "name", "description" : "test", "esn" : "ESN01234567", "ip" : "127.0.0.1", "port" : "8880", "hardware_type" : "ATLAS", "server_protocol_type" : "http", "server_cert" : null, "position_description" : "testtest", "location" : { "lat" : 22.4, "lon" : 124 }, "cameras" : [ "ab6cb4ca-bc7a-4b3d-8629-7212c5d9a6b0" ], "radars" : [ "ab6cb4ca-bc7a-4b3d-8629-7212c5d9a6b0" ], "local_rsus" : [ "rsu_test_01" ], "local_segment_rsus" : [ { "segment_id" : "1", "rsu_esn" : "13518098671442480164720973683901" }, { "segment_id" : "2", "rsu_esn" : "13518098671442480164720973683901" }, { "segment_id" : "3", "rsu_esn" : "98238558220689235608785517764662" } ], "edge_general_config" : { "avp_enabled" : true, "rsm_enabled" : true, "time_compensate" : true, "log_level" : false, "road_detection_length" : 10, "ramp_detection_length" : 10, "gat1400_username" : "dris_user", "user_name" : "dris_user" }, "edge_advance_config" : { "testKey" : "testValue" }, "status" : "ONLINE", "node_id" : "536434354358674544874543587", "created_time" : "2020-09-01T01:37:01Z", "last_modified_time" : "2020-09-01T01:37:01Z" }

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

请求示例 POST https://{endpoint}/v1/{project_id}/traffic-events Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "note" : "note", "event_source_id" : "11", "event_source_type" : "unknown", "area_code" : 440300, "event_description" : "123", "end_time" : "2022-01-05T21:25:14Z", "event_confidence" : 1, "reference_paths" : [ { "path_radius" : 1000, "active_path" : [ { "lon" : 114.123456, "lat" : 22.123456 }, { "lon" : 115.123456, "lat" : 23.123456 } ] } ], "event_params" : { "user_defined_param1" : "10" }, "event_position_name" : "深圳市龙岗区坂田华为基地F4", "event_position" : { "lon" : 114.123456, "lat" : 22.123456 }, "start_time" : "2021-12-30T21:25:14Z", "event_type" : 100, "event_class" : "AbnormalTraffic", "event_level" : 1, "coordinate" : "WGS84" }

响应示例 状态码： 201 Created { "status" : "Active", "event_id" : "bdd0da88-a22c-4259-8679-947b772512a3", "event_source_type" : "v2xServer", "event_source_id" : 301, "event_class" : "AbnormalVehicle", "event_type" : 903, "area_code" : 440330, "event_level" : 0, "event_params" : { "additionalProp1" : "50" }, "event_position" : { "lat" : 22.123456, "lon" : 114.123456 }, "event_description" : "q CS YD6jdXBLlm65GB9TguIV1ra80Mc0k", "reference_paths" : [ { "active_path" : [ { "lat" : 22.123456, "lon" : 114.123456 }, { "lat" : 23.123456, "lon" : 115.123456 } ], "path_radius" : 1000 } ], "event_position_name" : "F4(V2X 办公区域) ", "start_time" : "2021-12-23T08:32:51.618Z", "end_time" : "2021-12-23T08:32:51.618Z", "note" : "note", "event_confidence" : 100, "coordinate" : "WGS84" }

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

修订记录 发布日期 修订记录 2023-12-26 新增 数据转发中，rsi消息体增加congestion_lanes_info、data_source、camera_list字段 数据转发中，statistics消息体增加segment、section_id、lane_count、vehicle_density、head_interval、space_interval字段 数据转发中，tracks消息体增加camera_list字段 修改 RSU上报BSM、RSU上报MAP、RSU上报RSI、RSU上报RSM、RSU上报SPAT、信号机上报SPAT、RSU接收RSI、RSU接收SPAT等接口消息示例调整 2023-11-24 新增 OBU上报BSM OBU接收RSI 修改 RSU上报SPAT接口，修改ReportedIntersectionStateDTO中status、timeConfidence字段的描述。 信号机上报SPAT接口，修改OpenSouthIntersectionStateDTO中time_confidence字段的描述。 2023-06-29 修改 RSU接收SPAT，修正RSUReceivedTimeChangeDetailsDTO中的startTime、likelyEndTime字段的描述，修正ReceivedTimeMark中的参数，由“ReceivedTimeMark”修改为“timeMark”。 2023-06-25 新增 发送信号灯消息 2022-12-08 新增 查询雷达接口 2022-11-10 新增 查询历史交通统计信息列表 获取信号机设备列表 创建信号机设备 删除信号机设备 修改信号机设备 获取车辆列表 创建车辆 删除车辆 修改车辆 2022-03-25 修改 RSU管理、Edge管理、业务通道管理、Edge应用版本管理、长期交通事件管理、IPC管理、RSU型号管理、数据转发配置管理、历史交通事件管理、即时交通事件管理，调整请求示例的格式。 RSU接收RSI，ReceivedPosition3D字段修改lat、lat的描述。 查询长期交通事件列表，修改from_time、to_time的描述。 历史交通事件管理，HistoryTrafficEventDTO字段修改start_time、end_time的描述。 Edge管理，harwareType参数名修改为hardware_type，ModifyV2XEdgeDTO移除hardware_type参数。 长期交通事件管理，TrafficEventDTO字段修改event_params的描述 2022-02-10 修改 RSU型号管理，修改project_id、Instance-Id的描述。 创建RSU型号，修改状态码。 查询RSU型号列表，修改功能介绍，修改limit、manufacturer_name、offset的描述，修改状态码。 查询RSU型号，修改功能介绍，修改rsu_model_id的描述，修改状态码。 修改RSU型号，修改功能介绍，修改rsu_model_id的描述，修改状态码。 删除RSU型号，修改功能介绍，修改rsu_model_id的描述，修改状态码。 RSU管理，修改project_id、Instance-Id的描述，RsuPageDTO字段修改count、rsus的描述，RsuDTO字段修改rsu_id、name、description、ip、location、status、rsu_model_id、related_edge_num、software_version的描述，InnerRsuDTO字段修改rsu_id、name、description、esn、ip、position_description、location、status、rsu_model_id、related_edge_num的描述，AddRsuDTO字段修改description、esn、ip、position_description、related_edge_num、rsu_model_id、secret的描述，ModifyRsuRequestDTO字段修改description、ip、position_description、related_edge_num的描述，ModifyInnerRsuRequestDTO字段修改status、ip、position_description、location、related_edge_num的描述，RsuLocation字段修改lat、lon的描述。 查询RSU列表，修改offset、limit、rsu_id、esn、status、rsu_model_id的描述，修改状态码。 创建RSU，修改状态码。 删除RSU，修改rsu_id的描述，修改状态码。 修改RSU，修改rsu_id的描述，修改状态码。 查询历史交通事件列表，修改project_id、Instance-Id、offset、limit、event_class、event_source的描述，修改响应示例，修改状态码。 Edge管理，修改project_id、Instance-Id的描述，AddV2XEdgeDataChannelDTO字段修改platform_type的描述，PlatformPara字段修改address、passwd的描述，V2XEdgeDataChannelResponseDTO字段修改platform_type、channel_status，EdgeConfigData字段修改v2x_server_ip的描述，CameraStatus字段修改status、calibration_status的描述，RadarStatus字段修改status的描述，StatusData字段修改connect_status的描述，V2XEdgeResponseDTO修改v2x_edge_id、name、description、esn、ip、position_description、camera_ids、radar_ids、local_rsus、status、last_modified_time的描述，V2XEdgeListResponseDTO字段修改v2x_edge_id、name、esn、position_description、status的描述，V2XEdgeDetailResponseDTO字段修改v2x_edge_id、name、description、esn、ip、hardwareType、position_description、cameras、radars、local_rsus、status、channel_status、last_modified_time的描述，AddV2XEdgeDTO字段修改name、description、esn、ip、position_description、camera_ids、radar_ids、local_rsus的描述，ModifyV2XEdgeDTO字段修改description、esn、ip、position_description、camera_ids、radar_ids、local_rsus的描述，Location字段修改lat、lon的描述，IdAndStatus字段修改id、status的描述，CameraInfo字段修改camera_ip的描述，ThirdPartyRsu字段修改esn的描述，SyncAppDataRequest字段修改v2x_edge_id的描述，V2XEdgeInnerResponseDTO字段修改rsus、projcet_id、v2x_id、tenant_id的描述。 查询Edge列表，修改status的描述，修改状态码。 创建Edge，修改状态码。 删除Edge，修改v2x_edge_id的描述，修改状态码。 查询Edge，修改v2x_edge_id的描述，修改状态码。 修改Edge，修改v2x_edge_id的描述，修改状态码。 生成部署应用安装命令，修改v2x_edge_id的描述，修改状态码。 创建业务通道，修改v2x_edge_id的描述，修改状态码。 修改业务通道，修改v2x_edge_id的描述，修改状态码。 查询业务通道，修改v2x_edge_id的描述，修改状态码。 删除业务通道，修改v2x_edge_id的描述，修改状态码。 长期交通事件管理，修改project_id、Instance-Id的描述，TrafficEventDTO字段修改status、event_id、event_source_type、event_class、area_code、event_params、reference_paths、event_position_name的描述，AddTrafficEventDTO字段修改event_source_type、event_source_id、event_class、area_code、event_params、reference_paths、event_position_name的描述，UpdateTrafficEventDTO字段修改event_source_type、event_source_id、event_class、area_code、event_params、reference_paths、event_position_name的描述，InnerTrafficEventDTO字段修改status、event_id、event_source_type、event_source_id、event_class、area_code、event_params、reference_paths、event_position_name。 查询长期交通事件列表，修改limit、area_code、status、event_source_type、event_class、event_id的描述，修改状态码。 创建长期交通事件，修改状态码。 查询长期交通事件，修改event_id的描述，修改状态码。 修改长期交通事件，修改event_id的描述，修改状态码。 删除长期交通事件，修改event_id的描述，修改状态码。 RSU接收RSI，RSUReferencePath字段名修改为RSUReceivedReferencePath。 RSU接收SPAT，PhaseDTO字段名修改为RSUReceivedPhaseDTO，TimeChangeDetailsDTO字段名修改为RSUReceivedTimeChangeDetailsDTO，UTCTimingDTO字段名修改为RSUReceivedUTCTimingDTO。 数据转发配置管理，修改project_id、Instance-Id的描述，AddForwardingConfigRequestDTO字段修改forwarding_type的描述，修改ForwardingConfigRequestDTO、KafkaConfigRequestDTO字段的描述，KafkaConfigRequestDTO字段修改topic_prefix、user_topics、brokers、username、password的描述，KafkaConfigRequestDTO字段修改items参数信息，ForwardingConfig字段修改forwarding_type参数的信息，KafkaConfigPageResponseDTO字段修改count、forwarding_configs的描述，修改KafkaConfigResponseDTO字段的描述，KafkaConfigResponseDTO字段修改kafka_config_id、kafka_topics、brokers、username、password、status、created_time、last_modified_time的描述，KafkaConfigResponseDTO字段修改items参数信息，UpdateKafkaConfigRequestDTO字段修改topic_prefix、user_topics、brokers、username、password的描述，UpdateKafkaConfigRequestDTO字段修改items参数信息。 创建数据转发配置，修改功能介绍，修改状态码。 查询数据转发配置列表，修改forwarding_type、limit的描述，修改状态码。 修改数据转发配置，修改forwarding_type的描述，修改状态码。 查询数据转发配置，修改forwarding_type的描述，修改状态码。 删除数据转发配置，修改功能介绍，修改状态码。 即时交通事件管理，修改project_id、Instance-Id的描述，修改SendConfig、Channel字段的描述，Channel字段修改by_lte_pc5、by_lte_uu的描述，TargetList字段修改target_rsu_ids、target_obu_ids的描述，ImmediateEventDTO字段修改time_stamp、event_class、event_type、event_source、event_source_id、event_radius的描述，ImmediateEventResponseDTO字段修改event_class、event_type、event_source、event_source_id的描述，RtesDTO字段修改rte_id、event_source的描述，Position3D字段修改lat、lon的描述。 创建即时交通事件，修改功能介绍，修改状态码。 IPC管理，修改project_id、Instance-Id的描述，IpcResponseDTO字段修改camera_id、v2x_edge_id、cross_id、focal_type、esn、status的描述，IpcInfoResponseDTO字段修改esn的描述。 查询IPC列表，修改limit、status的描述，修改状态码。 查询IPC，修改camera_id的描述，修改状态码。 Edge应用管理，修改project_id、Instance-Id、v2x_edge_id、edge_app_id的描述，修改X-Domain-Id参数信息。CreateEdgeApplicationRequestDTO字段修改edge_app_id、description的描述，UpdateEdgeApplicationRequestDTO字段修改description的描述，QueryEdgeApplicationVersionResponseDTO字段修改edge_app_id、description、state的描述，QueryEdgeAppVersionBriefResponseDTO字段修改edge_app_id、description、state的描述，CreateEdgeApplicationVersionDTO字段修改description的描述，UpdateEdgeAppVersionDTO字段修改description的描述，UpdateEdgeAppVersionStateDTO字段修改state的描述，PageInfoDTO字段修改offset的描述，QueryApplicationBriefResponseDTO字段修改edge_app_id、description、edge_app_id、app_version的描述，V2XEdgeAppResponseDTO字段修改v2x_edge_id、edge_app_id、status的描述，ModifyV2XEdgeAppDTO字段修改app_version的描述。 创建应用，修改状态码。 查询应用列表，修改edge_app_id、offset、limit的描述，修改状态码。 删除应用，修改状态码。 修改应用，修改状态码。 创建应用版本，修改状态码。 查询应用版本列表，修改offset、limit、state的描述，修改状态码。 查询应用版本，修改状态码。 删除应用版本，修改状态码。 修改应用版本，修改状态码。 更新应用版本状态，修改状态码。 部署边缘应用，修改功能介绍，修改状态码。 查询边缘应用列表，修改offset、limit的描述，修改状态码。 升级边缘应用，修改功能介绍，修改edge_app_id的描述，修改状态码。 查询边缘应用，修改状态码，修改delete参数的描述。 删除边缘应用，修改状态码。 RSU上报SPAT，ReportedIntersectionStateDTO字段修改status的描述。 RSU上报MAP，ReportedLane字段修改maneuvers的描述，ReportedConnectingLane字段修改maneuvers的描述，ReportedLaneAttributes字段修改shareWith、laneType的描述。 2022-01-10 新增 数据转发 消息上报 消息接收 Edge管理，新增ModifyEdgeGeneralConfig字段。 2021-11-10 修改 Edge管理，V2XEdgeResponseDTO新增edge_advance_config字段，V2XEdgeDetailResponseDTO新增edge_advance_config字段，AddV2XEdgeDTO新增edge_advance_config字段，ModifyV2XEdgeDTO新增edge_advance_config字段。 2021-11-01 新增 查询IPC列表 查询IPC 修改 Edge管理，EdgeGeneralConfi新增log_level字段，ModifyV2XEdgeDTO新增port、hardwareType字段，AddV2XEdgeDTO新增port、hardwareType字段，V2XEdgeDetailResponseDTO新增port，hardwareType字段，V2XEdgeResponseDTO新增port、hardwareType字段。 Edge管理，VolumeDTO修改部分字段的示例，ExtDevice修改部分字段的示例，ContainerConfigsDTO修改部分字段的示例，ContainerPortDTO修改部分字段的示例，UpdateEdgeAppVersionDTO修改部分字段的示例。 数据转发配置管理，Instance-Id的required的值修改为false。 Edge管理，Instance-Id的required的值修改为false。 长期交通事件管理，AddTrafficEventDTO修改start_time、end_time字段的校验规则，UpdateTrafficEventDTO修改start_time、end_time字段的校验规则。 历史交通消息管理，新增event_source、cross_id字段。 2021-07-02 修改 Edge管理，扩展RSI description字段。 查询RSU列表，修正name: offset参数描述。 查询历史交通事件列表，修改经纬度精度描述。 2021-05-14 修改 Edge管理，新增rsus字段。 2021-03-30 修改 Edge管理，修改created_time、last_modified_time、channel_status字段，enum参数删除“NULL”值。 RSU管理，新增intersection_id字段，status字段新增“UNKNOWN”状态。 Edge应用管理，修改app_id正则校验。 新增 创建业务通道 修改业务通道 查询业务通道 删除业务通道 2021-03-16 修改 数据转发配置管理，新增InnerKafkaConfigDTO字段。 Edge管理，修改“- UNKONWN”为“- UNKNOWN”。 Edge管理，新增user_name字段、password字段。 Edge管理，移除废弃的AppData、AddAppData、EdgeAppResponseDTO、AddEdgeAppDTO。 Edge管理，新增location{lon,lat}字段，修改platform_type、PlatformPara、address、Location字段。 RSU管理，新增software_version字段。 Edge管理，新增user_name、password字段。 2021-02-20 修改 RSU管理，新增dag_ip字段。 部署边缘应用，原命名“创建边缘应用”修改为“部署边缘应用”。 查询边缘应用列表，修改状态码及描述，修正APIG配置，修改httpVpcEndpoints字段方法。 升级边缘应用，原命名“修改边缘应用”修改为“升级边缘应用”。 查询边缘应用，修改httpVpcEndpoints字段方法。 Edge管理，edge查询接口返回值增加channe_status字段，enum参数新增“- UNKONWN”值。 查询历史交通事件列表，修改APIG请求配置。 Edge应用管理，修改project_id字段描述，修改X-Auth-Token参数描述。 废弃 移除废弃的查询节点配置证书 2021-01-09 新增 RSU型号管理 Edge应用管理 Edge应用版本管理 边缘应用管理 生成部署应用安装命令 查询Edge 2020-12-04 新增 Edge管理 数据转发配置管理 历史交通消息管理 即时交通事件管理 参数说明列表 修改 长期交通事件管理 错误码 获取Instance-Id 2020-08-17 新增 V2X MAP接口 获取Instance-Id 获取应用接入信息 修改 RSU管理 长期交通事件管理 2020-08-10 废弃 Kafka配置接口 V2X MAP接口 即时交通事件分发 V2X HistoryTrafficEvents接口 统计交通事件资源管理 V2X VehicleHistory接口 2020-07-31 新增 Kafka配置接口 V2X MAP接口 即时交通事件分发 V2X HistoryTrafficEvents接口 统计交通事件资源管理 V2X VehicleHistory接口 2020-07-01 新增 补充文档修订记录 2020-05-08 新增 RSU管理 长期交通事件管理

上行TOPIC v2x/v1/signalcontroller/{traffic_controller_id}/spat/up topic中{traffic_controller_id}替换为创建信号机时填写的traffic_controller_id（设备id）。例如traffic_controller_id为132293，topic：v2x/v1/signalcontroller/132293/spat/up。

Message示例 { "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 } } ] } ] } ] } }

响应示例 状态码： 200 OK { "forwarding_type" : "kafka", "kafka_config_id" : 1234567890, "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "topic_prefix" : "prefix", "brokers" : [ "127.0.0.1:10000" ], "username" : "1234567890", "status" : "OFFLINE", "authentication" : false, "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-12T12:12:12Z" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 forwarding_type String 参数说明：转发配置的类型。 取值范围：当前仅支持“kafka、mrskafka”。 kafka_config_id String 参数说明：每一套Kafka配置的唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：1 最大长度：255 kafka_topics Array of strings 参数说明：kafka的主题列表。 取值范围： v2x-v1-tracks：edge上报的车辆轨迹数据 v2x-v1-bsm：车载T-BOX，RSU上报的BSM消息数据 v2x-v1-rsi：RSU，edge上报的RSI消息数据 v2x-v1-rsm： RSU，edge上报的RSM消息数据 v2x-v1-spat：RSU上报的SPAT消息数据 v2x-v1-edge-flow：edge上报的车流量统计信息数据 数组长度：0 - 7 brokers Array of strings 参数说明：Kafka broker列表。 最小长度：1 最大长度：255 数组长度：1 - 255 username String 参数说明：kafka用户名。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：1 最大长度：255 topic_prefix String 参数说明：Topic前缀。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 status String 参数说明：一套kafka的连接状态。 取值范围： OFFLINE：离线 ONLINE：在线 枚举值： OFFLINE ONLINE authentication Boolean 参数说明：是否开启kerberos安全认证的开关。若开启安全认证则需要先上传kerberos安全认证的凭证。 缺省值：false created_time String 参数说明：创建时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z last_modified_time String 参数说明：修改时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z

请求示例 POST https://{endpoint}/v1/{project_id}/forwarding-configs Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "forwarding_type" : "kafka", "forwarding_config" : { "kafka_config" : { "topic_prefix" : "prefix", "user_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "brokers" : [ "127.0.0.1:10000" ], "username" : "1234567890", "password" : "1234567890" } } }

响应参数 状态码： 201 表7 响应Body参数 参数 参数类型 描述 forwarding_type String 参数说明：转发配置的类型。 取值范围：当前仅支持“kafka、mrskafka”。 kafka_config KafkaConfigResponseDTO object 参数说明：Kafka配置信息。 mrs_kafka_config MrsKafkaConfigResponseDTO object 参数说明：mrsKafka配置信息。 表8 KafkaConfigResponseDTO 参数 参数类型 描述 kafka_config_id String 参数说明：每一套Kafka配置的唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：1 最大长度：255 kafka_topics Array of strings 参数说明：kafka的主题列表。 取值范围： v2x-v1-tracks：edge上报的车辆轨迹数据 v2x-v1-bsm：车载T-BOX，RSU上报的BSM消息数据 v2x-v1-rsi：RSU，edge上报的RSI消息数据 v2x-v1-rsm： RSU，edge上报的RSM消息数据 v2x-v1-spat：RSU上报的SPAT消息数据 v2x-v1-edge-flow：edge上报的车流量统计信息数据 数组长度：0 - 7 brokers Array of strings 参数说明：Kafka broker列表。 最小长度：1 最大长度：255 数组长度：1 - 255 username String 参数说明：kafka用户名。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：1 最大长度：255 topic_prefix String 参数说明：Topic前缀。 取值范围：长度不超过255，只允许字母、数字、下划线（_）、连接符（-）的组合。 status String 参数说明：一套kafka的连接状态。 取值范围： OFFLINE：离线 ONLINE：在线 枚举值： OFFLINE ONLINE created_time String 参数说明：创建时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z last_modified_time String 参数说明：修改时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z 表9 MrsKafkaConfigResponseDTO 参数 参数类型 描述 kafka_config_id String 参数说明：每一套Kafka配置的唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：1 最大长度：255 kafka_topics Array of strings 参数说明：kafka的主题列表。 取值范围： v2x-v1-tracks：edge上报的车辆轨迹数据 v2x-v1-bsm：车载T-BOX，RSU上报的BSM消息数据 v2x-v1-rsi：RSU，edge上报的RSI消息数据 v2x-v1-rsm： RSU，edge上报的RSM消息数据 v2x-v1-spat：RSU上报的SPAT消息数据 v2x-v1-edge-flow：edge上报的车流量统计信息数据 数组长度：0 - 7 brokers Array of strings 参数说明：Kafka broker列表。 最小长度：1 最大长度：255 数组长度：1 - 255 username String 参数说明：mrskafka用户名，若开启安全认证该参数必填。 取值范围：只允许字母、数字、下划线（_）、连接符（-）的组合。 最小长度：0 最大长度：255 status String 参数说明：一套kafka的连接状态。 取值范围： OFFLINE：离线 ONLINE：在线 枚举值： OFFLINE ONLINE authentication Boolean 参数说明：是否开启kerberos安全认证的开关。若开启安全认证则需要先上传kerberos安全认证的凭证。 缺省值：false created_time String 参数说明：创建时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z last_modified_time String 参数说明：修改时间。 格式为yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2015-12-12T12:12:12Z

响应示例 状态码： 201 Created { "forwarding_type" : "kafka", "kafka_config" : { "kafka_config_id" : 1234567890, "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "topic_prefix" : "prefix", "brokers" : [ "127.0.0.1:10000" ], "username" : "1234567890", "status" : "OFFLINE", "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-12T12:12:12Z" }, "mrs_kafka_config" : { "kafka_config_id" : null, "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "brokers" : [ "127.0.0.1:10000" ], "username" : null, "status" : null, "authentication" : false, "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-12T12:12:12Z" } }

Message示例 { "name" : "testpat", "content" : "{\"intersections\":[{\"intersectionId\":{\"region\":1,\"id\":301},\"status\":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\":1642667084000,\"likelyEndTime\":1642670684000}}]}]}],\"name\":\"12345\"}" }

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 参数说明：消息名称。 最小长度：1 最大长度：255 content 是 RsuReceivedSpatData object 参数说明：下发的spat消息内容，格式为JSON字符串。 表2 RsuReceivedSpatData 参数 是否必选 参数类型 描述 intersections 否 Array of RSUReceivedIntersectionStateDTO objects 参数说明：路口信号灯集合。 数组长度：0 - 1000 name 否 String 参数说明：供理解的名称描述。 最小长度：1 最大长度：63 表3 RSUReceivedIntersectionStateDTO 参数 是否必选 参数类型 描述 intersectionId 是 ReceivedNodeReferenceId object 参数说明：节点属性ID。 status 否 Integer 参数说明：路口信号机的工作状态指示。 取值范围： 0：手动控制状态开启 1：停止计时状态激活 2：用于硬件故障检测 3：优先状态激活 4：信号优先级状态激活 5：固定配时 6：基于交通流状态的配时 7：备用操作，可部分关闭或闪烁 8：故障模式 9：控制状态关闭 10：近期地图内容数据更新 11：近期地图道路id数据更新 12：此时无有效地图 13：此时无有效spat信息 最小值：0 最大值：13 phases 是 Array of RSUReceivedPhaseDTO objects 参数说明：信号灯各道路方向的灯态列表。 数组长度：1 - 16 表4 ReceivedNodeReferenceId 参数 是否必选 参数类型 描述 region 否 Integer 参数说明：所在区域在地图中的编号，数值0仅用于测试。 最小值：0 最大值：65535 id 否 Integer 参数说明：节点编号。路网最基本的构成即节点和节点之间连接的路段。节点可以是路口，也可以是一条 路的端点。一个节点的 ID 在同一个区域内是唯一的。数值 0~255 预留为测试使用。 最小值：0 最大值：65535 表5 RSUReceivedPhaseDTO 参数 是否必选 参数类型 描述 phaseId 是 Integer 参数说明：定义信号灯相位ID。数值0表示无效ID。 最小值：0 最大值：255 phaseStates 是 Array of RSUReceivedPhaseStateDTO objects 参数说明：一个信号灯的一个相位状态列表。列表中每一个相位状态物理上对应了一种相位灯色，其属性包括了该状态的实时计时信息。 数组长度：1 - 16 表6 RSUReceivedPhaseStateDTO 参数 是否必选 参数类型 描述 light 是 String 参数说明：定义信号灯相位的灯色状态。支持GB14886规定的红绿黄三种信号灯灯色，以及亮灯、 闪烁和熄灭三种状态。 取值范围： 0：不可用 1：黑色 2：红色闪烁 3：红色 4：绿色闪烁 5：通行允许相位（通行绿） 6：通行保护相位（保护绿） 7：黄色 8：黄色闪烁 最小值：0 最大值：8 timing 否 RSUReceivedTimeChangeDetailsDTO object 参数说明：定义一个信号灯相位的计时状态。提供了两种可选的计时状态格式，一种是倒计时形式，另一种是UTC世界标准时间的形式。在实际使用时，由路侧设施根据实际情况选用。 表7 RSUReceivedTimeChangeDetailsDTO 参数 是否必选 参数类型 描述 counting 否 ReceivedTimeCountingDownDTO object 参数说明：用倒计时形式，描述一个信号灯相位状态的完整计时状态。 utcTiming 否 RSUReceivedUTCTimingDTO object 参数说明：用UTC世界标准时间形式，描述一个信号灯相位状态的完整计时状态。 startTime 否 Integer 参数说明：开始时间。以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 最小值：0 最大值：36001 likelyEndTime 否 Integer 参数说明：可能结束时间。以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 最小值：0 最大值：36001 表8 ReceivedTimeCountingDownDTO 参数 是否必选 参数类型 描述 startTime 是 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 minEndTime 否 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 maxEndTime 否 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 likelyEndTime 是 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 timeConfidence 否 Integer 参数说明：定义置信度。单位为0.5%。 最小值：0 最大值：200 nextStartTime 否 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 nextDuration 否 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 表9 RSUReceivedUTCTimingDTO 参数 是否必选 参数类型 描述 startUtcTime 是 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 minEndUtcTime 否 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 maxEndUtcTime 否 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 likelyEndUtcTime 是 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 timeConfidence 否 Integer 参数说明：定义置信度。单位为0.5%。 最小值：0 最大值：200 nextStartUtcTime 否 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 nextEndUtcTime 否 ReceivedTimeMark object 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 表10 ReceivedTimeMark 参数 是否必选 参数类型 描述 timeMark 是 Integer 参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 最小值：0 最大值：36001

响应示例 状态码： 200 OK { "status" : "Active", "event_id" : "bdd0da88-a22c-4259-8679-947b772512a3", "event_source_type" : "v2xServer", "event_source_id" : 301, "event_class" : "AbnormalVehicle", "event_type" : 903, "area_code" : 440330, "event_level" : 0, "event_params" : { "additionalProp1" : "50" }, "event_position" : { "lat" : 22.123456, "lon" : 114.123456 }, "event_description" : "qCSYD6jdXBLlm65GB9TguIV1ra80Mc0k", "reference_paths" : [ { "active_path" : [ { "lat" : 22.123456, "lon" : 114.123456 } ], "path_radius" : 1000 } ], "event_position_name" : "F4(V2X 办公区域) ", "start_time" : "2021-12-23T08:32:51.618Z", "end_time" : "2021-12-23T08:32:51.618Z", "note" : "note", "coordinate" : "WGS84" }

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示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "source" : { "source_type" : "detection", "source_id" : "705183159624675328_2102312ETX10K7000037" }, "time" : "2020-09-01T01:37:01Z", "section_id" : 1, "period" : 300, "direction" : 180, "flow" : 75, "average_speed" : 72.5, "cross_id" : "cross0123456789", "segment" : { "segment_id" : "1", "lon" : 114.23256, "lat" : 30.121545 }, "esn" : "2102312ETX10K7000037", "traffic_direction" : "0,", "road_kind" : "1,", "has_congestion" : "false,", "vehicle_class_flow" : [ { "vehicle_class" : 10, "flow" : 50, "average_speed" : 73.6 }, { "vehicle_class" : 20, "flow" : 25, "average_speed" : 71.4 } ], "occupancy" : [ { "lane_id" : 0, "space_occupancy" : 0.6, "time_occupancy" : 0.5 }, { "lane_id" : 1, "space_occupancy" : 0.6, "time_occupancy" : 0.5 } ], "lane_count" : 4, "lane_flow" : [ { "lane_id" : 10, "flow" : 50, "average_speed" : 73.6, "vehicle_density" : 100, "head_interval" : 100, "space_interval" : 1000 }, { "lane_id" : 20, "flow" : 25, "average_speed" : 71.4, "vehicle_density" : 100, "head_interval" : 100, "space_interval" : 1000 } ] } }

响应示例 状态码： 200 OK { "edge_app_id" : "14414341626215826433476361010249", "version" : "1.0.2", "description" : "hello", "created_time" : "2020-05-28T11:31:29.740Z", "last_modified_time" : "2020-05-28T11:31:29.740Z", "state" : "DRAFT", "command" : [ "tets" ], "args" : [ "tets" ], "container_settings" : { "configs" : { "privileged" : false, "host_network" : true, "restart_policy" : "Always", "container_port_list" : [ { "container_port" : 2656, "host_port" : 2656, "host_ip" : "1.1.1.1" } ] }, "image_url" : "xxx.com/huawei/edge:1.0.0", "envs" : { "test" : "test" }, "volumes" : [ { "name" : "config", "type" : " LOG ", "source" : "/iot/opt/test", "destination" : "/iot/opt/test", "read_only" : false } ], "resources" : { "limits" : { "cpu" : 2, "memory" : 2, "gpu" : 2, "npu" : 2 }, "requests" : { "cpu" : 4, "memory" : 4, "gpu" : 4, "npu" : 4 } }, "ext_devices" : null }, "publish_time" : "2020-05-28T11:31:29.740Z", "off_shelf_time" : "2020-05-28T11:31:29.740Z" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 edge_app_id String 参数说明：用户自定义应用唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）、美元符号（$）的组合。 最小长度：0 最大长度：32 version String 参数说明：应用版本。 最小长度：0 最大长度：32 description String 参数说明：应用描述。 取值范围：只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文引号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）的组合。 最小长度：0 最大长度：255 created_time String 参数说明：创建时间。 最小长度：0 最大长度：255 last_modified_time String 参数说明：最后一次修改时间。 最小长度：0 最大长度：255 state String 参数说明：应用版本状态。 取值范围： DRAFT：草稿 PUBLISHED：发布 OFF_SHELF：下线 command Array of strings 参数说明：启动命令。 数组长度：1 - 1000000 args Array of strings 参数说明：启动参数。 数组长度：1 - 1000000 container_settings ContainerSettingsDTO object 参数说明：容器配置。 publish_time String 参数说明：发布时间。 最小长度：0 最大长度：255 off_shelf_time String 参数说明：下线时间。 最小长度：0 最大长度：255 表4 ContainerSettingsDTO 参数 参数类型 描述 configs ContainerConfigsDTO object 参数说明：容器特殊参数。 image_url String 参数说明：镜像存储地址。 envs Object 参数说明：环境变量。 volumes Array of VolumeDTO objects 参数说明：卷配置。 数组长度：0 - 100 resources ResourceDTO object 参数说明：资源配额。 ext_devices Array of ExtDevice objects 参数说明：外挂设备配置。 数组长度：0 - 100 表5 ContainerConfigsDTO 参数 参数类型 描述 privileged Boolean 参数说明：开启容器特权模式。 缺省值：false host_network Boolean 参数说明：是否使用主机网络模式。 缺省值：true restart_policy String 参数说明：重启策略，容器执行健康检查后失败后的策略。 最小长度：1 最大长度：255 container_port_list Array of ContainerPortDTO objects 参数说明：容器端口映射值。 数组长度：0 - 1000000 表6 ContainerPortDTO 参数 参数类型 描述 container_port Integer 参数说明：构成一堆映射的容器端口。 最小值：1 最大值：65535 host_port Integer 参数说明：构成一对映射的物理机对应网卡端口。 最小值：1 最大值：65535 host_ip String 参数说明：对应网卡地址。 表7 VolumeDTO 参数 参数类型 描述 name String 参数说明：卷名称。 最小长度：1 最大长度：63 type String 参数说明：挂载类型。 source String 参数说明：源路径。 最小长度：1 最大长度：255 destination String 参数说明：卷挂载路径。 最小长度：1 最大长度：255 read_only Boolean 参数说明：只读，默认只读。 表8 ResourceDTO 参数 参数类型 描述 limits ResourceConfigDTO object 参数说明：允许容器使用的最大资源。 requests ResourceConfigDTO object 参数说明：容器需要使用的最小资源。 表9 ResourceConfigDTO 参数 参数类型 描述 cpu Float 参数说明：cpu个数。 最小值：0.01 最大值：1000 memory Float 参数说明：内存大小。 最小值：0.01 最大值：1024000 gpu Float 参数说明：gpu个数。 最小值：0.01 最大值：1024000 npu Float 参数说明：npu个数。 最小值：0.01 最大值：1000 表10 ExtDevice 参数 参数类型 描述 source String 参数说明：源路径。 最小长度：1 最大长度：255 destination String 参数说明：卷挂载路径。 最小长度：1 最大长度：255 cgroup_permissions String 参数说明：只读，默认MRW。

请求示例 PUT https://{endpoint}/v1/{project_id}/forwarding-configs/{forwarding_config_id}?forwarding_type={forwarding_type} Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "kafka_config" : { "topic_prefix" : "abc", "user_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "brokers" : [ "127.0.0.1:1000" ], "username" : "1234567890", "password" : "1234567890" } }

响应示例 状态码： 200 OK { "forwarding_type" : "kafka", "kafka_config" : { "kafka_config_id" : "1234567890", "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "brokers" : [ "127.0.0.1:10000" ], "username" : "1234567890", "topic_prefix" : "abc", "status" : "ONLINE", "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-13T12:12:12Z" }, "mrs_kafka_config" : { "kafka_config_id" : null, "kafka_topics" : [ "v2x-v1-tracks", "v2x-v1-bsm", "v2x-v1-rsi", "v2x-v1-rsm", "v2x-v1-spat", "v2x-v1-edge-flow" ], "brokers" : [ "127.0.0.1:10000" ], "username" : null, "status" : null, "authentication" : false, "created_time" : "2015-12-12T12:12:12Z", "last_modified_time" : "2015-12-12T12:12:12Z" } }