ICS 03.220.20 CCS P 66 13 河北省 地方 标准 DB 13/T 5998—2024 智慧高速公路交通云控平台数据接口 技术规范 Technical specification for data interface of intelligent expressway traffic cloud control platform 2024 - 08 - 12发布 2024 - 09 - 12实施 河北省市场监督管理局 发布 DB 13/T 5998 —2024 I 目次 前言 ................................ ................................ ............... II 1 范围 ................................ ................................ ............. 1 2 规范性引用文件 ................................ ................................ ... 1 3 术语和定义 ................................ ................................ ....... 1 4 缩略语 ................................ ................................ ........... 1 5 数据交互流程及接口分类 ................................ ........................... 1 6 数据采集接口 ................................ ................................ ..... 2 7 数据服务接口 ................................ ................................ .... 12 8 接口响应状态码 ................................ ................................ .. 26 9 接口交互安全 ................................ ................................ .... 26 DB 13/T 5998 —2024 II 前言 本文件按照 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规 定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由河北省交通运输厅提出并归口。 本文件起草单位：河北省交通规划设计研究院有限公司。 本文件主要起草人： 何勇海、雷伟、焦彦利、张龙、付增辉、韩明敏、 葛志鹏、金凤温、张义彬、 张凯丽、解振龙、蒋岚、牛兆霞、 游燕燕、 潘显豪、牛志愿、段河霞、侯建华、谭振东、杨欣、 蔺会娟、 石磊、王学军 。 DB 13/T 5998 —2024 1 智慧高速公路交通云控平台数据接口 技术规范 1 范围 本文件规定了智慧高速公路交通云控平台数据接口的术语和定义、数据交互流程及接口分类、 数据采集接口和数据服务接口、接口响应状态码及接口交互安全等的要求。 本文件适用于新建智慧高速公路、运营高速公路智慧化升级改造及高速公路相关系统的平台数 据接口设计与开发。普通干线公路系统数据接口开发可参照执行。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期 的引用 文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单） 适用于本文件。 GB/T 917 公路路线标识规则和国道编号 GB/T 35561 突发事件分类与编码 JT/T 809 道路运输车辆卫星定位系统 平台数据交换 JT/T 1008 .1-2015 公路交通情况调查设备 第1部分：技术条件 JT/T 1008 .2 公路交通情况调查设备 第2部分：通信协议 JT/T 1415 交通运输数据资源交换与共享 T/CITSA 09 车路协同系统应用层数据标准 T/CITSA 18 网联车辆平台间协同服务信息交互规范 3 术语和定义 下列术语和定义适用于本文件。 交通云控平台 traffic cloud control platform 基于智能网联云控技术，面向交通管理需求，建设的逻辑协同、物理分散的路段云、路网云平 台。 第三方系统平台 Third-party system platforms 与交通云控平台进行数据交互的其他系统平台。 4 缩略语 HTTP—超文本传输协议（ Hypertext Transfer Protocol ） JSON—JavaScri pt对象简谱（ JavaScript Object Notation ） SSL—安全套接层 (Secure Sockets Layer) UTC—协调世界时 (Universal Time Coordinated) 5 数据交互流程及接口分类 接口分类 数据接口包括数据采集接口和数据服务接口，数据交互流程如图 1所示。 DB 13/T 5998 —2024 2 图1 数据交互流程 数据采集接口 数据采集接口 主要负责智慧高速公路感知系统数据和其他系统接入数据的获取。感知系统数据 包括但不限于车辆目标实时信息、交通统计信息、交通事件信息、气象数据、设备状态信息等外场 设备获取的数据。其他系统接入数据包括但不限于交通管理系统、“两客一危”系统、收费系统及 路网联合管控提供的必要管理数据。数据采集接口类型宜采用 HTTP/WebSocket 接口，数据结构宜采 用JSON结构。其中，感知系统与其他系统作为接口服务器端，智慧高速公路交通云控平台作为接口 客户端，请求模式为主动推送模式。 数据服务接口 数据服务接口 主要负责为公共服务业务或应用系统提供数据，可根据应用需求进行扩展。数据 服务接口类型宜采用 HTTP/WebSocket 接口，数据结构宜采用 JSON结构。其中，智慧高速公路交通云 控平台作为接口服务器端，第三方平台作为接口客户端，请求模式为双向通信方式；允许客户端和 服务器在需要时主动发送消息，同时也可以接收消息。 6 数据采集接口 感知系统业务数据 6.1.1 车辆目标实时信息数据接口 6.1.1.1 车辆目标实时信息数据接口实时获取路侧感知车辆目标信息， 接口类型宜采用 WebSocket ， 接口数据推送频率不大于 100ms，数据接口请求字段如表 1所示。 表1 车辆目标实时信息数据请求字段 字段名称 中文名称 字段类型 是否必填 备注 action 业务类型 STRING 是 固定值“ road_real_data_per ” result type 推送类型 INT 是 固定值1 polygon 区域数据 JSON Array 是 多边形区域（经纬度，单位 :°，保留 12 位小数） 示例： { "action": "road_real_data_per", "result": { "type": 1, "polygon": [ [116.227998031041, 39.1788317256612], DB 13/T 5998 —2024 3 [116.230173538096, 39.1660561471784], [116.158069365442, 39.1569717025223], [116.156634456533, 39.1699323002445] ] } } <RaderAreaP1 longitude="116.227998031041" latitude="39.1788317256612" label=" 围点1-左下"/> <RaderAreaP2 longitude="116.230173538096" latitude="39.1660561471784" la bel="围点2-左上"/> <RaderAreaP3 longitude="116.158069365442" latitude="39.1569717025223" label=" 围点3-右上"/> <RaderAreaP4 longitude="116.156634456533" latitude="39.1699323002445" label=" 围点4-右下"/> 6.1.1.2 车辆目标实时信息数据接口返回字段如表 2所示。 表2 车辆目标实时信息数据返回字段 字段名称 中文名称 字段类型 备注 action 业务类型 STRING ro