华为云用户手册

请求示例 POST https://{endpoint}/v1/{project_id}/immediate-event Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "send_config" : { "channel" : { "by_lte_pc5" : false, "by_lte_uu" : false }, "target_list" : { "target_rsu_ids" : [ "rsu0123456789" ], "target_obu_ids" : [ "obu0123456789" ] } }, "immediate_event" : { "time_stamp" : "2015-12-12T12:12:12.356Z", "event_class" : "traffic sign", "event_type" : 39, "event_source" : "internet", "event_source_id" : 123456789, "event_confidence" : 100, "event_position" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "event_radius" : 1000, "event_description" : 123456789, "event_priority" : 3, "coordinate" : "WGS84", "reference_paths" : [ { "active_path" : [ { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, { "lat" : 50.1234567, "lon" : 136.1234567, "ele" : 1000 } ], "path_radius" : 1000 } ] } }

Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "rsi_source" : { "rsi_source_type" : "rsu", "rsi_source_id" : "RSU0123456789", "esn" : "2102312ETX10K7000037" }, "rtss" : [ { "rts_id" : 100, "sign_type" : 1, "cross_id" : "cross0123456789", "sign_position" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "sign_description" : "string", "time_details" : { "start_time" : 666, "end_time" : 666, "end_time_confidence" : 10 }, "sign_priority" : 5, "reference_paths" : [ { "active_path" : [ { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 } ], "path_radius" : 100 } ], "reference_links" : [ { "up_stream_node_id" : { "region" : 100, "node_id" : 100 }, "down_stream_node_id" : { "region" : 100, "node_id" : 100 }, "reference_lane" : { "reserve0" : false, "lane1" : false, "lane2" : false, "lane3" : false, "lane4" : false, "lane5" : false, "lane6" : false, "lane7" : false, "lane8" : false, "lane9" : false, "lane10" : false, "lane11" : false, "lane12" : false, "lane13" : false, "lane14" : false, "lane15" : false } } ] } ], "rtes" : [ { "rte_id" : 100, "cross_id" : "cross0123456789", "event_type" : 100, "event_source" : "rsu", "event_position" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "event_radius" : 100, "event_description" : "string", "time_details" : { "start_time" : 666, "end_time" : 666, "end_time_confidence" : 10 }, "event_priority" : 5, "reference_paths" : [ { "active_path" : [ { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 } ], "path_radius" : 100 } ], "reference_links" : [ { "up_stream_node_id" : { "region" : 100, "node_id" : 100 }, "down_stream_node_id" : { "region" : 100, "node_id" : 100 }, "reference_lane" : { "reserve0" : false, "lane1" : false, "lane2" : false, "lane3" : false, "lane4" : false, "lane5" : false, "lane6" : false, "lane7" : false, "lane8" : false, "lane9" : false, "lane10" : false, "lane11" : false, "lane12" : false, "lane13" : false, "lane14" : false, "lane15" : false } } ], "event_confidence" : 100, "event_ex_info" : { "participants" : [ { "ptc_type" : "unknown", "plate_no" : "粤B1234567", "speed" : 110, "vehicle_class" : 54, "gat_vehicle_class" : "K33", "track_id" : 100, "lane_no" : 1, "start_time" : 1664507548437 } ], "congestion_info" : { "level" : 0, "length" : 200, "speed" : 10, "start_time" : 1664507548437, "start_point" : { "lat" : 22.12345, "lon" : 114.12345, "ele" : 110.12345 }, "end_point" : { "lat" : 22.12345, "lon" : 114.12345, "ele" : 110.12345 }, "congestion_lanes_info" : [ { "laneid" : 1, "level" : 0, "length" : 200, "speed" : 10, "start_time" : 1664507548437, "start_point" : { "lat" : 22.12345, "lon" : 114.12345, "ele" : 110.12345 }, "end_point" : { "lat" : 22.12345, "lon" : 114.12345, "ele" : 110.12345 } } ] }, "data_source" : { "radar" : [ 1 ], "camera" : [ 1 ] }, "camera_list" : [ { "id" : 0, "ip" : "127.0.0.1" } ] } } ] } }

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 body 是 OpenV2XRSITopicBodyDTO object 参数说明：即时事件消息。来源于边缘感知计算单元分析生成的即时事件。 header 是 OpenRSITopicHeaderDTO object 参数说明：路侧交通消息的附加描述。 表2 OpenV2XRSITopicBodyDTO 参数 是否必选 参数类型 描述 rsi_source 否 RSISource object 参数说明：消息来源。 time_stamp 否 String 参数说明：采集数据的UTC时间。格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'，如2021-12-18T07:20:51.683Z。rsu上报的rsi不推送该字段。 最小长度：0 最大长度：63 rtss 否 Array of RTSData objects 参数说明：道路交通标志。 数组长度：1 - 16 rtes 否 Array of RTEData objects 参数说明：道路交通事件。 数组长度：1 - 8 表3 RSISource 参数 是否必选 参数类型 描述 rsi_source_type 是 String 参数说明：来源的具体类型描述。 取值范围： rsu：RSU上报数据 obu：车载终端上报数据 detection：检测器检测到的数据 v2xServer：平台上报数据 internet：互联网数据 meteorological：气象数据 government：政府数据 police：警方数据 unknown：未知数据 camera：摄像头 sne: sne上报 枚举值： rsu obu detection v2xServer internet meteorological government police unknown camera sne rsi_source_id 否 String 参数说明：信息来源的唯一标识码ID。 最小长度：1 最大长度：255 esn 是 String 参数说明：设备编码。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 表4 RTSData 参数 是否必选 参数类型 描述 rts_id 是 Integer 参数说明：RTS的本地id。 最小值：0 最大值：255 sign_type 是 Integer 参数说明：道路交通标志类型，参考国标GB 5768.2-2009。 最小值：1 最大值：520 cross_id 否 String 参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 最小长度：0 最大长度：64 sign_position 否 Position3D object 参数说明：位置信息。 sign_description 否 String 参数说明：道路交通标志的附加说明。 最小长度：0 最大长度：255 time_details 否 RSITimeDetails object 参数说明：定义道路交通事件和道路交通标志信息的生效时间属性。 sign_priority 否 Integer 参数说明：道路交通标志紧急程度。数字越大，级别越高。 最小值：0 最大值：7 reference_paths 否 Array of ReferencePath objects 参数说明：道路交通事件的关联路径。 数组长度：1 - 8 reference_links 否 Array of ReferenceLink objects 参数说明：道路交通事件的关联路段集合。 数组长度：1 - 16 表5 RTEData 参数 是否必选 参数类型 描述 event_id 否 String 参数说明：唯一的事件标识ID。 最小长度：0 最大长度：36 rte_id 是 Integer 参数说明：道路交通事件的本地id。 最小值：0 最大值：255 cross_id 否 String 参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 最小长度：0 最大长度：64 event_type 是 Integer 参数说明：GB/T 29100-2012定义的事件类型。 最小值：0 最大值：65535 event_source 是 String 参数说明：来源的具体类型描述。 取值范围： rsu：RSU上报数据 obu：车载终端上报数据 detection：检测器检测到的数据 v2xServer：平台上报数据 internet：互联网数据 meteorological：气象数据 government：政府数据 police：警方数据 unknown：未知数据 camera：摄像头 -sne: sne上报 枚举值： rsu obu detection v2xServer internet meteorological government police unknown camera sne event_position 否 Position3D object 参数说明：位置信息。 event_radius 否 Integer 参数说明：事件半径，单位分米。 最小值：0 最大值：1000 event_description 否 String 参数说明：道路交通事件的描述信息。 最小长度：0 最大长度：255 time_details 否 RSITimeDetails object 参数说明：定义道路交通事件和道路交通标志信息的生效时间属性。 event_priority 否 Integer 参数说明：道路交通事件的紧急程度。数字越大，级别越高。 最小值：0 最大值：7 reference_paths 否 Array of ReferencePath objects 参数说明：道路交通事件的关联路径。 数组长度：1 - 8 reference_links 否 Array of ReferenceLink objects 参数说明：道路交通事件的关联路段集合。 数组长度：1 - 16 event_confidence 否 Integer 参数说明：道路交通事件的信息来源提供的事件置信度水平，帮助接收端判断是否相信该事件信息，单位为0.5%。 最小值：0 最大值：200 event_ex_info 否 EdgeEventExInfo object 参数说明：交通事件扩展信息。 表6 Position3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表7 RSITimeDetails 参数 是否必选 参数类型 描述 start_time 否 Integer 参数说明：数值用来表示当前年份，已经过去的总分钟数（UTC时间）。 最小值：0 最大值：527040 end_time 否 Integer 参数说明：数值用来表示当前年份，已经过去的总分钟数（UTC时间）。 最小值：0 最大值：527040 end_time_confidence 否 Integer 参数说明：数值描述了95%置信水平的结束时间置信度。该精度理论上只考虑了当前计时系统本身传感器的误差。参考 时间精度参数说明。 最小值：0 最大值：39 表8 ReferencePath 参数 是否必选 参数类型 描述 active_path 是 Array of Position3D objects 参数说明：与当前情况关联的有效点集。 数组长度：1 - 8 path_radius 否 Integer 参数说明：单位为0.1米。用半径表示影响区域边界离中心线的垂直距离，反映该区域的宽度以覆盖实际路段。 最小值：0 最大值：200 表9 ReferenceLink 参数 是否必选 参数类型 描述 up_stream_node_id 是 NodeReferenceID object 参数说明：节点ID是由一个全局唯一的地区ID和一个地区内部唯一的节点ID组成。 down_stream_node_id 是 NodeReferenceID object 参数说明：节点ID是由一个全局唯一的地区ID和一个地区内部唯一的节点ID组成。 reference_lane 否 ReferenceLanes object 参数说明：关联车道,将指定车道号对应的比特位置1表示该车道为有效的关联车道。最多支持15条车道。车道号，以该车道行驶方向为参考，自左向右从 1 开始编号。 表10 NodeReferenceID 参数 是否必选 参数类型 描述 region 是 Integer 参数说明：所在区域的编号,数值 0 仅用于测试。 最小值：0 最大值：65535 node_id 是 Integer 参数说明：节点编号，路网最基本的构成即节点和节点之间连接的路段。节点可以是路口，也可以是一条 路的端点。一个节点的ID在同一个区域内是唯一的。数值 0~255 预留为测试使用。 最小值：0 最大值：65535 表11 ReferenceLanes 参数 是否必选 参数类型 描述 reserve0 否 Boolean 参数说明：保留参数。 缺省值：false lane1 否 Boolean 参数说明：左侧第1车道。 缺省值：false lane2 否 Boolean 参数说明：左侧第2车道。 缺省值：false lane3 否 Boolean 参数说明：左侧第3车道。 缺省值：false lane4 否 Boolean 参数说明：左侧第4车道。 缺省值：false lane5 否 Boolean 参数说明：左侧第5车道。 缺省值：false lane6 否 Boolean 参数说明：左侧第6车道。 缺省值：false lane7 否 Boolean 参数说明：左侧第7车道。 缺省值：false lane8 否 Boolean 参数说明：左侧第8车道。 缺省值：false lane9 否 Boolean 参数说明：左侧第9车道。 缺省值：false lane10 否 Boolean 参数说明：左侧第10车道。 缺省值：false lane11 否 Boolean 参数说明：左侧第11车道。 缺省值：false lane12 否 Boolean 参数说明：左侧第12车道。 缺省值：false lane13 否 Boolean 参数说明：左侧第13车道。 缺省值：false lane14 否 Boolean 参数说明：左侧第14车道。 缺省值：false lane15 否 Boolean 参数说明：左侧第15车道。 缺省值：false 表12 EdgeEventExInfo 参数 是否必选 参数类型 描述 camera_list 否 Array of EdgeCameraInfo objects 拍摄到事件的摄像头信息； 数组长度：0 - 10 participants 否 Array of EdgeEventParticipant objects 识别出交通事件时所对应的交通参与者 数组长度：0 - 20 congestion_info 否 EdgeCongestionInfo object 拥堵事件时，携带的信息 data_source 否 EdgeDataSourceInfo object 数据来源 表13 EdgeCameraInfo 参数 是否必选 参数类型 描述 id 否 Integer SNE的摄像头id,编号从0开始 最小值：0 最大值：128 ip 否 String 摄像头ip 最小长度：0 最大长度：15 表14 EdgeEventParticipant 参数 是否必选 参数类型 描述 ptc_type 否 String 交通参与者的具体类型描述，枚举 枚举值： unknown motor non-motor pedestrian plate_no 否 String 参数说明：车牌号 取值范围：长度不超过10，大写字母、数字、中文、阿拉伯文的组合。 speed 否 Integer 对应车辆被检测到超速或者慢行时的速度小。单位为0.02米每秒。值为8191时代表无效数值。 最小值：0 最大值：8191 vehicle_class 否 Integer 车辆类型，参考RSM中的车辆类型定义 最小值：0 最大值：255 track_id 否 Long 感知设备识别的id，具体表示为机动车轨迹ID 最小值：0 最大值：9223372036854775807 lane_no 否 Integer 参数说明: 车辆所处车道。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。 最小值：-32 最大值：32 gat_vehicle_class 否 String 参数说明: 国标车辆类型，参考国标 target_rects 否 Array of TargetRect objects 参数说明：目标检测框信息列表。 数组长度：0 - 10 start_time 否 Long 参数说明: 本次事件中，车辆检测到事件行为的最初时间；格式：1970开始的毫秒时间。 最小值：0 最大值：9223372036854775807 表15 TargetRect 参数 是否必选 参数类型 描述 camera_code 否 String 参数说明：摄像头编码。 最小长度：0 最大长度：32 camera_ip 否 String 参数说明：摄像头IP地址。 最小长度：0 最大长度：32 target_pos 否 TargetPos object 参数说明：目标检测框万分比坐标。 time_stamp_diff 否 Long 参数说明：与SnapTime的时间差值：当前检测框所在相机的时间戳减去雷视拟合轨迹中的SnapTime的差值。 表16 TargetPos 参数 是否必选 参数类型 描述 left_top_x 否 Long 参数说明：目标区域框左上X坐标。 最小值：0 最大值：2147483647 left_top_y 否 Long 参数说明：目标区域框左上Y坐标。 最小值：0 最大值：2147483647 right_bottom_x 否 Long 参数说明：目标区域框右下X坐标。 最小值：0 最大值：2147483647 right_bottom_y 否 Long 参数说明：目标区域框右下Y坐标。 最小值：0 最大值：2147483647 表17 EdgeCongestionInfo 参数 是否必选 参数类型 描述 level 否 Integer 拥堵级别， 1：拥堵级别低，速度[25, 30) 单位：km/h， 2：拥堵级别中，速度[15，25) 单位：km/h， 3：拥堵级别高，速度[0, 15) 单位：km/h 最小值：0 最大值：3 length 否 Integer 拥堵长度，单位：m 最小值：0 最大值：1000 speed 否 Double 参数说明：拥堵路段平均车速，单位：km/h。 最小值：0 最大值：250 start_time 否 Long 参数说明：拥堵开始时间；格式：1970开始的毫秒时间 最小值：0 最大值：9223372036854775807 start_point 否 ReportedPosition3D object 拥堵的起点经纬度 end_point 否 ReportedPosition3D object 拥堵的终点经纬度 congestion_lanes_info 否 Array of CongestionLanesInfo objects 参数说明：车道拥堵信息。 数组长度：0 - 100 表18 CongestionLanesInfo 参数 是否必选 参数类型 描述 laneid 否 Integer 参数说明：车辆所处车道。对于桩号递增的道路方向，其车道号为正数。对于桩号递减的道路方向，其车道号为负数。按照行驶方向，从左到右，从1开始编号。 最小值：-32 最大值：32 level 否 Integer 参数说明：拥堵级别。 取值范围： 1：拥堵级别低，速度[25, 30) 单位：km/h 2：拥堵级别中，速度[15，25) 单位：km/h 3：拥堵级别高，速度[0, 15) 单位：km/h 最小值：0 最大值：3 length 否 Integer 参数说明：拥堵长度，单位为米（m）。 最小值：0 最大值：1000 speed 否 Double 参数说明：拥堵车道平均车速，单位：km/h。 最小值：0 最大值：250 start_time 否 Long 参数说明：拥堵开始时间；格式：1970开始的毫秒时间 最小值：0 最大值：9223372036854775807 start_point 否 ReportedPosition3D object 参数说明：拥堵的起点经纬度。 end_point 否 ReportedPosition3D object 参数说明：拥堵的终点经纬度。 表19 ReportedPosition3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表20 EdgeDataSourceInfo 参数 是否必选 参数类型 描述 radar 否 Array of integers 雷达id 最小值：0 最大值：2147483647 数组长度：0 - 4 camera 否 Array of integers 摄像头id 最小值：0 最大值：2147483647 数组长度：0 - 4 表21 OpenRSITopicHeaderDTO 参数 是否必选 参数类型 描述 instance_id 是 String 参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 event 是 String 参数说明：操作描述。" 取值范围： MODIFIED：修改 ADDED：新增 DELETED：删除 枚举值： MODIFIED ADDED DELETED

响应示例 状态码： 200 Created { "edge_app_id" : "10689817309939082523811187758968", "version" : "1.0.2", "description" : "this is a test", "created_time" : "2020-05-28T11:31:29.740Z", "last_modified_time" : "2020-05-28T11:31:29.740Z", "state" : "DRAFT", "command" : null, "args" : null, "container_settings" : null, "publish_time" : null, "off_shelf_time" : null }

请求示例 POST https://{endpoint}/v1/{project_id}/v2x-edge-apps/{edge_app_id}/versions Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "args" : [ "args" ], "description" : "description", "version" : "1.0.11", "command" : [ "start" ], "container_settings" : { "configs" : { "privileged" : false, "host_network" : true, "restart_policy" : "Always", "container_port_list" : [ { "container_port" : 8082, "host_ip" : "127.0.0.1", "host_port" : 8083 } ] }, "image_url" : "www.baidu.com", "volumes" : [ { "read_only" : true, "name" : "config", "destination" : "destination_1", "source" : "/opt/host/iot", "type" : " LOG " } ], "envs" : { "test" : "test" }, "resources" : { "requests" : { "npu" : 4, "memory" : 2, "cpu" : 1, "gpu" : 3 }, "limits" : { "npu" : 9, "memory" : 7, "cpu" : 6, "gpu" : 8 } }, "ext_devices" : [ { "destination" : "/destination", "cgroup_permissions" : "MRW", "source" : "/source" } ] } }

响应参数 状态码： 200 表11 响应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 表12 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 表13 ContainerConfigsDTO 参数 参数类型 描述 privileged Boolean 参数说明：开启容器特权模式。 缺省值：false host_network Boolean 参数说明：是否使用主机网络模式。 缺省值：true restart_policy String 参数说明：重启策略，容器执行健康检查后失败后的策略。 最小长度：1 最大长度：255 container_port_list Array of ContainerPortDTO objects 参数说明：容器端口映射值。 数组长度：0 - 1000000 表14 ContainerPortDTO 参数 参数类型 描述 container_port Integer 参数说明：构成一堆映射的容器端口。 最小值：1 最大值：65535 host_port Integer 参数说明：构成一对映射的物理机对应网卡端口。 最小值：1 最大值：65535 host_ip String 参数说明：对应网卡地址。 表15 VolumeDTO 参数 参数类型 描述 name String 参数说明：卷名称。 最小长度：1 最大长度：63 type String 参数说明：挂载类型。 source String 参数说明：源路径。 最小长度：1 最大长度：255 destination String 参数说明：卷挂载路径。 最小长度：1 最大长度：255 read_only Boolean 参数说明：只读，默认只读。 表16 ResourceDTO 参数 参数类型 描述 limits ResourceConfigDTO object 参数说明：允许容器使用的最大资源。 requests ResourceConfigDTO object 参数说明：容器需要使用的最小资源。 表17 ResourceConfigDTO 参数 参数类型 描述 cpu Float 参数说明：cpu个数。 最小值：0.01 最大值：1000 memory Float 参数说明：内存大小。 最小值：0.01 最大值：1024000 gpu Float 参数说明：gpu个数。 最小值：0.01 最大值：1024000 npu Float 参数说明：npu个数。 最小值：0.01 最大值：1000 表18 ExtDevice 参数 参数类型 描述 source String 参数说明：源路径。 最小长度：1 最大长度：255 destination String 参数说明：卷挂载路径。 最小长度：1 最大长度：255 cgroup_permissions String 参数说明：只读，默认MRW。

响应示例 状态码： 200 OK { "count" : 1, "events" : [ { "event_id" : 11111, "event_source_type" : "RSU", "event_source_id" : 2, "esn" : "2102312ETX10K7000037", "area_code" : 568, "event_class" : "AbnormalTraffic", "event_type" : 100, "cross_id" : 1111, "event_description" : "交通事故", "event_level" : 1, "event_params" : { "speed" : "60" }, "event_position" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "event_position_name" : "深圳深南大道", "reference_paths" : [ { "active_path" : [ { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 } ], "path_radius" : 100 } ], "note" : "交通事件信息", "event_status" : "Invalid", "event_confidence" : 1, "event_ex_info" : { "participants" : [ { "ptc_type" : "unknown", "plate_no" : "粤B12345", "speed" : 3000, "vehicle_class" : 54, "gat_vehicle_class" : "k33", "track_id" : 123456789, "lane_no" : 1, "target_rects" : [ { "camera_code" : "abcd", "camera_ip" : "127.0.0.1", "target_pos" : [ { "left_top_x" : 10, "left_top_y" : 10, "right_bottom_x" : 5, "right_bottom_y" : 5 } ], "time_stamp_diff" : 1664507548437 } ], "start_time" : 1664507548437 } ], "congestion_info" : { "level" : 0, "length" : 200, "start_point" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "end_point" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "speed" : 10, "start_time" : 1664507548437, "congestion_lanes_info" : [ { "laneid" : 1, "level" : 0, "length" : 200, "speed" : 10, "start_time" : 1664507548437, "start_point" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "end_point" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 } } ] }, "data_source" : { "radar" : [ 0 ], "camera" : [ 1 ] }, "camera_list" : [ { "id" : 0, "ip" : "127.0.0.1" } ] }, "rsu_id" : [ "b58efc27-a6e5-4bca-9d12-c76ecfe3f102" ], "start_time" : "2019-08-28T16:32:24Z", "end_time" : "2019-08-28T16:32:24Z" } ] }

请求示例 GET https://{endpoint}/v1/{project_id}/history-traffic-events?limit={limit}&offset={offset}&from_date={from_date}&to_date={to_date}&event_class={event_class}&event_type={event_type}&event_source={event_source}&event_id={event_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:********

响应示例 状态码： 200 OK { "count" : 1, "apps" : [ { "v2x_edge_id" : "74297d76-6f99-4fe2-a435-1e27a524e4c8", "edge_app_id" : "test-app", "app_version" : "1.0.0", "status" : "RUNNING" } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：满足查询条件的记录数。 最小值：0 最大值：10000 apps Array of V2XEdgeAppResponseDTO objects 参数说明：已部署的边缘应用列表。 数组长度：0 - 20 表5 V2XEdgeAppResponseDTO 参数 参数类型 描述 v2x_edge_id String 参数说明：Edge ID，用于唯一标识一个Edge。 最小长度：0 最大长度：255 edge_app_id String 参数说明：用户自定义应用唯一ID。 最小长度：1 最大长度：32 app_version String 参数说明：应用版本，比如1.0.0。 最小长度：1 最大长度：64 status String 参数说明：应用部署状态。 取值范围： UNINSTALLED：待部署 INSTALLED：部署中 OFFLINE：离线 ONLINE：在线 UPGRADING：升级中 DELETING：删除中 RUNNING：运行中

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

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

请求示例 PUT https://{endpoints}/v1/{project_id}/traffic-events/{event_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "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", "coordinate" : "WGS84" }

响应示例 状态码： 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 }, { "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", "coordinate" : "WGS84" }

响应示例 状态码： 200 OK { "count" : 1, "events" : [ { "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", "event_confidence" : 100, "coordinate" : "WGS84", "created_time" : "2021-12-23T08:32:51.618Z", "last_modified_time" : "2021-12-23T08:32:51.618Z" } ] }

请求示例 GET https://{endpoint}/v1/{project_id}/traffic-events?limit={limit}&status={status}&area_code={area_code}&offset={offset}&event_type={event_type}&event_source_type={event_source_type}&event_class={event_class}&event_id={event_id}&from_time={from_time}&to_time={to_time}&sort_key={sort_key}&sort_dir={sort_dir} Content-Type:application/json X-Auth-Token:******** Instance-Id:********

请求示例 PUT https://{endpoint}/v1/{project_id}/v2x-edge-apps/{edge_app_id}/versions/{version} Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "description" : "this is a test app version", "container_settings" : { "configs" : { "privileged" : false, "host_network" : true, "restart_policy" : "Never" }, "image_url" : "xxx.com/huawei/edge:1.0.0", "volumes" : [ { "name" : "newconfig", "destination" : "newDestination", "source" : "/user" } ] } }

响应示例 状态码： 200 OK { "edge_app_id" : "12617852507412065303014562034843", "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" : null, "args" : null, "container_settings" : null, "publish_time" : null, "off_shelf_time" : "2020-05-28T11:31:29.740Z" }

响应参数 状态码： 200 表11 响应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 表12 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 表13 ContainerConfigsDTO 参数 参数类型 描述 privileged Boolean 参数说明：开启容器特权模式。 缺省值：false host_network Boolean 参数说明：是否使用主机网络模式。 缺省值：true restart_policy String 参数说明：重启策略，容器执行健康检查后失败后的策略。 最小长度：1 最大长度：255 container_port_list Array of ContainerPortDTO objects 参数说明：容器端口映射值。 数组长度：0 - 1000000 表14 ContainerPortDTO 参数 参数类型 描述 container_port Integer 参数说明：构成一堆映射的容器端口。 最小值：1 最大值：65535 host_port Integer 参数说明：构成一对映射的物理机对应网卡端口。 最小值：1 最大值：65535 host_ip String 参数说明：对应网卡地址。 表15 VolumeDTO 参数 参数类型 描述 name String 参数说明：卷名称。 最小长度：1 最大长度：63 type String 参数说明：挂载类型。 source String 参数说明：源路径。 最小长度：1 最大长度：255 destination String 参数说明：卷挂载路径。 最小长度：1 最大长度：255 read_only Boolean 参数说明：只读，默认只读。 表16 ResourceDTO 参数 参数类型 描述 limits ResourceConfigDTO object 参数说明：允许容器使用的最大资源。 requests ResourceConfigDTO object 参数说明：容器需要使用的最小资源。 表17 ResourceConfigDTO 参数 参数类型 描述 cpu Float 参数说明：cpu个数。 最小值：0.01 最大值：1000 memory Float 参数说明：内存大小。 最小值：0.01 最大值：1024000 gpu Float 参数说明：gpu个数。 最小值：0.01 最大值：1024000 npu Float 参数说明：npu个数。 最小值：0.01 最大值：1000 表18 ExtDevice 参数 参数类型 描述 source String 参数说明：源路径。 最小长度：1 最大长度：255 destination String 参数说明：卷挂载路径。 最小长度：1 最大长度：255 cgroup_permissions String 参数说明：只读，默认MRW。

响应示例 状态码： 200 OK { "count" : 1, "forwarding_configs" : [ { "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" } } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 参数说明：满足查询条件的记录总数。 最小值：0 最大值：10000 forwarding_configs Array of ForwardingConfig objects 参数说明：转发配置的列表。 数组长度：0 - 50 表5 ForwardingConfig 参数 参数类型 描述 forwarding_type String 参数说明：转发配置的类型。 取值范围：当前仅支持“kafka、mrskafka”。 kafka_config KafkaConfigResponseDTO object 参数说明：Kafka配置信息。 mrs_kafka_config MrsKafkaConfigResponseDTO object 参数说明：mrsKafka配置信息。 表6 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 表7 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

Topic定义 设备使用MQTT协议接入平台时，平台和设备通过Topic进行通信。 上行Topic：设备上报消息到平台。 下行Topic：设备接收平台下发的消息。 平台支持的topic列表如下： Topic Publisher(发布者) Subscriber(订阅者) 用途 v2x/v1/rsu/{esn}/bsm/up 设备 平台 RSU上报BSM消息 v2x/v1/rsu/{esn}/map/up 设备 平台 RSU上报MAP消息 v2x/v1/rsu/{esn}/rsi/up 设备 平台 RSU上报RSI消息 v2x/v1/rsu/{esn}/rsm/up 设备 平台 RSU上报RSM消息 v2x/v1/rsu/{esn}/spat/up 设备 平台 RSU上报SPAT消息 oc/devices/{vehicle_id}/user/obu/bsm/up 设备 平台 OBU上报BSM v2x/v1/signalcontroller/{traffic_controller_id}/spat/up 设备 平台 信号机上报SPAT v2x/v1/rsu/{esn}/rsi/down 平台 设备 RSU接收RSI消息 v2x/v1/rsu/{esn}/spat/down 平台 设备 RSU接收SPAT消息 $oc/devices/{vehicle_id}/sys/messages/down 平台 设备 OBU接收RSI 父主题： 设备侧MQTT接口参考

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

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

响应示例 成功响应示例 { "total": 1, "count": 1, "tasks": [ { "task_id": "40axxxxx-701a-47cf-8b56-648xxxxxxx25", "status": "running", "result": {}, "error_detail": null } ] }

示例 请求示例 POST https://{endpoint}/v1/optverse/2dcut/regular-plate/tasks Request Header: Content-Type: application/json;charset=utf-8 Auth-Token: Body: { "items": [ { "item_id": 0, "item_material": "18MM_PLATE", "item_length": 60.0, "item_width": 553.0, "item_turn": true, "item_num": 1, "item_name": "底板", "item_thick": 18, "is_substitute": false, "label_info": { "order_code": "订单号", "plan_code": "批次号", "item_code": "小板标识" } }, { "item_id": 0, "item_material": "18MM_PLATE", "item_length": 60.0, "item_width": 553.0, "item_turn": true, "item_num": 1, "item_name": "底板", "item_thick": 18, "is_substitute": true, "label_info": { "order_code": "订单号", "plan_code": "批次号", "item_code": "小板标识" } } ], "parameters": [ { "calculate_time": 30, "first_cut_direction": 2, "item_backward_trim": 0.0, "item_forward_trim": 0.0, "kerf_horizontal": 4.4, "kerf_vertical": 4.4, "max_stack_height": 80, "plate_trim_horizontal": 10.0, "plate_trim_vertical": 10.0, "time_cost": 200, "max_cut_stage_num": 3, "min_stack_utilization": 0.8, "item_sort_location": false, "item_num_limit": 0 } ], "plates": [ { "plate_grain": true, "plate_id": 0, "plate_length": 2440.0, "plate_material": "18MM_PLATE", "plate_num": 9999, "plate_thick": 18.0, "plate_width": 1220.0, "plate_cost": 100 } ] } 成功响应示例 { "task_id": "40axxxx-701a-47cf-8b56-648xxxxxxd25" } 参数说明如表4所示。 表4 参数说明 参数 参数类型 说明 task_id String 任务ID 失败响应示例 { "error_code": "optverse.00000006", "error_msg": "Input data validate error: the item material is 18MM_PLATE, item_id is 0： Length and width are larger than plate.\n" }

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12M以内，12M以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

概述 天筹求解器服务(OptVerse)是一种基于华为云基础架构和平台的智能决策服务，以自研AI求解器为核心引擎，结合机器学习与深度学习技术，为企业提供生产计划与排程、切割优化、路径优化、库存优化等一系列有竞争力的行业解决方案。 OptVerse以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过实时访问和调用API获取推理结果，帮助用户自动采集关键数据，打造智能化业务系统，提升业务效率。 您可以使用本文档提供的天筹求解器服务API的描述、语法、参数说明及样例等内容，进行相关操作，例如天筹求解器服务包含的二维切割等具体接口使用说明。支持的全部操作请参见2 API概览。 在调用天筹求解器服务API之前，请确保已经充分了解运筹优化算法相关概念，详细信息请参见“产品介绍”。 父主题： 使用前必读

状态码 状态码如下所示。 状态码 编码 状态说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTPS的新版本协议。 200 OK 服务器已成功处理了请求。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 203 Non-Authoritative Information 非授权信息，请求成功。 204 No Content 请求完全成功，同时HTTP响应不包含响应体。 在响应OPTIONS方法的HTTP请求时返回此状态码。 205 Reset Content 重置内容，服务器处理成功。 206 Partial Content 服务器成功处理了部分GET请求。 300 Multiple Choices 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择。 301 Moved Permanently 永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。 302 Found 资源被临时移动。 303 See Other 查看其它地址，使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。 306 Unused 已经被废弃的HTTP状态码。 400 Bad Request 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 402 Payment Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 Not Found 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 Method Not Allowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Timeout 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。 返回该状态码，表明请求的资源已被永久删除。 411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。 412 Precondition Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 414 Request URI Too Long 请求的URI过长（URI通常为网址），服务器无法处理。 415 Unsupported Media Type 服I务器无法处理请求附带的媒体格式。 416 Requested Range Not Satisfiable 客户端请求的范围无效。 417 Expectation Failed 服务器无法满足Expect的请求头信息。 422 Unprocessable Entity 请求格式正确，但是由于含有语义错误，无法响应。 429 Too Many Requests 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部，然后等待该首部指出的时间后再重试。 500 Internal Server Error 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 Service Unavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 Gateway Timeout 请求在给定的时间内无法完成。客户端仅在为请求指定超时（Timeout）参数时会得到该响应。 505 HTTP Version Not Supported 服务器不支持请求的HTTPS协议的版本，无法完成处理。 父主题： 附录

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "cn-north-4", ...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg": "The format of message is error", "error_code": "AS.0001" } 其中，error_code表示错误码，error_msg表示错误描述信息。