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

ICS65.020.99B07DB12天津市地方标准DB12/T740.1—2017农业物联网平台技术规范第1部分：数据上传接口TechnicalspecificationfortheplatformofagriculturalInternetofthingsPart1:Datauploadinterface2017-10-27发布2017-12-01实施天津市市场和质量监督管理委员会发布DB12/T740.1—2017I前言DB12/T740《农业物联网平台技术规范》分为以下几个部分：——第1部分：数据上传接口；——第2部分：应用系统发布；„„本部分为DB12/T740《农业物联网平台技术规范》的第1部分。本部分按照GB/T1.1-2009《标准化工作导则第1部分：标准的结构和编写》给出的规则起草。本部分由天津市农村工作委员会提出并归口。本部分起草单位：天津市农村工作委员会信息中心、中国科学院合肥物质科学研究院。本部分主要起草人：唐树山、孙丙宇、胡宜敏、李洁、史杨、张保岩、李小刚、路宁、康双辉、杨勇、包蕊、于建美、韩跃。DB12/T740.1—20171农业物联网平台技术规范第1部分：数据上传接口1范围本部分规定了农业物联网平台技术规范中数据上传接口的数据上传框架、农业环境信息数据及要求、视频数据。本部分适用于需要接入天津市农业物联网平台的农业生产基地数据的规范。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB2312信息交换用汉字编码字符集GB/T28281安全防范视频监控联网系统信息传输、交换、控制技术要求GB50198民用闭路监视电视系统工程技术规范3数据上传框架数据上传框架由农业生产基地、农业物联网平台两个部分组成（图1）。农业生产基地将采集的环境信息数据或视频数据，通过网络传输上传到农业物联网平台。农业物联网平台农业生产基地应用系统数据库Webservice环境数据视频数据图1数据上传框架DB12/T740.1—201724农业环境信息数据及要求4.1数据标识4.1.1种植环境信息数据元表1种植环境信息常用数据元名称、单位和标识符要求名称单位标识符太阳辐射瓦每平方米（W/m2）FALI太阳有效辐射瓦每平方米（W/m2）FEALI降雨量毫米（mm）FAPT空气温度摄氏度（℃）FTemp空气相对湿度无（%）FHumidity风速米每秒（m/s）FAWS风向度（°）FAWD二氧化碳浓度毫克每立方米（mg/m3）FCO2光照强度勒克斯（lx）FLight20厘米土壤温度摄氏度（℃）FSTC2020厘米土壤含水率无（%）FSWC2040厘米土壤温度摄氏度（℃）FSTC4040厘米土壤含水率无（%）FSWC4060厘米土壤温度摄氏度（℃）FSTC6060厘米土壤含水率无（%）FSWC60电导率毫西每厘米（mS/cm）FECpH无FPH露点摄氏度（℃）FDew4.1.2水产养殖环境信息数据元表2水产养殖环境信息常用数据元名称、单位和标识符要求名称单位标识符pH无APH溶解氧毫克每升（mg/l）ADO溶解氧饱和度无（%）ADOL水温摄氏度（℃）AT电导率毫西每厘米（mS/cm）AC盐度无（%）ASalinity浊度散射浊度单位（NTU）ATurbidity氨氮毫克每升（mg/l）AAmmoniaDB12/T740.1—201734.1.3畜牧养殖环境信息数据元表3畜牧养殖环境信息常用数据元名称、单位和标识符要求名称单位标识符空气温度摄氏度（℃）LTemp空气相对湿度无（%）LHumidity光照强度勒克斯（lx）LLight氨气浓度毫克每立方米（mg/m3）LAmmonia硫化氢浓度毫克每立方米（mg/m3）LH2S二氧化碳浓度毫克每立方米（mg/m3）LCO2一氧化碳浓度毫克每立方米（mg/m3）LCOPM10浓度毫克每立方米（mg/m3）LPM104.2数据上传要求农业物联网平台提供WebService作为农业生产基地数据上传接口，传输报文使用可扩展标记语言（XML），具体接口定义、格式要求及示例参见附录A。5视频数据5.1摄像头安装农业生产基地采用摄像头的选型及安装应符合GB/T28281及GB50198中的要求。5.2视频质量农业生产基地采集视频的分辨率应不低于640×480，帧数应大于每秒15帧。5.3文字标注农业生产基地上传视频应包含基地名称、采集点名称、采集时间的文字标注。DB12/T740.1—20174AA附录A（规范性附录）农业环境信息数据上传规范A.1上传接口说明A.1.1接口地址天津市农业物联网农业环境信息数据上传采用WebService接口，地址为，提供registerview、getviews、uploadinfos三个方法供远程调用。A.1.2观测点注册观测点首次上传数据前应调用registerview进行观测点注册，反复注册无效。农业生产基地名称、观测点名称注册后不得修改。农业生产基地上传未注册观测点环境信息数据时，农业物联网平台默认丢弃处理。A.1.3数据上传农业生产基地观测点环境信息数据采集上传时间间隔建议为半小时。环境信息数据只需上传一次，反复上传无效。农业生产基地应避免反复上传重复信息，加重系统负担。A.1.4格式调用接口传输时，传输报文使用XML，字符编码采用GB2312。报文字段中不得出现汉字、字母、数字、小数点以外字符。A.2方法明细及输入输出示例A.2.1注册观测点A.2.1.1方法名注册观测点方法名为registerview，用于新观测点注册。A.2.1.2输入输入为农业生产基地名称、新观测点名称。报文起止标签为View，层级为一级。每条报文包含一条View记录。每条View记录中包含字段定义见表A.1。表A.1View记录标签及含义标签名说明CompanyName农业生产基地名称ViewName农业生产基地观测点名称DB12/T740.1—20175表A.2注册观测点输入示例示例?xmlversion=1.0encoding=GB2312?ViewCompanyName天津生宝谷物基地/CompanyNameViewName新观测点/ViewName/ViewA.2.1.3输出输出为成功注册的观测点信息。报文起止标签为Views，层级为一级。每条观测点记录标签为View，层级为二级。注册成功时，返回该观测点信息；注册失败时返回空记录。表A.3注册观测点输出示例注册成功示例?xmlversion=1.0encoding=GB2312?ViewsViewCompanyName天津生宝谷物基地/CompanyNameViewName新观测点/ViewNameStatus注册成功/Status/View/Views注册失败示例?xmlversion=1.0encoding=GB2312?ViewsViewCompanyName天津生宝谷物基地/CompanyNameViewName新观测点/ViewNameStatus注册失败，新观测点名称重复/Status/View/ViewsA.2.2获取观测点A.2.2.1方法名获取观测点方法名为getviews，用于查询某农业生产基地在物联网平台中已注册的观测点名称列表。A.2.2.2输入DB12/T740.1—20176输入为农业生产基地名称。报文起止标签为Company，层级为一级。每条报文包含一条Company记录。输入农业生产基地名称标签为CompanyName，层级为二级。一条Company记录中包含一条CompanyName记录。表A.4获取观测点输入示例示例?xmlversion=1.0encoding=GB2312?CompanyCompanyName天津生宝谷物基地/CompanyName/CompanyA.2.2.3输出输出为农业生产基地所有观测点记录。报文起止标签为Views，层级为一级。每条观测点记录标签为View，层级为二级。每条报文包含一组或多组View记录。每条View记录中包含字段定义见表A.1。表A.5获取观测点输出示例示例?xmlversion=1.0encoding=GB2312?ViewsViewCompanyName天津生宝谷物基地/CompanyNameViewName观测点1/ViewName/ViewViewCompanyName天津生宝谷物基地/CompanyNameViewName观测点2/ViewName/View/ViewsA.2.3上传环境信息数据A.2.3.1方法名上传环境信息数据方法名为uploadinfos，用于将采集的环境信息上传到农业物联网平台。A.2.3.2输入输入为采集的环境信息。报文起止标签为Infos，层级为一级。每条环境信息数据记录标签为Info，层级为二级。每条报文包含一条或多条Info记录，单次上传记录总数不超过1000条。Info标签及含义见表A.6，每组Info记录中应包含表A.6中所有字段。表A.6Info记录标签及含义DB12/T740.1—20177标签名说明CompanyName农业生产基地名称ViewName农业生产基地观测点名称UpdateTime接收数据时间，格式为“yyyy-MM-ddHH:mm:ss”的字符串DataType接收数据类型，命名见4.1节Value接收数据数值，数值应换算到4.1节要求的单位，格式为保留两位小数的字符串Description其他需要说明的情况表A.7上传环境信息数据输入示例示例?xmlversion=1.0encoding=GB2312?InfosInfoCompanyName天津生宝谷物基地/CompanyNameViewName观测点1/ViewNameUpdateTime2014-4-232:48:43/UpdateTimeDataTypefTemp/DataTypeValue10.00/ValueDescription无/Description/InfoInfoCompanyName天津生宝谷物基地/CompanyNameViewName观测点1/ViewNameUpdateTime2014-4-232:48:43/UpdateTimeDataTypefHumidity/DataTypeValue50.00/ValueDescription无/Description/Info/InfosA.2.3.3输出输出为本次成功上传的数据记录。报文起止标签为Infos，层级为一级。每条环境信息数据记录标签为Info，层级为二级。每条报文包含一条或多条Info记录。Info记录分条入库，输出包含本次成功上传的记录。表A.8上传环境信息数据输出示例示例?xmlversion=1.0encoding=GB2312?InfosInfoCompanyName天津生宝谷物基地/CompanyNameDB12/T740.1—20178ViewName观测点1/ViewNameUpdateTime2014-4-232:48:43/UpdateTimeDataTypefTemp/DataTypeValue10.00/ValueDescription无/Description/InfoInfoCompanyName天津生宝谷物基地/CompanyNameViewName观测点1/ViewNameUpdat