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