ICS 65.020.01 B 05 石 家 DB1301 庄 市 农 业 地 方 标 准 DB 1301/T 332—2020 农业物联网平台数据交换共享指南 2020 - 04 - 14 发布 石家庄市市场监督管理局 2020 - 06 - 14 实施 发 布 DB1301/T 332—2020 目 次 前言 ................................................................................ II 1 范围 .............................................................................. 1 2 规范性引用文件 .................................................................... 1 3 术语和定义 ........................................................................ 1 4 总则 .............................................................................. 1 5 需考虑的因素 ...................................................................... 1 I DB1301/T 332—2020 前 言 本标准按照GB/T 1.1—2009给出的规则起草。 本标准由石家庄市农业农村局提出。 本标准主要起草单位：石家庄市农林科学研究院、北京农业信息技术研究中心。 本标准主要起草人：朱华吉、田国英、罗磊、杨英茹、孙想、黄媛、郝鹏、高欣娜、吴华瑞、李海 杰、顾静秋、武猛、李庆学、郝晓兰。 II DB1301/T 332—2020 农业物联网平台数据交换共享指南 1 范围 本标准提出了种植业农业物联网采集系统与物联网平台之间对各类数据进行交换共享时对数据定 义、数据共享方式与交换格式、数据安全、维护升级的建议。 本标准适用于石家庄市种植业农业物联网采集系统和物联网平台间的数据交换共享。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 DB1301/T 331—2020 设施农业物联网数据采集指南 3 术语和定义 下列术语和定义适用于本文件。 3.1 农业物联网平台 agricultural Internet of things information platform 通过各种传感器、控制设备实时感知、控制生产现场参变量，提供农业生产服务的软硬件集成平台。 3.2 数据申请方 data applicant 数据交换中发起服务请求的一方，远程获取内容提供方的数据。 3.3 数据提供方 data provider 数据交换中被访问的一方，接收服务请求，通过接口为数据申请方提供数据。 4 总则 为规范农业物联网平台间的数据交换共享工作制定本指南。农业物联网平台数据交换共享工作应符 合数据规范、传输安全、效率合理、便于迭代的基本原则。本指南适用于新建物联网系统的数据交换共 享工作，已有系统可参照执行。 5 需考虑的因素 5.1 数据 农业物联网平台共享交换的数据。基于种植业农业物联网设施产生的数据和人为填报数据。平台间 进行数据交换共享时，交换数据格式应符合DB1301/T 331—2020 第7章的规定。 1 DB1301/T 332—2020 5.2 数据共享 5.2.1 传输方式 农业物联网平台数据交换共享基于RESTFul API，采用标准JSON数据格式，HTTP传输协议。数据申 请方通过GET/POST方法访问数据提供方，数据提供方应给与JSON格式字符串作为回复。 5.2.2 服务方式 服务方式如图1所示： 图1 服务方式 传输过程中，数据申请方向数据提供方发出查询请求，数据提供方通过RESTFulApi接口响应请求， 并返回相应的数据。 5.2.3 数据交换格式 5.2.3.1 报文 数据申请方发送的请求报文内，可包含双方约定的筛选参数，如设备编码、上报时间等内容，对请 求数据内容进行筛选。 数据提供方的回复数据报文应在1 024 k范围内，交换频率低于2 次/秒。对于长列表数据需要分页 提供，并在回复报文中包含页码和总页码字段，便于数据申请方分段处理。分页数据需允许请求方通过 参数指定获取的页码和每页长度。 回复报文必须包含“code”字段和“msg”字段。code字段表示访问状态，msg字段为访问状态文字 说明。字段内容由双方约定。 回复报文必须包含data字段，为一次请求中回复的数据体。对于数据内容是单个对象的，data中直 接返回对象属性；对于数据内容为列表的，data为array格式，内含多个回复数据。 5.2.3.2 基地信息 示例1：通过 baseCode 获取单个基地信息： 请求：GET /base?baseCode=1301090001 2 DB1301/T 332—2020 回复报文： HTTP/1.1 200 OK { “code”:200, “msg”:“获取成功” “data”: { “createDate”: “2015-01-01”, “baseCode”:“1301090001”, “baseName”:“藁城示范基地”, “info”:“建立于藁城区的测试基地”, “area”:“100”, “xzqhCode”:“130109”, “picture”:“http://www.basegaocheng.org/pic/20150101/title.png” } } 示例2：获取多个基地信息： 请求：GET /baseList?page=1&pageSize=2 回复报文： HTTP/1.1 200 OK { “code”:200, “msg”:“获取成功”, “page”:1, “totalPages”:5, “data”: [ { “createDate”: “2015-01-01”, “baseCode”:“1301090001”, “baseName”:“藁城示范基地”, “info”:“建立于藁城区的测试基地”, “area”:“100”, “xzqhCode”:“130109”, “picture”:“http://www.basegaocheng.org/pic/20150101/title.png” }, { “createDate”: “2015-01-05”, “baseCode”:“1301090002”, “baseName”:“藁城种植基地”, “info”:“建立于藁城区的种植基地”, “area”:“180”, “xzqhCode”:“130109”, 3 DB1301/T 332—2020 “picture”:“http://www.basegaocheng.org/pic/20150105/title.png” } ] } 5.2.3.3 设施类型 示例：获取设施类型列表： 请求：GET /baseTypeList?page=1&pageSize=2 回复报文： HTTP/1.1 200 OK { “code”:200, “msg”:“获取成功”, “page”:1, “totalPages”:5, “data”: [ { “typeCode”: “Q001”, “unit”:“℃”, “minValue”:“-20.0”, “maxValue”:“80.0”, “precision”:“0.1”, “resolution”:“0.1”, “responseTime”:“1”, “picture”:“http://www.basegaocheng.org/pic/20150105/station1.png” }, { “typeCode”: “V001”, “unit”:“”, “minValue”:“”, “maxValue”:“”, “precision”:“”, “resolution”:“”, “responseTime”:“0”, “picture”:“http://www.basegaocheng.org/pic/20150105/station2.png” } ] } 5.2.3.4 设施信息 示例1：获取单个设施信息： 请求：GET /device?dviceCode=1301090001W002Q002 4 DB1301/T 332—2020 回复报文： HTTP/1.1 200 OK { “code”:200, “msg”:“获取成功”, “data”: { “deviceCode”:“1301090001W002Q001”, “typeCode”:“Q004”, “deviceName”:“一号气象站”, “parentCode”:“1301090001W002” } } 示例2：获取多个设施信息： 请求：GET /devices?typeCode=Q004&page=1&pageSize=2 回复报文： HTTP/1.1 200 OK { “code”:200, “msg”:“获取成功”, “page”:1, “totalPages”:5, “data”: [ { “deviceCode”:“1301090001W002Q001”, “typeCode”:“Q004”, “deviceName”:“一号气象站”, “parentCode”:“1301090001W002” }, { “deviceCode”:“1301090001W002Q002”, “typeCode”:“Q004”, “deviceName”:“二号气象站”, “parentCode”:“1301090001W002” } ] } 5.2.3.5 传感器数据 示例：获取多个传感器数据： 请求：GET /data?deviceCode=1301090001W002Q001&page=1&pageSize=2 回复报文： 5 DB1301/T 332—2020 HTTP/1.1 200 OK { “code”:200, “msg”:“获取成功”, “page”:1, “totalPages”:5, “data”: [ { “deviceCode”:“1301090001W002Q0