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

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