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

65.020.99B

07DB12 12/T

—2017农业物联网平台技术规范第

1

部分：数据上传接口Technical

specification

the

platform

of

agricultural

of

thingsPart

1:

interface 天津市市场和质量监督管理委员会 发

布DB12/T

740.1—2017 DB12/T

740《农业物联网平台技术规范》分为以下几个部分：——第

1

部分：数据上传接口；——第

2

部分：应用系统发布；„„本部分为DB12/T

740《农业物联网平台技术规范》的第1部分。本部分按照GB/T

1.1-2009《标准化工作导则

第1部分：标准的结构和编写》给出的规则起草。本部分由天津市农村工作委员会提出并归口。本部分起草单位：天津市农村工作委员会信息中心、中国科学院合肥物质科学研究院。勇、包蕊、于建美、韩跃。DB12/T

740.1—2017

1范围本部分规定了农业物联网平台技术规范中数据上传接口的数据上传框架、农业环境信息数据及要求、视频数据。本部分适用于需要接入天津市农业物联网平台的农业生产基地数据的规范。2规范性引用文件件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB

2312 信息交换用汉字编码字符集GB/T

28281 安全防范视频监控联网系统信息传输、交换、控制技术要求GB

50198 民用闭路监视电视系统工程技术规范3 数据上传框架数据上传框架由农业生产基地、农业物联网平台两个部分组成（图1）。农业生产基地将采集的环境信息数据或视频数据，通过网络传输上传到农业物联网平台。

图1

数据上传框架2W/m

FALI2W/m

FEALImmFAPTFTempFHumiditym/sFAWSFAWDmg/m3FCO2lxFLight20

FSTC2020

FSWC2040

FSTC4040

FSWC4060

FSTC6060

FSWC60mS/cmFECpHFPHFDewpHAPHmg/lADOADOLATmS/cmACASalinityNTUATurbiditymg/lAAmmoniaDB12/T

740.1—20174 农业环境信息数据及要求4.1 数据标识4.1.1种植环境信息数据元表1种植环境信息常用数据元名称、单位和标识符要求表1种植环境信息常用数据元名称、单位和标识符要求表2水产养殖环境信息常用数据元名称、单位和标识符要求LTempLHumiditylxLLight3mg/m

LAmmonia3mg/m

LH2S3mg/m

LCO23mg/m

LCOPM10

3mg/m

LPM10DB12/T

740.1—20174.1.3 畜牧养殖环境信息数据元表3 畜牧养殖环境信息常用数据元名称、单位和标识符要求4.2 数据上传要求农业物联网平台提供WebService作为农业生产基地数据上传接口，传输报文使用可扩展标记语言（XML），具体接口定义、格式要求及示例参见附录A。5 视频数据5.1 摄像头安装农业生产基地采用摄像头的选型及安装应符合GB/T

28281及GB

501985.2 视频质量农业生产基地采集视频的分辨率应不低于640×480，帧数应大于每秒15帧。5.3 文字标注农业生产基地上传视频应包含基地名称、采集点名称、采集时间的文字标注。CompanyNameViewNameDB12/T

740.1—2017AA附

录 A（规范性附录）农业环境信息数据上传规范A.1 上传接口说明A.1.1 接口地址天津市农业物联网农业环境信息数据上传采用WebService接口，地址为/services/wlwupload?wsdl，提供registerview、getviews、三个方法供远程调用。A.1.2 观测点注册观测点首次上传数据前应调用registerview进行观测点注册，反复注册无效。农业生产基地名称、弃处理。A.1.3 数据上传农业生产基地观测点环境信息数据采集上传时间间隔建议为半小时。环境信息数据只需上传一次，反复上传无效。农业生产基地应避免反复上传重复信息，加重系统负担。A.1.4 格式XMLGB

2312字、小数点以外字符。A.2方法明细及输入输出示例A.2.1 注册观测点A.2.1.1 方法名注册观测点方法名为registerview，用于新观测点注册。A.2.1.2 输入ViewView记录。每条View记录中包含字段定义见表A.1。表A.1表A.1 View

记录标签及含义DB12/T

740.1—2017表A.2 注册观测点输入示例<?xml

?><View><CompanyName><ViewName></View>A.2.1.3 输出ViewsView，层级为二级。注册成功时，返回该观测点信息；注册失败时返回空记录。表A.3注册观测点输出示例<?xml

?><Views><View><CompanyName><ViewName><Status></View></Views><?xml

?><Views><View><CompanyName><ViewName><Status></Status></View></Views>A.2.2获取观测点A.2.2.1方法名获取观测点方法名为getviews，用于查询某农业生产基地在物联网平台中已注册的观测点名称列表。A.2.2.2 输入DB12/T

740.1—2017Company记录。输入农业生产基地名称标签为CompanyName，层级为二级。一条Company记录中包含一条CompanyName记录。表A.4 获取观测点输入示例<?xml

encoding="GB2312"

?><Company><CompanyName></CompanyName></Company>A.2.2.3 输出输出为农业生产基地所有观测点记录。报文起止标签为Views，层级为一级。每条观测点记录标签为View，层级为二级。每条报文包含一组或多组记录。每条View记录中包含字段定义见表A.1。表A.5 获取观测点输出示例<?xml

encoding="GB2312"

?><Views><View><CompanyName><ViewName>

1</ViewName></View><View><CompanyName><ViewName>

2</ViewName></View></Views>A.2.3上传环境信息数据A.2.3.1 方法名上传环境信息数据方法名为uploadinfos，用于将采集的环境信息上传到农业物联网平台。A.2.3.2 输入InfosInfo，Info1000条。Info标签及含义见表A.6，每组Info记录中应包含表A.6中所有字段。表A.6 Info

记录标签及含义CompanyNameViewNameUpdateTimeyyyy-MM-dd

DataType

Value

DescriptionDB12/T

740.1—2017表A.7 上传环境信息数据输入示例<?xml

encoding="GB2312"

?><Infos><Info><CompanyName></CompanyName><ViewName><UpdateTime>2014-4-23

<DataType>fTemp</DataType><Value>10.00</Value><Description></Description></Info><Info><CompanyName><ViewName><UpdateTime>2014-4-23

<DataType>fHumidity</DataType><Value>50.00</Value><Description></Info></Infos>A.2.3.3 输出输出为本次成功上传的数据记录。报文起止标签为Infos，层级为一级。每条环境信息数据记录标签为InfoInfo记录。Info传的记录。表A.8 上传环境信息数据输出示例<?xml

?><Infos><Info><CompanyName></CompanyName>DB12/T

740.1—2017<ViewName><UpdateTime>2014-4-23

<DataType>fTemp</DataType><Value>10.00</Value><Description