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

ICS03.220.20

CCSP66

13

河北省地方标准

DB13/T5998—2024

智慧高速公路交通云控平台数据接口

技术规范

Technicalspecificationfordatainterfaceofintelligentexpresswaytrafficcloud

controlplatform

2024-08-12发布2024-09-12实施

河北省市场监督管理局发布

DB13/T5998—2024

目次

前言...............................................................................II

1范围.............................................................................1

2规范性引用文件...................................................................1

3术语和定义.......................................................................1

4缩略语...........................................................................1

5数据交互流程及接口分类...........................................................1

6数据采集接口.....................................................................2

7数据服务接口....................................................................12

8接口响应状态码..................................................................26

9接口交互安全....................................................................26

I

DB13/T5998—2024

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规

定起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由河北省交通运输厅提出并归口。

本文件起草单位：河北省交通规划设计研究院有限公司。

本文件主要起草人：何勇海、雷伟、焦彦利、张龙、付增辉、韩明敏、葛志鹏、金凤温、张义彬、

张凯丽、解振龙、蒋岚、牛兆霞、游燕燕、潘显豪、牛志愿、段河霞、侯建华、谭振东、杨欣、蔺会娟、

石磊、王学军。

II

DB13/T5998—2024

智慧高速公路交通云控平台数据接口

技术规范

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数据交互流程及接口分类

接口分类

数据接口包括数据采集接口和数据服务接口，数据交互流程如图1所示。

1

DB13/T5998—2024

图1数据交互流程

数据采集接口

数据采集接口主要负责智慧高速公路感知系统数据和其他系统接入数据的获取。感知系统数据

包括但不限于车辆目标实时信息、交通统计信息、交通事件信息、气象数据、设备状态信息等外场

设备获取的数据。其他系统接入数据包括但不限于交通管理系统、“两客一危”系统、收费系统及

路网联合管控提供的必要管理数据。数据采集接口类型宜采用HTTP/WebSocket接口，数据结构宜采

用JSON结构。其中，感知系统与其他系统作为接口服务器端，智慧高速公路交通云控平台作为接口

客户端，请求模式为主动推送模式。

数据服务接口

数据服务接口主要负责为公共服务业务或应用系统提供数据，可根据应用需求进行扩展。数据

服务接口类型宜采用HTTP/WebSocket接口，数据结构宜采用JSON结构。其中，智慧高速公路交通云

控平台作为接口服务器端，第三方平台作为接口客户端，请求模式为双向通信方式；允许客户端和

服务器在需要时主动发送消息，同时也可以接收消息。

6数据采集接口

感知系统业务数据

6.1.1车辆目标实时信息数据接口

车辆目标实时信息数据接口实时获取路侧感知车辆目标信息，接口类型宜采用WebSocket，

接口数据推送频率不大于100ms，数据接口请求字段如表1所示。

表1车辆目标实时信息数据请求字段

字段名称中文名称字段类型是否必填备注

action业务类型STRING是固定值“road_real_data_per”

type推送类型INT是固定值1

result多边形区域（经纬度，单位:°，保留12

polygon区域数据JSONArray是

位小数）

示例：

{

"action":"road_real_data_per",

"result":{

"type":1,

"polygon":[

[116.227998031041,39.1788317256612],

2

DB13/T5998—2024

[116.230173538096,39.1660561471784],

[116.158069365442,39.1569717025223],

[116.156634456533,39.1699323002445]

]

}

}

<RaderAreaP1longitude="116.227998031041"latitude="39.1788317256612"label="围点1-左下"/>

<RaderAreaP2longitude="116.230173538096"latitude="39.1660561471784"label="围点2-左上"/>

<RaderAreaP3longitude="116.158069365442"latitude="39.1569717025223"label="围点3-右上"/>

<RaderAreaP4longitude="116.156634456533"latitude="39.1699323002445"label="围点4-右下"/>

车辆目标实时信息数据接口返回字段如表2所示。

表2车辆目标实时信息数据返回字段

字段名称中文名称字段类型备注

action业务类型STRINGroad_real_data_per

code接口响应状态码INT

message接口返回消息STRING

time消息时间戳LONGUTC+8，毫秒级

ecdevId边缘计算设备编号STRING

type轨迹类型INT固定值3

gpsTime融合时间戳LONGUTC+8，毫秒级

vehicleId目标编号STRING

longitude目标经度FLOAT经度(°)，保留9位小数

latitude目标纬度FLOAT经度(°)，保留9位小数

heading航向角FLOAT单位:°

speed目标速度FLOAT单位：km/h

resultperListplateNo车牌号STRING

confidence置信度FLOAT

result

devId设备编号STRING

timestamp感知时间戳LONGUTC+8，毫秒级

参照JT/T1008.1-2015附录A执

targetType目标类型STRING

行

1-蓝色；2-黄色；3-白色；4-黑

objColor目标颜色INT色；5-绿色；6-红；7-橙色；8-

紫色；9-灰色；10-银色

示例：

{

"action":"road_real_data_per",

"message":"Success",

"code":200,

"time":1618803971941,

"result":

"perList":[

{

"devId":"U-EC0001",

"result":[

{

"confidence":1,

"devId":"U-LG0001",

"timestamp":1618803971587,

"heading":90.0,

"latitude":39.793261754981074,

"longitude":116.50772066581348,

"plateNo":"冀AXXXXX",

"speed":0.45,

"targetType":"小型车",

"vehicleId":"10000000000000000000000000000031",

3

DB13/T5998—2024

"objColor":2

}

],

"gpsTime":1618803971587,

"type":3

}

]

}

6.1.2交通统计信息数据接口

交通统计信息包括字段名称、数据结构，接口类型宜采用WebSocket，接口数据推送频率

宜不大于30s，数据接口请求字段如表3所示。

表3交通统计信息接口请求字段

字段名称中文名称字段类型是否必填备注

action业务类型STRING是固定值“traffic_flow”

station桩号STRING否设备位置

示例：

{

"action":"traffic_flow",

"station":"KXX+XXX"

}

交通统计信息数据接口输出字段如表4所示。

表4交通统计信息接口返回字段

字段名称中文名称字段类型备注

action业务类型STRING

code接口响应状态码INT接口响应状态码

message接口返回消息STRING

time消息时间戳LONGUTC+8，毫秒级

ecuId边缘计算编号STRING

channel渠道来源INT

devId感知设备编号INT

timestamp感知时间戳LONGUTC+8，毫秒级

laneNum车道数INT

laneId车道编号INT

trafficFlowA中小客车流量INT

trafficFlowB小型货车INT

trafficFlowC大客车流量INT

result

trafficFlowD中型货车流量INT

trafficFlowE大型货车流量INT

trafficFlowF特大型货车流量INT

trafficFlowG集装箱车流量INT

trafficFlowH摩托车流量INT

occupancy时间占有率INT单位：%

aveSpeed平均速度FLOAT单位：km/h

aveLength平均车长FLOAT单位：dm

aveInterval平均车头时距FLOAT单位：s

示例：

4

DB13/T5998—2024

{

"action":"traffic_flow",

"code":200,

"message":"Success",

"time":1617179420535,

"result":[

{

"ecuId":"rd_866400_1",

"channel":0,

"devId":"05612356185",

"timestamp":"1617179420535",

"laneNum":"5",

"laneId":1,

"trafficFlowA":21,

"trafficFlowB":11,

"trafficFlowC":23,

"trafficFlowD":23,

"trafficFlowE":23,

"trafficFlowF":20,

"trafficFlowG":8,

"trafficFlowH":5,

"occupancy":16,

"aveSpeed":85,

"aveLength":50,

"veInterval":2

},

{

"ecuId":"rd_866400_1",

"channel":0,

"devId":"05612356185",

"timestamp":"1617179420535",

"laneNum":"5",

"laneId":2,

……

}

]

}

6.1.3交通事件信息数据接口

交通事件信息包括字段名称、数据结构。接口类型宜采用WebSocket，接口数据推送频率

不大于100ms，数据接口请求字段如表5所示。

表5交通事件信息数据接口请求字段

字段名称中文名称字段类型是否必填备注

action业务类型STRING是固定值“event_efficient”

示例：

{

"action":"event_efficient"

}

交通事件信息数据接口输出字段如表6所示。

表6交通事件信息数据接口输出字段

字段名称中文名称字段类型备注

action业务类型STRING

code接口响应状态码INT

5

DB13/T5998—2024

表6交通事件信息数据接口输出字段（续）

字段名称中文名称字段类型备注

message接口返回消息STRING

time消息时间戳LONGUTC+8，毫秒级

ecdevId边缘计算设备IDSTRING

devId感知设备IDSTRING设备唯一ID，

timestamp感知时间戳LONGUTC+8，毫秒级

dataVersion数据版本INT数据版本

roadId路段IDSTRING参照GB/T917的规定

camId摄像机IDINT摄像机编号

presetId预置IDINT0～255

0-蓝色，1-黄色，2-黑色，3-白色，4-渐变绿色，5-黄绿双

plateColor车牌颜色INT

拼色，6-蓝白渐变色，9-未确定，11-绿色，12-红色

startTime开始时间STRING格式：yyyyMMddHHmmssSSS

endTime结束时间STRING格式：yyyyMMddHHmmssSSS

dataType数据类型INT数据类型：交通事件

1-停车事件；2-行人事件；3-逆行事件；4-拥堵事件；5-遗

落事件；6-烟雾事件；7-火灾事件；8-超速行驶事件；9-压

evenType事件类型INT线检测；10-穿越事件；11-排队超限事件；12-禁行区行驶；

13-摩托车事件；14-自行车事件；15-重型车辆不按道行驶

result

事件；16-事故事件

location像素位置INT像素位置，横坐标在前

videoAddr录像地址STRING事件违章录像FTP地址（包括录像名称）

imgAddr图像地址STRING事件违章抓图FTP地址（不包括图片名称）

img1Name图像1名称STRING图片名称

img1Time图像1时间STRING格式：yyyyMMddHHmmssSSS

img2Name图像2名称STRING图片名称

img2Time图像2时间STRING格式：yyyyMMddHHmmssSSS

img3Name图像3名称STRING图片名称

img3Time图像3时间STRING格式：yyyyMMddHHmmssSSS

img4Name图像4名称STRING图片名称

img4Time图像4时间STRING格式：yyyyMMddHHmmssSSS

eventDesc事件描述STRING事件描述

longitude经度FLOAT保留7位有效位

latitude纬度FLOAT保留7位有效位

laneId车道号INT车道号

示例：

{

"action":"event_efficient",

"time":1617179420535,

"code":200,

"message":"Success",

"result":[

{

"devId":eventfinder_rw_866100,

"timestamp":1617179420535,

"dataVersion":10,

"roadId":10,

"camId":8661001,

"presetId":24,

"plateColor":1,

"startTime":20230629222510000,

"endTime":20230629222610000,

"datatype":1,

"evenType":1,

"location":[156,502],

6

DB13/T5998—2024

"videoAddr"::8080/video/20230629222510000.XXX,

"imgAddr"::8080/image,

"img1Name":"image1",

"img1Time":"20230629222510000",

"img2Name":"image2",

"img2Time":"20230629222520000",

"img3Name":"image3",

"img3Time":"20230629222530000",

"img4Name":"image4",

"img4Time":"20230629222540000",

"eventDesc"："K866+400停车事件,占据外侧车道",

"longitude"：115.8986233,

"latitude"：39.1739329,

"laneId"：4

}

]

}

6.1.4气象数据接口

气象数据宜采用WebSocket接口进行数据对接，数据推送频率宜不大于1min。

风速风向数据包括字段名称、数据结构，数据接口请求字段如表7所示。

表7风速风向数据接口请求字段

字段名称中文名称字段类型是否必填备注

action业务类型STRING是固定值“wind_real_data”

station桩号STRING否设备位置

示例：

{

"action":"wind_real_data",

"station":"KXX+XXX"

}

风速风向数据接口输出字段如表8所示。

表8风速风向数据接口返回字段

字段名称中文名称字段类型备注

action业务类型STRING

code接口响应状态码INT接口响应状态码

message接口返回消息STRING

time消息时间戳LONGUTC+8，毫秒级

windSpeed风速FLOAT单位：m/s

01指正北，32个方位01～32对应顺时针旋转一周的方

resultwindDirection风向INT

位

windAngle风速角INT角度，单位：°

示例：

7

DB13/T5998—2024

{

"action":"wind_real_data",

"code":200,

"message":"Success",

"time":1617179420535,

"result":[

{

"windSpeed":2.1,

"windDirection":5,

"windAngle":"30"

}

]

}

温湿度数据包括字段名称、数据结构，数据接口请求字段如表9所示。

表9温湿度数据接口请求字段

字段名称中文名称字段类型是否必填备注

action业务类型STRING是固定值“temp_real_data”

station桩号STRING否设备位置

示例：

{

"action":"temp_real_data",

"station":"KXX+XXX"

}

温湿度数据接口输出字段如表10所示。

表10温湿度数据输出字段

字段名称中文名称字段类型备注

action业务类型STRING

code接口响应状态码INT接口响应状态码

message接口返回消息STRING

time消息时间戳LONGUTC+8，毫秒级

airTemp气温FLOAT温度，单位：℃

dewPointTemp露点FLOAT温度，单位：℃

result

relativeHumidity相对湿度FLOAT相对湿度，单位：%

absoluteHumidity