ICS 65.060.01 CCS B 90 NY 中华人民共和国农业行业标准 NY/T 38922021 农机作业远程监测管理平台数据 交换技术规范 Technical specification of data exchange for remote monitoring platform of agricultural machinery operation 2021-05-07 发布 2021-11-01实施 中华人民共和国农业农村部 发布 NY/T3892—2021 全国农业食前标准言 共服务平台 入 本文件按照GB/T1.1 2020标准化工作导则 第1部分： 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由农业农村部农业机械化管理司提出。 本文件由全国农业机械标准化技术委员会农业机械化分技术委员会（SAC/TC201/SC2)归口。 本文件起草单位：北京农业智能装备技术研究中心、农芯科技（北京)有限责任公司、北京农业信息技 术研究中心、农业农村部农业机械化技术开发推广总站、中国农业机械化科学研究院、北京市农业机械试 验鉴定推广站、黑龙江惠达科技发展有限公司、江苏北斗卫星应用产业研究院有限公司。 本文件起草人：孟志军、赵春江、杜经纬、陈立平、陈竞平、苏春华、伟利国、梅鹤波、罗长海、吴春江、张 光强、王培、尹彦鑫、魏学礼、秦五昌、郭树霞、刘旺、安红艳、盛顺、胡浩、吴紫晗、韩兴宇、陈伏州、陈伟、陈启 东、马姝岑。 1 NY/T3892—2021 农机作业远程监测管理平台数据交换技术规范 1范围 本文件规定了农机作业远程监测管理平台之间进行数据交换过程中所需遵守的规范，包括术语和定 义、一般性规范、数据传输方式、功能实现流程、数据接口定义、参数和常量定义等内容。 本文件适用于农机作业远程监测管理平台之间的数据交换。 2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文 件，仅该日期对应的版本适用于本义 件：不注日期的角文件，共最新版本（包括所有的修改单）适用于 本文件。 GB/T2260 共和国行政 NY/T1640 3术语和定义 下列术语和是义 适用 3. 1 L 农机作业远程监测管理平台 rennote mom toring platformor agricultural 具有作业数据 实回显泰 作业轨迹回放、作业面积计算作业质量分析重 分析、作业数 早出和报表打印等功能的综合性信息处理平台（以下简称平 CH 据统计汇总、数据导 3. 2 上级平台 数据流入的平 3.3 下级平台 ned ouayu! 数据流出的平 U 3.4 农机定位信息 agricultural machinery location information 由作业监测终端从导航卫星接收并发送到监测管理平台的 位置有关的信息的统称，包 括农机的经纬度、速度、方向等 3.5 农机作业信息agriculturalmachineryoperationinformation 能够表征农机作业类型、作业状态、作业数量和作业质量的相关参数。例如，耕整地、播种、收获等作 业类型信息；作业面积、作业地块面积、作业时长、作业里程等作业数量信息；漏播率、重播率、深松达标比 等作业质量信息。 3. 6 农机作业轨迹信息 agriculturalmachineryoperationtrackinformation 农机在一段时间内连续运行所产生的多个轨迹点位的集合，每个轨迹点位包括经纬度、时间、速度、方 向、作业状态等信息。 3. 7 农机作业地块信息 agricultural machinery operation plot information 1 NY/T3892—2021 由农机作业轨迹信息解析生成的，能够表征作业地块地理位置、面积、边界轮廓等的信息。 3. 8 农机作业图像信息agriculturalmachineryoperationimageinformation 农机在作业过程中利用图像采集设备采集的作业图像，也包括采集时间、经纬度等信息。 4一般性规范 4.1接口基础功能 提供数据接口服务的平台应具备如下接口功能： a）应提供必要的用户身份验证方式，同时应为使用数据服务的平台分配正确的权限； b）应在数据接口服务的返回结果中给出必要且准确的提示信息； c）数据对接的双方平台应有一定的技术措施核查传输数据的准确性和完整性， 4.2数据安全 数据对接的双方应采取必要的措施保证数据安全： a）双方传输的数据应经过加密后进行网络传输； b) 接口服务提供方应配备必要的软硬件设施以保证接口服务正常运行、数据安全存储、用户隐私 安全等，同时对于数据重传、数据补传、数据变更等情况有相应的处理方案； c）接口服务使用方应规范使用接口服务，保证自身账户信息不被泄露。 4.3作业农机的区域归属 4.3.1作业农机的区域归属分为省市、地市、区县、乡镇、服务组织5个级别，各级别有对应的区划代码。 4.3.2服务组织为作业农机区域归属的具体级别，分为3种类型： a）行政村：对于从属于个人的农机，将农机归属的行政村指定为其服务组织，区划代码使用对应的 行政村代码，按照GB/T2260的规定执行； b） 合作社：区划代码使用统一社会信用代码； c) 公司型服务组织：区划代码使用统一社会信用代码。 4.3.3省市、地市、区县、乡镇区划代码按照GB/T2260的规定执行。 4.3.4数据接口提供方依据国家统计局发布的最新版全国行政区划信息建立相应的区划信息库，并定期 维护更新。 5数据传输方式 5.1传输格式 平台间数据通信方式采用HTTPS协议，数据协议格式采用JSON(JavaScriptObjectNotation），字 符编码使用UTF-8。 5.2传输模式 根据平台数据交换过程中的数据交换发起者的区别，分为如下两种数据传输模式，模式选择根据实际 业务需求确定 a）模式A：上级平台发起，调用下级平台的数据接口服务，获取下级平台数据。模式A如图1 所示。 接口调用 上级平台 下级平台 数据返回 图1模式A b）模式B：下级平台发起，调用上级平台的数据接口服务，主动向上级平台推送。模式B如图2 所示。 2 NY/T3892—2021 数据推送 上级平台 下级平台 图2 模式B 5.3参数加密 5.3. 1 加密算法 a) 加密算法：AES； b) 加密模式：ECB; c) 补码方式：PKCS5Padding； d) 密钥长度：128； e) 加密结果编码方式：Base64： D 字符集：UTF-8。 5.3.2 加密方式 a) 对接口请求参数中业务 TAND 示例1： mso....sn.. "pwd":"te DW "para":"" ABOSH b) 对接口返回结果牛 的业务数 示例2： "code": "msg": "result" CQhABI ICU 6 功能实现流程 6.1模式A 下级平台开发数据接口 服务 6.1.2账号及密钥分配 下级平台为上级平台分配账户，并根据实际需求赋宇相应的权限。 权限包括： a）区域权限：接口用户在指定时问范围内，对指定区域的农机作业数据拥有获取权限； b） 接口权限：允许用户访问的接口和使用时限 6.1.3开发数据对接程序（服务） 上级平台开发数据对接程序（服务）。 6.1.4参数加密及接口访问 上级平台对请求参数中的业务数据进行加密，并使用账号信息连接数据接口服务，获得加密的业务 数据。 6.1.5数据解密 上级平台对加密数据进行解密得到所需的业务数据。 6.2模式B 6.2.1开发数据接口服务 NY/T3892—2021 上级平台开发数据接口服务 6.2.2账号及密钥分配 上级平台为下级平台分配账户，并根据实际需要赋予相应的权限。用户权限包括： a）区域权限：接口用户在指定时间范围内，对指定区域的农机作业数据拥有推送权限； b）接口权限：允许用户访问的接口和使用时限。 6.2.3开发数据对接程序（服务） 下级平台开发数据对接程序（服务）。 6.2.4参数加密及接口访问 下级平台对除账户信息外的业务数据参数进行加密，并使用账户信息连接数据接口服务。 6.2.5定时上传 上级平台与下级平台协定不同数据类型的上传频率，下级平台按规定的频率上传数据至上级平台。 6.2.6结果返回 上级平台接收并解密得到所需的业务数据，同时返回调用结果状态信息。 7数据接口定义 7.1接口通用要求 7.1.1接口请求类型 数据接口请求类型均为POST。 7.1.2账户信息参数 账户信息参数形式由数据接口提供方确定，有用户名密码形式、令牌形式等。 a) 用户名密码形式： "usr"."testusr", "pwd":"testpwd" b) 令牌形式： "1oken":"LscQhABl66pHxeb" 7.1.3各数据接口的请求参数中都需包含用户账户信息，请求参数表中不再列出此项。 7.2通用接口 7.2.1用户配置信息查询接口 用户使用该接口查询用户配置信息以及接口状态，接口方法名为userinfo，接口请求参数和返回结果 分别见表1和表2。 表1 用户配置信息查询接口请求参数 参数名称 参数类型 必填与否 参数说明 . . 注：该接口请求参数仅包含用户账户信息，具体参数格式由数据接口提供方确定。 表2用户配置信息查询接口返回结果 参数名称 类型 参数说明 result int 服务状态码（见表29） msg string 返回信息 user object 用户配置信息 NY/T3892