华为云用户手册

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。

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

响应示例 状态码： 201 Created { "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" : "0123456789", "event_confidence" : 100, "event_position" : { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, "event_radius" : 1000, "event_description" : "0123456789", "event_priority" : 3, "reference_paths" : [ { "active_path" : [ { "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 1000 }, { "lat" : 50.1234567, "lon" : 136.1234567, "ele" : 1000 } ], "path_radius" : 1000 } ], "coordinate" : "WGS84" } }

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

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

响应参数 状态码： 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。

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

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

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

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

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

响应参数 状态码： 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 { "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" }

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

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之前，请确保已经充分了解运筹优化算法相关概念，详细信息请参见“产品介绍”。 父主题： 使用前必读