DB12-T740-1-2017農(nóng)業(yè)物聯(lián)網(wǎng)平臺技術(shù)規(guī)范第1部分：數(shù)據(jù)上傳接口

1、ICS 65. 020. 99B 07DB12天 津 市 地 方 標(biāo) 準(zhǔn)DB12/T 740. 12017農(nóng)業(yè)物聯(lián)網(wǎng)平臺技術(shù)規(guī)范第1部分：數(shù)據(jù)上傳接口Technical specification for the platform of agricultural Internet of thingsPart 1: Data upload interface2017-12-01 實施2017- 10- 27 發(fā)布天津市市場和質(zhì)量監(jiān)督管理委員會 發(fā)布DB12/T 740. 12017 IDB12/T 740農(nóng)業(yè)物聯(lián)網(wǎng)平臺技術(shù)規(guī)范分為以下幾個部分:第1部分：數(shù)據(jù)上傳接口；第2部分：應(yīng)用系統(tǒng)發(fā)布；本部

2、分為DB12/T 740農(nóng)業(yè)物聯(lián)網(wǎng)平臺技術(shù)規(guī)范的第1部分。本部分按照GB/T 1. 1-2009標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)的結(jié)構(gòu)和編寫給出的規(guī)則起草。 本部分由天津市農(nóng)村工作委員會提出并歸口。本部分起草單位：天津市農(nóng)村工作委員會信息中心、中國科學(xué)院合肥物質(zhì)科學(xué)研究院。本部分主要起草人：唐樹山、孫丙宇、胡宜敏、李潔、史楊、張保巖、李小剛、路寧、康雙輝、楊 勇、包蕊、于建美、韓躍。DB12/T 740. 12017 農(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è)物

3、聯(lián)網(wǎng)平臺的農(nóng)業(yè)生產(chǎn)基地數(shù)據(jù)的規(guī)范。2規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB 2312信息交換用漢字編碼字符集GB/T 28281安全防范視頻監(jiān)控聯(lián)網(wǎng)系統(tǒng)信息傳輸、交換、控制技術(shù)要求GB 50198民用閉路監(jiān)視電視系統(tǒng)工程技術(shù)規(guī)范3數(shù)據(jù)上傳框架數(shù)據(jù)上傳框架由農(nóng)業(yè)生產(chǎn)基地、農(nóng)業(yè)物聯(lián)網(wǎng)平臺兩個部分組成（圖1） O農(nóng)業(yè)生產(chǎn)基地將采集的環(huán) 境信息數(shù)據(jù)或視頻數(shù)據(jù)，通過網(wǎng)絡(luò)傳輸上傳到農(nóng)業(yè)物聯(lián)網(wǎng)平臺。農(nóng)業(yè)生產(chǎn)基地農(nóng)業(yè)物聯(lián)網(wǎng)平臺圖1數(shù)據(jù)上傳框架4農(nóng)業(yè)環(huán)境信息數(shù)據(jù)及要求 4.

4、1數(shù)據(jù)標(biāo)識4. 1. 1種植環(huán)境信息數(shù)據(jù)元表1種植環(huán)境信息常用數(shù)據(jù)元名稱、單位和標(biāo)識符要求名稱單位標(biāo)識符太陽輻射瓦每平方米（w/k）FALI太陽有效輻射瓦每平方米（w/k）FEALI降雨量毫米（111111）FAPT空氣溫度攝氏度（C）FTemp空氣相對濕度無(%)FHumidity風(fēng)速米每秒（m/s）FAWS風(fēng)向度（ ）FAWD二氧化碳濃度毫克每立方米（mg/m3）FCO2光照強度勒克斯（lx）FLight20厘米土壤溫度攝氏度（C）FSTC2020厘米土壤含水率無(%)FSWC2040厘米土壤溫度攝氏度（C）FSTC4040厘米土壤含水率無(%)FSWC4060厘米土壤溫度攝氏度（C）FS

5、TC6060厘米土壤含水率無(%)FSWC60電導(dǎo)率毫西每厘米（iiiS/cm）FECpH無FPH露點攝氏度（C）FDew4. 1.2水產(chǎn)養(yǎng)殖環(huán)境信息數(shù)據(jù)元表2水產(chǎn)養(yǎng)殖環(huán)境信息常用數(shù)據(jù)元名稱、單位和標(biāo)識符要求名稱單位標(biāo)識符pH無APH溶解氧毫克每升（mg/1）ADO溶解氧飽和度無(%)ADOL水溫攝氏度（C）AT電導(dǎo)率毫西每厘米（iiiS/cm）AC鹽度無(%)ASalinity濁度散射濁度單位（NTU）ATurbidity氨氮毫克每升（mg/1）AAmmoniaDB12/T 740. 12017 4.1.3畜牧養(yǎng)殖環(huán)境信息數(shù)據(jù)元表3畜牧養(yǎng)殖環(huán)境信息常用數(shù)據(jù)元名稱、單位和標(biāo)識符要求名稱單位標(biāo)識

6、符空氣溫度攝氏度(C)LTemp空氣相對濕度無(%)LHumidity光照強度勒克斯(1X)LLight氨氣濃度毫克每立方米(mg/m3)LAmmonia硫化氫濃度毫克每立方米(mg/m3)LH2S二氧化碳濃度毫克每立方米(mg/m3)LC02一氧化碳濃度毫克每立方米(mg/m3)LCOPM10濃度毫克每立方米(mg/m3)LPM104.2數(shù)據(jù)上傳要求農(nóng)業(yè)物聯(lián)網(wǎng)平臺提供WebService作為農(nóng)業(yè)生產(chǎn)基地數(shù)據(jù)上傳接口，傳輸報文使用可擴展標(biāo)記語言 (XML),具體接口定義、格式要求及示例參見附錄A。5視頻數(shù)據(jù)5. 1攝像頭安裝農(nóng)業(yè)生產(chǎn)基地采用攝像頭的選型及安裝應(yīng)符合GB/T 28281及GB 5

7、0198中的要求。5. 2視頻質(zhì)量農(nóng)業(yè)生產(chǎn)基地采集視頻的分辨率應(yīng)不低于640X480,幀數(shù)應(yīng)大于每秒15幀。5. 3文字標(biāo)注農(nóng)業(yè)生產(chǎn)基地上傳視頻應(yīng)包含基地名稱、采集點名稱、采集時間的文字標(biāo)注。附錄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ù)上傳采用恥bServiee接口，地址為 HYPERLINK http:www. t.jnywlw. cn /serviees/wlwuijloadfwsdl,提供建 gistervi倉 w、g 在 tviews、up load infos 三個方法供遠(yuǎn)程調(diào)用。A. 1.2觀測點注冊觀測點首次

8、上傳數(shù)據(jù)前應(yīng)調(diào)用registerview進行觀測點注冊，反復(fù)注冊無效。農(nóng)業(yè)生產(chǎn)基地名稱、 觀測點名稱注冊后不得修改。農(nóng)業(yè)生產(chǎn)基地上傳未注冊觀測點環(huán)境信息數(shù)據(jù)時，農(nóng)業(yè)物聯(lián)網(wǎng)平臺默認(rèn)丟 棄處理。A. 1.3數(shù)據(jù)上傳農(nóng)業(yè)生產(chǎn)基地觀測點環(huán)境信息數(shù)據(jù)采集上傳時間間隔建議為半小時。環(huán)境信息數(shù)據(jù)只需上傳一次， 反復(fù)上傳無效。農(nóng)業(yè)生產(chǎn)基地應(yīng)避免反復(fù)上傳重復(fù)信息，加重系統(tǒng)負(fù)擔(dān)。A. 1.4格式調(diào)用接口傳輸時，傳輸報文使用XML,字符編碼采用GB2312報文字段中不得出現(xiàn)漢字、字母、數(shù) 字、小數(shù)點以外字符。A.2方法明細(xì)及輸入輸出示例A. 2. 1注冊觀測點A. 2. 1.1 方法名注冊觀測點方法名為regist

9、erview,用于新觀測點注冊。A. 2. 1.2 輸入輸入為農(nóng)業(yè)生產(chǎn)基地名稱、新觀測點名稱。報文起止標(biāo)簽為View,層級為一級。每條報文包含一條 View記錄。每條View記錄中包含字段定義見表A. 1。表A. 1 View記錄標(biāo)簽及含義標(biāo)簽名說明CompanyName農(nóng)業(yè)生產(chǎn)基地名稱ViewName農(nóng)業(yè)生產(chǎn)基地觀測點名稱表A. 2注冊觀測點輸入示例示例 天津生寶谷物基地 新觀測點 A. 2. 1.3 輸出輸出為成功注冊的觀測點信息。報文起止標(biāo)簽為Views,層級為一級。每條觀測點記錄標(biāo)簽為View, 層級為二級。注冊成功時，返回該觀測點信息；注冊失敗時返回空記錄。表A.3注冊觀測點輸出示例

10、注冊成功示例 天津生寶谷物基地 新觀測點 注冊成功 注冊失敗示例 天津生寶谷物基地 新觀測點 注冊失敗，新觀測點名稱重復(fù)/StatusA. 2. 2獲取觀測點A. 2. 2. 1 方法名獲取觀測點方法名為getviews,用于查詢某農(nóng)業(yè)生產(chǎn)基地在物聯(lián)網(wǎng)平臺中已注冊的觀測點名稱列 表。A. 2. 2. 2 輸入輸入為農(nóng)業(yè)生產(chǎn)基地名稱。報文起止標(biāo)簽為Company,層級為一級。每條報文包含一條Company記錄。 輸入農(nóng)業(yè)生產(chǎn)基地名稱標(biāo)簽為CompanyName,層級為二級。一條Company記錄中包含一條CompanyName記 錄。表A.4獲取觀測點輸入示例示例 天津生寶谷物基地 A. 2.

11、2. 3 輸出輸出為農(nóng)業(yè)生產(chǎn)基地所有觀測點記錄。報文起止標(biāo)簽為Views,層級為一級。每條觀測點記錄標(biāo)簽 為View,層級為二級。每條報文包含一組或多組View記錄。每條View記錄中包含字段定義見表A. 1。表A.5獲取觀測點輸出示例示例 天津生寶谷物基地 觀測點 K/ViewName 天津生寶谷物基地 觀測點 2 A. 2. 3上傳環(huán)境信息數(shù)據(jù)A. 2. 3. 1 方法名上傳環(huán)境信息數(shù)據(jù)方法名為uploadinfos,用于將采集的環(huán)境信息上傳到農(nóng)業(yè)物聯(lián)網(wǎng)平臺。A. 2. 3. 2 輸入輸入為采集的環(huán)境信息。報文起止標(biāo)簽為Infos,層級為一級。每條環(huán)境信息數(shù)據(jù)記錄標(biāo)簽為Info, 層級為二

12、級。每條報文包含一條或多條Info記錄，單次上傳記錄總數(shù)不超過1000條。Info標(biāo)簽及含義見 表A. 6,每組Info記錄中應(yīng)包含表A. 6中所有字段。表A. 6I nfo記錄標(biāo)簽及含義DB12/T 740. 12017 標(biāo)簽名說明CompanyName農(nóng)業(yè)生產(chǎn)基地名稱ViewName農(nóng)業(yè)生產(chǎn)基地觀測點名稱UpdateTime接收數(shù)據(jù)時間，格式為“yyyy-MM-dd的字符串DataType接收數(shù)據(jù)類型，命名見4.1節(jié)Value接收數(shù)據(jù)數(shù)值，數(shù)值應(yīng)換算到4.1節(jié)要求的單位，格式為保留兩位小數(shù)的字符串Description其他需要說明的情況表A. 7上傳環(huán)境信息數(shù)據(jù)輸入示例示例 天津生寶谷物基地 觀測點 K/ViewName2014-4-23 2:48:43 fTemp10. 00c 天津生寶谷物基地 觀測點 K/ViewName2014-4-23 2:48:43 fHumidity50. 00 c A. 2. 3. 3 輸出輸出為本次成功上傳的數(shù)據(jù)記錄。報文起止標(biāo)簽為Infos,層級為一級。每條環(huán)境