ICSL77備案號：Technologicalspecificationforurbantrafficsynthesizecommandplatform—Interfacerequirements上海市計算機行業(yè)協(xié)會發(fā)布1 1 1 2 12規(guī)范性引用文件 13術語與定義 14縮略語 15通信協(xié)議組成及應用框架 16通信協(xié)議技術要求 2 2 2 4 5附錄A（規(guī)范性附錄）通用數(shù)據(jù)對象定義 7A.1數(shù)據(jù)包對象Message 7 7 7A.1.3操作命令名稱Operation 7 8A.2錯誤信息對象CSTCP_Error 8A.3用戶信息對象CSTCP_User 8A.4訂閱對象MsgEntity 8A.5心跳CSTCP_HeartBeat 9A.6超時對象CSTCP_TimeOut 9附錄B（規(guī)范性附錄）通用操作 B.1系統(tǒng)連接/登錄 B.2系統(tǒng)斷開/登出 B.3信息訂閱 B.4取消訂閱 2B.5心跳信息 B.6超時設置 1T/SCTA303《城市智能交通綜合管控平臺技術規(guī)范通信協(xié)議要求》是上海市計算機行業(yè)協(xié)會制定的城市智能交通綜合管控系列團體標準之一，本系列標準結構如下：——T/SCTA301城市智能交通綜合管控平臺技術規(guī)范前端系統(tǒng)通用技術要求——T/SCTA302城市智能交通綜合管控平臺技術規(guī)范架構與功能——T/SCTA303城市智能交通綜合管控平臺技術規(guī)范通信協(xié)議要求——T/SCTA304城市智能交通綜合管控平臺技術規(guī)范電警卡口數(shù)據(jù)處理本標準按照GB/T1.1-2009《標準化工作導則第1部分：標準的結構和編寫》給出的規(guī)則起草。請注意本文件的某些內容可能涉及專利。本文件的發(fā)布機構不承擔識別這些專利的責任。本標準由上海寶康電子控制工程有限公司提出。本標準由上海市計算機行業(yè)協(xié)會歸口。本標準主要起草單位：上海寶康電子控制工程有限公司、上海寶信軟件股份有限公司本標準起草單位：上海寶康電子控制工程有限公司、上海凌峰信息技術有限公司、上海市城市建設設計研究總院（集團）有限公司、同濟大學、上海理工大學、北方工業(yè)大學、上海市城鄉(xiāng)建設和交通發(fā)展研究院、上海寶信軟件股份有限公司、上海市公安局松江分局、桐鄉(xiāng)市公安局交通警察大隊、菏澤市公安局、招遠市公安局交警大隊、上海市計算機行業(yè)協(xié)會、上海果路交通科技有限公司、上海君來軟件有限公司。本標準主要起草人：黃克彪、鐘淮、阮永華、樊丁玎、童治國、陳高飛、魏飛、符廣賀、陳長明、時俊普、熊啟鵬、歐陽樹生、徐曉熙、孫劍、劉小松、唐克雙、金建良、閆偉、裘維東、王克寧、高翔、韓印、王志建、王媛。本標準首期承諾實施單位：上海寶康電子控制工程有限公司、上海凌峰信息技術有限公司、上海寶信軟件股份有限公司、上海君來軟件有限公司、上海旋思智能科技有限公司、上海果路交通科技有限公司。2隨著各地城市智能交通設施、系統(tǒng)和平臺的建設，以及交通管理的實際需要，交通管理者越來越重視將各類設施設備的數(shù)據(jù)匯聚融合，讓不同種類的數(shù)據(jù)實現(xiàn)聯(lián)動，從而實現(xiàn)單類數(shù)據(jù)價值的增值。但是因為建設時期和建設單位以及廠商的不同，各類前端系統(tǒng)因為由不同廠家建設所采用的標準各不相同，存在數(shù)據(jù)及通信協(xié)議無法兼容的問題，系統(tǒng)集成時往往需要根據(jù)不同的協(xié)議進行接入開發(fā)，費時費力。而如何采用統(tǒng)一的標準來實現(xiàn)數(shù)據(jù)聯(lián)通，采集各類動靜態(tài)信息為城市智能交通綜合管控平臺所用正是本標準制定的目的。本標準通過定義一套標準通信協(xié)議規(guī)范城市智能交通綜合管控平臺和各個子系統(tǒng)之間的通信機制，解決數(shù)據(jù)聯(lián)通的問題。從而降低系統(tǒng)集成的難度和工作量，提高系統(tǒng)集成類平臺建設的效率，縮短建設周期，降低建設成本。1城市智能交通綜合管控平臺通信技術規(guī)范通信協(xié)議要求本標準規(guī)定了城市智能交通綜合管控平臺與各基礎應用系統(tǒng)數(shù)據(jù)通信的通用要求，定義了通信數(shù)據(jù)包結構、通信規(guī)程和通用數(shù)據(jù)對象。本標準適用于城市智能交通綜合管控平臺和各基礎應用系統(tǒng)的軟件設計和開發(fā)。2規(guī)范性引用文件下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GA/T1049.1-2013公安交通集成指揮平臺通信協(xié)議第1部分：總則3術語與定義GA/T1049.1-2013界定的以及下列術語和定義適用于本文件。3.1基礎應用系統(tǒng)basictrafficmanagementsystem與城市智能交通綜合管控平臺進行數(shù)據(jù)通信的車輛緝查布控系統(tǒng)、交通信號控制系統(tǒng)、交通誘導系統(tǒng)、交通態(tài)勢管理系統(tǒng)、警用智慧調度系統(tǒng)等系統(tǒng)的統(tǒng)稱。[GA/T1049.1-2013，定義3.2]3.2數(shù)據(jù)包message通信協(xié)議中單次接收或發(fā)送并以JSON語言描述的字符串數(shù)據(jù)。4縮略語下列縮略語適用于本文件。JSON：對象標記語言（JavaScriptObjectNotation）URL：統(tǒng)一資源定位符（UniformResourceLocators）5通信協(xié)議組成及應用框架城市智能交通綜合管控平臺通信協(xié)議僅規(guī)定了城市智能交通綜合管控平臺與各基礎應用系統(tǒng)數(shù)據(jù)通信的通用要求，定義了通信數(shù)據(jù)包結構、通信規(guī)程和通用數(shù)據(jù)對象，在實現(xiàn)時需參照定義構建各個基礎應用系統(tǒng)的數(shù)據(jù)對象。城市智能交通綜合管控平臺通過上述通信協(xié)議與各基礎應用系統(tǒng)進行數(shù)據(jù)交換，見圖1。2圖1城市智能交通綜合管控平臺通信協(xié)議應用架構圖6通信協(xié)議技術要求6.1一般規(guī)定通信雙方通過交換協(xié)議數(shù)據(jù)的方式實現(xiàn)數(shù)據(jù)通信。每個交換的協(xié)議數(shù)據(jù)都是以JSON語言描述的一個獨立完整的數(shù)據(jù)包。編碼使用UTF-8編碼。數(shù)據(jù)收發(fā)方式除了協(xié)議中明確規(guī)定了時序的操作外，通信雙方數(shù)據(jù)收發(fā)采用全雙工方式。6.2數(shù)據(jù)包6.2.1數(shù)據(jù)包格式數(shù)據(jù)包以根元素Message標記開頭，具體內容見下表1,表2。表1Message數(shù)據(jù)包序號字段名稱字段說明12345367表2Operation操作對象123其中：a)版本號的表示方式為“主版本號.副版本號”,主版本號和副版本號的取值范圍為數(shù)b)令牌由基礎應用系統(tǒng)成功登錄城市智能交通綜合管控平臺后獲得。令牌在每次連接會話中有效，登錄成功前Token元素可取空字符串，登陸成功后取值不能為空，通信雙方收到數(shù)據(jù)后通過檢查Token確認數(shù)據(jù)包是否有效；c)源地址指數(shù)據(jù)包發(fā)送方的地址。源地址由3組字符串組成，每組之間用下劃線連接,即“基礎應用系統(tǒng)類型標識_子系統(tǒng)標識_具體系統(tǒng)標識”，基礎應用系統(tǒng)類型標識取值見表B.1，城市智能交通綜合管控平臺作為源地址或目的地址時無“_子系統(tǒng)標識_具體系統(tǒng)標識”；d)目的地址指數(shù)據(jù)包接收的地址。其取值要求同源地址；e)數(shù)據(jù)包類型分為請求、應答、主動推送、錯誤4種類型。取值見表B.2；f)序列號用于標識一對REQUEST/RESPONSE（即應答數(shù)據(jù)包和請求數(shù)據(jù)包）。序列號取值唯一，最大長度20位，宜采用14位日期（YYYYMMDDHHMMSS）+6位順序號（不足10位前補0）；g)Body為數(shù)據(jù)包的包體，可包含一個或多個操作命令；h)Operation內容為一個操作命令,該操作命令可以包含一個或多個數(shù)據(jù)對象。每個操作命令應包含以下屬性:——order表示操作命令的順序編號，從1開始；——name表示操作命令的名稱，其取值見表B.3。i)Object為數(shù)據(jù)對象，其包含了描述對象具體信息的子元素。系統(tǒng)預定義了5個通用的數(shù)據(jù)對象，見表3。表3系統(tǒng)預定義數(shù)據(jù)對象序號對象元素名說明41CSTCP_Error系統(tǒng)錯誤2CSTCP_User系統(tǒng)用戶3MsgEntity訂閱對象4CSTCP_HeartBeat心跳對象5CSTCP_TimeOut超時對象6.2.2數(shù)據(jù)包最大長度單個數(shù)據(jù)包的最大長度宜為100000個字符。6.2.3大容量特殊數(shù)據(jù)的處理圖片、音視頻文件等大容量數(shù)據(jù)宜不通過本數(shù)據(jù)包進行交換，可通過URL引用數(shù)據(jù)位置。6.2.4擴展性基于JSON自身的擴展性，用戶可通過對本標準中定義的數(shù)據(jù)對象追加元素，實現(xiàn)擴展的6.3通信規(guī)程6.3.1通信連接與斷開6.3.1.1通信連接在通信雙方進行數(shù)據(jù)交換前，城市智能交通綜合管控平臺和各基礎應用系統(tǒng)應建立通信連接，即一方發(fā)出連接請求，接收方應答。通信連接為邏輯上的“連接”。6.3.1.2通信斷開通信雙方中任意一方在需要斷開時發(fā)送請求，接收方收到斷開請求并發(fā)送回復即視為通信斷開，發(fā)送方收到斷開回復后即視為通信斷開。6.3.1.3連接超時斷開通信雙方通過定時交換心跳數(shù)據(jù)包的方式來維持連接，當任意一方3次在約定時間（連接超時時間）內沒有收到心跳數(shù)據(jù)包，則視為連接超時，置狀態(tài)為斷開。城市智能交通綜合管控平臺與各基礎應用系統(tǒng)的連接超時時間由通信雙方自行約定。6.3.1.4通信重連連接應答超時或者通信斷開后，延遲一個時間間隔后重新開始連接過程。該時間間隔由計算機隨機產生，取值范圍為1s-60s。6.3.2各類型數(shù)據(jù)包處理流程6.3.2.1REQUEST類型數(shù)據(jù)包的處理REQUEST類型數(shù)據(jù)包的處理應滿足：5a)發(fā)送方在發(fā)送需要接收方應答的數(shù)據(jù)包時，應發(fā)送REQUEST類型數(shù)據(jù)包。發(fā)送方在REQUEST類型數(shù)據(jù)包發(fā)出后，若在規(guī)定時間內沒有收到任何應答時則視為應答超時錯誤，該請求失敗；b)接收方收到REQUEST類型數(shù)據(jù)包后檢查數(shù)據(jù)包內容。正確的，則向發(fā)送方發(fā)送RESPONSE類型的應答數(shù)據(jù)包；錯誤的，則向發(fā)送方發(fā)送ERROR類型的應答數(shù)據(jù)包。接收方的ERROR或RESPONSE類型數(shù)據(jù)包中Operation的屬性name取值與發(fā)送方的REQUEST類型數(shù)據(jù)包相同。6.3.2.2RESPONSE類型數(shù)據(jù)包的處理RESPONSE類型數(shù)據(jù)包的處理應滿足：a)發(fā)送方收到REQUEST類型數(shù)據(jù)包后檢查數(shù)據(jù)包內容。正確的，則向接收方發(fā)送RESPONSE類型的應答數(shù)據(jù)包；錯誤的，則向接收方發(fā)送ERROR類型的應答數(shù)據(jù)包。發(fā)送方的ERROR或RESPONSE類型數(shù)據(jù)包中Operation的屬性name取值與接收方的REQUEST類型數(shù)據(jù)包相同；b)接收方收到RESPONSE類型數(shù)據(jù)包后檢查數(shù)據(jù)包內容。正確的，則進行相應的處理；錯誤的，則丟棄，并記錄錯誤日志。6.3.2.3PUSH類型數(shù)據(jù)包的處理PUSH類型數(shù)據(jù)包的處理應滿足：a)發(fā)送方在發(fā)送不需要應答的數(shù)據(jù)包時，應發(fā)送PUSH類型數(shù)據(jù)包；b)接收方收到該類數(shù)據(jù)包后檢查數(shù)據(jù)包內容。正確的，則進行相應的處理；錯誤的，則丟棄該數(shù)據(jù)包，并記錄錯誤日志。6.3.2.4ERROR類型數(shù)據(jù)包的處理ERROR類型數(shù)據(jù)包的處理應滿足：a)發(fā)送方收到REQUEST類型數(shù)據(jù)包后檢查數(shù)據(jù)包內容。數(shù)據(jù)包錯誤的，則向接收方發(fā)送ERROR類型的應答數(shù)據(jù)包，該ERROR類型數(shù)據(jù)包中Operation的屬性name取值與其對應的REQUEST類型數(shù)據(jù)包相同；b)接收方收到ERROR類型數(shù)據(jù)包后檢查數(shù)據(jù)包內容。正確的，則進行相應的處理；錯誤的，則丟棄該數(shù)據(jù)包，并記錄錯誤日志。6.4通用操作與數(shù)據(jù)對象6.4.1系統(tǒng)連接/登錄基礎應用系統(tǒng)發(fā)送操作命令Login、數(shù)據(jù)對象為CSTCP_User的請求，城市智能交通綜合管控平臺接收到Login操作數(shù)據(jù)包后驗證并應答，具體見A.1。6.4.2系統(tǒng)斷開/登出需斷開一方發(fā)送操作命令Logout、數(shù)據(jù)對象為CSTCP_User的請求，具體見A.2。6.4.3信息訂閱6基礎應用系統(tǒng)向城市智能交通綜合管控平臺訂閱其他系統(tǒng)發(fā)送給平臺的數(shù)據(jù)，操作命令Subscribe，數(shù)據(jù)對象為MsgEntity，具體見A.3。6.4.4取消訂閱基礎應用系統(tǒng)取消從城市智能交通綜合管控平臺訂閱其他系統(tǒng)發(fā)送給平臺的數(shù)據(jù)，操作命令UnSubscribe，數(shù)據(jù)對象為MsgEntity，具體見A.4。6.4.5心跳信息心跳信息由通信雙方互發(fā)，操作命令Notify，數(shù)據(jù)對象為CSTCP_HeartBeat，具體見A.5。6.4.6超時設置城市智能交通綜合管控平臺使用默認的通信超時時間設置，基礎應用系統(tǒng)需要改變超時發(fā)出設置超時請求，城市智能交通綜合管控平臺應答，操作命令Set，數(shù)據(jù)對象為CSTCP_TimeOut，具體見A.6。7（規(guī)范性附錄）通用數(shù)據(jù)對象定義A.1數(shù)據(jù)包對象MessageA.1.1地址中基礎應用系統(tǒng)類型標識基礎應用系統(tǒng)類型標識取值見表A.1。表A.1基礎應用系統(tǒng)類型標識序號基礎應用系統(tǒng)類型標識說明1CSTCP城市智能交通綜合管控平臺2交通信號控制系統(tǒng)3TVMS交通視頻監(jiān)控系統(tǒng)4TICS交通態(tài)勢管理系統(tǒng)5TIPS交通誘導系統(tǒng)6PGPS警用指揮調度系統(tǒng)7TDMS設施設備運維管理系統(tǒng)8VMKS車輛緝查布控系統(tǒng)A.1.2數(shù)據(jù)包類型Type數(shù)據(jù)包類型取值見表A.2。表A.2數(shù)據(jù)包類型序號類型說明1REQUEST請求，要求通信對方應答2RESPONSE應答，針對請求數(shù)據(jù)包的應答數(shù)據(jù)包3PUSH主動推送，單向數(shù)據(jù)包不需要應答4ERROR出錯應答，REQUEST數(shù)據(jù)包發(fā)生錯誤時應答該數(shù)據(jù)包A.1.3操作命令名稱Operationname操作命令的name（名稱）屬性的取值見表A.3。表A.3操作命令名稱序號名稱說明1Login登錄2Logout登出3Subscribe訂閱4Unsubscribe取消訂閱5Get查詢，獲取6Set設置7Notify通知88Other其他A.1.4錯誤類型ErrType系統(tǒng)預定義錯誤類型的字符串常量，對應于CSTCP_Error元素中的ErrType元素，取值見表A.4，用戶可根據(jù)需要擴展。表A.4系統(tǒng)預定義錯誤類型序號值說明1ERR_Version版本號錯誤2ERR_Token無效令牌，會話錯誤3ERR_Address地址錯誤4ERR_MsgType數(shù)據(jù)包類型錯誤5ERR_OperName操作命令錯誤6ERR_UserName用戶名錯誤7ERR_Pwd8ERR_NotAllow操作不允許9ERR_Failure操作失敗ERR_Unknown其他未知錯誤A.2錯誤信息對象CSTCP_Error系統(tǒng)預定義錯誤對象的具體信息見表A.5。表A.5錯誤信息對象序號元素名說明1ErrObj錯誤對象名2ErrType錯誤類型3ErrDesc錯誤描述A.3用戶信息對象CSTCP_User用戶信息對象的具體信息見表A.6。表A.6用戶信息對象序號元素名說明1UserName用戶名2PwdA.4訂閱對象MsgEntity訂閱對象的具體信息見表A.7。表A.7訂閱對象9序號元素名說明1MsgType數(shù)據(jù)包類型，取值見表B.22OperName操作命令，取值見表B.33ObjName操作的數(shù)據(jù)對象名稱A.5心跳CSTCP_HeartBeat心跳信息對象為空元素對象，元素中不包含文本和子元素。A.6超時對象CSTCP_TimeOut超時對象的具體信息見表A.8。表A.8超時對象元素名說明CSTCP_TimeOut通信超時時間，單位（s）（規(guī)范性附錄）通用操作B.1系統(tǒng)連接/登錄B.1.1系統(tǒng)連接請求系統(tǒng)連接請求Message數(shù)據(jù)包見表B.1，Operation操作對象見表B.2，CSTCP_User操作對象見表B.3，表B.1Message數(shù)據(jù)包序號字段名稱字段值1234567表B.2Operation操作對象123表B.3CSTCP_User操作對象12B.1.2成功應答成功應答Message數(shù)據(jù)包見表B.4,Operation操作對象見表B.5，CSTCP_User操作對象見表B.6。表B.4Message數(shù)據(jù)包序號字段名稱字段值1234567表B.5Operation操作對象123表B.6CSTCP_User操作對象12空B.1.3失敗應答失敗應答Message數(shù)據(jù)包見表B.7,Operation操作對象見表B.8，CSTCP_Error操作對象見表B.9。表B.7Message數(shù)據(jù)包序號字段名稱字段值1234567表B.8Operation操作對象123表B.9CSTCP_Error操作對象123CSTCP_User對象的具體信息見A.3。B.2系統(tǒng)斷開/登出B.2.1系統(tǒng)斷開請求系統(tǒng)斷開請求Message數(shù)據(jù)包見表B.10,Operation操作對象見表B.11，CSTCP_User操作對象見表B.12。表B.10Message數(shù)據(jù)包序號字段名稱字段值1234567表B.11Operation操作對象123表B.12CSTCP_User操作對象12B.2.2成功應答成功應答Message數(shù)據(jù)包見表B.13,Operation操作對象見表B.14，CSTCP_User操作對象見表B.15。表B.13Message數(shù)據(jù)包序號字段名稱字段值1234567表B.14Operation操作對象123表B.15CSTCP_User操作對象12空B.3信息訂閱B.3.1請求請求Message數(shù)據(jù)包見表B.16,Operation操作對象見表B.17，MsgEntity操作對象見表B.18。表B.16Message數(shù)據(jù)包序號字段名稱字段值1234