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

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