DB12-T740.1-2017-農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)技術(shù)規(guī)范-天津市

ICS65.020.99DB12B07天津市地方標(biāo)準(zhǔn)DB12/T740.1—2017農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)技術(shù)規(guī)范第1部分：數(shù)據(jù)上傳接口TechnicalspecificationfortheplatformofagriculturalInternetofthingsPart1:Datauploadinterface天津市市場(chǎng)和質(zhì)量監(jiān)督管理委員會(huì)發(fā)布DB12/T740.1—2017前言DB12/T740《農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)技術(shù)規(guī)范》分為以下幾個(gè)部分：——第1部分：數(shù)據(jù)上傳接口；——第2部分：應(yīng)用系統(tǒng)發(fā)布；??本部分為DB12/T740《農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)技術(shù)規(guī)范》的第1部分。本部分按照GB/T1.1-2009《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)的結(jié)構(gòu)和編寫(xiě)》給出的規(guī)則起草。本部分由天津市農(nóng)村工作委員會(huì)提出并歸口。本部分起草單位：天津市農(nóng)村工作委員會(huì)信息中心、中國(guó)科學(xué)院合肥物質(zhì)科學(xué)研究院。本部分主要起草人：唐樹(shù)山、孫丙宇、胡宜敏、李潔、史楊、張保巖、李小剛、路寧、康雙輝、楊勇、包蕊、于建美、韓躍。IDB12/T740.1—2017農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)技術(shù)規(guī)范第1部分：數(shù)據(jù)上傳接口1范圍本部分規(guī)定了農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)技術(shù)規(guī)范中數(shù)據(jù)上傳接口的數(shù)據(jù)上傳框架、農(nóng)業(yè)環(huán)境信息數(shù)據(jù)及要求、視頻數(shù)據(jù)。本部分適用于需要接入天津市農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)的農(nóng)業(yè)生產(chǎn)基地?cái)?shù)據(jù)的規(guī)范。2規(guī)范性引用文件下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB2312信息交換用漢字編碼字符集GB/T28281安全防范視頻監(jiān)控聯(lián)網(wǎng)系統(tǒng)信息傳輸、交換、控制技術(shù)要求民用閉路監(jiān)視電視系統(tǒng)工程技術(shù)規(guī)范GB501983數(shù)據(jù)上傳框架由農(nóng)業(yè)生產(chǎn)基地、農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)兩個(gè)部分組成（圖1）。農(nóng)業(yè)生產(chǎn)基地將采集的環(huán)圖11DB12/T740.1—20174農(nóng)業(yè)環(huán)境信息數(shù)據(jù)及要求數(shù)據(jù)標(biāo)識(shí)種植環(huán)境信息數(shù)據(jù)元表1種植環(huán)境信息常用數(shù)據(jù)元名稱、單位和標(biāo)識(shí)符要求名稱單位標(biāo)識(shí)符FALI太陽(yáng)輻射瓦每平方米（W/m瓦每平方米（W/m毫米（mm）攝氏度（℃）無(wú)（%）2））太陽(yáng)有效輻射降雨量2FEALIFAPT空氣溫度FTempFHumidityFAWS空氣相對(duì)濕度風(fēng)速米每秒（m/s）度（°）風(fēng)向FAWD二氧化碳濃度光照強(qiáng)度毫克每立方米（mg/m3）勒克斯（lx）攝氏度（℃）無(wú)（%）FCO2FLightFSTC20FSWC20FSTC40FSWC40FSTC60FSWC60FEC20厘米土壤溫度20厘米土壤含水率40厘米土壤溫度40厘米土壤含水率60厘米土壤溫度60厘米土壤含水率電導(dǎo)率攝氏度（℃）無(wú)（%）表22DB12/T740.1—20174.1.3畜牧養(yǎng)殖環(huán)境信息數(shù)據(jù)元表3畜牧養(yǎng)殖環(huán)境信息常用數(shù)據(jù)元名稱、單位和標(biāo)識(shí)符要求名稱單位標(biāo)識(shí)符LTemp空氣溫度攝氏度（℃）空氣相對(duì)濕度光照強(qiáng)度無(wú)（%）LHumidityLLightLAmmoniaLH2S勒克斯（lx）氨氣濃度毫克每立方米（mg/m毫克每立方米（mg/m毫克每立方米（mg/m毫克每立方米（mg/m毫克每立方米（mg/m33333）））））硫化氫濃度二氧化碳濃度一氧化碳濃度PM10濃度LCO2LCOLPM104.2數(shù)據(jù)上傳要求農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)提供WebService作為農(nóng)業(yè)生產(chǎn)基地?cái)?shù)據(jù)上傳接口，傳輸報(bào)文使用可擴(kuò)展標(biāo)記語(yǔ)言（XML），具體接口定義、格式要求及示例參見(jiàn)附錄A。5視頻數(shù)據(jù)3DB12/T740.1—2017AA附錄A（規(guī)范性附錄）農(nóng)業(yè)環(huán)境信息數(shù)據(jù)上傳規(guī)范A.1上傳接口說(shuō)明接口地址A.1.1天津市農(nóng)業(yè)物聯(lián)網(wǎng)農(nóng)業(yè)環(huán)境信息數(shù)據(jù)上傳采用WebService接口，地址為/services/wlwupload?wsdl，提供registerview、getviews、uploadinfos三個(gè)方法供遠(yuǎn)程調(diào)用。A.1.2觀測(cè)點(diǎn)注冊(cè)觀測(cè)點(diǎn)首次上傳數(shù)據(jù)前應(yīng)調(diào)用registerview進(jìn)行觀測(cè)點(diǎn)注冊(cè)，反復(fù)注冊(cè)無(wú)效。農(nóng)業(yè)生產(chǎn)基地名稱、觀測(cè)點(diǎn)名稱注冊(cè)后不得修改。農(nóng)業(yè)生產(chǎn)基地上傳未注冊(cè)觀測(cè)點(diǎn)環(huán)境信息數(shù)據(jù)時(shí)，農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)默認(rèn)丟棄處理。A.1.3數(shù)據(jù)上傳農(nóng)業(yè)生產(chǎn)基地觀測(cè)點(diǎn)環(huán)境信息數(shù)據(jù)采集上傳時(shí)間間隔建議為半小時(shí)。環(huán)境信息數(shù)據(jù)只需上傳一次，反復(fù)上傳無(wú)效。農(nóng)業(yè)生產(chǎn)基地應(yīng)避免反復(fù)上傳重復(fù)信息，加重系統(tǒng)負(fù)擔(dān)。調(diào)用接口傳輸時(shí)，傳輸報(bào)文使用XML，字符編碼采用GB2312。報(bào)文字段中不得出現(xiàn)漢字、字母、數(shù)字、小數(shù)點(diǎn)以外字符。輸入為農(nóng)業(yè)生產(chǎn)基地名稱、新觀測(cè)點(diǎn)名稱。報(bào)文起止標(biāo)簽為View，層級(jí)為一級(jí)。每條報(bào)文包含一條View記錄。每條View記錄中包含字段定義見(jiàn)表A.1。表A.1View記錄標(biāo)簽及含義農(nóng)業(yè)生產(chǎn)基地名稱農(nóng)業(yè)生產(chǎn)基地觀測(cè)點(diǎn)名稱4DB12/T740.1—2017表A.2注冊(cè)觀測(cè)點(diǎn)輸入示例示例<?xmlversion="1.0"encoding="GB2312"?><View><CompanyName>天津生寶谷物基地</CompanyName><ViewName>新觀測(cè)點(diǎn)</ViewName></View>A.2.1.3輸出輸出為成功注冊(cè)的觀測(cè)點(diǎn)信息。報(bào)文起止標(biāo)簽為Views，層級(jí)為一級(jí)。每條觀測(cè)點(diǎn)記錄標(biāo)簽為View，層級(jí)為二級(jí)。注冊(cè)成功時(shí)，返回該觀測(cè)點(diǎn)信息；注冊(cè)失敗時(shí)返回空記錄。表A.3注冊(cè)觀測(cè)點(diǎn)輸出示例注冊(cè)成功示例<?xmlversion="1.0"encoding="GB2312"?><Views><View><CompanyName>天津生寶谷物基地</CompanyName><ViewName>新觀測(cè)點(diǎn)</ViewName><?xmlversion="1.0"encoding="GB2312"?>獲取觀測(cè)點(diǎn)方法名為getviews，用于查詢某農(nóng)業(yè)生產(chǎn)基地在物聯(lián)網(wǎng)平臺(tái)中已注冊(cè)的觀測(cè)點(diǎn)名稱列5DB12/T740.1—2017輸入為農(nóng)業(yè)生產(chǎn)基地名稱。報(bào)文起止標(biāo)簽為Company，層級(jí)為一級(jí)。每條報(bào)文包含一條Company記錄。輸入農(nóng)業(yè)生產(chǎn)基地名稱標(biāo)簽為CompanyName，層級(jí)為二級(jí)。一條Company記錄中包含一條CompanyName記錄。表A.4獲取觀測(cè)點(diǎn)輸入示例示例<?xmlversion="1.0"encoding="GB2312"?><Company><CompanyName>天津生寶谷物基地</CompanyName></Company>A.2.2.3輸出輸出為農(nóng)業(yè)生產(chǎn)基地所有觀測(cè)點(diǎn)記錄。報(bào)文起止標(biāo)簽為Views，層級(jí)為一級(jí)。每條觀測(cè)點(diǎn)記錄標(biāo)簽為View，層級(jí)為二級(jí)。每條報(bào)文包含一組或多組View記錄。每條View記錄中包含字段定義見(jiàn)表A.1。表A.5獲取觀測(cè)點(diǎn)輸出示例示例<?xmlversion="1.0"encoding="GB2312"?><Views>上傳環(huán)境信息數(shù)據(jù)方法名為uploadinfos，用于將采集的環(huán)境信息上傳到農(nóng)業(yè)物聯(lián)網(wǎng)平臺(tái)。輸入為采集的環(huán)境信息。報(bào)文起止標(biāo)簽為Infos，層級(jí)為一級(jí)。每條環(huán)境信息數(shù)據(jù)記錄標(biāo)簽為Info，層級(jí)為二級(jí)。每條報(bào)文包含一條或多條Info記錄，單次上傳記錄總數(shù)不超過(guò)1000條。Info標(biāo)簽及含義見(jiàn)表A.6，每組Info記錄中應(yīng)包含表A.6中所有字段。表A.6Info記錄標(biāo)簽及含義6DB12/T740.1—2017標(biāo)簽名說(shuō)明CompanyNameViewNameUpdateTimeDataTypeValue農(nóng)業(yè)生產(chǎn)基地名稱農(nóng)業(yè)生產(chǎn)基地觀測(cè)點(diǎn)名稱接收數(shù)據(jù)時(shí)間，格式為“yyyy-MM-ddHH:mm:ss”的字符串接收數(shù)據(jù)類型，命名見(jiàn)4.1節(jié)接收數(shù)據(jù)數(shù)值，數(shù)值應(yīng)換算到4.1節(jié)要求的單位，格式為保留兩位小數(shù)的字符串Description其他需要說(shuō)明的情況表A.7上傳環(huán)境信息數(shù)據(jù)輸入示例示例<?xmlversion="1.0"encoding="GB2312"?><Infos><Info><CompanyName>天津生寶谷物基地</CompanyName><ViewName>觀測(cè)點(diǎn)1</ViewName><UpdateTime>2014-4-232:48:43</UpdateTime><DataType>fTemp</DataType><Value>10.00</Value><Description>無(wú)</Description></Info>輸出為本次成功上傳的數(shù)據(jù)記錄。報(bào)文起止標(biāo)簽為Infos，層級(jí)為一級(jí)。每條環(huán)境信息數(shù)據(jù)記錄標(biāo)簽為Info，層級(jí)為二級(jí)。每條報(bào)文包含一條或多條Info記錄。Info記錄分條入庫(kù)，輸出包含本次成功上傳的記錄。表A.8上傳環(huán)境信息數(shù)據(jù)輸出示例<?xmlversion="1.0"encoding="GB2312"?>7DB12/T740.1—2017<ViewName>觀測(cè)點(diǎn)1</ViewName><UpdateTime>2014-4-232:48:43</UpdateTime><DataType>fTemp</DataType><Value>10.00</Value><Description>無(wú)</Description></Info><Info><CompanyName>天津生寶谷物基地</Comp