DB12/T 740.1-2017 农业物联网平台技术规范 第1部分：数据上传接口.pdf

<p>ICS 65.020.99 B 07 DB12 天津市 地 方 标 准 &nbsp;DB12/T 740.1 2017 农业物联网平台 技术规范 &nbsp;第 1 部分 ： 数据 上传 接口 &nbsp;Technical specification for the platform of agricultural Internet of things Part 1: Data upload interface 2017 - 10 - 27 发布 &nbsp;2017 - 12 - 01 实施 &nbsp;天津 市市场和质量监督管理委员会 &nbsp; &nbsp;发布 &nbsp;DB12/T 740.1 2017 I 前 &nbsp; 言 &nbsp;DB12/T 740 农业物联网平台 技术规范 分为以下几个部分： &nbsp; 第 1 部分：数据上传接口； &nbsp; 第 2 部分：应用系统发布； &nbsp; &nbsp;本部分为 DB12/T 740农业物联网平台技术规范 的第 1部分。 &nbsp;本部分按照 GB/T 1.1-2009 标准 化 工作 导则 &nbsp;第 1部分 ： 标准 的 结构 和 编写 给出的规则起草。 &nbsp;本 部分 由天津市农村工作委员会提出并 归 口 。 &nbsp;本 部分 起草单位： 天津市农村工作委员会信息中心 、 中国科学院合肥物质科学研究院 。 &nbsp;本 部分 主要起草人： 唐树山 、 孙丙宇 、 胡宜敏 、 李洁 、 史杨 、 张保岩 、 李小刚 、 路宁 、 康双辉 、 杨勇 、 包 蕊、于建美、韩跃 。DB12/T 740.1 2017 1 农业物联网平台 技术 规范 &nbsp;第 1 部分 ： 数据 上传 接口 &nbsp;1 范围 &nbsp;本 部分 规定了农业物联网平台 技术 规范中 数据 上传 接口 的 数据 上传 框架、农业环境信息数据 及 要求、视频数据 。 &nbsp;本 部分 适用于 需要接入天津市农业物联网平台 的农业生产基地 数据 的 规范 。 &nbsp;2 规范性引用文件 &nbsp;下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 &nbsp;GB 2312 &nbsp;信息交换用汉字编码字符集 &nbsp;GB/T 28281 &nbsp;安全防范视频监控联网系统信 息传输、交换、控制技术要求 &nbsp;GB 50198 &nbsp;民用闭路监视电视系统工程技术规范 &nbsp;3 数据 上传 框架 &nbsp;数据 上传 框架由农业生产基地、农业物联网平台两个部分组成（图 1）。 农业生产 基地 将 采集 的 环境信息 数据 或视频数据 ，通过网络传输 上传 到农业物联网 平台 。 &nbsp;农 业 物 联 网 平 台农 业 生 产 基 地应 用 系 统数 据 库W e b s e r v i c e环 境 数 据 视 频 数 据图 1 数据 上传 框架 &nbsp;DB12/T 740.1 2017 2 4 农业 环境信息数据 及 要求 &nbsp;4.1 数据 标识 &nbsp;4.1.1 种植 环境信息 数据元 &nbsp;表 1 种植 环境信息 常用 数据元名 称 、单位和标识符要求 &nbsp;名称 &nbsp;单位 &nbsp;标识 符 &nbsp;太阳辐射 &nbsp;瓦每平方米（ W/m2） &nbsp;FALI 太阳有效辐射 &nbsp;瓦每平方米（ W/m2） &nbsp;FEALI 降雨量 &nbsp;毫米（ mm） &nbsp;FAPT 空气温度 &nbsp;摄氏度（） &nbsp;FTemp 空气相对湿度 &nbsp;无（ %） &nbsp;FHumidity 风速 &nbsp;米每秒（ m/s） &nbsp;FAWS 风向 &nbsp;度（°） &nbsp;FAWD 二氧化碳浓度 &nbsp;毫克每立方米（ mg/m3） &nbsp;FCO2 光照强度 &nbsp;勒克斯（ lx） &nbsp;FLight 20 厘米土壤温度 &nbsp;摄氏度（） &nbsp;FSTC20 20 厘米土壤含水率 &nbsp;无（ %） &nbsp;FSWC20 40 厘米土壤温度 &nbsp;摄氏度（） &nbsp;FSTC40 40 厘米土壤含水率 &nbsp;无（ %） &nbsp;FSWC40 60 厘米土壤温度 &nbsp;摄氏 度（） &nbsp;FSTC60 60 厘米土壤含水率 &nbsp;无（ %） &nbsp;FSWC60 电导率 &nbsp;毫西每厘米（ mS/cm） &nbsp;FEC pH 无 &nbsp;FPH 露点 &nbsp;摄氏度（） &nbsp;FDew 4.1.2 水产 养殖 环境信息数据元 &nbsp;表 2 水产养殖环境 信息常用数据元名称、单位和标识符要求 &nbsp;名称 &nbsp;单位 &nbsp;标识符 &nbsp;pH 无 &nbsp;APH 溶解氧 &nbsp;毫克每升（ mg/l） &nbsp;ADO 溶解氧饱和度 &nbsp;无（ %） &nbsp;ADOL 水温 &nbsp;摄氏度（） &nbsp;AT 电导率 &nbsp;毫西每厘米（ mS/cm） &nbsp;AC 盐度 &nbsp;无（ %） &nbsp;ASalinity 浊度 &nbsp;散射浊度单位（ NTU） &nbsp;ATurbidity 氨氮 &nbsp;毫克每升（ mg/l） &nbsp;AAmmonia DB12/T 740.1 2017 3 4.1.3 畜牧养殖 环境信息数据元 &nbsp;表 3 畜牧养殖环境 信息常用数据元名称、单位和标识符要求 &nbsp;名称 &nbsp;单位 &nbsp;标识符 &nbsp;空气温度 &nbsp;摄氏度（） &nbsp;LTemp 空气相对湿度 &nbsp;无（ %） &nbsp;LHumidity 光照强度 &nbsp;勒克斯（ lx） &nbsp;LLight 氨气浓度 &nbsp;毫克每立方米（ mg/m3） &nbsp;LAmmonia 硫化氢浓度 &nbsp;毫克每立方米（ mg/m3） &nbsp;LH2S 二氧化碳浓度 &nbsp;毫克每立方米（ mg/m3） &nbsp;LCO2 一氧化碳浓度 &nbsp;毫克每立方米（ mg/m3） &nbsp;LCO PM10 浓度 &nbsp;毫克每立方米（ mg/m3） &nbsp;LPM10 4.2 数据 上传 要求 &nbsp;农业物联网平台提供 WebService作为 农业生产基地数据 上传接口， 传输报文 使用可扩展标记语言（ XML） ，具体 接口定义 、 格式 要求及 示例 参见 附录 A。 &nbsp;5 视频数据 &nbsp;5.1 摄像头安装 &nbsp;农业生产基地采用 摄像头 的选型及安装 应 符合 GB/T 28281及 GB 50198中的要求。 &nbsp;5.2 视频 质量 &nbsp;农业生产基地采集视频的分辨率应不低于 640× 480，帧数应大于每秒 15帧 。 &nbsp;5.3 文字标注 &nbsp;农业生产基地上传视频应包含基地名称、采集点名称、采集时间的 文字标注 。 &nbsp;DB12/T 740.1 2017 4 A &nbsp;A &nbsp;附 &nbsp;录 &nbsp;A （规范性附录） &nbsp;农业环 境信息数据上传 规范 &nbsp;A.1 上传接口说明 &nbsp;A.1.1 接口 地址 &nbsp;天津市农业物联网农业环境信息数据上传 采用 WebService接口 ， 地址为 http:/www.tjnywlw.cn /services/wlwupload?wsdl，提供 registerview、 getviews、 uploadinfos三个方法供 远程 调用。 &nbsp;A.1.2 观测点注册 &nbsp;观测点首次上传数据前应调用 registerview进行 观测点 注册，反复注 册无效。 农业生产基地名称、观测点名称注册后不得修改。农业生产基地上传未注册观测点环境信息数据时，农业物联网平台默认丢弃处理。 &nbsp;A.1.3 数据上传 &nbsp;农业生产基地 观测点环境信息数据采集上传时间间隔建议为半小时。 环境信息数据只需上传一次，反复上传无效。农业生产基地应避免反复上传重复信息，加重系统负担。 &nbsp;A.1.4 格式 &nbsp;调用接口传输时，传输报文 使用 XML，字符编码采用 GB 2312。 报文字段中不得出现汉字、字母、数字、小数点以外字符。 &nbsp;A.2 方法 明细 及 输入输出 示例 &nbsp;A.2.1 注册观测点 &nbsp;A.2.1.1 方法名 &nbsp;注册观测点方法名为 registerview，用于新观测点 注册。 &nbsp;A.2.1.2 输入 &nbsp;输入为农业生产基地名称、新观测点名称。报文起止标签为 View，层级为一级。每条报文包含一条View记录。每条 View记录中包含字段定义见表 A.1。 &nbsp;表 A.1 View 记录标签及含义 &nbsp;标签名 &nbsp;说明 &nbsp;CompanyName 农业生产基地名称 &nbsp;ViewName 农业生产基地观测点名称 &nbsp;DB12/T 740.1 2017 5 表 A.2 注册观测点输入示例 &nbsp;示例 &nbsp;天津生宝谷物基地 &nbsp;新观测点 &nbsp;A.2.1.3 输出 &nbsp;输出为成功注册的观测点信息。报文起止标签为 Views，层级为一级。每条观测点记录标签为 View，层级为二级。注册成功时，返回该观测点信息；注册失败时返回空记录。 &nbsp;表 A.3 注册观测点输出示例 &nbsp;注册成功示例 &nbsp;天津生宝谷物基地 &nbsp;新观测点 &nbsp;注册成功 &nbsp;注册失败示例 &nbsp;天津生宝谷物基地 &nbsp;新观测点 &nbsp;注册失败，新观测点名称重复 &nbsp;A.2.2 获取观测点 &nbsp;A.2.2.1 方法名 &nbsp;获取观测点方法名为 getviews，用于查询某农业生产基地 在物联网平台中已注册的观测点名称列表。 &nbsp;A.2.2.2 输入 &nbsp;DB12/T 740.1 2017 6 输入为农业生产基地 名称。 报文起止标签 为 Company，层级为一级。每条报文 包含一 条 Company记录。输入 农业生产基地名称 标签为 CompanyName，层级为二级。一条 Company记录中包含一条 CompanyName记录。 &nbsp;表 A.4 获取观测点输入示例 &nbsp;示例 &nbsp;天津生宝谷物基地 &nbsp;A.2.2.3 输出 &nbsp;输出为 农业生产基地 所有 观测点 记录。 报文起止标签 为 Views，层级为一级。每条 观测点 记录标签为 View，层级为二级。 每条报文 包含 一组或 多 组 View记录。 每条 View记录中 包含 字段定义见表 A.1。 &nbsp;表 A.5 获取观测点输出示例 &nbsp;示例 &nbsp;天津生宝谷物基地 &nbsp;观测点 1 天津 生宝谷物基地 &nbsp;观测点 2 A.2.3 上传环境信息数据 &nbsp;A.2.3.1 方法名 &nbsp;上传环境信息数据方法名为 uploadinfos，用于将采集的环境信息上传到农业物联网平台。 &nbsp;A.2.3.2 输入 &nbsp;输入为采集的环境信息 。 报文起止标签为 Infos，层级为一级。 每条 环境信息数据 记录标签为 Info，层级为二级。 每条报文包含一条 或多条 Info记录 ， 单次上传 记录总数不 超过 1000条 。 Info标签及含义见表 A.6， 每组 Info记录中应包含 表 A.6中所有字段。 &nbsp;表 A.6 Info 记录标签及含义 &nbsp;DB12/T 740.1 2017 7 标签名 &nbsp;说明 &nbsp;CompanyName 农业生产基地 名称 &nbsp;ViewName 农业生产基地 观测点名称 &nbsp;UpdateTime 接收 数据时间 ， 格式 为 “ yyyy-MM-dd HH:mm:ss” 的 字符串 &nbsp;DataType 接收 数据类型 ，命名见 4.1 节 &nbsp;Value 接收数据 数值，数值应换算到 4.1 节要求的单位 ， 格式为 保留两位小数 的字符串 &nbsp;Description 其他需要说明的情况 &nbsp;表 A.7 上传环境信息数据输入示例 &nbsp;示例 &nbsp;天津生宝谷物基地 &nbsp;观测点 1 2014-4-23 2:48:43 fTemp 10.00 无 &nbsp;天津生宝谷物基地 &nbsp;观测点 1 2014-4-23 2:48:43 fHumidity 50.00 无 &nbsp;A.2.3.3 输出 &nbsp;输出为 本次成功上传的数据记录 。 报文起止标签为 Infos，层级为一级。 每条环境信息数据记录标签为 Info，层级为二级。每条报文包含一条或多条 Info记录。 Info记录分条入库 ， 输出包含本次 成功 上传 的 记录。 &nbsp;表 A.8 上传环境信息数据输 出 示例 &nbsp;示例 &nbsp;天津生宝谷物基地 &nbsp;DB12/T 740.1 2017 8 观测点 1 2014-4-23 2:48:43 fTemp 10.00 无 &nbsp;天津生宝谷物基地 &nbsp;观测点 1 2014-4-23 2:48:43 fHumidity 50.00 无 &nbsp;_</p>