DB14∕T 2041-2020 農機田間作業(yè)數(shù)據(jù)傳輸規(guī)范

ICS65.060.01B90DB14山西市場監(jiān)督管理局發(fā)布IDB14/T2041—2020 12規(guī)范性引用文件 13術語和定義 14基本要求 25傳輸內容 36數(shù)據(jù)傳輸 37數(shù)據(jù)傳輸安全 8數(shù)據(jù)傳輸評價 附錄A（資料性附錄）返回結果編碼表 14附錄B（規(guī)范性附錄）深松作業(yè)數(shù)據(jù)傳輸參數(shù)說明 附錄C（規(guī)范性附錄）秸稈還田作業(yè)數(shù)據(jù)傳輸參數(shù)說明 附錄D（規(guī)范性附錄）玉米收獲機作業(yè)數(shù)據(jù)傳輸參數(shù)說明 附錄E（規(guī)范性附錄）無人植保機作業(yè)數(shù)據(jù)傳輸參數(shù)說明 DB14/T2041—2020本標準按照GB/T1.1-2009給出的規(guī)則起草。本標準由山西省農業(yè)農村廳提出并監(jiān)督實施。本標準由山西省農業(yè)標準化技術委員會歸口。本標準起草單位：山西省農業(yè)機械發(fā)展中心、山西省農業(yè)機械化服務中心、山西微農天下科技有限公司、山西迪奧普科技有限公司、黑龍江惠達科技有限公司、江蘇北斗衛(wèi)星應用產(chǎn)業(yè)研究院、河北信翔電子有限公司、山西誠鼎偉業(yè)科技有限責任公司。本標準主要起草人：李雙喜、張建中、王曦、任維民、秦啟福、武東平、崔可嘉、程海富、李晉汾、任躍男、安邦、王曉萍、任寶香、姚永彪、裴慶、李嵩、路占民、馬悅、左鵬、孫超、程良俊。本標準首次發(fā)布。1DB14/T2041—2020農機田間作業(yè)數(shù)據(jù)傳輸規(guī)范本標準規(guī)定了農機田間作業(yè)數(shù)據(jù)傳輸?shù)男g語和定義、基本要求、傳輸內容、數(shù)據(jù)傳輸、數(shù)據(jù)安全和傳輸評價。本標準適用于農機田間作業(yè)數(shù)據(jù)的傳輸。2規(guī)范性引用文件下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T37025信息安全技術物聯(lián)網(wǎng)數(shù)據(jù)傳輸安全技術要求NY/T2845深松機作業(yè)質量NY/T1640農業(yè)機械分類3術語和定義下列術語與定義適用于本規(guī)范3.1數(shù)據(jù)采集終端安裝于作業(yè)農機具上，用于農機田間作業(yè)數(shù)據(jù)采集的專用設備。3.2接入方農機田間作業(yè)數(shù)據(jù)采集企業(yè)。3.3設備信息上傳接口接入方向信息管理系統(tǒng)上傳監(jiān)測設備安裝信息的協(xié)議接口。3.4作業(yè)信息上傳接口接入方向信息管理系統(tǒng)上傳農機田間作業(yè)信息的協(xié)議接口。2DB14/T2041—20203.5位置信息上傳接口接入方向信息管理系統(tǒng)上傳農機具田間作業(yè)位置信息的協(xié)議接口3.6圖片信息上傳接口接入方向信息管理系統(tǒng)上傳農機具田間作業(yè)照片信息的協(xié)議接口。3.7軌跡信息上傳接口接入方向信息管理系統(tǒng)上傳農機具田間作業(yè)軌跡的信息的協(xié)議接口。3.8作業(yè)統(tǒng)計上傳接口接入方向信息管理系統(tǒng)上傳農機具田間作業(yè)統(tǒng)計數(shù)據(jù)信息的協(xié)議接口。3.9軌跡信息查詢接口信息管理系統(tǒng)向接入方申請查詢當日農機具田間作業(yè)軌跡信息的協(xié)議接口。3.10作業(yè)信息查詢接口信息管理系統(tǒng)向接入方申請查詢當日農機具田間作業(yè)信息的協(xié)議接口。4基本要求4.1上傳訪問上傳訪問數(shù)據(jù)，應進行權限驗證。4.2傳輸方式使用httppost方式推送作業(yè)數(shù)據(jù)。4.3數(shù)據(jù)加密數(shù)據(jù)傳輸采用des加密方式。密鑰由接入方向信息系統(tǒng)申請。4.4數(shù)據(jù)傳輸周期每5分鐘上傳一次實時位置數(shù)據(jù)，每24小時批量傳輸當天位置、軌跡、圖片等全部作業(yè)數(shù)據(jù)。3DB14/T2041—20204.5日志記錄端口應設置日志記錄，對輸入、輸出數(shù)據(jù)進行實時記錄。4.6數(shù)據(jù)交換格式傳輸接口請求和返回的數(shù)據(jù)交換格式采用Json數(shù)據(jù)格式，并采取UTF-8編碼方式。5傳輸內容5.1機具、遠程監(jiān)測終端的相關設備信息。5.2機具定位、作業(yè)圖片、作業(yè)軌跡等作業(yè)數(shù)據(jù)信息。5.3接入方賬號、密碼等管理信息。6數(shù)據(jù)傳輸6.1終端信息上傳接口6.1.1接口地址：http://ip:port/zhnj/terminal。6.1.2上傳請求參數(shù)和返回結果參數(shù)見表1、表2的規(guī)定。表1上傳請求參數(shù)1表2返回結果參數(shù)1236.1.3返回結果編碼見附錄A的規(guī)定。6.1.4參數(shù)示例。上傳請求參數(shù)示例：{"acc":"","pwd":"","tNumber":"","p1":"","p2":"","p3":"","p4":"","p5":"","p6":"","p7":"","p8":"","p9":"","p10":"","p11":""}。返回結果參數(shù)示例：{"NStatus":"","NDesc":""}。6.1.5傳輸參數(shù)見表3的規(guī)定。4DB14/T2041—2020表3傳輸參數(shù)說明1234567896.2作業(yè)信息上傳接口6.2.1接口地址：http://ip:port/zhnj/job。6.2.2上傳請求參數(shù)和返回結果參數(shù)見表4、表5的規(guī)定。表4上傳請求參數(shù)1表5返回結果參數(shù)1236.2.3返回結果編碼見附錄A的規(guī)定。6.2.4參數(shù)示例。5DB14/T2041—2020上傳請求參數(shù)示例：[{"acc":"","pwd":"","tNumber":"","p1":"","p2":"","p3":"","p4":"","p5":"","p6":"","p7":"","p8":"","p9":"","p10":"","p11":"","p12":"","p13":"","p14":"","p15":"114.0,38.0,114.1,38.1,……","p16":"","p17":"","p18":"","p19":"","p20":"","p21":"","p22":"","p23":""}]。返回結果參數(shù)示例：{"NStatus":"","NDesc":""}。6.2.5傳輸參數(shù)見表6的規(guī)定。作業(yè)信息上傳接口支持批量推送，按照json數(shù)組格式進行推送。傳輸參數(shù)見附錄B-E的規(guī)定。表6傳輸參數(shù)說明123456789p15trueDouble傳輸參數(shù)n……………注1：作業(yè)類型代碼，選用《NY/T1604-2015農業(yè)機械分類》農機分類代碼代替作業(yè)類型代碼，如：自走式玉米收6DB14/T2041—20206.3位置信息上傳接口6.3.1接口地址：http://ip:port/zhnj/position。6.3.2上傳請求參數(shù)和返回結果參數(shù)見表7、表8的規(guī)定。表7上傳請求參數(shù)1表8返回結果參數(shù)1236.3.3返回結果編碼見附錄A的規(guī)定。6.3.4參數(shù)示例。上傳請求參數(shù)示例：[{"acc":"","pwd":"","tNumber":"","p1":"","p2":"","p3":"","p4":"","p5":"","p6":"","p7":"","p8":"","p9":"","p10":"","p11":"","p12":"","p13":"","p14":""},...]。返回結果參數(shù)示例：{"NStatus":"","NDesc":""}。6.3.5傳輸參數(shù)見表9的規(guī)定。位置信息上傳接口支持批量推送，按照json數(shù)組格式進行推送。表9傳輸參數(shù)說明1234567897DB14/T2041—2020表9傳輸參數(shù)說明（續(xù)）序號名稱是否必填類型說明p8false是否合格（0：不合格，1：合格）6.4圖片信息上傳接口6.4.1接口地址：http://ip:port/zhnj/photo。6.4.2上傳請求參數(shù)和返回結果參數(shù)見表10、表11的規(guī)定。表10上傳請求參數(shù)1表11返回結果參數(shù)1236.4.3返回結果編碼見附錄A的規(guī)定。6.4.4參數(shù)示例。上傳請求參數(shù)示例：[{"acc":"","pwd":"","tNumber":"","p1":"","p2":"","p3":"","p4":""},...]"。返回結果參數(shù)示例：{"NStatus":"","NDesc":""}。6.4.5傳輸參數(shù)見表12的規(guī)定。照片信息上傳接口支持批量推送，按照json數(shù)組格式，url全路徑地址，從接入方服務器進行上傳。表12傳輸參數(shù)說明128DB14/T2041—2020表12傳輸參數(shù)說明（續(xù)）序號名稱是否必填類型說明3tNumbertrueString終端設備號45676.5軌跡信息上傳接口6.5.1接口地址：http://ip:port/zhnj/trace。6.5.2上傳請求參數(shù)和返回結果參數(shù)見表13、表14的規(guī)定。表13上傳請求參數(shù)1表14返回結果參數(shù)1236.5.3返回結果編碼見附錄A的規(guī)定。6.5.4參數(shù)示例。[{"acc":"","pwd":"","tNumber":"","startTime":"","endTime":"","posList":"p1,p2,p3,p4,p5,p6,p7,p8"}]。6.5.5傳輸參數(shù)見表15的規(guī)定。表15傳輸參數(shù)說明1234開始時間（YYYY-MM-DDHH2456軌跡數(shù)據(jù)（每個字段從p1至p8順序排列，逗號789DB14/T2041—2020表15傳輸參數(shù)說明（續(xù)）序號名稱是否必填類型說明9p3truedouble緯度6.6作業(yè)統(tǒng)計信息上傳接口6.6.1接口地址：http://ip:port/zhnj/statistics。6.6.2上傳請求參數(shù)和返回結果參數(shù)見表16、表17的規(guī)定。表16上傳請求參數(shù)1表17返回結果參數(shù)1236.6.3返回結果編碼見附錄A的規(guī)定。6.6.4參數(shù)示例。上傳請求參數(shù)示例：{"acc":"","pwd":"","tNumber":"","clzdsl":"","p2":"","p3":"","p4":"","p5":"","p6":"","p7":"","p8":"","p9":"","p10":"","p11":""}。返回結果參數(shù)示例：{"NStatus":"","NDesc":""}。6.6.5傳輸參數(shù)見表18的規(guī)定。表18傳輸參數(shù)說明123DB14/T2041—2020表18傳輸參數(shù)說明(續(xù))序號名稱是否必填類型說明4clzdsltrueString車輛傳輸數(shù)量56傳輸時間（YYYY-MM-DDHH24:M7896.7軌跡信息查詢接口6.7.1接口地址：接入方提供。6.7.2查詢請求參數(shù)和返回結果參數(shù)見表19、表20的規(guī)定。表19查詢請求參數(shù)1234開始時間（YYYY-MM-DDHH245表20返回結果參數(shù)1236.7.3返回結果編碼見附錄A的規(guī)定。6.7.4參數(shù)示例。[{"acc":"","pwd":"","tNumber":"","startTime":"","endTime":"","posList":"p1,p2,p3,p4,p5,p6,p7,p8"}]。6.7.5傳輸參數(shù)見表21的規(guī)定。表21傳輸參數(shù)說明123DB14/T2041—2020表21傳輸參數(shù)說明（續(xù)）序號名稱是否必填類型說明4startTimetrueString開始時間（YYYY-MM-DDHH24:MI:SS）56軌跡數(shù)據(jù)（每個字段從p1至p8順序排列，逗號7896.8作業(yè)信息查詢接口6.8.1接口地址：接入方提供。6.8.2查詢請求參數(shù)和返回結果參數(shù)見表22、表23的規(guī)定。表22查詢請求參數(shù)12345表23返回結果參數(shù)1236.8.3返回結果編碼見附錄A的規(guī)定。6.8.4參數(shù)示例。查詢請求參數(shù)示例：[{"acc":"","pwd":"","tNumber":"","p1":"","p2":"","p3":"","p4":"","p5":"","p6":"","p7":"","p8":"","p9":"","p10":"","p11":"","p12":"","p13":"","p14":"","p15":"114.0,38.0,114.1,38.1,……","p16":"","p17":"","p18":"","p19":"","p20":"","p21":"","p22":"","p23":""}]。DB14/T2041—2020返回結果參數(shù)示例：{"NStatus":"","NDesc":""}。6.8.5傳輸參數(shù)作業(yè)信息查詢接口支持批量推送，按照json數(shù)組格式進行推送見表24的規(guī)定。表24傳輸參數(shù)說明12345作業(yè)日期（YYYY-MM-DDHH246開始時間（YYYY-MM-DDHH24789度,A點緯度，B點經(jīng)度，B點緯度，C點經(jīng)度，Cp10trueDouble傳輸參數(shù)2p11trueDouble傳輸參數(shù)3p12trueDouble傳輸參數(shù)4p13trueDouble傳輸參數(shù)4p14trueDouble傳輸參數(shù)6p15trueDouble傳輸參數(shù)n……………7數(shù)據(jù)傳輸安全應符合GB/T37025