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

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