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

1、ICS 65. 020. 99B 07DB12天 津 市 地 方 标 准DB12/T 740. 12017农业物联网平台技术规范第1部分：数据上传接口Technical specification for the platform of agricultural Internet of thingsPart 1: Data upload interface2017-12-01 实施2017- 10- 27 发布天津市市场和质量监督管理委员会 发布DB12/T 740. 12017 IDB12/T 740农业物联网平台技术规范分为以下几个部分:第1部分：数据上传接口；第2部分：应用系统发布；本部

2、分为DB12/T 740农业物联网平台技术规范的第1部分。本部分按照GB/T 1. 1-2009标准化工作导则第1部分：标准的结构和编写给出的规则起草。 本部分由天津市农村工作委员会提出并归口。本部分起草单位：天津市农村工作委员会信息中心、中国科学院合肥物质科学研究院。本部分主要起草人：唐树山、孙丙宇、胡宜敏、李洁、史杨、张保岩、李小刚、路宁、康双辉、杨 勇、包蕊、于建美、韩跃。DB12/T 740. 12017 农业物联网平台技术规范第1部分：数据上传接口1范围本部分规定了农业物联网平台技术规范中数据上传接口的数据上传框架、农业环境信息数据及要 求、视频数据。本部分适用于需要接入天津市农业物

3、联网平台的农业生产基地数据的规范。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB 2312信息交换用汉字编码字符集GB/T 28281安全防范视频监控联网系统信息传输、交换、控制技术要求GB 50198民用闭路监视电视系统工程技术规范3数据上传框架数据上传框架由农业生产基地、农业物联网平台两个部分组成（图1） O农业生产基地将采集的环 境信息数据或视频数据，通过网络传输上传到农业物联网平台。农业生产基地农业物联网平台图1数据上传框架4农业环境信息数据及要求 4.

4、1数据标识4. 1. 1种植环境信息数据元表1种植环境信息常用数据元名称、单位和标识符要求名称单位标识符太阳辐射瓦每平方米（w/k）FALI太阳有效辐射瓦每平方米（w/k）FEALI降雨量毫米（111111）FAPT空气温度摄氏度（C）FTemp空气相对湿度无(%)FHumidity风速米每秒（m/s）FAWS风向度（ ）FAWD二氧化碳浓度毫克每立方米（mg/m3）FCO2光照强度勒克斯（lx）FLight20厘米土壤温度摄氏度（C）FSTC2020厘米土壤含水率无(%)FSWC2040厘米土壤温度摄氏度（C）FSTC4040厘米土壤含水率无(%)FSWC4060厘米土壤温度摄氏度（C）FS

5、TC6060厘米土壤含水率无(%)FSWC60电导率毫西每厘米（iiiS/cm）FECpH无FPH露点摄氏度（C）FDew4. 1.2水产养殖环境信息数据元表2水产养殖环境信息常用数据元名称、单位和标识符要求名称单位标识符pH无APH溶解氧毫克每升（mg/1）ADO溶解氧饱和度无(%)ADOL水温摄氏度（C）AT电导率毫西每厘米（iiiS/cm）AC盐度无(%)ASalinity浊度散射浊度单位（NTU）ATurbidity氨氮毫克每升（mg/1）AAmmoniaDB12/T 740. 12017 4.1.3畜牧养殖环境信息数据元表3畜牧养殖环境信息常用数据元名称、单位和标识符要求名称单位标识

6、符空气温度摄氏度(C)LTemp空气相对湿度无(%)LHumidity光照强度勒克斯(1X)LLight氨气浓度毫克每立方米(mg/m3)LAmmonia硫化氢浓度毫克每立方米(mg/m3)LH2S二氧化碳浓度毫克每立方米(mg/m3)LC02一氧化碳浓度毫克每立方米(mg/m3)LCOPM10浓度毫克每立方米(mg/m3)LPM104.2数据上传要求农业物联网平台提供WebService作为农业生产基地数据上传接口，传输报文使用可扩展标记语言 (XML),具体接口定义、格式要求及示例参见附录A。5视频数据5. 1摄像头安装农业生产基地采用摄像头的选型及安装应符合GB/T 28281及GB 5

7、0198中的要求。5. 2视频质量农业生产基地采集视频的分辨率应不低于640X480,帧数应大于每秒15帧。5. 3文字标注农业生产基地上传视频应包含基地名称、采集点名称、采集时间的文字标注。附录A规范性附录）农业环境信息数据上传规范A. 1上传接口说明A. 1. 1接口地址天津市农业物联网农业环境信息数据上传采用恥bServiee接口，地址为 HYPERLINK http:www. t.jnywlw. cn /serviees/wlwuijloadfwsdl,提供建 gistervi倉 w、g 在 tviews、up load infos 三个方法供远程调用。A. 1.2观测点注册观测点首次

8、上传数据前应调用registerview进行观测点注册，反复注册无效。农业生产基地名称、 观测点名称注册后不得修改。农业生产基地上传未注册观测点环境信息数据时，农业物联网平台默认丢 弃处理。A. 1.3数据上传农业生产基地观测点环境信息数据采集上传时间间隔建议为半小时。环境信息数据只需上传一次， 反复上传无效。农业生产基地应避免反复上传重复信息，加重系统负担。A. 1.4格式调用接口传输时，传输报文使用XML,字符编码采用GB2312报文字段中不得出现汉字、字母、数 字、小数点以外字符。A.2方法明细及输入输出示例A. 2. 1注册观测点A. 2. 1.1 方法名注册观测点方法名为regist

9、erview,用于新观测点注册。A. 2. 1.2 输入输入为农业生产基地名称、新观测点名称。报文起止标签为View,层级为一级。每条报文包含一条 View记录。每条View记录中包含字段定义见表A. 1。表A. 1 View记录标签及含义标签名说明CompanyName农业生产基地名称ViewName农业生产基地观测点名称表A. 2注册观测点输入示例示例 天津生宝谷物基地 新观测点 A. 2. 1.3 输出输出为成功注册的观测点信息。报文起止标签为Views,层级为一级。每条观测点记录标签为View, 层级为二级。注册成功时，返回该观测点信息；注册失败时返回空记录。表A.3注册观测点输出示例

10、注册成功示例 天津生宝谷物基地 新观测点 注册成功 注册失败示例 天津生宝谷物基地 新观测点 注册失败，新观测点名称重复/StatusA. 2. 2获取观测点A. 2. 2. 1 方法名获取观测点方法名为getviews,用于查询某农业生产基地在物联网平台中已注册的观测点名称列 表。A. 2. 2. 2 输入输入为农业生产基地名称。报文起止标签为Company,层级为一级。每条报文包含一条Company记录。 输入农业生产基地名称标签为CompanyName,层级为二级。一条Company记录中包含一条CompanyName记 录。表A.4获取观测点输入示例示例 天津生宝谷物基地 A. 2.

11、2. 3 输出输出为农业生产基地所有观测点记录。报文起止标签为Views,层级为一级。每条观测点记录标签 为View,层级为二级。每条报文包含一组或多组View记录。每条View记录中包含字段定义见表A. 1。表A.5获取观测点输出示例示例 天津生宝谷物基地 观测点 K/ViewName 天津生宝谷物基地 观测点 2 A. 2. 3上传环境信息数据A. 2. 3. 1 方法名上传环境信息数据方法名为uploadinfos,用于将采集的环境信息上传到农业物联网平台。A. 2. 3. 2 输入输入为采集的环境信息。报文起止标签为Infos,层级为一级。每条环境信息数据记录标签为Info, 层级为二

12、级。每条报文包含一条或多条Info记录，单次上传记录总数不超过1000条。Info标签及含义见 表A. 6,每组Info记录中应包含表A. 6中所有字段。表A. 6I nfo记录标签及含义DB12/T 740. 12017 标签名说明CompanyName农业生产基地名称ViewName农业生产基地观测点名称UpdateTime接收数据时间，格式为“yyyy-MM-dd的字符串DataType接收数据类型，命名见4.1节Value接收数据数值，数值应换算到4.1节要求的单位，格式为保留两位小数的字符串Description其他需要说明的情况表A. 7上传环境信息数据输入示例示例 天津生宝谷物基地 观测点 K/ViewName2014-4-23 2:48:43 fTemp10. 00c 天津生宝谷物基地 观测点 K/ViewName2014-4-23 2:48:43 fHumidity50. 00 c A. 2. 3. 3 输出输出为本次成功上传的数据记录。报文起止标签为Infos,层级为一级。每条环境