车辆基本类型（basic_vehicle_class） 数值 含义 0 未知类型或不可用 1 特殊类型车辆 10 通用类型的乘用车 11 其他类型的乘用车 20 通用类型的轻型货车 21 其他类型的轻型货车 25 通用类型的卡车 26 其他类型的卡车 27 单机组2轴6轮卡车 28 单机组3轴卡车 29 单机组4轴（或多余4轴）卡车 30 4轴（或少于4轴）单挂拖车 31 5轴（或少于5轴）单挂拖车 32 6轴（或多于6轴）单挂拖车 33 5轴（或少于5轴）多挂拖车 34 6轴多挂拖车 35 7轴（或多于7轴）多挂拖车 40 通用类型的摩托车 41 其他类型的摩托车 42 标准巡航车 43 无涂层运动摩托车 44 运动旅行摩托车 45 超级运动摩托车 46 旅行摩托车 47 三轮摩托车 48 载客摩托车 50 通用类型的客车 51 其他类型的客车 52 快速公交（BRT） 53 快递运输货车 54 公交巴士 55 校车 56 有轨列车 57 辅助公交 58 辅助救援车辆 60 通用类型的紧急车辆 61 其他类型的紧急车辆 62 消防轻型车辆 63 消防重型车辆 64 消防辅助救护车辆 65 消防救护车 66 警用轻型车辆 67 警用重型车辆 68 其他紧急情况响应车辆 69 其他紧急情况救护车 80 未知交通参与者 81 其他交通参与者 82 行人 83 视力障碍人士 84 身体残障人士 85 自行车 86 道路施工人员 90 未知类型的基础设施 91 固定的基础设施 92 可移动的基础设施 93 配备货物拖车 父主题： 参数说明列表

Message示例 { "id": "494d83b1-3a2b-408b-9eac-a49872fb8623", "name": "name", "content": "{\"topic\":\"obu.rsi.down\",\"payload\":{\"vehicle_id\": \"test_vehicle_001\",\"rtes\":[{\"rte_id\":10,\"event_type\":2,\"event_source\":2,\"event_pos\":{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},\"event_radius\":2,\"description\":\"123456789\",\"time_details\":{\"start_time\":2,\"end_time\":2,\"end_time_confidence\":2},\"priority\":2,\"reference_paths\":[{\"active_path\":[{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000}],\"path_radius\":2}],\"reference_links\":[{\"upstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"downstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"reference_lanes\":[true,true]}],\"event_confidence\":2,\"duration\":0,\"event_status\":0}],\"rtss\":[{\"rts_id\":10,\"sign_type\":2,\"sign_pos\":{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},\"description\":\"123456789\",\"time_details\":{\"start_time\":2,\"end_time\":2,\"end_time_confidence\":2},\"priority\":2,\"reference_paths\":[{\"active_path\":[{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000},{\"lat\":40.1234567,\"lon\":116.1234567,\"ele\":1000}],\"path_radius\":2}],\"reference_links\":[{\"upstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"downstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"reference_lanes\":[true,true]},{\"upstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"downstream_node_id\":[{\"region\":2,\"id\":2},{\"region\":2,\"id\":2}],\"reference_lanes\":[true,true]}]}]}}" }

Message示例 { "name": testpat, "content": "{\"intersections\":[{\"intersection_id\":{\"region\":12,\"node_id\":11},\"status\":{\"manual_control_is_enabled\":true,\"stop_time_is_activated\":true,\"preempt_is_active\":true,\"signal_priority_is_active\":true,\"traffic_dependent_operation\":true,\"standby_operation\":true,\"recent_map_message_update\":true,\"recent_change_in_map_assigned_lanes_ids_used\":true,\"no_valid_map_is_available_at_this_time\":true,\"no_valid_spat_is_available_at_this_time\":true},\"time_stamp\":\"1970-01-08T22:05:13.553Z\",\"time_confidence\":1,\"phases\":[{\"phase_id\":123,\"phase_states\":[{\"light_state\":423,\"timing\":{\"utc_timing\":{\"start_utc_time\":{\"time_mark\":0},\"min_end_utc_time\":{\"time_mark\":0},\"max_end_utc_time\":{\"time_mark\":0},\"likely_end_utc_time\":{\"time_mark\":0},\"next_start_utc_time\":{\"time_mark\":0},\"next_end_utc_time\":{\"time_mark\":0}},\"start_time\":0,\"likely_end_time\":123}}]}]}],\"time_stamp\":\"2021-12-18T07:20:51.683Z\",\"name\":\"name\"}"}

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

设备查询 地图上可查看已接入的设备。 通过筛选设备类型，在地图上高亮同类型的所有设备。 通过输入设备Id或esn，在地图上高亮显示相应的设备。 在线率统计：各个设备类型的统计原理详见表1。 表1 设备在线率统计 统计对象 统计原理 边缘Edge 在线率=设备在线数 / 边缘Edge设备总数 在线：该边缘Edge和 路网数字化服务 连接正常 运行中：该边缘Edge节点在IEF（华为云智能边缘平台）状态为运行中，即Atlas设备和IEF当前连接正常 待部署：该边缘Edge节点在IEF状态为待部署，即Atlas设备还未部署 部署中：该边缘Edge节点在IEF状态为部署中，即Atlas设备正在部署 离线：该边缘Edge和路网数字化服务连接断开 升级中：该边缘Edge节点在IEF状态为升级中，即Atlas设备正在升级 删除中：该边缘Edge节点在IEF状态为删除中，即Atlas设备正在删除 未接入：该边缘Edge设备信息导入后，和路网数字化服务从未建立过连接 路侧RSU 在线率=设备在线数 / RSU设备总数 在线：该RSU和路网数字化服务连接正常 离线：该RSU和路网数字化服务连接断开 未接入：该RSU设备信息导入后，RSU设备和路网数字化服务从未建立过连接 摄像头 在线率=设备在线数 / 摄像头设备总数 在线：该摄像头和路网数字化服务连接正常 离线：该摄像头和路网数字化服务连接断开 未接入：该摄像头设备信息导入后，和路网数字化服务从未建立过连接 雷达 在线率=设备在线数 / 雷达设备总数 在线：该雷达和路网数字化服务连接正常 离线：该雷达和路网数字化服务连接断开 未接入：该雷达设备信息导入后，和路网数字化服务从未建立过连接 设备删除：单击“删除”按钮，可以删除该设备信息。 设备详情：单击“详情”按钮，可以查看该设备的详细信息。 设备修改：单击“编辑”按钮，可以修改该设备信息。 父主题： 设备管理

购买专业版 购买路网数字化服务专业版，提供可选择的叠加包和购买时长，可以享受更好的资源隔离和管控策略。 路网数字化服务专业版的资源独享，具有更高的数据可靠性和安全性。 开通之前，请浏览整体开通流程，以便提高操作效率。 区域 路网数字化服务部署的区域，当前仅支持“北京四”。 操作步骤 进入路网数字化服务的购买服务页。 在页面中选择服务配置信息，系统会根据您选择的“服务配置”和“购买时长”自动计算费用。 参数名称 参数说明 计费方式 包周期计费模式，是一种预付费方式，按订单的购买周期计费。 当前仅支持“包年”。 区域 北京四。 版本 专业版。 叠加服务 购买专业版后，才可购买叠加服务。请根据需要配置，提供更多的设备连接或每秒处理事务数。 路侧服务 提供路侧边缘计算服务，感知路侧对象和事件。请根据需要配置，避免不必要的浪费。 购买时长 按年购买，最短1年，最长3年。 勾选 《华为云服务免责声明》协议，单击“立即购买”，进入实例规格确认页面。 规格确认无误后，单击“去支付”。 在支付页面选择支付方式后，单击“确认付款”完成购买。 支付完成后，返回控制台，进入新手指引，进行设备的部署和注册。

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

API概览 类型 说明 RSU管理 包括RSU的创建、删除、修改、查询接口。 雷达管理 包括RSU型号的创建、删除、修改、查询接口。 Edge应用管理 包括Edge应用的创建、删除、修改、查询接口。 Edge应用版本管理 包括Edge应用版本的创建、删除、修改、更新、查询接口。 边缘应用管理 包括边缘应用的部署、删除、升级、查询接口。 信号机管理 包括Edge的创建、删除、修改、查询等接口。 长期交通事件管理 包括业务通道的创建、删除、修改、查询接口。 车辆管理 包括IPC的查询接口。 IPC管理 包括雷达信息的查询接口。 RSU型号管理 包括信号机的获取、创建、删除、修改接口。 业务通道管理 包括车辆的获取、创建、删除、修改接口。 Edge管理 包括交通事件的创建、删除、修改、查询接口。 历史交通消息管理 创建即时交通事件。 即时交通事件管理 包括数据转发配置的创建、删除、更新、查询接口。 数据转发 包括bsm、rsi、rsm、spat、statistics、tracks消息转发。 数据转发配置管理 下发交通消息给设备侧，当前仅支持下发SPAT消息给RSU设备。 交通消息下发 查询历史交通事件。 父主题： 应用侧API参考

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用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不同，使用时请注意。

Token认证 Token是服务端生成的一串字符串，作为客户端进行请求的一个令牌。第一次登录后，服务器生成一个Token并将此Token返回给客户端，以后客户端只需带上这个Token前来请求数据即可，无需再次带上用户名和密码。Token有效期是24小时，从客户端获取开始算起（24小时是相对时间），需要使用同一个Token鉴权时，建议缓存起来使用，避免频繁调用。在Token过期前，务必刷新Token或重新 获取Token ，否则Token过期后会在服务端鉴权失败。 如果您获取Token多次，以最新的为准，前面的Token会被覆盖并失效。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxxxxxx" } } } } 加粗的斜体字段需要根据实际值填写，其中username为 IAM 用户名，domainname为IAM用户所属帐号名，********为IAM用户的登录密码，xxxxxxxxxxxxxxxxxx为IAM用户所属账号的项目名称，如“cn-north-1”，您可以参考我的凭证页面获取。 接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值为获取到的Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 POST https://ocv2x-api.cn-north-4.myhuaweicloud.com/v1/{project_id}/traffic-events Content-Type: application/json X-Auth-Token: ABCDEFJ.... Instance-Id: xxxxxx 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的帐号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token额作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器 域名 或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点中获取。 例如IAM服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京一”区域的Token，则需使用“华北-北京一”区域的Endpoint（iam.cn-north-1.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表格内容。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Instance-Id 路网数字化服务的实例ID，请参考获取Instance-Id获取实例ID。 否 部分接口调用要求必选。 c7ff8b76-9e6c-46c1-863e-a2225bb637ef project-id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens