DB12-T740.1-2017-农业物联网平台技术规范-天津市

ICS65.020.99DB12B07天津市地方标准DB12/T740.1—2017农业物联网平台技术规范第1部分：数据上传接口TechnicalspecificationfortheplatformofagriculturalInternetofthingsPart1:Datauploadinterface天津市市场和质量监督管理委员会发布DB12/T740.1—2017前言DB12/T740《农业物联网平台技术规范》分为以下几个部分：——第1部分：数据上传接口；——第2部分：应用系统发布；„„本部分为DB12/T740《农业物联网平台技术规范》的第1部分。本部分按照GB/T1.1-2009《标准化工作导则第1部分：标准的结构和编写》给出的规则起草。本部分由天津市农村工作委员会提出并归口。本部分起草单位：天津市农村工作委员会信息中心、中国科学院合肥物质科学研究院。本部分主要起草人：唐树山、孙丙宇、胡宜敏、李洁、史杨、张保岩、李小刚、路宁、康双辉、杨勇、包蕊、于建美、韩跃。IDB12/T740.1—2017农业物联网平台技术规范第1部分：数据上传接口1范围本部分规定了农业物联网平台技术规范中数据上传接口的数据上传框架、农业环境信息数据及要求、视频数据。本部分适用于需要接入天津市农业物联网平台的农业生产基地数据的规范。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB2312信息交换用汉字编码字符集GB/T28281安全防范视频监控联网系统信息传输、交换、控制技术要求民用闭路监视电视系统工程技术规范GB501983数据上传框架由农业生产基地、农业物联网平台两个部分组成（图1）。农业生产基地将采集的环图11DB12/T740.1—20174农业环境信息数据及要求数据标识种植环境信息数据元表1种植环境信息常用数据元名称、单位和标识符要求名称单位标识符FALI太阳辐射瓦每平方米（W/m瓦每平方米（W/m毫米（mm）摄氏度（℃）无（%）2））太阳有效辐射降雨量2FEALIFAPT空气温度FTempFHumidityFAWS空气相对湿度风速米每秒（m/s）度（°）风向FAWD二氧化碳浓度光照强度毫克每立方米（mg/m3）勒克斯（lx）摄氏度（℃）无（%）FCO2FLightFSTC20FSWC20FSTC40FSWC40FSTC60FSWC60FEC20厘米土壤温度20厘米土壤含水率40厘米土壤温度40厘米土壤含水率60厘米土壤温度60厘米土壤含水率电导率摄氏度（℃）无（%）表22DB12/T740.1—20174.1.3畜牧养殖环境信息数据元表3畜牧养殖环境信息常用数据元名称、单位和标识符要求名称单位标识符LTemp空气温度摄氏度（℃）空气相对湿度光照强度无（%）LHumidityLLightLAmmoniaLH2S勒克斯（lx）氨气浓度毫克每立方米（mg/m毫克每立方米（mg/m毫克每立方米（mg/m毫克每立方米（mg/m毫克每立方米（mg/m33333）））））硫化氢浓度二氧化碳浓度一氧化碳浓度PM10浓度LCO2LCOLPM104.2数据上传要求农业物联网平台提供WebService作为农业生产基地数据上传接口，传输报文使用可扩展标记语言（XML），具体接口定义、格式要求及示例参见附录A。5视频数据3DB12/T740.1—2017AA附录A（规范性附录）农业环境信息数据上传规范A.1上传接口说明接口地址A.1.1天津市农业物联网农业环境信息数据上传采用WebService接口，地址为/services/wlwupload?wsdl，提供registerview、getviews、uploadinfos三个方法供远程调用。A.1.2观测点注册观测点首次上传数据前应调用registerview进行观测点注册，反复注册无效。农业生产基地名称、观测点名称注册后不得修改。农业生产基地上传未注册观测点环境信息数据时，农业物联网平台默认丢弃处理。A.1.3数据上传农业生产基地观测点环境信息数据采集上传时间间隔建议为半小时。环境信息数据只需上传一次，反复上传无效。农业生产基地应避免反复上传重复信息，加重系统负担。调用接口传输时，传输报文使用XML，字符编码采用GB2312。报文字段中不得出现汉字、字母、数字、小数点以外字符。输入为农业生产基地名称、新观测点名称。报文起止标签为View，层级为一级。每条报文包含一条View记录。每条View记录中包含字段定义见表A.1。表A.1View记录标签及含义农业生产基地名称农业生产基地观测点名称4DB12/T740.1—2017表A.2注册观测点输入示例示例<?xmlversion="1.0"encoding="GB2312"?><View><CompanyName>天津生宝谷物基地</CompanyName><ViewName>新观测点</ViewName></View>A.2.1.3输出输出为成功注册的观测点信息。报文起止标签为Views，层级为一级。每条观测点记录标签为View，层级为二级。注册成功时，返回该观测点信息；注册失败时返回空记录。表A.3注册观测点输出示例注册成功示例<?xmlversion="1.0"encoding="GB2312"?><Views><View><CompanyName>天津生宝谷物基地</CompanyName><ViewName>新观测点</ViewName><?xmlversion="1.0"encoding="GB2312"?>获取观测点方法名为getviews，用于查询某农业生产基地在物联网平台中已注册的观测点名称列5DB12/T740.1—2017输入为农业生产基地名称。报文起止标签为Company，层级为一级。每条报文包含一条Company记录。输入农业生产基地名称标签为CompanyName，层级为二级。一条Company记录中包含一条CompanyName记录。表A.4获取观测点输入示例示例<?xmlversion="1.0"encoding="GB2312"?><Company><CompanyName>天津生宝谷物基地</CompanyName></Company>A.2.2.3输出输出为农业生产基地所有观测点记录。报文起止标签为Views，层级为一级。每条观测点记录标签为View，层级为二级。每条报文包含一组或多组View记录。每条View记录中包含字段定义见表A.1。表A.5获取观测点输出示例示例<?xmlversion="1.0"encoding="GB2312"?><Views>上传环境信息数据方法名为uploadinfos，用于将采集的环境信息上传到农业物联网平台。输入为采集的环境信息。报文起止标签为Infos，层级为一级。每条环境信息数据记录标签为Info，层级为二级。每条报文包含一条或多条Info记录，单次上传记录总数不超过1000条。Info标签及含义见表A.6，每组Info记录中应包含表A.6中所有字段。表A.6Info记录标签及含义6DB12/T740.1—2017标签名说明CompanyNameViewNameUpdateTimeDataTypeValue农业生产基地名称农业生产基地观测点名称接收数据时间，格式为“yyyy-MM-ddHH:mm:ss”的字符串接收数据类型，命名见4.1节接收数据数值，数值应换算到4.1节要求的单位，格式为保留两位小数的字符串Description其他需要说明的情况表A.7上传环境信息数据输入示例示例<?xmlversion="1.0"encoding="GB2312"?><Infos><Info><CompanyName>天津生宝谷物基地</CompanyName><ViewName>观测点1</ViewName><UpdateTime>2014-4-232:48:43</UpdateTime><DataType>fTemp</DataType><Value>10.00</Value><Description>无</Description></Info>输出为本次成功上传的数据记录。报文起止标签为Infos，层级为一级。每条环境信息数据记录标签为Info，层级为二级。每条报文包含一条或多条Info记录。Info记录分条入库，输出包含本次成功上传的记录。表A.8上传环境信息数据输出示例<?xmlversion="1.0"encoding="GB2312"?>7DB12/T740.1—2017<ViewName>观测点1</ViewName><UpdateTime>2014-4-232:48:43</UpdateTime><DataType>fTemp</DataType><Value>10.00</Value><Description>无</Description></Info><Info><CompanyName>天津生宝谷物基地</Comp