华为云用户手册

请求示例 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

结构定义 表1 请求Body参数 参数 是否必选 参数类型 描述 etag 是 String 参数说明：Map消息的etag，格式为：地图来源_格式标准_标准对应的版本_扩展说明_时间。仅允许数字、大小写字母及下划线（_）的组合。 mapParts 是 Array of UploadMapPart objects 参数说明：高精地图的区域列表。 表2 UploadMapPart 参数 是否必选 参数类型 描述 referencePoints 是 Array of UploadMapReferencePoint objects 当前区域的分割参考点，即当前区域地图数据需下发的目标设备 nodes 是 Array of UploadMapNode objects 基于V2X MAP消息集定义的node节点，单一分片地图暂定最大63个node 表3 UploadMapReferencePoint 参数 是否必选 参数类型 描述 deviceType 是 String 参考点设备的设备类型。 deviceId 是 String 参考点设备的设备id, 若设备类型为RSU则为rsu_id，若设备类型为Edge则为v2x_edge_id。设备id为36位小写字母、数字及中划线（-）的组合" 表4 UploadMapNode 参数 是否必选 参数类型 描述 name 否 String 参数说明：节点属性名称。仅允许小写字母、大写字母、数字、下划线（_）及中划线（-）的组合。 最小长度：1 最大长度：256 id 是 UploadMapNodeReferenceId object 参数说明：地图节点ID。 refPos 是 UploadMapPosition3D object 参数说明：位置信息。 inLinks 否 Array of UploadMapLink objects 参数说明：节点上下游路段集合。 zone 否 Array of UploadMapZone objects 参数说明：特殊区域，如导流线，禁停区等。 表5 UploadMapPosition3D 参数 是否必选 参数类型 描述 lat 是 Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位为：1°，精确到小数点后7位； 最小值：-90 最大值：90 lon 是 Number 参数说明定义经度数值。东经为正，西经为负，单位为：1°，精确到小数点后7位； 最小值：-180 最大值：180 ele 否 Number 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表6 UploadMapLink 参数 是否必选 参数类型 描述 name 否 String 参数说明：路段名称。仅允许小写字母、大写字母、数字、下划线（_）及中划线（-）的组合。 最小长度：1 最大长度：256 upstreamNodeId 是 UploadMapNodeReferenceId object 参数说明：地图节点ID。 speedLimits 否 Array of UploadMapSpeedLimit objects 参数说明：限速列表，最大9个。 linkWidth 是 Integer 参数说明：车道宽度，单位cm。 最小值：0 最大值：400 points 否 Array of UploadMapPosition3D objects 参数说明：路段中心点，数量范围（2~31）。 movements 否 Array of UploadMapMovement objects 参数说明：下游信息，最大32个。 lanes 是 Array of UploadMapLane objects 参数说明：路段包含的车道，最大32个。 stopLine 否 Array of UploadMapPosition3D objects 参数说明：道路停止线，一般在红绿灯路口定义多个坐标点连接成为一条线，通常为两点连接为一条直线，也可以是一条折线，数量范围（2-32）。 表7 UploadMapMovement 参数 是否必选 参数类型 描述 remoteIntersection 是 UploadMapNodeReferenceId object 参数说明：地图节点ID。 phaseId 否 Integer 参数说明：信号灯相位ID，数值0表示无效ID。 最小值：0 最大值：255 表8 UploadMapLane 参数 是否必选 参数类型 描述 laneId 是 Integer 参数说明：车道ID。车道定义在每一条有向路段上，同一条有向路段上的每个车道，都拥有一个单独的ID。以该车道行驶方向为参考，自左向右从1开始编号 最小值：0 最大值：20 laneWidth 是 Integer 参数说明：车道宽度，单位cm。 最小值：0 最大值：400 laneAttributes 是 UploadMapLaneAttributes object 参数说明：定义车道属性。包括车道共享情况以及车道本身所属的类别特性。 maneuvers 否 Array of strings 参数说明：车道所允许的行驶方向。 取值范围： straightAllowed：允许直行 leftAllowed：允许左转向 rightAllowed：允许右转向 uTurnAllowed：允许掉头转向 leftTurnOnRedAllowed：红灯情况下允许左转向 rightTurnOnRedAllowed：红灯情况下允许右转向 laneChangeAllowed：允许变道 noStoppingAllowed：不允许停车 yieldAllWaysRequired：非保护车道状态，如永久黄灯状态 goWithHalt：停车，再前行 caution：小心前行 connectsTo 否 Array of UploadMapConnection objects 参数说明：车道与下游路段车道的连接关系列表。 speedLimits 否 Array of UploadMapSpeedLimit objects 参数说明：限速列表，最大9个。 points 是 Array of UploadMapPosition3D objects 参数说明：车道中间点列表。 parkingSlots 否 Array of UploadMapParkingSlot objects 参数说明：路边停车位。 表9 UploadMapLaneAttributes 参数 是否必选 参数类型 描述 shareWith 否 Array of strings 参数说明：定义车道被共享的情况。在已有的车道属性定义基础上，该数据表示此车道还会有其他的交通参与者出现，并可能拥有相同的路权。 取值范围: overlappingLaneDescriptionProvided：当存在其他车道时，描述重叠共享车道的路径。不适用简单交叉车道。 multipleLanesTreatedAsOneLane：当车道对象的路径和宽度细节表示多个车道的情况下，使用该参数判断是否为多个车道。各种模式和交通类型都可以共享该车道。 otherNonMotor：其他非机动车类型的共享车道情况。 individualMotorizedVehicle：个人机动车共享车道情况。 bus：公交车共享车道情况。 taxi：出租车共享车道情况。 pedestrians：人群共享车道情况。 cyclistVehicle：自行车共享车道情况。 trackedVehicle：履带车共享车道情况。 pedestrian：行人共享车道情况。 laneType 是 UploadMapLaneTypeAttributes object 参数说明：道路属性，根据道路类型定义其具体的属性。该属性包含多个子属性，对于一条车道，只有一个属性会生效，正常情况下只携带一个子属性。如果携带了多个子属性，属于异常情况，取第一个携带的子属性。 leftBoundary 是 UploadMapLaneBoundary object 参数说明：定义车道线属性。 rightBoundary 是 UploadMapLaneBoundary object 参数说明：定义车道线属性。 hovTimes 否 Array of UploadMapHovTime objects 参数说明：hov（多成员车道，High-Occupancy Vehicle Lane）生效时间。 busTimes 否 Array of UploadMapBusTime objects 参数说明：公交车道生效时间生效时间。 prohibitInfos 否 Array of UploadMapProhibitInfo objects 参数说明：禁行信息。 表10 UploadMapLaneTypeAttributes 参数 是否必选 参数类型 描述 vehicle 否 Array of strings 参数说明：表达车道相关属性。最大个数：16 取值范围: revocable ramp hovLaneOnly busOnly taxiOnly publicUseOnly emergency permissionOnRequest crosswalk 否 Array of strings 参数说明：表达车道相关属性。最大个数：16 取值范围: revocable bicyleAllowed xWalkFlyOver fixedCycleTime biDirectionalCycleTimes hasPushWalkButton audioSupport rfSignalRequestPresent unsignalizedSegmentsPresent bikeLane 否 Array of strings 参数说明：表达车道相关属性。最大个数：16 取值范围: revocable pedestrianAllowed bikeFlyOver fixedCycleTime biDirectionalCycleTimes isolatedByBarrier unsignalizedSegmentsPresent sidewalk 否 Array of strings 参数说明：表达车道相关属性。最大个数：16 取值范围: revocable bicyleAllowed sidewalkFlyOver walkBikes median 否 Array of strings 参数说明：表达车道相关属性。最大个数：16 取值范围: revocable median whiteLineHashing stripedLines doubleStripedLines trafficCones constructionBarrier trafficChannels lowCurbs highCurbs striping 否 Array of strings 参数说明：表达车道相关属性。最大个数：16 取值范围: revocable drawOnLeft drawOnRight connectingLanesLeft connectingLanesRight connectingLanesAhead trackedVehicle 否 Array of strings 参数说明：表达车道相关属性。最大个数：16 取值范围: revocable commuterRailRoad lightRailRoad heavyRailRoad otherRailType parking 否 Array of strings 参数说明：表达车道相关属性。最大个数：16 取值范围: revocable parallelParking headInParking notParkZone parkingForBus parkingForTaxi noPublicParking 表11 UploadMapLaneBoundary 参数 是否必选 参数类型 描述 type 是 String 参数说明：车道线类型。 取值范围： singleSolidLine: 单实线 doubleSolidLine: 双实线 singleDashedLine: 单虚线 doubleDashedLine: 双虚线 dashedSolidLine: 虚实线（内虚，外实） solidDashedLine: 实虚线（内实，外虚） curbside: 路牙 railing: 栏杆 wall: 墙 color 否 String 参数说明：车道线颜色。 取值范围： white: 白色 yellow: 黄色 width 否 Integer 参数说明：车道线宽度，单位：厘米 最小值：0 最大值：100 表12 UploadMapHovTime 参数 是否必选 参数类型 描述 startTime 是 Integer 参数说明：生效开始时间，定义为一天的分钟数。 最小值：0 最大值：1440 endTime 是 Integer 参数说明：生效结束时间，定义为一天的分钟数。 最小值：0 最大值：1440 validType 否 String 参数说明：生效日期类型。 取值范围： allDate: 所有日期 holiday: 节假日 exceptHoliday: 节假日除外 weekend: 周末 exceptWeekend: 周末除外 表13 UploadMapBusTime 参数 是否必选 参数类型 描述 startTime 是 Integer 参数说明：生效开始时间，定义为一天的分钟数。 最小值：0 最大值：1440 endTime 是 Integer 参数说明：生效结束时间，定义为一天的分钟数。 最小值：0 最大值：1440 validType 否 String 参数说明：生效日期类型。 取值范围： allDate: 所有日期 holiday: 节假日 exceptHoliday: 节假日除外 weekend: 周末 exceptWeekend: 周末除外 表14 UploadMapProhibitInfo 参数 是否必选 参数类型 描述 startTime 是 Integer 参数说明：生效开始时间，定义为一天的分钟数。 最小值：0 最大值：1440 endTime 是 Integer 参数说明：生效结束时间，定义为一天的分钟数。 最小值：0 最大值：1440 vehicleType 是 Integer 参数说明：车辆类型，参考车辆基本类型。 最小值：0 最大值：100 validType 否 String 参数说明：生效日期类型。 取值范围： allDate: 所有日期 holiday: 节假日 exceptHoliday: 节假日除外 weekend: 周末 exceptWeekend: 周末除外 表15 UploadMapConnection 参数 是否必选 参数类型 描述 remoteIntersection 是 UploadMapNodeReferenceId object 参数说明：地图节点ID。 connectingLane 否 UploadMapConnectingLane object 参数说明：用于定位上游车道转向连接的下游车道。包括下游车道 ID 以及该转向的允许行驶行为下游车道 ID 的作用范围是该车道所在的路段。 phaseId 否 Integer 参数说明：定义信号灯相位ID。数值0表示无效。 最小值：0 最大值：255 表16 UploadMapNodeReferenceId 参数 是否必选 参数类型 描述 region 否 Integer 参数说明：所在区域在地图中的编号，数值0仅用于测试。 最小值：0 最大值：65535 id 是 Integer 参数说明：节点编号。路网最基本的构成即节点和节点之间连接的路段。节点可以是路口，也可以是一条路的端点。一个节点的ID在同一个区域内是唯一的。 数值0~255预留为测试使用。 最小值：0 最大值：65535 表17 UploadMapConnectingLane 参数 是否必选 参数类型 描述 laneId 是 Integer 参数说明：车道定义在每一条有向路段上，同一条有向路段上的每个车道，都拥有一个单独的ID。车道号以该车道行驶方向为参考，自左向右从1开始编号。 最小值：1 最大值：255 maneuvers 否 Array of strings 参数说明：车道所允许的行驶方向。 取值范围： straightAllowed：允许直行 leftAllowed：允许左转向 rightAllowed：允许右转向 uTurnAllowed：允许掉头转向 leftTurnOnRedAllowed：红灯情况下允许左转向 rightTurnOnRedAllowed：红灯情况下允许右转向 laneChangeAllowed：允许变道 noStoppingAllowed：不允许停车 yieldAllWaysRequired：非保护车道状态，如永久黄灯状态 goWithHalt：停车，再前行 caution：小心前行 表18 UploadMapSpeedLimit 参数 是否必选 参数类型 描述 type 是 String 参数说明：限速类型。 取值范围： unknown: 未知 maxSpeedInSchoolZone: 学校区域的最大速度 maxSpeedInSchoolZoneWhenChildrenArePresent: 学校区域存在学生时的最大速度 maxSpeedInConstructionZone: 建筑区的最大速度 vehicleMinSpeed: 汽车最小速度 vehicleMaxSpeed: 汽车最大速度 vehicleNightMaxSpeed: 汽车夜间行驶最大速度 truckMinSpeed: 卡车最小速度 truckMaxSpeed: 卡车最大速度 truckMinSpeed: 卡车最小速度 truckNightMaxSpeed: 卡车夜间行驶最大速度 vehiclesWithTrailersMinSpeed: 拖车最小速度 vehiclesWithTrailersMaxSpeed: 拖车最大速度 vehiclesWithTrailersNightMaxSpeed: 拖车夜间行驶最大速度 speed 是 Integer 参数说明：限速大小，单位为0.02m/s。数值8191表示无效数值。 最小值：0 最大值：8191 表19 UploadMapParkingSlot 参数 是否必选 参数类型 描述 polygon 是 Array of UploadMapPosition3D objects 参数说明：停车位区域边界，通过坐标点顺序连接构成的多边形，一般是四边形，最大32个点。 lat 是 Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位为：1°，精确到小数点后7位； 最小值：-90 最大值：90 lon 是 Number 参数说明定义经度数值。东经为正，西经为负，单位为：1°，精确到小数点后7位； 最小值：-180 最大值：180 side 是 Integer 参数说明：停车位与lane的方位关系。左侧：left（0），右侧：right（1），不使用：not used（2） 最小值：0 最大值：2 poiId 是 Integer 参数说明：停车位id。最大为65535。 最小值：0 最大值：65535 表20 UploadMapZone 参数 是否必选 参数类型 描述 type 是 String 参数说明: 区域类型。 取值范围: crosswalk：人行横道 constructionIsolation：施工隔离 guideLine：导流线区域 speedBump：减速带 gridLine：方格线区域 regionalBoundary 是 Array of UploadMapPosition3D objects 参数说明：通过坐标点顺序连接构成的多边形，最大32个点。

响应示例 状态码： 201 Created { "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}

请求参数 表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}/vehicles/{vehicle_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID。获取方法请参见 获取项目ID。 取值范围：仅支持数字，a到f的小写字母组合，长度32。 vehicle_id 是 String 参数说明：车辆唯一标识符。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。

响应示例 状态码： 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"}

请求示例 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 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}

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 DRIS.00000002 Invalid input. %s 请求参数不合法 请排查请求参数是否符合文档定义。 400 DRIS.00000012 Resource create failed. 开通资源失败 请联系华为工程师分析解决。 400 DRIS.00000013 Resource already exist. This domain is already create resource. 资源已经存在 资源已经存在，请勿重复开通资源。 400 DRIS.00010001 The RSU ESN already exists. RSU esn已经存在 请更换esn后重试。 400 DRIS.00010005 The RSU model name already exists. RSU型号名称已存在 请更换名称后重试。 400 DRIS.00020002 Invalid input, event type invalid. 事件分类和事件类型不匹配 请参考国标交通事件编码填写。 400 DRIS.00020003 Invalid input, no tenant id found! 帐号ID不合法 请联系华为工程师分析解决。 400 DRIS.00030001 Invalid input. No matching RSU found for this event. 事件位置范围内未匹配到RSU 请检查事件位置是否正确。 400 DRIS.00100001 The number of RSU connection to Edges have reached the upper limit. RSU可关联的Edge数量达上限 请参考修改一个RSU资源调整RSU可关联的Edge数量。 400 DRIS.00100003 The EdgeApps are repeated. Edge App已经存在 请更换edge_app_id后重试。 400 DRIS.00120002 IPC ESN duplicate IPC设备已经存在 请更换esn后重试。 400 DRIS.00130003 Create install command failed. 生成边缘节点安装命令失败 请联系华为工程师分析解决。 400 DRIS.00200000 Instance not found. dris实例不存在 请确认携带的instance_id是否正确。 400 DRIS.00210001 Unknown system mode. 未知的系统模式 请确认携带的systemMode是否正确。 400 DRIS.00210003 Incremental updates are not supported. License不支持增量更新 请尝试使用全量更新操作。 400 DRIS.00210008 ESN not match can not apply. 激活license时esn匹配失败 请联系华为工程师分析解决。 400 DRIS.00280001 The Vehicle VehicleId already exists. 车辆ID已经存在 请更换vehicle_id后重试。 400 DRIS.00290001 The TrafficController TrafficControllerId already exists. 信号机设备已存在 请更换traffic_controller_id后重试。 400 DRIS.00340002 The file not found! 文件不存在 请确认对应file_id的文件是否已经导入到平台。 400 DRIS.00340003 The file has imported! 文件中的设备已经创建 请更换文件后重试。 400 DRIS.00350004 The linkAssetRelation file not found! 该file_id对应的路段设备关系文件不存在 请确认对应file_id的文件是否已经导入到平台后重试。 401 DRIS.00000004 Token is invalid. token不合法 请排查请求中的token是否正确或是否过期。 401 DRIS.00000007 Resource unauthorized. The instance does not belong to this authorized user. 资源未授权 请确认是否已开通资源。 401 DRIS.00000010 Resource unauthorized. URL's project id doesn't match token. 资源访问受限 请检查携带的token是否有权限访问url中指定project_id的项目。 403 DRIS.00000005 Resource limit reached. 请求的资源配额已达上限 请联系华为工程师分析解决。 403 DRIS.00000006 Resource is frozen. 资源已被冻结 请联系华为工程师分析解决。 403 DRIS.00000009 Operation not allowed. The user does not have the permission of this API. 无权访问此API 请联系华为工程师确认用户的权限策略。 403 DRIS.00010004 Rsu resource reach limit. RSU可关联的Edge数量达上限 请参考修改一个RSU资源调整RSU可关联的Edge数量。 403 DRIS.00020004 Traffic event resource reach limit. 交通事件数量达上限 请删除一些交通事件后重试。 403 DRIS.00031005 Simulation task is running! 仿真任务正在执行中 请在任务执行完成后再操作。 403 DRIS.00031006 Simulation task lack scenes! 仿真任务缺少任务应用场景 请根据任务类型补全对应场景。 403 DRIS.00130001 Request forbidden. The system app $edgetepa must be deployed first. 部署边缘应用失败 请先部署边缘系统应用。 403 DRIS.00130005 The EdgeApp cannot be deleted because it has associated DataChannels. 删除边缘应用失败 Edge设备的业务通道存在时无法直接删除边缘应用，请先删除业务通道后重试。 403 DRIS.00150001 Max configurations (10) exceeded. 租户数据转发配置资源（Kafka）数量达上限 请删除未使用的数据转发配置后重试。 403 DRIS.00150002 The broker in your request already exists. Check your Kafka configurations. 数据转发配置中的broker地址已经存在 请更换broker地址及用户名密码后重试。 403 DRIS.00190001 The algorithm model for this function of this road network already exists. 算法模型已经存在 请确认对应road_network_id和model_function的算法模型是否已经添加到平台。 403 DRIS.00190002 The algorithm model of this version is in use. 指定版本的算法模型已经在使用中 请确认此版本的算法模型处于非使用状态后重试 403 DRIS.00200002 Forbidden to operate instance. 禁止操作dris实例 请联系华为工程师分析解决。 403 DRIS.00280003 Vehicle resource reach limit. 车辆数量达上限 请联系华为工程师分析解决。 403 DRIS.00290003 TrafficController resource reach limit. 信号机设备数量达上限 请联系华为工程师分析解决。 403 DRIS.00350001 The number of devices of the same data type on one link exceeds the limit! 该路段下同种数据类型的绑定设备数量超过限制 请先解绑该路段下对应数据类型的已绑定设备后重试。 403 DRIS.00350002 The total number of linkAssetRelation exceeds the limit! 绑定路段设备关系总数超过限制 请先解绑部分未使用的路段设备关系后重试。 403 DRIS.00350003 The linkAssetRelation not bound! 该路段设备关系未绑定 请确认当前输入的link_id,esn,data_type对应的路段设备关系已绑定。 403 DRIS.00350005 The number of subTasks in the file exceeds limit 该文件下对应的子任务数量超过限制 请减少文件中的待操作的数据条数以符合限制后重试。 403 DRIS.00350006 The linkAssetRelation task is running! 已有路段设备任务正在执行 请在当前任务完成后再重试。 404 DRIS.00000011 Resource not found. 资源不存在 请确认是否已开通资源。 404 DRIS.00010002 The RSU not found. RSU不存在 请确认对应的rsu_id或esn是否已经在平台创建RSU。 404 DRIS.00010003 Rsu model not found. RSU型号不存在 请确认对应的rsu_model_id是否已经在平台创建RSU型号。 404 DRIS.00020001 This traffic event is not found. 交通事件不存在 请确认对应的event_id是否已经在平台创建交通事件。 404 DRIS.00040001 Area config not found. 区域配置不存在 请确认对应的area_code是否已经在平台添加区域配置。 404 DRIS.00080001 Rule config not found 交通事件规则配置不存在 请确认对应的event_type或position_id是否已经在平台新增规则。 404 DRIS.00090001 Edge not found. Edge设备不存在 请确认对应的v2x_edge_id是否已经在平台创建Edge设备。 404 DRIS.00100002 The EdgeApp not found. Edge App不存在 请确认对应的edge_app_id是否已经在平台创建Edge App。 404 DRIS.00100004 The EdgeAppVersion not found. Edge App版本不存在 请确认对应的version是否已经在平台创建Edge App版本。 404 DRIS.00120001 This camera does not exist. IPC设备不存在 请确认对应camera_id的IPC设备是否已经添加到平台。 404 DRIS.00130002 The V2XEdgeApp not found 边缘应用不存在 请确认对应v2x_edge_id和edge_app_id的边缘应用是否已经部署。 404 DRIS.00130004 DataChannel not found 业务通道不存在 请确认指定Edge设备（v2x_edge_id）是否已经在平台创建业务通道 404 DRIS.00150003 Kafka config not found 数据转发配置资源（Kafka）不存在 请确认对应的forwarding_config_id是否已经在平台创建数据转发配置。 404 DRIS.00170001 Not Found. 地图区间不存在 请确认地图区间是否已经在平台添加。 404 DRIS.00180001 Not Found. 资源不存在 请确认是否已开通资源。 404 DRIS.00190003 The algorithm model not found. 算法模型不存在 请确认对应model_id的算法模型是否已经添加到平台。 404 DRIS.00210000 The license file does not exist and cannot be updated. License文件不存在 请确认携带的lsn是否正确。 404 DRIS.00210004 ESN not found. license esn不存在 请联系华为工程师分析解决。 404 DRIS.00220001 The file not found. 文件不存在 请联系华为工程师分析解决。 404 DRIS.00230001 The interaction not found. 对接系统不存在 请确认对应interaction_id的对应系统是否已经在平台配置。 404 DRIS.00240001 The ITS asset not found. 交通设施不存在 请确认对应its_asset_id的交通设施是否已经在平台添加。 404 DRIS.00250001 Link not found. 路段不存在 请确认对应link_id的路段是否已经在平台添加。 404 DRIS.00260001 The Road network not found. 路网不存在 请确认对应road_network_id的路网是否已经在平台生成。 404 DRIS.00270001 The control strategy not found. 管控策略不存在 请确认对应strategy_id的管控策略是否已经在平台下发。 404 DRIS.00280002 The Vehicle not found. 车辆不存在 请确认对应vehicle_id的车辆资源是否已经在平台创建。 404 DRIS.00290002 The TrafficController not found. 信号机设备不存在 请确认对应traffic_controller_id的信号机设备是否已经在平台创建。 404 DRIS.00300001 The datasource not found. 数据源不存在 请检查data_source_id是否正确。 404 DRIS.00310001 The simulation task not found! 仿真任务不存在 请确认对应task_id的仿真任务是否已经在平台创建。 404 DRIS.00320001 The common scene not found! 仿真任务普通场景不存在 请确认对应task_id和common_id的普通场景仿真任务是否已经在平台创建。 404 DRIS.00320002 The accident scene not found! 仿真任务事故场景不存在 请确认对应task_id和accident_id的事故场景仿真任务是否已经在平台创建。 404 DRIS.00320003 The construction scene not found! 仿真任务施工场景不存在 请确认对应task_id和construction_id的施工场景仿真任务是否已经在平台创建。 404 DRIS.00320004 The common speed-limit scene not found! 仿真任务限速场景不存在 请确认对应task_id和speed_limit_id的限速场景仿真任务是否已经在平台创建。 404 DRIS.00320005 The common flow-control scene not found! 仿真任务匝道流控场景不存在 请确认对应task_id和flow_control_id的匝道流控场景仿真任务是否已经在平台创建。 404 DRIS.00320006 The emergency-lan-open scene not found! 仿真任务开放应急车道场景不存在 请确认对应task_id和emergency_lan_open_id的开放应急车道场景仿真任务是否已经在平台创建。 404 DRIS.00330001 The statistics result not found! 仿真任务的统计结果不存在 请检查任务是否已经执行成功。 404 DRIS.00330002 The detector result not found! 仿真任务的检测器结果不存在 请检查任务是否已经执行成功且检测器已经存在。 404 DRIS.00340001 The task not found! 任务不存在 请确认对应task_id的任务是否已经在平台创建。 404 DRIS.00350007 The linkAssetRelation task not found! 该task_id对应的路段设备关系任务不存在 请确认对应task_id的路段设备关系任务是否已经在平台创建。 405 DRIS.00000003 Method not allowed. Http request method not supported, just supports: %s Http Method不合法 请排查Http Method是否与文档一致。 429 DRIS.00000008 Request reached the maximum rate limit %s. 请求被流控 请在流控范围内请求接口。 500 DRIS.00000001 Internal server error. %s 服务器内部错误 请联系华为工程师分析解决。 500 DRIS.00200001 Instance create failed. %s 创建dris实例失败 请联系华为工程师分析解决。 500 DRIS.00200003 Create vpc endpoint failed. 创建vpcep失败 请联系华为工程师分析解决。 500 DRIS.00200004 Create iotda out channel failed. 创建IoTDA的网络通道失败 请联系华为工程师分析解决。 500 DRIS.00210002 Update device limit failed. 更新设备数上限配置时发生错误 请联系华为工程师分析解决。 500 DRIS.00210005 Get key file content failed. 获取license key文件失败 请联系华为工程师分析解决。 500 DRIS.00210006 Get revoke code failed. 更新license为失败状态时获取失效码失败 请联系华为工程师分析解决。 500 DRIS.00210007 Parse license failed. license解析失败 请联系华为工程师分析解决。

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

响应示例 状态码： 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" } ]}