DB14∕T 2041-2020 农机田间作业数据传输规范

ICS65.060.01B90DB14山西市场监督管理局发布IDB14/T2041—2020 12规范性引用文件 13术语和定义 14基本要求 25传输内容 36数据传输 37数据传输安全 8数据传输评价 附录A（资料性附录）返回结果编码表 14附录B（规范性附录）深松作业数据传输参数说明 附录C（规范性附录）秸秆还田作业数据传输参数说明 附录D（规范性附录）玉米收获机作业数据传输参数说明 附录E（规范性附录）无人植保机作业数据传输参数说明 DB14/T2041—2020本标准按照GB/T1.1-2009给出的规则起草。本标准由山西省农业农村厅提出并监督实施。本标准由山西省农业标准化技术委员会归口。本标准起草单位：山西省农业机械发展中心、山西省农业机械化服务中心、山西微农天下科技有限公司、山西迪奥普科技有限公司、黑龙江惠达科技有限公司、江苏北斗卫星应用产业研究院、河北信翔电子有限公司、山西诚鼎伟业科技有限责任公司。本标准主要起草人：李双喜、张建中、王曦、任维民、秦启福、武东平、崔可嘉、程海富、李晋汾、任跃男、安邦、王晓萍、任宝香、姚永彪、裴庆、李嵩、路占民、马悦、左鹏、孙超、程良俊。本标准首次发布。1DB14/T2041—2020农机田间作业数据传输规范本标准规定了农机田间作业数据传输的术语和定义、基本要求、传输内容、数据传输、数据安全和传输评价。本标准适用于农机田间作业数据的传输。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T37025信息安全技术物联网数据传输安全技术要求NY/T2845深松机作业质量NY/T1640农业机械分类3术语和定义下列术语与定义适用于本规范3.1数据采集终端安装于作业农机具上，用于农机田间作业数据采集的专用设备。3.2接入方农机田间作业数据采集企业。3.3设备信息上传接口接入方向信息管理系统上传监测设备安装信息的协议接口。3.4作业信息上传接口接入方向信息管理系统上传农机田间作业信息的协议接口。2DB14/T2041—20203.5位置信息上传接口接入方向信息管理系统上传农机具田间作业位置信息的协议接口3.6图片信息上传接口接入方向信息管理系统上传农机具田间作业照片信息的协议接口。3.7轨迹信息上传接口接入方向信息管理系统上传农机具田间作业轨迹的信息的协议接口。3.8作业统计上传接口接入方向信息管理系统上传农机具田间作业统计数据信息的协议接口。3.9轨迹信息查询接口信息管理系统向接入方申请查询当日农机具田间作业轨迹信息的协议接口。3.10作业信息查询接口信息管理系统向接入方申请查询当日农机具田间作业信息的协议接口。4基本要求4.1上传访问上传访问数据，应进行权限验证。4.2传输方式使用httppost方式推送作业数据。4.3数据加密数据传输采用des加密方式。密钥由接入方向信息系统申请。4.4数据传输周期每5分钟上传一次实时位置数据，每24小时批量传输当天位置、轨迹、图片等全部作业数据。3DB14/T2041—20204.5日志记录端口应设置日志记录，对输入、输出数据进行实时记录。4.6数据交换格式传输接口请求和返回的数据交换格式采用Json数据格式，并采取UTF-8编码方式。5传输内容5.1机具、远程监测终端的相关设备信息。5.2机具定位、作业图片、作业轨迹等作业数据信息。5.3接入方账号、密码等管理信息。6数据传输6.1终端信息上传接口6.1.1接口地址：http://ip:port/zhnj/terminal。6.1.2上传请求参数和返回结果参数见表1、表2的规定。表1上传请求参数1表2返回结果参数1236.1.3返回结果编码见附录A的规定。6.1.4参数示例。上传请求参数示例：{"acc":"","pwd":"","tNumber":"","p1":"","p2":"","p3":"","p4":"","p5":"","p6":"","p7":"","p8":"","p9":"","p10":"","p11":""}。返回结果参数示例：{"NStatus":"","NDesc":""}。6.1.5传输参数见表3的规定。4DB14/T2041—2020表3传输参数说明1234567896.2作业信息上传接口6.2.1接口地址：http://ip:port/zhnj/job。6.2.2上传请求参数和返回结果参数见表4、表5的规定。表4上传请求参数1表5返回结果参数1236.2.3返回结果编码见附录A的规定。6.2.4参数示例。5DB14/T2041—2020上传请求参数示例：[{"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":""}]。返回结果参数示例：{"NStatus":"","NDesc":""}。6.2.5传输参数见表6的规定。作业信息上传接口支持批量推送，按照json数组格式进行推送。传输参数见附录B-E的规定。表6传输参数说明123456789p15trueDouble传输参数n……………注1：作业类型代码，选用《NY/T1604-2015农业机械分类》农机分类代码代替作业类型代码，如：自走式玉米收6DB14/T2041—20206.3位置信息上传接口6.3.1接口地址：http://ip:port/zhnj/position。6.3.2上传请求参数和返回结果参数见表7、表8的规定。表7上传请求参数1表8返回结果参数1236.3.3返回结果编码见附录A的规定。6.3.4参数示例。上传请求参数示例：[{"acc":"","pwd":"","tNumber":"","p1":"","p2":"","p3":"","p4":"","p5":"","p6":"","p7":"","p8":"","p9":"","p10":"","p11":"","p12":"","p13":"","p14":""},...]。返回结果参数示例：{"NStatus":"","NDesc":""}。6.3.5传输参数见表9的规定。位置信息上传接口支持批量推送，按照json数组格式进行推送。表9传输参数说明1234567897DB14/T2041—2020表9传输参数说明（续）序号名称是否必填类型说明p8false是否合格（0：不合格，1：合格）6.4图片信息上传接口6.4.1接口地址：http://ip:port/zhnj/photo。6.4.2上传请求参数和返回结果参数见表10、表11的规定。表10上传请求参数1表11返回结果参数1236.4.3返回结果编码见附录A的规定。6.4.4参数示例。上传请求参数示例：[{"acc":"","pwd":"","tNumber":"","p1":"","p2":"","p3":"","p4":""},...]"。返回结果参数示例：{"NStatus":"","NDesc":""}。6.4.5传输参数见表12的规定。照片信息上传接口支持批量推送，按照json数组格式，url全路径地址，从接入方服务器进行上传。表12传输参数说明128DB14/T2041—2020表12传输参数说明（续）序号名称是否必填类型说明3tNumbertrueString终端设备号45676.5轨迹信息上传接口6.5.1接口地址：http://ip:port/zhnj/trace。6.5.2上传请求参数和返回结果参数见表13、表14的规定。表13上传请求参数1表14返回结果参数1236.5.3返回结果编码见附录A的规定。6.5.4参数示例。[{"acc":"","pwd":"","tNumber":"","startTime":"","endTime":"","posList":"p1,p2,p3,p4,p5,p6,p7,p8"}]。6.5.5传输参数见表15的规定。表15传输参数说明1234开始时间（YYYY-MM-DDHH2456轨迹数据（每个字段从p1至p8顺序排列，逗号789DB14/T2041—2020表15传输参数说明（续）序号名称是否必填类型说明9p3truedouble纬度6.6作业统计信息上传接口6.6.1接口地址：http://ip:port/zhnj/statistics。6.6.2上传请求参数和返回结果参数见表16、表17的规定。表16上传请求参数1表17返回结果参数1236.6.3返回结果编码见附录A的规定。6.6.4参数示例。上传请求参数示例：{"acc":"","pwd":"","tNumber":"","clzdsl":"","p2":"","p3":"","p4":"","p5":"","p6":"","p7":"","p8":"","p9":"","p10":"","p11":""}。返回结果参数示例：{"NStatus":"","NDesc":""}。6.6.5传输参数见表18的规定。表18传输参数说明123DB14/T2041—2020表18传输参数说明(续)序号名称是否必填类型说明4clzdsltrueString车辆传输数量56传输时间（YYYY-MM-DDHH24:M7896.7轨迹信息查询接口6.7.1接口地址：接入方提供。6.7.2查询请求参数和返回结果参数见表19、表20的规定。表19查询请求参数1234开始时间（YYYY-MM-DDHH245表20返回结果参数1236.7.3返回结果编码见附录A的规定。6.7.4参数示例。[{"acc":"","pwd":"","tNumber":"","startTime":"","endTime":"","posList":"p1,p2,p3,p4,p5,p6,p7,p8"}]。6.7.5传输参数见表21的规定。表21传输参数说明123DB14/T2041—2020表21传输参数说明（续）序号名称是否必填类型说明4startTimetrueString开始时间（YYYY-MM-DDHH24:MI:SS）56轨迹数据（每个字段从p1至p8顺序排列，逗号7896.8作业信息查询接口6.8.1接口地址：接入方提供。6.8.2查询请求参数和返回结果参数见表22、表23的规定。表22查询请求参数12345表23返回结果参数1236.8.3返回结果编码见附录A的规定。6.8.4参数示例。查询请求参数示例：[{"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返回结果参数示例：{"NStatus":"","NDesc":""}。6.8.5传输参数作业信息查询接口支持批量推送，按照json数组格式进行推送见表24的规定。表24传输参数说明12345作业日期（YYYY-MM-DDHH246开始时间（YYYY-MM-DDHH24789度,A点纬度，B点经度，B点纬度，C点经度，Cp10trueDouble传输参数2p11trueDouble传输参数3p12trueDouble传输参数4p13trueDouble传输参数4p14trueDouble传输参数6p15trueDouble传输参数n……………7数据传输安全应符合GB/T37025