DB13T 5998-2024智慧高速公路交通云控平台数据接口技术规范

智慧高速公路交通云控平台数据接口技术规范2024-09-12实施2024-09-12实施河北省市场监督管理局发布I 1范围 12规范性引用文件 13术语和定义 14缩略语 15数据交互流程及接口分类 16数据采集接口 27数据服务接口 8接口响应状态码 9接口交互安全 本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由河北省交通运输厅提出并归口。本文件起草单位：河北省交通规划设计研究院有限公司。本文件主要起草人：何勇海、雷伟、焦彦利、张龙、付增辉、韩明敏、葛志鹏、金凤温、张义彬、张凯丽、解振龙、蒋岚、牛兆霞、游燕燕、潘显豪、牛志愿、段河霞、侯建华、谭振东、杨欣、蔺会娟、石磊、王学军。1智慧高速公路交通云控平台数据接口技术规范本文件规定了智慧高速公路交通云控平台数据接口的术语和定义、数据交互流程及接口分类、数据采集接口和数据服务接口、接口响应状态码及接口交互安全等的要求。本文件适用于新建智慧高速公路、运营高速公路智慧化升级改造及高速公路相关系统的平台数据接口设计与开发。普通干线公路系统数据接口开发可参照执行。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T917公路路线标识规则和国道编号GB/T35561突发事件分类与编码JT/T809道路运输车辆卫星定位系统平台数据交换JT/T1008.1-2015公路交通情况调查设备第1部分：技术条件JT/T1008.2公路交通情况调查设备第2部分：通信协议JT/T1415交通运输数据资源交换与共享T/CITSA09车路协同系统应用层数据标准T/CITSA18网联车辆平台间协同服务信息交互规范3术语和定义下列术语和定义适用于本文件。交通云控平台trafficcloudcontrolplatform基于智能网联云控技术，面向交通管理需求，建设的逻辑协同、物理分散的路段云、路网云平第三方系统平台Third-partysystemplatforms与交通云控平台进行数据交互的其他系统平台。4缩略语HTTP一超文本传输协议(HypertextTransferProtocol)JSON—JavaScript对象简谱(JavaScriptObjectNotation)SSL—安全套接层(SecureSocketsLayer)UTC一协调世界时(UniversalTimeCoordinated)5数据交互流程及接口分类5.1接口分类数据接口包括数据采集接口和数据服务接口，数据交互流程如图1所示。2数据采集接口数据采集接口…智慧高速公路交通云控平台其他系统“两客一危”系统JSON数据结构接口交互安全数据服务接口第三方系统平台感知系统图1数据交互流程5.2数据采集接口数据采集接口主要负责智慧高速公路感知系统数据和其他系统接入数据的获取。感知系统数据包括但不限于车辆目标实时信息、交通统计信息、交通事件信息、气象数据、设备状态信息等外场设备获取的数据。其他系统接入数据包括但不限于交通管理系统、“两客一危”系统、收费系统及路网联合管控提供的必要管理数据。数据采集接口类型宜采用HTTP/WebSocket接口，数据结构宜采用JSON结构。其中，感知系统与其他系统作为接口服务器端，智慧高速公路交通云控平台作为接口客户端，请求模式为主动推送模式。5.3数据服务接口数据服务接口主要负责为公共服务业务或应用系统提供数据，可根据应用需求进行扩展。数据服务接口类型宜采用HTTP/WebSocket接口，数据结构宜采用JSON结构。其中，智慧高速公路交通云控平台作为接口服务器端，第三方平台作为接口客户端，请求模式为双向通信方式；允许客户端和服务器在需要时主动发送消息，同时也可以接收消息。6数据采集接口6.1感知系统业务数据6.1.1车辆目标实时信息数据接口车辆目标实时信息数据接口实时获取路侧感知车辆目标信息，接口类型宜采用WebSocket,接口数据推送频率不大于100ms,数据接口请求字段如表1所示。表1车辆目标实时信息数据请求字段中文名称是固定值“road_real_data_per”是固定值1区域数据是位小数)3[116.230173538096,3]}}<RaderAreaP1longitude="116.227998031041"lat<RaderAreaP2longitude="116.230173538096"latitude="39.1660561471784"label="围点2-左上"/><RaderAreaP3longitude="116.158069365442"latitude="39.1569717025223"labe<RaderAreaP4longitude="116.156634456533"latitude="39.1699323002445"lab车辆目标实时信息数据接口返回字段表2车辆目标实时信息数据返回字段中文名称固定值3目标编号目标经度目标纬度航向角目标速度设备编号目标类型行目标颜色1-蓝色；2-黄色；3-白色；4-黑{{"plateNo":"冀AXXXXX","targetType":"小型车","vehicleId":"100000000000000000046.1.2交通统计信息数据接口交通统计信息包括字段名称、数据结构，接口类型宜采用WebSocket,接口数据推送频率宜不大于30s,数据接口请求字段如表3所示。中文名称是否{}交通统计信息数据接口输出字段中文名称UTC+8,毫秒级感知时间戳UTC+8,毫秒级中小客车流量中型货车流量时间占有率单位：s51r[{1r[{{…}6.1.3交通事件信息数据接口交通事件信息包括字段名称、数据结构。接口类型宜采用WebSocket,接口数据推送频率不大于100ms,数据接口请求字段如表5所示。表5交通事件信息数据接口请求字段中文名称是固定值"event_efficient"}交通事件信息数据接口输出字段表6交通事件信息数据接口输出字段中文名称6表6交通事件信息数据接口输出字段(续)中文名称设备唯一ID,感知时间戳参照GB/T917的规定开始时间结束时间数据类型事件违章录像FTP地址(包括录像名称)图像地址事件违章抓图FTP地址(不包括图片名称)图像1名称图片名称图像1时间图像2名称图片名称图像2时间图像3名称图片名称图像3时间图像4名称图片名称图像4时间{7"videoAddr"::8080/video/20230629"imgAddr":ftp://192.168.0."eventDesc":"K866+400停车事件，占据外侧车道",}]}气象数据宜采用WebSocket接口进行数据对接，数据推送频率宜不大于1min。风速风向数据包括字段名称、数据结构，数据接口请求字段如表7所示。中文名称是固定值“wind_real_data”否{}风速风向数据接口输出字段如表8所示。中文名称消息时间戳单位：m/s风向位风速角角度，单位：8{}]}温湿度数据包括字段名称、数据结构，数据接口请求字段如表9所示。中文名称是固定值“temp_real_data”否e}温湿度数据接口输出字段如表10所示。中文名称温度，单位：℃露点温度，单位：℃单位：g/m³{{}]}9表11气压数据接口请求字段中文名称是否{}气压数据接口输出字段如表12所示。表12气压数据接口输出字段中文名称{}]}降水数据包括字段名称、数据结构，数据接口请求字段如表13所示。表13降水数据接口请求字段中文名称是固定值“rainfall_real_data”否}降水数据接口输出字段如表14所示。表14降水数据字段接口输出字段中文名称中文名称降水量数据，单位：mm降水强度降水形态雪{{}]}0路面状态数据包括字段名称、数据结构，数据接口请求字段如表15所示。中文名称是固定值“roadDetection_real_data”否{"action":"roadDetect}1路面状态数据接口输出字段如表16所示。中文名称UTC+8,毫秒级温度，单位：℃温度，单位：℃1-干燥；2-潮湿；3-有水；4-有雪/冰"action":"roadDetect{}]}6.1.5设备状态信息数据接口设备状态信息数据接口定时获取路测外场设备状态信息，接口类型宜采用HTTP,数据请求模式POST,接口数据请求频率不大于1min,数据接口请求字段如表17所示。表17设备状态信息数据接口请求字段中文名称是固定值"device_status"{}设备状态数据接口输出字段如表18所示。表18设备状态信息数据接口返回中文名称1-设备；2-平台当前工作的相机数量当前工作的雷达数量雷达设备编号{}]}6.2其他系统接入数据6.2.1“两客一危”数据接口“两客一危”数据接口应符合JT/T809的规定。6.2.2收费系统数据接口收费系统数据接口应符合JT/T1415的规定。6.2.3交调数据接口交调数据接口应符合JT/T1008.2的规定。7数据服务接口7.1.1设备概览设备概况数据为应用系统提供概览及通用检索数据支撑。设备概况数据包括字段名称、字段类型，接口类型宜采用HTTP,数据接口请求字段如表19所示。表19设备概况数据接口请求字段中文名称是固定值“device_overview”{}设备概况数据接口输出字段如表20所示。表20设备概况数据接口输出字段中文名称表20设备概况数据接口输出字段(续)中文名称{{]7.1.2查询区域内网联车辆区域内网联车辆数据为应用系统提供网联车辆监管支撑。区域内网联车辆数据包括字段名称、字段类型，接口类型宜采用WebSocket,接口数据推送频率宜不大于100ms,数据接口请求字段如表21所示。表21区域内网联车辆数据接口请求字段中文名称是固定值"vehicle" {}区域内网联车辆数据接口输出字段如表22所示。表22区域内网联车辆数据接口输出字段中文名称单位：deg(°)航向角单位：deg(°)上报时间单位：ms设备编号设备类型1-TBOX/CBOX;2-0BU;3-边缘计算设备；4-1-平台车；2-V2X过路车；3-感知车更新时间单位：ms{}}}7.1.3查询地图路侧点位地图路侧点位数据为应用系统提供高速沿线基础设施检索功能。区域内地图路侧点位数据包括字段名称、字段类型，接口类型宜采用HTTP,数据接口请求字段如表23所示。表23区域内地图路侧点位数据接口请求字段中文名称是固定值"road_point"是true:只查询绑定摄像头的点位；{表24区域内地图路侧点位数据接口输出字段中文名称 {{"rsName":"xxx高速1号杆"}]}7.1.4查询指定路侧点位绑定摄像头列表指定路侧点位绑定的摄像头数据为应用系统提供摄像头检索功能。指定路侧点位绑定的摄像头数据包括字段名称、字段类型，接口类型宜采用HTTP,数据接口请求字段如表25所示。表25指定路侧点位绑定摄像头数据接口请求字段中文名称是固定值“rs_camId”是{4.3指定路侧点位绑定摄像头数据接口输出字段如表26所示。表26指定路侧点位绑定摄像头数据接口输出字段中文名称枚举：0-车载；1-路侧流{{"serialNum":"130000000"cameraParam":"{"x":114.6552371668413,"y":38.261290827561474,"z":9.890"rsName":"XX高速8号杆"}]}7.1.5查询摄像头直播地址摄像头直播地址数据为应用系统提供摄像头视频播放功能。摄像头直播地址数据包括字段名称、字段类型，接口类型宜采用HTTP,数据接口请求字段如表27所示。表27摄像头直播地址数据接口请求字段中文名称是固定值"streaming_address"是枚举：0-车载；1-路侧是"serialNum":"13000000摄像头直播地址数据接口输出字段如表28所示。表28摄像头直播地址数据接口输出字段中文名称{"rtmp":"rtmp://IP:PORT/X"flvUrl":"http://IP:"hlsUrl":"http://IP:P"wsUrl":"ws://IP:PORT/w}}7.1.6查询地图气象站查询地图气象站数据为应用系统提供气象站检索功能。查询地图气象站数据包括字段名称、字段类型，接口类型宜采用HTTP,数据接口请求字段宜根据系统需求设置。数据接口请求字段如表29所示。表29查询地图气象站数据接口请求字段中文名称是固定值“weather_stations”{}查询地图气象站数据接口输出字段如表30所示。表30查询地图气象站数据接口输出字段中文名称字段类型接口返回消息经度Ip地址{"detectorName":"1号气象站",}]}7.1.7查询气象站动态数据气象站动态数据为应用系统提供气象站数据查询功能。气象站动态数据包括字段名称、字段类型，接口类型宜采用WebSocket,接口数据推送频率宜不大于1min,数据接口请求字段如表31所示。表31查询气象站动态数据接口请求字段中文名称是固定值“station_real_data” 示例：{}查询气象站动态数据接口输出字段和结果如表32和表33所示。表32查询气象站动态数据接口输出字段中文名称固定值"vehicle"表33查询气象站动态数据result表中文名称必填，设备的唯一标识必填，UTC+8,毫秒级必填，单位：m/s风向角度选填，单位：空气温度必填，单位：℃露点温度选填，单位：℃选填，单位：g/m³19中文名称降水量降水强度降水形态能见度必填，单位：℃必填，单位：℃1-干燥；2-潮湿；3-有水；4-有雪/冰未来1小时路面结冰的概率，预测值范围0~5,0表示没有结冰预警，1~5随数值增大，必填，单位：℃必填，单位：℃冰必填，单位：℃{"snowThickness":0,"roadCondition":0,}}7.1.8查询地图事件检测器查询地图事件检测器数据包括字段名称及数据结构，接口类型宜采用HTTP,数据接口请求字段宜根据系统需求设置。数据接口请求字段如表34所示。表34查询气象站动态数据接口请求字段中文名称是{}查询地图事件检测器数据接口输出字段如表35所示。表35查询地图事件检测器数据接口输出字段中文名称{"detectorName":"1号事件检测器"}]}7.1.9查询地图能见度检测器查询地图能见度检测器数据包括字段名称、字段类型，接口类型宜采用HTTP,数据接口请求字段宜根据系统需求设置。数据接口请求字段如表36所示。表36查询地图能见度检测器数据接口请求字段中文名称是固定值"videtector" {}查询地图能见度检测器数据接口输出字段如表37所示。表37查询地图能见度检测器数据接口输出字段中文名称ip地址{"detectorName":"1号能见度检测器",]}7.1.10能见度检测器数据推送查询能见度检测器数据推送包括字段名称、字段类型，接口类型宜采用WebSocket,接口数据推送频率宜采用1min,数据接口请求字段如表38所示。表38查询能见度检测器数据接口请求字段中文名称是固定值“videtector_real_data”"action":"videtecto}查询能见度检测器数据接口输出字段如表39查询能见度检测器数据接口输出字段中文名称消息时间戳能见度能见度检测器ip上报时间数据采集时间，单位：ms{"action":"videtecto{}]}7.2管理7.2.1运营基本状态数据运营基本状态数据包括字段名称、字段类型，接口类型宜采用HTTP,数据接口请求字段如表40所示。表40查询运营基本状态数据接口请求字段中文名称是固定值"static_mng"}查询运营基本状态数据接口输出字段如表41所示。表41查询运营基本状态数据接口输出字段中文名称固定值"static_mng"表41查询运营基本状态数据接口输出字段(续)中文名称"result":{}}7.2.2查询有效事件查询有效事件信息包括字段名称、字段类型，接口类型宜采用WebSocket,接口数据推送频率宜不大于10s,数据接口请求字段如表42所示。表42查询有效事件信息数据接口请求字段中文名称是固定值"event_efficient"}查询有效事件信息数据接口输出字段如表43所示。表43查询有效事件信息数据接口输出字段中文名称固定值“event_efficient”UTC+8,毫秒级参照GB/T35561的规定事件；4-拥堵事件；5-遗落事件；发生时间单位：ms{"result":{{"eventName":"大雨",}]}}7.2.3有效事件处理情况有效事件处理情况包括字段名称、字段类型，接口类型宜采用WebSocket,接口数据推送频率宜不大于10s,数据接口请求字段如表44所示。表44查询有效事件处理情况数据接口请求字段中文名称是固定值“mng_event”}查询有效事件处理情况数据接口输出字段如表45所示。表45查询有效事件处理情况数据接口输出字段中文名称固定值"mng_event"已完成事件个数发生时间1:step<4时为待处理；2:step≥8时为已完成；3:4～7时为处理中{"eventsource":"车基反馈","eventName":"大雨","processor":"管理员",}]}}7.3.1查询网联车辆信息查询网联车辆信息数据包括字段名称、字段类型，接口类型宜采用WebSocket,接口数据推送频率宜大于10s,数据接口请求字段如表46所示。表46查询网联车辆信息数据接口请求字段中文名称是固定值“connected_vehicle_info”{3.1.2查询网联车辆信息数据接口输出字段如表47所示。表47查询网联车辆信息数据接口输出字段中文名称车辆图片照片地址自动驾驶级别货车；4:特型车"action":"connected{"pic":"1/"plateNo"