智慧高速公路交通云控平臺數據接口技術規范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/m3{{}]}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/m319中文名稱降水量降水強度降水形態能見度必填，單位：℃必填，單位：℃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"