2022道路交通動(dòng)態(tài)數(shù)據(jù)采集接口規(guī)范

道路交通動(dòng)態(tài)數(shù)據(jù)采集接口規(guī)范目 次前 言 II1范圍 1規(guī)范性用文件 1術(shù)語(yǔ)和義 14縮略語(yǔ) 2整體架構(gòu) 2數(shù)據(jù)采接口技要求 2接口式 2交換程 3數(shù)據(jù)信接口格式 3數(shù)據(jù)構(gòu) 3登錄證 3通用文結(jié)構(gòu) 3數(shù)據(jù)息接口 3IPAGEPAGE1道路交通動(dòng)態(tài)數(shù)據(jù)采集接口規(guī)范范圍術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。個(gè)人車(chē)輛personalvehicle為私人所擁有、以滿足個(gè)人和家庭出行需要為主要目的非盈利車(chē)輛。行業(yè)車(chē)輛businessvehicle車(chē)聯(lián)網(wǎng)終端terminalininternetofvehicles安裝在車(chē)輛上的可實(shí)現(xiàn)與路側(cè)設(shè)備、云平臺(tái)等開(kāi)展信息交互的通信設(shè)備。道路交通動(dòng)態(tài)數(shù)據(jù)管理系統(tǒng)roadtrafficdynamicdatamanagementsystem由道路、通信設(shè)備、中心控制計(jì)算機(jī)及相關(guān)軟件等組成，用于道路交通控制的系統(tǒng)。車(chē)聯(lián)網(wǎng)設(shè)備身份認(rèn)證平臺(tái)internetofvehiclesdeviceidentityauthenticationplatform對(duì)數(shù)據(jù)交換過(guò)程中的車(chē)聯(lián)網(wǎng)終端及路側(cè)設(shè)備進(jìn)行身份認(rèn)證的中心平臺(tái)。交通管制trafficcontrol出于某種安全方面的原因，對(duì)于部分或者全部交通路段的車(chē)輛和人員通行進(jìn)行的控制措施。施工占道occupying-roadconstruction由于施工，道路被占用的情況。交通事故trafficaccident車(chē)輛在道路上因過(guò)錯(cuò)或者意外造成人身傷亡或者財(cái)產(chǎn)損失的事件。道路擁堵roadcongestion（路段或交叉口）上的交通現(xiàn)象。交通指數(shù)trafficperformanceindex采用0～10表示道路網(wǎng)暢通或擁堵程度的概念性指數(shù)值，數(shù)值越高表明交通擁堵?tīng)顩r越嚴(yán)重。縮略語(yǔ)下列縮略語(yǔ)適用于本文件。LTE：長(zhǎng)期演進(jìn)LongTermEvolution5G：第五代移動(dòng)通信技術(shù)5thGenerationMobileCommunicationTechnologyHTTP：超文本傳輸協(xié)議HyperTextTransferProtocolJSON：JavaScript對(duì)象簡(jiǎn)譜JavaScriptObjectNotationUTF：統(tǒng)一碼轉(zhuǎn)換格式UnicodeTransformationFormatWGS-84：1984年世界大地坐標(biāo)系統(tǒng)WorldGeodeticSystem1984GCJ：中國(guó)國(guó)測(cè)局地理坐標(biāo)GuojiaCehuiJu整體架構(gòu)圖1 道路交通態(tài)數(shù)據(jù)集整體構(gòu)道路交通動(dòng)態(tài)數(shù)據(jù)采集整體由車(chē)載和路側(cè)感知設(shè)備、道路交通動(dòng)態(tài)數(shù)據(jù)管理系統(tǒng)、車(chē)聯(lián)網(wǎng)數(shù)據(jù)交換平臺(tái)、車(chē)聯(lián)網(wǎng)終端、車(chē)聯(lián)網(wǎng)設(shè)備身份認(rèn)證平臺(tái)五部分組成。車(chē)聯(lián)網(wǎng)數(shù)據(jù)交換平臺(tái)分為車(chē)聯(lián)網(wǎng)數(shù)據(jù)采集系統(tǒng)和分發(fā)系統(tǒng)兩部分。車(chē)聯(lián)網(wǎng)數(shù)據(jù)采集系統(tǒng)實(shí)時(shí)采集接口形式JSON。車(chē)聯(lián)網(wǎng)數(shù)據(jù)交換平臺(tái)與道路交通動(dòng)態(tài)數(shù)據(jù)管理系統(tǒng)進(jìn)行數(shù)據(jù)同步，兩者的接口協(xié)議宜基于HTTP，服務(wù)結(jié)構(gòu)體宜支持JSON。車(chē)聯(lián)網(wǎng)數(shù)據(jù)交換平臺(tái)和車(chē)聯(lián)網(wǎng)終端進(jìn)行數(shù)據(jù)同步，兩者的接口協(xié)議為HTTP或MQTT，服務(wù)結(jié)構(gòu)體支持JSON。交換過(guò)程車(chē)聯(lián)網(wǎng)數(shù)據(jù)交換平臺(tái)從車(chē)載和路側(cè)感知設(shè)備或道路交通動(dòng)態(tài)數(shù)據(jù)管理系統(tǒng)獲取道路交通動(dòng)態(tài)數(shù)據(jù)。數(shù)據(jù)結(jié)構(gòu)所有的請(qǐng)求和應(yīng)答報(bào)文宜采用JSON格式，編碼方式為UTF-8。登錄認(rèn)證登錄認(rèn)證httpurl為datacollect/auth/<userId>。接口要求以中<user_id>和BODY狀態(tài)碼字符串表1元素名稱(chēng)約束類(lèi)型描述companyId必須String單位標(biāo)識(shí)（由交換平臺(tái)統(tǒng)一分配）token必須String客戶(hù)端進(jìn)行請(qǐng)求的一個(gè)令牌IPCType必須Number業(yè)務(wù)接口代碼，具體內(nèi)容見(jiàn)表2、5、8、11busiBody必須結(jié)構(gòu)體業(yè)務(wù)結(jié)構(gòu)，具體內(nèi)容見(jiàn)表2、5、8、11業(yè)務(wù)描述：實(shí)時(shí)同步施工占道數(shù)據(jù)信息交換頻率：增量更新表2施工占道信息接口表名稱(chēng)約束類(lèi)型描述IPCType必須Number業(yè)務(wù)接口代碼areaId必須Number所屬省市區(qū)編號(hào)routes必須Array包含施工占道路段的數(shù)組，具體內(nèi)容見(jiàn)表3timeStamp必須String時(shí)間戳表3施工占道路段數(shù)組表(routes)名稱(chēng)約束類(lèi)型描述routeId必須Number施工路段編號(hào)operateType必須Number操作類(lèi)型，1：新增，2：修改，3：刪除routeName必須String施工路段名稱(chēng)direction必須Number施工路段方向，1：南往北，2：北往南，3：東往西，4：西往東length必須Number施工路段長(zhǎng)度，單位：米width可選Number施工路段寬度，單位：米lanes可選Number施工占用的車(chē)道個(gè)數(shù)startTime必須String施工圍擋開(kāi)始時(shí)間，yyyy-MM-ddHH:mm:ssendTime必須String施工圍擋結(jié)束時(shí)間，yyyy-MM-ddHH:mm:sspoints必須Arrary施工占道路段坐標(biāo)數(shù)組，具體內(nèi)容見(jiàn)表4ptype必須String坐標(biāo)系類(lèi),WGS-84、GCJ-02describe可選String具體描述表4施工占道路段坐標(biāo)數(shù)組表(points)名稱(chēng)約束類(lèi)型描述lng必須Number點(diǎn)位經(jīng)度坐標(biāo)，單位：度，精確到10-6lat必須Number點(diǎn)位緯度坐標(biāo)，單位：度，精確到10-6業(yè)務(wù)描述：實(shí)時(shí)同步交通管制數(shù)據(jù)信息交換頻率：增量更新表5交通管制信息接口表名稱(chēng)約束類(lèi)型描述IPCType必須Number業(yè)務(wù)接口代碼areaId必須Number所屬省市區(qū)編號(hào)routes必須Array管制路段數(shù)組，具體內(nèi)容見(jiàn)表6timeStamp必須Number時(shí)間戳表6交通管制路段數(shù)組表（routes）名稱(chēng)約束類(lèi)型描述routeId必須Number管制路段編號(hào)operateType必須Number操作類(lèi)型，1：新增，2：修改，3：刪除routeName必須String管制路段的名稱(chēng)direction必須Number管制路段方向，1：南往北，2：北往南，3：東往西，4：西往東startTime必須String管制開(kāi)始時(shí)間，yyyy-MM-ddHH:mm:ssendTime必須String管制結(jié)束時(shí)間，yyyy-MM-ddHH:mm:sspoints必須Array管制路段坐標(biāo)數(shù)組，具體內(nèi)容見(jiàn)表7ptype必須String坐標(biāo)系類(lèi)，WGS-84、GCJ-02describe可選String具體描述表7交通管制路段坐標(biāo)數(shù)組表（points）名稱(chēng)約束類(lèi)型描述lng必須Number點(diǎn)位經(jīng)度坐標(biāo)，單位：度，精確到10-6lat必須Number點(diǎn)位緯度坐標(biāo)，單位：度，精確到10-6業(yè)務(wù)描述：實(shí)時(shí)同步交通事故數(shù)據(jù)信息交換頻率：增量更新表8交通事故信息接口表名稱(chēng)約束類(lèi)型描述IPCType必須Number業(yè)務(wù)接口代碼areaId必須Number所屬省市區(qū)編號(hào)routes必須Array事故路段數(shù)組，具體內(nèi)容見(jiàn)表9timeStamp必須Number時(shí)間戳表9交通事故路段數(shù)組表（routes）名稱(chēng)約束類(lèi)型描述routeId必須Number事故路段編號(hào)operateType必須Number操作類(lèi)型，1：新增，2：修改，3：刪除routeName必須String事故路段的名稱(chēng)place必須Number事故地點(diǎn)，1：機(jī)動(dòng)車(chē)道，2：非機(jī)動(dòng)車(chē)道，3：機(jī)非混合車(chē)道，4：人行道，5：緊急停車(chē)帶，6：其他form必須Number事故形態(tài)，1：車(chē)輛間事故，2：車(chē)輛與行人，3：?jiǎn)诬?chē)事故description可選Number事故類(lèi)型，1：死亡事故，2：傷人事故，3：財(cái)產(chǎn)損失事故，4：簡(jiǎn)易程序事故reason可選Number3：行人67：意外，8：其他condition可選String傷亡情況startTime必須String事故發(fā)生時(shí)間，yyyy-MM-ddHH:mm:ssendTime可選String預(yù)計(jì)處理結(jié)束時(shí)間，yyyy-MM-ddHH:mm:sspoints必須Array事故路段坐標(biāo)數(shù)組，具體內(nèi)容見(jiàn)表10ptype必須String坐標(biāo)系類(lèi)，WGS-84、GCJ-02describe可選String具體描述表10交通事故路段坐標(biāo)數(shù)組表（points）名稱(chēng)約束類(lèi)型描述lng必須Number點(diǎn)位經(jīng)度坐標(biāo)，單位：度，精確到10-6lat必須Number點(diǎn)位緯度坐標(biāo)，單位：度，精確到10-6業(yè)務(wù)描述：實(shí)時(shí)同步道路擁堵數(shù)據(jù)信息交換頻率：（30秒-1分鐘）/次表11道路擁堵信息接口表名稱(chēng)約束類(lèi)型描述IPCType必須Number業(yè)務(wù)接口代碼areaId必須Number所屬省市區(qū)編號(hào)Routes必須Array擁堵路段數(shù)組，具體內(nèi)容見(jiàn)表12timeStamp必須Number時(shí)間戳表12道路擁堵路段數(shù)組表（routes）名稱(chēng)約束類(lèi)型描述routeId必須Number擁堵路段編號(hào)operateType必須Number操作類(lèi)型，1：新增，2：修改，3：刪除routeName必須String擁堵路段的名稱(chēng)length必須Number路段擁堵長(zhǎng)度，單位：米lanes可選Number占用的車(chē)道個(gè)數(shù)trafficPerformance-Index必須Number123擁堵，5：嚴(yán)重?fù)矶耫irection必須Number134startTime必須String擁堵發(fā)生時(shí)間，yyyy-MM-ddHH:mm:ssendTime可選S