T-NXNJXH 05-2024 農(nóng)機田間作業(yè)數(shù)據(jù)傳輸規(guī)范

ICS65.060.01CSSB912024-10-25發(fā)布2024-10-31實施寧夏農(nóng)機生產(chǎn)與流通協(xié)會發(fā)布本文件按照GB/T1.1-2020《標準化工作導則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》規(guī)定編寫。本文件由靈武市海江種植合作社提出。本文件由寧夏農(nóng)機生產(chǎn)與流通協(xié)會歸口。本文件起草單位：靈武市海江種植合作社、寧夏萬眾農(nóng)業(yè)機械化服務有限公司、靈武市聚盛德家庭農(nóng)場、寧夏農(nóng)業(yè)機械化技術(shù)推廣總站、靈武市農(nóng)業(yè)機械化服務中心、寧夏回族自治區(qū)農(nóng)業(yè)技術(shù)推廣總站。本文件主要起草人：王健、李健榮、唐衛(wèi)宏、李翔、王鵬、韓楊、楊月萍、張愛君、王海江、李娟、馬鵬遠。1農(nóng)機田間作業(yè)數(shù)據(jù)傳輸規(guī)范本文件規(guī)定了農(nóng)機田間作業(yè)數(shù)據(jù)傳輸?shù)男g(shù)語和定義、基本要求、傳輸內(nèi)容、數(shù)據(jù)傳輸、數(shù)據(jù)安全和傳輸評價。本文件適用于農(nóng)機田間作業(yè)數(shù)據(jù)的傳輸。2規(guī)范性引用文件下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T37025信息安全技術(shù)物聯(lián)網(wǎng)數(shù)據(jù)傳輸安全技術(shù)要求NY/T2845深松機作業(yè)質(zhì)量NY/T1640農(nóng)業(yè)機械分類DB14/T2041農(nóng)機田間作業(yè)數(shù)據(jù)傳輸規(guī)范3術(shù)語和定義3.1安裝于作業(yè)農(nóng)機具上，用于農(nóng)機田間作業(yè)數(shù)據(jù)采集的專用設備。3.2農(nóng)機田間作業(yè)數(shù)據(jù)采集企業(yè)。4基本要求4.1上傳訪問上傳訪問數(shù)據(jù)，應進行權(quán)限驗證。4.2傳輸方式4.3數(shù)據(jù)加密數(shù)據(jù)傳輸采用des加密方式。密鑰由接入方向信息系統(tǒng)申請。4.4數(shù)據(jù)傳輸周期每5分鐘上傳一次實時位置數(shù)據(jù)，每24小時批量傳輸當天位置、軌跡、圖片等全部作4.5日志記錄端口應設置日志記錄，對輸入、輸出數(shù)據(jù)進行實時記錄。24.6數(shù)據(jù)交換格式傳輸接口請求和返回的數(shù)據(jù)交換格式采用Json數(shù)據(jù)格式，并采取UTF-8編碼方式。5傳輸內(nèi)容5.1機具、遠程監(jiān)測終端的相關(guān)設備信息。5.2機具定位、作業(yè)圖片、作業(yè)軌跡等作業(yè)數(shù)據(jù)信息。5.3接入方賬號、密碼等管理信息。6數(shù)據(jù)傳輸6.1終端信息上傳接口6.1.1接口地址：按照實際情況設置。6.1.2上傳請求參數(shù)和返回結(jié)果參數(shù)見表1、表2的規(guī)定。表1上傳請求參數(shù)序號名稱是否必填類型說明1同步參數(shù)及信息表2返回參數(shù)結(jié)果序號名稱是否必填類型說明1結(jié)果類2推送結(jié)果狀態(tài)（見附表1返回結(jié)果編碼表）3推送結(jié)果說明6.1.3返回結(jié)果編碼見附錄A的規(guī)定。6.1.4參數(shù)示例。6.1.5傳輸參數(shù)見表3的規(guī)定。3表3傳輸參數(shù)說明序號名稱是否必填類型說明1Acc接入方授權(quán)賬號2接入方授權(quán)密碼3終端設備號4P1農(nóng)機號牌5農(nóng)機品牌6農(nóng)機類型代碼7P15機具類型（多個用/隔開）8終端安裝時（YYYY-MM-DDHH24:MI:SS）9農(nóng)機動力值（單位：千瓦）所有者類型：1、合作社，2、個體戶合作社工商注冊號/個體戶手機號碼合作社名稱/個體戶名稱所有者歸屬省份P10所有者歸屬地市P11所有者歸屬縣/區(qū)P12所有者歸屬鄉(xiāng)/鎮(zhèn)P13所有者歸屬合作社P14所有者歸屬村注1：以上數(shù)據(jù)均為必填項2：農(nóng)機類型（見NY/T1604-2015農(nóng)業(yè)機械分類如：輪式拖拉機用140101代替）3：終端數(shù)據(jù)信息傳輸協(xié)議接口僅支持單條數(shù)據(jù)傳輸6.2作業(yè)信息上傳接口6.2.1接口地址：按照實際情況設置。6.2.2上傳請求參數(shù)和返回結(jié)果參數(shù)見表4、表5的規(guī)定。4表4上傳請求參數(shù)序號名稱是否必填類型說明1同步參數(shù)及信息表5返回結(jié)果參數(shù)序號名稱是否必填類型說明1結(jié)果類2推送結(jié)果狀態(tài)（見附表1返回結(jié)果編碼表）3推送結(jié)果說明6.2.3返回結(jié)果編碼見附錄A的規(guī)定。6.2.4參數(shù)示例。6.2.5傳輸參數(shù)見表6的規(guī)定。6.2.5.1作業(yè)信息上傳接口支持批量推送，按照json數(shù)組格式進行推送。6.2.5.2傳輸參數(shù)見附錄B-E的規(guī)定。5表6傳輸參數(shù)說明序號名稱是否必填類型說明1Acc接入方授權(quán)賬號2接入方授權(quán)密碼3終端設備號4P1作業(yè)類型代碼5作業(yè)日期（YYYY-MM-DDHH24:MI:SS）6開始時間（YYYY-MM-DDHH24:MI:SS）7結(jié)束時間（YYYY-MM-DDHH24:MI:SS）8作業(yè)時長（分鐘<min>）9作業(yè)地點經(jīng)度作業(yè)地點緯度P15地塊坐標組，坐標組格式為字符串形式，B點緯度，C經(jīng)度，C點緯度，…】P16作業(yè)油耗（單位：升）P23結(jié)算信息（單位：元）P25農(nóng)機號牌機具類型代碼傳輸參數(shù)2P10傳輸參數(shù)2P11傳輸參數(shù)3P12傳輸參數(shù)420P13傳輸參數(shù)521P14傳輸參數(shù)622P15傳輸參數(shù)n注1：作業(yè)類型代碼，選用《NY/T1604-2015農(nóng)業(yè)機械分類》農(nóng)機分類代碼代替作6業(yè)類型代碼，如：自走式玉米收獲作業(yè)用040202代替。2：采集參數(shù)依據(jù)不同的作業(yè)類型選用相應的附錄（作業(yè)數(shù)據(jù)傳輸代碼表）填寫。6.3位置信息上傳接口6.3.1接口地址：按照實際情況設置。6.3.2上傳請求參數(shù)和返回結(jié)果參數(shù)見表7、表8的規(guī)定。表7上傳請求參數(shù)序號名稱是否必填類型說明1同步參數(shù)及信息表8返回結(jié)果參數(shù)序號名稱是否必填類型說明1結(jié)果類2推送結(jié)果狀態(tài)（見附表1返回結(jié)果編碼表）3推送結(jié)果說明6.3.3返回結(jié)果編碼見附錄A的規(guī)定。6.3.5傳輸參數(shù)見表9的規(guī)定。位置信息上傳接口支持批量推送，按照json數(shù)組格式進行推送。表9傳輸參數(shù)說明7序號名稱是否必填類型說明1Acc接入方授權(quán)賬號2接入方授權(quán)密碼3終端設備號4P1經(jīng)度5緯度6定位時間（YYYY-MM-DDHH24:MI:SS）7定位方式（0：GPS定位,1：北斗定位，2：雙模定位）8作業(yè)狀態(tài)（0：未作業(yè)，1：作業(yè)）9啟動狀態(tài)（0：未啟動，1：啟動）作業(yè)類型（當作業(yè)狀態(tài)為1時必填）是否合格（0：不合格，1：合格）P10方向（度）P11P12海拔（米<m>）P13機具類型（當作業(yè)狀態(tài)為1時必填）P14報警狀態(tài)（0：正常，1：報警）注1：是否必填列為true的為必須傳輸屬性，啟動狀態(tài):p6、作業(yè)類型:p7、是否合格:p8、作業(yè)深度：p9是6.4圖片信息上傳接口6.4.1接口地址：按照實際情況設置。6.4.2上傳請求參數(shù)和返回結(jié)果參數(shù)見表10、表11的規(guī)定。表10上傳請求參數(shù)序號名稱是否必填類型說明1同步參數(shù)及信息表11返回結(jié)果參數(shù)8序號名稱是否必填類型說明1結(jié)果類2推送結(jié)果狀態(tài)（見附表1返回結(jié)果編碼表）3推送結(jié)果說明6.4.3返回結(jié)果編碼見附錄A的規(guī)定。6.4.5傳輸參數(shù)見表12的規(guī)定。照片信息上傳接口支持批量推送，按照json數(shù)組格式，url全路徑地址，從接入方服務器進行上傳。表12傳輸參數(shù)說明序號名稱是否必填類型說明1Acc接入方授權(quán)賬號2接入方授權(quán)密碼3終端設備號4經(jīng)度5P1緯度6拍攝時間（YYYY-MM-DDHH24:MI:SS）7注1：否必填列為true的為必須傳輸屬性，該接口可以根據(jù)接入方需求是否要調(diào)用傳輸圖片。6.5軌跡信息上傳接口6.5.1接口地址：按照實際情況設置。6.5.2上傳請求參數(shù)和返回結(jié)果參數(shù)見表13、表14的規(guī)定。表13上傳請求參數(shù)序號名稱是否必填類型說明1同步參數(shù)及信息表14返回結(jié)果參數(shù)9序號名稱是否必填類型說明1結(jié)果類2推送結(jié)果狀態(tài)（見附表1返回結(jié)果編碼表）3推送結(jié)果說明6.5.3返回結(jié)果編碼見附錄A的規(guī)定6.5.4傳輸參數(shù)見表15的規(guī)定表15傳輸參數(shù)說明序號名稱是否必填類型說明1Acc接入方授權(quán)賬號2接入方授權(quán)密碼3終端設備號4開始時間（YYYY-MM-DDHH24:MI:SS）5結(jié)束時間（YYYY-MM-DDHH24:MI:SS）6軌跡數(shù)據(jù)（每個字段從p1至p8順序排列，逗號分隔，不同軌跡數(shù)據(jù)也用逗號分隔）7P1定位時間（YYYY-MM-DDHH24:MI:SS）8經(jīng)度9緯度海拔高度，單位為米（m）方向（度）工作狀態(tài)（0：未作業(yè)，1：作業(yè)）機具類型注1：posList軌跡數(shù)據(jù)詳細內(nèi)容如下，按照設備時間升序排序6.6作業(yè)統(tǒng)計信息上傳接口6.6.1接口地址：按照實際情況設置。6.6.2上傳請求參數(shù)和返回結(jié)果參數(shù)見表16、表17的規(guī)定。表16上傳請求參數(shù)序號名稱是否必填類型說明1同步參數(shù)及信息表17返回結(jié)果參數(shù)序號名稱是否必填類型說明1結(jié)果類2推送結(jié)果狀態(tài)（見附表1返回結(jié)果編碼表）3推送結(jié)果說明6.6.3返回結(jié)果編碼見附錄A的規(guī)規(guī)定。6.6.4傳輸參數(shù)見表18的規(guī)定。表18傳輸參數(shù)說明序號名稱是否必填類型說明1Acc接入方授權(quán)賬號2接入方授權(quán)密碼3終端設備號4車輛傳輸數(shù)量5P1作業(yè)總量（畝）6傳輸時間（YYYY-MM-DDHH24:MI:SS）7傳輸數(shù)據(jù)總量（條）8軌跡數(shù)據(jù)傳輸總量（條）9終端數(shù)據(jù)傳輸總量（條）圖片地址數(shù)據(jù)傳輸總量（條）作業(yè)數(shù)據(jù)傳輸總量（條）6.7軌跡信息查詢接口6.7.1接口地址：接入方提供。6.7.2查詢請求參數(shù)和返回結(jié)果參數(shù)見表19、表20的規(guī)定。表19查詢請求參數(shù)序號名稱是否必填類型說明1Acc接入方授權(quán)賬號2接入方授權(quán)密碼3終端設備號4開始時間（YYYY-MM-DDHH24:MI:SS）5結(jié)束時間（YYYY-MM-DDHH24:MI:SS）表20返回結(jié)果參數(shù)序號名稱是否必填類型說明1結(jié)果類2推送結(jié)果狀態(tài)（見附表1返回結(jié)果編碼表）3推送結(jié)果說明6.7.3返回結(jié)果編碼見附錄A的規(guī)定。6.7.4傳輸參數(shù)見表21的規(guī)定。表21傳輸參數(shù)說明序號名稱是否必填類型說明1Acc接入方授權(quán)賬號2接入方授權(quán)密碼3終端設備號4開始時間（YYYY-MM-DDHH24:MI:SS）5結(jié)束時間（YYYY-MM-DDHH24:MI:SS）6軌跡數(shù)據(jù)（每個字段從p1至p8順序排列，逗號分隔，不同軌跡數(shù)據(jù)也用逗號分隔）7P1定位時間（YYYY-MM-DDHH24:MI:SS）8經(jīng)度9緯度海拔高度，單位為米（m）方向（度）工作狀態(tài)（0：未作業(yè)，1：作業(yè)）6.8作業(yè)信息查詢接口6.8.1接口地址：接入方提供。6.8.2查詢請求參數(shù)和返回結(jié)果參數(shù)見表22、表23的規(guī)定。表22查詢請求參數(shù)序號名稱是否必填類型說明1Acc接入方授權(quán)賬號2接入方授權(quán)密碼3終端設備號4開始時間（YYYY-MM-DDHH24:MI:SS）5結(jié)束時間（YYYY-MM-DDHH24:MI:SS）表23返回結(jié)果參數(shù)序號名稱是否必填類型說明1結(jié)果類2推送結(jié)果狀態(tài)（見附表1返回結(jié)果編碼表）3推送結(jié)果說明6.8.3返回結(jié)果編碼見附錄A的規(guī)定。6.8.5傳輸參數(shù)作業(yè)信息查詢接口支持批量推送，按照json數(shù)組格式進行推送見表24的規(guī)定。表24傳輸參數(shù)說明序號名稱是否必填類型說明1Acc接入方授權(quán)賬號2接入方授權(quán)密碼3終端設備號4P1作業(yè)類型代碼5作業(yè)日期（YYYY-MM-DDHH24:MI:SS）6開始時間（YYYY-MM-DDHH24:MI:SS）7結(jié)束時間（YYYY-MM-DDHH24:MI:SS）8作業(yè)時長（分鐘<min>）9作業(yè)地點經(jīng)度作業(yè)地點緯度P15地塊坐標組，坐標組格式為字符串形式，B點緯度，C經(jīng)度，C點緯度，…】P16作業(yè)油耗（單位：升）P23結(jié)算信息（單位：元）P25農(nóng)機號牌機具類型代碼傳輸參數(shù)2P10傳輸參數(shù)2P11傳輸參數(shù)3P12傳輸參數(shù)420P13傳輸參數(shù)521P14傳輸參數(shù)622P15傳輸參數(shù)n注1：作業(yè)類型代碼，選用《NY/T1604-2015農(nóng)業(yè)機械分類》農(nóng)機分類代碼代替作業(yè)類型，如：自走式玉米收獲用040202代替）。7數(shù)據(jù)傳輸安全應符合GB/T37025的規(guī)定。8數(shù)據(jù)傳輸評價8.1應定期對數(shù)據(jù)傳輸質(zhì)量進行自我評價。8.2應定期組織數(shù)據(jù)傳輸單位及信息管理部門對數(shù)據(jù)傳輸質(zhì)量進行評價。8.3應組織第三方專業(yè)機構(gòu)對數(shù)據(jù)傳輸質(zhì)量進行評價。（規(guī)范性附錄）返回結(jié)果編碼表表A.1返回結(jié)果編碼表序號推送結(jié)果狀態(tài)碼推送結(jié)果狀態(tài)說明10成功2賬號密碼錯誤31014102終端類型ID不存在5必填信息不完整6201數(shù)據(jù)格式錯誤7JSON協(xié)議錯誤8請求URL錯誤9接口內(nèi)部錯誤（請聯(lián)系技術(shù)支持）接口服務繁忙，稍后重試未知錯誤（請聯(lián)系技術(shù)支持）（規(guī)范性附錄）深松機作業(yè)數(shù)據(jù)傳輸參數(shù)說明表B.1深松機作業(yè)數(shù)據(jù)傳輸參數(shù)說明序號名稱是否必填類型說明1P16傳輸編碼長度2P17作業(yè)幅寬（厘米<cm>）3P18作業(yè)面積（畝）4P19作業(yè)平均深度（厘米<cm>）5作業(yè)達標率(%)6P21作業(yè)達標面積（畝）7P22作業(yè)重復面積（畝）8P23作業(yè)漏耕面積（畝）（規(guī)范性附錄）秸稈還田機作業(yè)數(shù)據(jù)傳輸參數(shù)說明表C.1秸稈還田機作業(yè)數(shù)據(jù)傳輸參數(shù)說明序號名稱是否必填類型說明1P16傳輸編碼長度2P17作業(yè)幅寬（厘米<cm>）3P18作業(yè)面積（畝）4P19秸稈殘茬高度（厘米<cm>）5秸稈粉碎長度（厘米<cm>）6P21秸稈粉碎長度合格率(≥85%）7P22秸稈粉碎拋灑（均勻無明顯漏切）8P23秸稈還田達標率(%)9秸稈還田作業(yè)達標面積（畝）（規(guī)范性附錄）