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