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

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