华为云用户手册

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：返回信号机设备的总体数量。 traffic_controller_devices Array of TrafficControllerDTO objects 参数说明：数据列表。 表5 TrafficControllerDTO 参数 参数类型 描述 traffic_controller_id String 参数说明：信号机设备ID，全局唯一。 esn String 参数说明：序列号。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 name String 参数说明：名称。 description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 lon Number 参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 ele Number 参数说明：定义海拔高程，可选，单位为分米。 pos_description String 参数说明：位置说明。 取值范围：长度不超过128，只允许字母、数字、以及_等字符的组合。 installation_mode String 参数说明：架设方式。 取值范围： columnar：柱式 road-side-attach：路侧附着式 cantilever：悬臂式 gantry：门架式 lane-above-attach：车行道上方附着式 road_name String 参数说明：所属道路名称，比如高速名称。 取值范围：长度不超过64，只允许汉字、字母、数字、以及_-等字符的组合。 link_id String 参数说明：信号机设备所属路段ID。 取值范围：长度等于30，只允许大写字母、数字。 status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 last_modified_time String 参数说明：最后修改的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_time String 参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 traffic_controller_id String 参数说明：信号机设备ID，全局唯一。 esn String 参数说明：序列号。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 name String 参数说明：名称。 description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 lon Number 参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 ele Number 参数说明：定义海拔高程，可选，单位为分米。 pos_description String 参数说明：位置说明。 取值范围：长度不超过128，只允许字母、数字、以及_等字符的组合。 installation_mode String 参数说明：架设方式。 取值范围： columnar：柱式 road-side-attach：路侧附着式 cantilever：悬臂式 gantry：门架式 lane-above-attach：车行道上方附着式 road_name String 参数说明：所属道路名称，比如高速名称。 取值范围：长度不超过64，只允许汉字、字母、数字、以及_-等字符的组合。 link_id String 参数说明：信号机设备所属路段ID。 取值范围：长度等于30，只允许大写字母、数字。 status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 last_modified_time String 参数说明：最后修改的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_time String 参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

响应示例 状态码： 200 OK { "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road2", "link_id" : "12345678", "status" : "INITIAL", "last_modified_time" : "2022-01-06T09:30:24Z", "created_time" : "2022-01-06T09:30:24Z", "last_online_time" : null }

请求示例 PUT https://{endpoint}/v1/{project_id}/traffic-controllers/{traffic_controller_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "name" : "TrafficController001", "description" : "test001", "lat" : 40.1234567, "lon" : 116.1234567, "ele" : 116.741, "pos_description" : "K08", "installation_mode" : "columnar", "road_name" : "road2", "link_id" : "12345678" }

响应示例 状态码： 200 OK { "count" : 1, "rsus" : [ { "rsu_id" : "b58efc27-a6e5-4bca-9d12-c76ecfe3f102", "name" : "RSU001", "description" : "TEST", "esn" : "13518098671442480164720973683901", "last_modified_time" : "2020-09-01T01:37:01Z", "created_time" : "2020-09-01T01:37:01Z", "last_online_time" : "2020-09-01T01:37:01Z", "ip" : "127.0.0.1", "position_description" : "K08", "location" : { "lat" : 40.1234567, "lon" : 116.1234567 }, "status" : "ONLINE", "rsu_model_id" : "27652459499824704332521974743806", "intersection_id" : "1-301", "related_edge_num" : 0, "software_version" : "V100X00XX00X325" } ] }

请求示例 GET https://{endpoint}/v1/{project_id}/rsus?limit={limit}&offset={offset}&rsu_id={rsu_id}&esn={esn}&status={status}&rsu_model_id={rsu_model_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:********

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：返回RSU的总体数量。 rsus Array of RsuDTO objects 参数说明：RSU数据列表。 表5 RsuDTO 参数 参数类型 描述 rsu_id String 参数说明：RSU的唯一标识符，在平台创建RSU时由平台生成。 name String 参数说明：RSU的名字。 取值范围：长度不低于1不超过128，只允许中文、字母、数字、下划线（_）、连接符（-）的组合。 description String 参数说明：RSU的描述。 取值范围：只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文分号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）、空格的组合。 esn String 参数说明：RSU的设备序列号。 取值范围：只允许字母、数字、下划线（_）的组合。 last_modified_time String 参数说明：最后修改的时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_time String 参数说明：最后的在线时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z ip String 参数说明：RSU的IP。满足IP的格式，例如127.0.0.1。 position_description String 参数说明：安装位置编码，由用户自定义。 取值范围：长度不低于1不超过128，只允许字母、数字、下划线（_）的组合。 location RsuLocation object 参数说明：RSU的位置信息。 status String 参数说明：RSU设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 UNKNOWN：未知 rsu_model_id String 参数说明：RSU型号ID，用于唯一标识一个RSU型号，在平台创建RSU型号后由平台分配获得，获取方法可参见 “创建RSU型号”接口。 取值范围：长度不低于1不超过36，只允许字母、数字、连接符（-）的组合。 intersection_id String 参数说明：在地图中，rsu所在区域对应的路口ID，也即区域ID拼接路口ID，格式为：region-node_id。其中路网最基本的构成即节点和节点之间连接的路段。节点可以是路口，也可以是一条 路的端点。一个节点的ID在同一个区域内是唯一的。 related_edge_num Integer 参数说明：RSU可关联的Edge的数量。 software_version String 参数说明：RSU的软件版本，由RSU上报其软件版本。 表6 RsuLocation 参数 参数类型 描述 lat Number 参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 lon Number 参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。

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

请求示例 PUT https://{endpoint}/v1/{project_id}/rsu-models/{rsu_model_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "manufacturer_name" : "ABC", "description" : "excellent" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 rsu_model_id String 参数说明：RSU型号ID，用于唯一标识一个RSU型号，在平台创建RSU型号后由平台分配获得。 取值范围：长度不小于1不超过36，只允许字母、数字、连接符（-）的组合。 name String 参数说明: RSU型号名称。 取值范围：长度不低于1不超过64，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 manufacturer_name String 参数说明: RSU的厂商名称。 取值范围：长度不低于1不超过32，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 description String 参数说明: RSU型号的描述信息。 取值范围：长度不低于1不超过128，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）、空格的组合。 last_modified_time String 参数说明: RSU型号更新的时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z created_time String 参数说明: 在平台创建RSU型号的时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 platform_type String 参数说明：平台类型。 取值范围： DRIS：华为路网数字化平台 LITONG：利通 ZHONGQIYAN：中汽研 platform_para PlatformPara object 参数说明：platform_type为非DRIS时有效，表示第三方平台的对接参数 channel_status String 参数说明：华为路网数字化平台或第三方业务平台连接状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化 表6 PlatformPara 参数 参数类型 描述 address String 参数说明：第三方业务平台的ip地址和端口。 username String 参数说明：鉴权用户名。 取值范围：长度不超过255，只允许字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 passwd String 参数说明：鉴权密码，ITS800或者ATLAS500的密码 取值范围：长度不超过255，只允许字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。

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

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

响应示例 状态码： 200 OK { "count" : 1, "statistics" : [ { "source" : { "source_type" : "detection", "source_id" : "EDGE0123456789" }, "section_id" : 1, "time" : "2022-09-01T13:10:21Z", "period" : 300, "direction" : 180.5, "flow" : 50, "average_speed" : 70.8, "esn" : "2102312ETX10K7000037", "cross_id" : "cross0123456789", "segment" : { "segment_id" : "1", "lon" : 114.23256, "lat" : 30.121545 }, "traffic_direction" : 0, "road_kind" : 10, "lane_count" : 4, "vehicle_class_flow" : [ { "vehicle_class" : 10, "flow" : 50, "average_speed" : 70.8 } ], "lane_flow" : [ { "lane_id" : 10, "flow" : 50, "average_speed" : 73.6, "vehicle_density" : 100, "head_interval" : 100, "space_interval" : 1000, "vehicle_class_flow" : [ { "vehicle_class" : 10, "flow" : 50, "average_speed" : 70.8 } ] } ], "occupancy" : [ { "lane_id" : 1, "space_occupancy" : 1, "time_occupancy" : 1 } ] } ] }

响应示例 状态码： 200 OK { "edge_app_id" : "16993214329224629859639932733105", "version" : "1.0.0", "description" : "hello", "created_time" : null, "last_modified_time" : null, "state" : "OFF_SHELF", "publish_time" : null, "off_shelf_time" : null }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 edge_app_id String 参数说明：用户自定义应用唯一ID。 version String 参数说明：应用版本。 description String 参数说明：应用描述。 取值范围：只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文引号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）的组合。 created_time String 参数说明：创建时间。 last_modified_time String 参数说明：最后一次修改时间。 state String 参数说明：应用版本状态。 取值范围： DRAFT：草稿 PUBLISHED：发布 OFF_SHELF：下线 publish_time String 参数说明：发布时间。 off_shelf_time String 参数说明：下线时间。

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

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

请求示例 PUT https://{endpoint}/v1/{project_id}/vehicles/{vehicle_id} Content-Type:application/json X-Auth-Token:******** Instance-Id:******** { "imei" : "imei", "brand" : "polo", "model" : "model", "style" : "2020", "fuel_type" : "gasoline", "color" : "blue", "plate_color" : "black", "access_type" : "5g", "description" : "description" }

响应示例 状态码： 200 OK { "vehicle_id" : "13229397084005974033576909202199", "plate_no" : "粤B12345", "vin" : "vin121456", "obu_id" : "112412", "brand" : "polo", "model" : "model", "style" : "2020", "fuel_type" : "gasoline", "color" : "blue", "plate_color" : "black", "access_type" : "5g", "description" : "description", "status" : "INITIAL", "created_time" : "2022-01-06T09:30:24Z" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 vehicle_id String 参数说明：车辆唯一标识符。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 plate_no String 参数说明：车牌号。 取值范围：长度最小1最大64，支持中文、阿拉伯文、字母、数字、下划线（_）、横杠（-）的组合。 vin String 参数说明：VIN码，车辆的17位VIN码。 取值范围：长度不超过17，只允许字母、数字字符的组合。 obu_id String "参数说明：车载OBU的唯一标识。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 imei String 参数说明：IMEI，OBU上电子序列号。 取值范围：长度最小1最大255，支持纯数字的组合。 brand String 参数说明：车辆品牌。 取值范围：长度最小1最大64，支持中文、字母、数字、下划线（_）、横杠（-）的组合。 model String 参数说明：车牌型号。 取值范围：长度最小1最大64，支持字母、数字、下划线（_）、横杠（-）的组合。 style String 参数说明：车辆年款。 取值范围：长度最小1最大64，支持纯数字的组合。 fuel_type String 参数说明：定义车辆的燃料动力类。 取值范围： unknownFuel：未知 gasoline：汽油 ethanol：乙醇 diesel：柴油 electric：电动 hybrid：混合燃料类型 hydrogen：氢气 natGasLiquid：液化天然气 natGasComp：压缩天然气 propane：丙烷 color String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 gray：灰色 red：红色 blue：蓝色 yellow：黄色 orange：橙色 brown：棕色 green：绿色 purple：紫色 cyan：青色 pink：粉红色 transparent：透明色 other：其他 plate_color String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 blue：蓝色 yellow：黄色 green：绿色 access_type String 参数说明：车辆接入网络的方式。 取值范围： 5g 4g 3g 2g pc5Only pc5And5g pc5And4g pc5And3g pc5And2g description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 last_modified_time String 参数说明：最后修改的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_time String 参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：总记录数。 edge_apps Array of QueryApplicationBriefResponseDTO objects 参数说明：列举每条记录。 表5 QueryApplicationBriefResponseDTO 参数 参数类型 描述 edge_app_id String 参数说明：用户自定义应用唯一ID。 取值范围：只允许字母、数字、下划线（_）、连接符（-）、美元符号（$）的组合。 description String 参数说明：应用描述。 取值范围：只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文引号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）的组合。 created_time String 参数说明：创建时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z。 last_modified_time String 参数说明：更新时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z。 last_published_version String 参数说明：最新发布版本。

响应示例 状态码： 200 OK { "count" : 1, "edge_apps" : [ { "edge_app_id" : "10691172132537970614092038885766", "description" : "this is a test app", "created_time" : "2021-12-23T12:21:55", "last_modified_time" : "2021-12-23T12:21:55", "last_published_version" : null } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 参数说明：返回车辆的总体数量。 vehicles Array of VehicleDTO objects 参数说明：数据列表。 表5 VehicleDTO 参数 参数类型 描述 vehicle_id String 参数说明：车辆唯一标识符。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 plate_no String 参数说明：车牌号。 取值范围：长度最小1最大64，支持中文、阿拉伯文、字母、数字、下划线（_）、横杠（-）的组合。 vin String 参数说明：VIN码，车辆的17位VIN码。 取值范围：长度不超过17，只允许字母、数字字符的组合。 obu_id String "参数说明：车载OBU的唯一标识。 取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。 imei String 参数说明：IMEI，OBU上电子序列号。 取值范围：长度最小1最大255，支持纯数字的组合。 brand String 参数说明：车辆品牌。 取值范围：长度最小1最大64，支持中文、字母、数字、下划线（_）、横杠（-）的组合。 model String 参数说明：车牌型号。 取值范围：长度最小1最大64，支持字母、数字、下划线（_）、横杠（-）的组合。 style String 参数说明：车辆年款。 取值范围：长度最小1最大64，支持纯数字的组合。 fuel_type String 参数说明：定义车辆的燃料动力类。 取值范围： unknownFuel：未知 gasoline：汽油 ethanol：乙醇 diesel：柴油 electric：电动 hybrid：混合燃料类型 hydrogen：氢气 natGasLiquid：液化天然气 natGasComp：压缩天然气 propane：丙烷 color String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 gray：灰色 red：红色 blue：蓝色 yellow：黄色 orange：橙色 brown：棕色 green：绿色 purple：紫色 cyan：青色 pink：粉红色 transparent：透明色 other：其他 plate_color String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 blue：蓝色 yellow：黄色 green：绿色 access_type String 参数说明：车辆接入网络的方式。 取值范围： 5g 4g 3g 2g pc5Only pc5And5g pc5And4g pc5And3g pc5And2g description String 参数说明：描述。 取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。 last_modified_time String 参数说明：最后修改的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_time String 参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z status String 参数说明：设备状态。 取值范围： ONLINE：在线 OFFLINE：离线 INITIAL：初始化

响应示例 状态码： 200 OK { "count" : 1, "vehicles" : [ { "vehicle_id" : "12302463411926825917269660281057", "plate_no" : "Huawei", "vin" : "74512845126", "obu_id" : "OBU_007", "imei" : "987954asdfasdf", "brand" : "Huawei", "model" : "Huawei", "style" : "2022", "fuel_type" : "gasoline", "color" : "white", "plate_color" : "black", "access_type" : "5g", "description" : "description", "last_modified_time" : "2020-09-01T01:37:01Z", "created_time" : "2020-09-01T01:37:01Z", "last_online_time" : "2020-11-01T01:37:01Z", "status" : "OFFLINE" } ] }

Message示例 { "header" : { "instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7", "event" : "ADDED" }, "body" : { "rsm_source" : { "rsm_source_type" : "rsu", "rsm_source_id" : "RSU0123456789", "esn" : "2102312ETX10K7000037" }, "id" : "12345678", "send_time" : "2020-09-01T01:37:01.123Z", "ref_pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "participant_list" : [ { "ptc_type" : "unknown", "ptc_id" : 3, "global_track_id" : 3, "source" : "rsu", "id" : "1234567890", "sec_mark" : 0, "pos" : { "lat" : 401234567, "lon" : 1161234567, "ele" : 1000 }, "pos_confidence" : { "position_confidence" : 10, "ele_confidence" : 10 }, "transmission" : 2, "speed" : 3000, "heading" : 10000, "angle" : 0, "vehicle_color" : "black", "vehicle_model" : "朗逸", "vehicle_brand" : "红旗", "vehicle_style" : "2018,2019,2020", "lane_no" : 1, "gat_vehicle_class" : "K33", "cross_id" : "cross0123456789", "plate_no" : "粤B1234567", "motion_cfd" : { "speed_confidence" : 5, "heading_confidence" : 5, "steer_confidence" : 2 }, "accel_set" : { "long_accel" : 0, "lat_accel" : 0, "vert_accel" : 0, "yaw_rate" : 0 }, "size" : { "width" : 200, "length" : 3000, "height" : 40 }, "vehicle_class" : { "basic_vehicle_class" : 54, "fuel_type" : 5 } } ] } }

Message参数 表1 请求Body参数 参数 是否必选 参数类型 描述 body 是 OpenV2XRSMTopicBodyDTO object 参数说明：路侧动态目标物消息，参考路侧安全消息。来源于边缘感知计算单元分析生成的路侧动态目标物状态数据。 header 是 OpenRSMTopicHeaderDTO object 参数说明：路侧动态目标物数据的附加信息。 表2 OpenV2XRSMTopicBodyDTO 参数 是否必选 参数类型 描述 rsm_source 否 R SMS ource object 参数说明：消息来源。 ref_pos 是 Position3D object 参数说明：位置信息。 participant_list 否 Array of ParticipantData objects 参数说明：交通参与者列表。应用于RSM消息，表示当前探测到的所有或者部分交通参与者信息。 表3 RSMSource 参数 是否必选 参数类型 描述 rsm_source_type 是 String 参数说明：信息来源的具体类型描述。 枚举值： rsu obu detection rsm_source_id 否 String 参数说明：信息来源的唯一标识码ID。 最小长度：1 最大长度：255 esn 是 String 参数说明：设备编码。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 表4 ParticipantData 参数 是否必选 参数类型 描述 ptc_type 是 String 参数说明：路侧单元检测到的交通参与者类型。 取值范围： unknown：未知类型 motor：机动车 non-motor：非机动车 pedestrian：行人 rsu：RSU设备 枚举值： unknown motor non-motor pedestrian rsu ptc_id 是 Integer 参数说明：检测单元设置的临时ID。 最小值：0 最大值：65535 global_track_id 否 Long 参数说明：ITS800通过GlobalTrackID字段标识了车辆唯一ID。 最小值：0 最大值：9223372036854775807 source 是 String 参数说明：定义交通参与者数据的来源。 枚举值： unknown rsu v2x video microwaveRadar loop lidar integrated id 否 String 参数说明：对应BSM消息中车辆ID。 最小长度：8 最大长度：8 sec_mark 是 Integer 参数说明：以0.1 秒为单位，定义1分钟中的毫秒级时刻。分辨率为1毫秒，有效范围是0~59999。 60000及以上表示未知或无效数值。 最小值：0 最大值：65535 pos 是 Position3D object 参数说明：位置信息。 pos_confidence 是 PositionalConfidence object 参数说明：定义当前实时位置（经纬度和高程）的精度大小，包括水平位置精度和高程精度， 由系统自身进行实时计算和更新。 transmission 否 Integer 参数说明：车辆档位状态。 0：空档 1：停止档 2：前进档 3：倒档 7：不可用 4~6：预留 最小值：0 最大值：7 speed 是 Integer 参数说明：车辆或其他交通参与者的速度大小。单位为0.02米每秒。值为8191时代表无效数值。 最小值：0 最大值：8191 heading 是 Integer 参数说明：车辆或交通参与者的航向角。为运动方向与正北方向的顺时针夹角。单位为0.0125°。 最小值：0 最大值：28800 angle 否 Integer 参数说明：定义车辆转向轮角度。向右为正，向左为负。单位为1.5°，值为127时代表无效值。 最小值：-126 最大值：127 vehicle_color 否 String 参数说明：车辆颜色。 取值范围： black：黑色 white：白色 gray：灰色 red：红色 blue：蓝色 yellow：黄色 orange：橙色 brown：棕色 green：绿色 purple：紫色 cyan：青色 pink：粉红色 transparent：透明色 other：其他 最小长度：0 最大长度：100 vehicle_model 否 String 参数说明：车辆型号。 最小长度：0 最大长度：31 vehicle_brand 否 String 参数说明：车辆品牌。 最小长度：0 最大长度：31 vehicle_style 否 String 参数说明：车辆年款，通过年份来表示，多个年份通过逗号分隔。 最小长度：0 最大长度：63 lane_no 否 Integer 参数说明：车辆所在车道。默认不携带。 最小值：0 最大值：99 gat_vehicle_class 否 String 参数说明：机动车车辆类型。参考机动车车辆类型。 cross_id 否 String 参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 最小长度：0 最大长度：64 plate_no 否 String 参数说明：车牌号。 最小长度：0 最大长度：32 motion_cfd 否 MotionConfidenceSet object 参数说明：描述车辆运行状态的精度。包括车速精度、航向精度和方向盘转角的精度。 accel_set 否 AccelerationSet4Way object 参数说明：定义车辆四轴加速度。 size 是 VehicleSize object 参数说明：定义车辆尺寸大小。由车辆长宽高三个维度来定义尺寸，其中高度数值为可选项。 vehicle_class 否 VehicleClassification object 参数说明：定义车辆类型。包含车辆基本类型以及燃料动力类型。 表5 Position3D 参数 是否必选 参数类型 描述 lat 是 Object 参数说明：定义纬度数值，北纬为正，南纬为负。单位°，精度小数点后7位。 最小值：-90 最大值：90.0000001 lon 是 Object 参数说明：定义经度数值。东经为正，西经为负。单位°，精度小数点后7位。 最小值：-179.9999999 最大值：180.0000001 ele 否 Object 参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。 最小值：-4096 最大值：61439 表6 PositionalConfidence 参数 是否必选 参数类型 描述 position_confidence 是 Integer 参数说明：数值描述了95%置信水平的车辆位置精度。参考 位置精度参数说明。 最小值：0 最大值：15 ele_confidence 否 Integer 参数说明：数值描述了95%置信水平的车辆高程精度。参考 高程精度参数说明。 最小值：0 最大值：15 表7 MotionConfidenceSet 参数 是否必选 参数类型 描述 speed_confidence 否 Integer 参数说明：数值描述了95%置信水平的速度精度。 取值范围： 0：不可用 1：100m/s 2：10m/s 3：5m/s 4：1m/s 5：0.1m/s 6：0.05m/ 7：0.01m/s 最小值：0 最大值：7 heading_confidence 否 Integer 参数说明：数值描述了95%置信水平的航向精度。 取值范围： 0：不可用 1：10° 2：5° 3：1° 4：0.1° 5：0.05° 6：0.01° 7：0.0125° 最小值：0 最大值：7 steer_confidence 否 Integer 参数说明：数值描述了95%置信水平的车辆转向轮角度精度。 取值范围： 0：不可用 1：2° 2：1° 3：0.02° 最小值：0 最大值：3 表8 AccelerationSet4Way 参数 是否必选 参数类型 描述 long_accel 是 Integer 参数说明：车辆纵向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 lat_accel 是 Integer 参数说明：车辆横向加速度。单位为0.01米每平方秒。值为2001时代表无效数值。 最小值：-2000 最大值：2001 vert_accel 是 Integer 参数说明：定义Z轴方向的加速度大小，Z轴方向竖直向下，沿着Z轴方向为正。 分辨率为0.02G，G为重力加速度值9.80665m/s2。 最小值：-127 最大值：127 yaw_rate 是 Integer 参数说明：车辆横摆角速度。指汽车绕垂直轴的偏转，该偏转的大小代表汽车的稳定程度。如果偏转角速度达 到一个阈值，说明汽车发生侧滑或者甩尾等危险工况。 顺时针旋转为正，逆时针为负。 数据分辨率为0.01°/s。 最小值：-127 最大值：127 表9 VehicleSize 参数 是否必选 参数类型 描述 width 是 Integer 参数说明：车辆车身宽度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：1023 length 是 Integer 参数说明：车辆车身长度。单位为0.01米。值为0时代表无效数值。 最小值：0 最大值：4095 height 否 Integer 参数说明：车辆车身高度。单位为0.05米。值为0时代表无效数值。 最小值：0 最大值：127 表10 VehicleClassification 参数 是否必选 参数类型 描述 basic_vehicle_class 否 Integer 参数说明：定义车辆基本类型。参考 车辆基本类型参数说明。 最小值：0 最大值：255 fuel_type 否 Integer 参数说明：定义车辆的燃料动力类型，10-15暂未定义。 取值范围： 0：未知 1：汽油 2：乙醇 3：柴油 4：电动 5：混合燃料类型 6：氢气 7：液化天然气 8：压缩天然气 9：丙烷 最小值：0 最大值：15 表11 OpenRSMTopicHeaderDTO 参数 是否必选 参数类型 描述 instance_id 是 String 参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 event 是 String 参数说明：操作描述。" 取值范围： MODIFIED：修改 ADDED：新增 DELETED：删除 枚举值： MODIFIED ADDED DELETED

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 rsu_model_id String 参数说明：RSU型号ID，用于唯一标识一个RSU型号，在平台创建RSU型号后由平台分配获得。 取值范围：长度不小于1不超过36，只允许字母、数字、连接符（-）的组合。 name String 参数说明: RSU型号名称。 取值范围：长度不低于1不超过64，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 manufacturer_name String 参数说明: RSU的厂商名称。 取值范围：长度不低于1不超过32，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）的组合。 description String 参数说明: RSU型号的描述信息。 取值范围：长度不低于1不超过128，只允许中文、字母、数字、下划线（_）、问号（?）、反引号（'）、井号（#）、左小括号（(）、右小括号（)）、点（.）、逗号（,）、与（&）、百分号（%）、At（@）、感叹号（!）、连接符（-）、空格的组合 last_modified_time String 参数说明: RSU型号更新的时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z created_time String 参数说明: 在平台创建RSU型号的时间。 格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z

响应示例 状态码： 200 OK { "rsu_model_id" : "5ba24f5ebbe8f56f5a14f605", "name" : "RSU001", "manufacturer_name" : "ABC", "description" : "excellent", "created_time" : "2020-12-07T01:32:17Z", "last_modified_time" : "2020-12-07T01:32:17Z" }