DB12/T 740.1-2017 農(nóng)業(yè)物聯(lián)網(wǎng)平臺技術(shù)規(guī)范 第1部分：數(shù)據(jù)上傳接口.pdf
<p>ICS 65.020.99 B 07 DB12 天津市 地 方 標(biāo) 準(zhǔn) DB12/T 740.1 2017 農(nóng)業(yè)物聯(lián)網(wǎng)平臺 技術(shù)規(guī)范 第 1 部分 ： 數(shù)據(jù) 上傳 接口 Technical specification for the platform of agricultural Internet of things Part 1: Data upload interface 2017 - 10 - 27 發(fā)布 2017 - 12 - 01 實施 天津 市市場和質(zhì)量監(jiān)督管理委員會 發(fā)布 DB12/T 740.1 2017 I 前 言 DB12/T 740 農(nóng)業(yè)物聯(lián)網(wǎng)平臺 技術(shù)規(guī)范 分為以下幾個部分： 第 1 部分：數(shù)據(jù)上傳接口； 第 2 部分：應(yīng)用系統(tǒng)發(fā)布； 本部分為 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.1 2017 1 農(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)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。 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）。 農(nóng)業(yè)生產(chǎn) 基地 將 采集 的 環(huán)境信息 數(shù)據(jù) 或視頻數(shù)據(jù) ，通過網(wǎng)絡(luò)傳輸 上傳 到農(nóng)業(yè)物聯(lián)網(wǎng) 平臺 。 農(nóng) 業(yè) 物 聯(lián) 網(wǎng) 平 臺農(nóng) 業(yè) 生 產(chǎn) 基 地應(yīng) 用 系 統(tǒng)數(shù) 據(jù) 庫W e b s e r v i c e環(huán) 境 數(shù) 據(jù) 視 頻 數(shù) 據(jù)圖 1 數(shù)據(jù) 上傳 框架 DB12/T 740.1 2017 2 4 農(nóng)業(yè) 環(huán)境信息數(shù)據(jù) 及 要求 4.1 數(shù)據(jù) 標(biāo)識 4.1.1 種植 環(huán)境信息 數(shù)據(jù)元 表 1 種植 環(huán)境信息 常用 數(shù)據(jù)元名 稱 、單位和標(biāo)識符要求 名稱 單位 標(biāo)識 符 太陽輻射 瓦每平方米（ W/m2） FALI 太陽有效輻射 瓦每平方米（ W/m2） FEALI 降雨量 毫米（ mm） FAPT 空氣溫度 攝氏度（） FTemp 空氣相對濕度 無（ %） FHumidity 風(fēng)速 米每秒（ m/s） FAWS 風(fēng)向 度（°） FAWD 二氧化碳濃度 毫克每立方米（ mg/m3） FCO2 光照強(qiáng)度 勒克斯（ lx） FLight 20 厘米土壤溫度 攝氏度（） FSTC20 20 厘米土壤含水率 無（ %） FSWC20 40 厘米土壤溫度 攝氏度（） FSTC40 40 厘米土壤含水率 無（ %） FSWC40 60 厘米土壤溫度 攝氏 度（） FSTC60 60 厘米土壤含水率 無（ %） FSWC60 電導(dǎo)率 毫西每厘米（ mS/cm） FEC pH 無 FPH 露點 攝氏度（） FDew 4.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/l） ADO 溶解氧飽和度 無（ %） ADOL 水溫 攝氏度（） AT 電導(dǎo)率 毫西每厘米（ mS/cm） AC 鹽度 無（ %） ASalinity 濁度 散射濁度單位（ NTU） ATurbidity 氨氮 毫克每升（ mg/l） AAmmonia DB12/T 740.1 2017 3 4.1.3 畜牧養(yǎng)殖 環(huán)境信息數(shù)據(jù)元 表 3 畜牧養(yǎng)殖環(huán)境 信息常用數(shù)據(jù)元名稱、單位和標(biāo)識符要求 名稱 單位 標(biāo)識符 空氣溫度 攝氏度（） LTemp 空氣相對濕度 無（ %） LHumidity 光照強(qiáng)度 勒克斯（ lx） LLight 氨氣濃度 毫克每立方米（ mg/m3） LAmmonia 硫化氫濃度 毫克每立方米（ mg/m3） LH2S 二氧化碳濃度 毫克每立方米（ mg/m3） LCO2 一氧化碳濃度 毫克每立方米（ mg/m3） LCO PM10 濃度 毫克每立方米（ mg/m3） LPM10 4.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ù) 5.1 攝像頭安裝 農(nóng)業(yè)生產(chǎn)基地采用 攝像頭 的選型及安裝 應(yīng) 符合 GB/T 28281及 GB 50198中的要求。 5.2 視頻 質(zhì)量 農(nóng)業(yè)生產(chǎn)基地采集視頻的分辨率應(yīng)不低于 640× 480，幀數(shù)應(yīng)大于每秒 15幀 。 5.3 文字標(biāo)注 農(nóng)業(yè)生產(chǎn)基地上傳視頻應(yīng)包含基地名稱、采集點名稱、采集時間的 文字標(biāo)注 。 DB12/T 740.1 2017 4 A A 附 錄 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接口 ， 地址為 http:/www.tjnywlw.cn /services/wlwupload?wsdl，提供 registerview、 getviews、 uploadinfos三個方法供 遠(yuǎn)程 調(diào)用。 A.1.2 觀測點注冊 觀測點首次上傳數(shù)據(jù)前應(yīng)調(diào)用 registerview進(jìn)行 觀測點 注冊，反復(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，字符編碼采用 GB 2312。 報文字段中不得出現(xiàn)漢字、字母、數(shù)字、小數(shù)點以外字符。 A.2 方法 明細(xì) 及 輸入輸出 示例 A.2.1 注冊觀測點 A.2.1.1 方法名 注冊觀測點方法名為 registerview，用于新觀測點 注冊。 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)基地觀測點名稱 DB12/T 740.1 2017 5 表 A.2 注冊觀測點輸入示例 示例 天津生寶谷物基地 新觀測點 A.2.1.3 輸出 輸出為成功注冊的觀測點信息。報文起止標(biāo)簽為 Views，層級為一級。每條觀測點記錄標(biāo)簽為 View，層級為二級。注冊成功時，返回該觀測點信息；注冊失敗時返回空記錄。 表 A.3 注冊觀測點輸出示例 注冊成功示例 天津生寶谷物基地 新觀測點 注冊成功 注冊失敗示例 天津生寶谷物基地 新觀測點 注冊失敗，新觀測點名稱重復(fù) A.2.2 獲取觀測點 A.2.2.1 方法名 獲取觀測點方法名為 getviews，用于查詢某農(nóng)業(yè)生產(chǎn)基地 在物聯(lián)網(wǎng)平臺中已注冊的觀測點名稱列表。 A.2.2.2 輸入 DB12/T 740.1 2017 6 輸入為農(nóng)業(yè)生產(chǎn)基地 名稱。 報文起止標(biāo)簽 為 Company，層級為一級。每條報文 包含一 條 Company記錄。輸入 農(nóng)業(yè)生產(chǎn)基地名稱 標(biāo)簽為 CompanyName，層級為二級。一條 Company記錄中包含一條 CompanyName記錄。 表 A.4 獲取觀測點輸入示例 示例 天津生寶谷物基地 A.2.2.3 輸出 輸出為 農(nóng)業(yè)生產(chǎn)基地 所有 觀測點 記錄。 報文起止標(biāo)簽 為 Views，層級為一級。每條 觀測點 記錄標(biāo)簽為 View，層級為二級。 每條報文 包含 一組或 多 組 View記錄。 每條 View記錄中 包含 字段定義見表 A.1。 表 A.5 獲取觀測點輸出示例 示例 天津生寶谷物基地 觀測點 1 天津 生寶谷物基地 觀測點 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，層級為二級。 每條報文包含一條 或多條 Info記錄 ， 單次上傳 記錄總數(shù)不 超過 1000條 。 Info標(biāo)簽及含義見表 A.6， 每組 Info記錄中應(yīng)包含 表 A.6中所有字段。 表 A.6 Info 記錄標(biāo)簽及含義 DB12/T 740.1 2017 7 標(biāo)簽名 說明 CompanyName 農(nóng)業(yè)生產(chǎn)基地 名稱 ViewName 農(nóng)業(yè)生產(chǎn)基地 觀測點名稱 UpdateTime 接收 數(shù)據(jù)時間 ， 格式 為 “ yyyy-MM-dd HH:mm:ss” 的 字符串 DataType 接收 數(shù)據(jù)類型 ，命名見 4.1 節(jié) Value 接收數(shù)據(jù) 數(shù)值，數(shù)值應(yīng)換算到 4.1 節(jié)要求的單位 ， 格式為 保留兩位小數(shù) 的字符串 Description 其他需要說明的情況 表 A.7 上傳環(huán)境信息數(shù)據(jù)輸入示例 示例 天津生寶谷物基地 觀測點 1 2014-4-23 2:48:43 fTemp 10.00 無 天津生寶谷物基地 觀測點 1 2014-4-23 2:48:43 fHumidity 50.00 無 A.2.3.3 輸出 輸出為 本次成功上傳的數(shù)據(jù)記錄 。 報文起止標(biāo)簽為 Infos，層級為一級。 每條環(huán)境信息數(shù)據(jù)記錄標(biāo)簽為 Info，層級為二級。每條報文包含一條或多條 Info記錄。 Info記錄分條入庫 ， 輸出包含本次 成功 上傳 的 記錄。 表 A.8 上傳環(huán)境信息數(shù)據(jù)輸 出 示例 示例 天津生寶谷物基地 DB12/T 740.1 2017 8 觀測點 1 2014-4-23 2:48:43 fTemp 10.00 無 天津生寶谷物基地 觀測點 1 2014-4-23 2:48:43 fHumidity 50.00 無 _</p>
個人主頁