1、 ICS备案号：中华人民共和国粮食行业标准LSLS 多模式储粮害虫及防治信息交互接口Multi-Mode Interface on Information and Control of Stored-Grain Insects（讨论稿）国 家 粮 食 局 发 布-发布 -实施LS II目 次前 言.III多模式储粮害虫及防治信息交互接口.41. 范围.42. 规范性引用文件.43. 术语和定义.44. 接口规则.55. 接口组成与功能.8附 录 A （资料性附录）示范库虫情监控接口说明、结构定义 .40附 录 B （资料性附录）虫调数据接口说明、结构定义 .40B.1 Farmer .40B.
2、2 Pageable.41B.3 FactoryInfo .41B.4 InsectsOnfactory .42B.5 InsectOnfield.44C（资料性附录）接口调用示例 .46LS III前 言本标准的附录 A 和附录 B 为资料性性附录。本标准由国家粮食局提出并归口。本标准负责起草单位:北京邮电大学、国家粮食局科学研究院。本标准主要起草人: LS 4多模式储粮害虫及防治信息交互接口1. 范围本接口包括储粮害虫的多角度基本信息及防治信息的上报下发的内容和技术规范。本接口适用于具备储粮温度、湿度和气体浓度等粮情检测及储粮害虫监测功能的储备粮库的散装平房仓、浅圆仓和立筒仓的虫情监测信息
3、上报和虫情基本信息及防治信息与预测预报信息下发。也适用于具备储粮温度、湿度和气体浓度等粮情检测或者具备储粮害虫检测功能的储粮农户和加工厂的虫情信息上报以及虫情信息咨询。2. 规范性引用文件下列文件中的条款通过本技术要点的引用而成为本技术要点的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本技术要点达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。GB/T 29890 粮油储藏技术规范GB/T 26882.1 粮油储藏 粮情测控系统 第1部通则GB/T 26882.2 粮油储藏 粮情测控系统
4、 第2部分机GB/T 26882.3 粮油储藏 粮情测控系统 第3部软件GB/T 26882.4 粮油储藏 粮情测控系统 第4部信息交换接口协议GB/T 7408 数据元和交换格式 信息交换 日期和时间表示法GB/T 17295 国际贸易计量单位代码？ 库存粮食识别代码3. 术语和定义下列术语和定义适用于本标准。3.1 储粮温度、湿度、气体浓度及虫情粮情 stored-grain condition with multi-parameters （temperature，humidity , gas concentration and insects situation）LS 5粮食在储藏过程中
5、所处的状态以及影响其粮食品质和数量变化的各种因素，如温度、湿度、气体成分、虫情状况等多个参数组成的粮情。3.2 智能终端(Intelligent Terminal)利用现代计算机和电子技术对储粮温度、湿度和气体浓度以及虫情进行检测、数据存储与分析，并可对这些信息进行远程上报和接收远程服务器上的相关信息的终端设备。3.3 JSONJSON(JavaScript Object Notation) 是一种轻量级的数据交换格式，它采用了完全独立于语言的文本格式，易于人阅读和编写，同时也易于机器解析和生成。3.4 JSONObjectJSON对象，由一对 括起来的键值对数据。3.5 JSONArray是
6、用 包裹起来的一个数组JSONObject的数组。4. 接口规则4.1 访问规则1) 客户端访问以http传输协议方式访问，数据提交方式为post方式，并且使用UTF-8格式。2) 客户端必须先进行身份认证后，才能进行其他接口功能的访问。3) 进行其他功能的访问时，每次访问必须携带身份认证成功后返回的token。4.2 数据对象关系4.2.1 示范库粮情虫情监控对象：a) 粮库信息对象包含粮仓信息对象，粮仓信息对象包含储粮信息对象；b) 粮仓信息对象中包含粮情及虫情监测装置对象c) 含粮情及虫情监测装置对象包含多条检测记录信息对象；d) 检测记录对象又包含害虫信息和害虫图片信息对象；它们之间的
7、相互关系如右图所示。1.*1.*1.*1.*1.*粮 库 信 息粮 仓 信 息 储 粮 信 息实 时 信 息 表实 时 害 虫实 时 图 片LS 64.2.2 虫调数据对象虫调工作主要包括：粮库釆虫，加工厂釆虫，农户点釆虫和其他点釆虫4个大部分，其包含的主要数据对象如下：a) 粮库、釆虫记录、害虫文本信息、害虫图片信息；b) 加工厂、釆虫记录、害虫文本信息、害虫图片信息；c) 农户点、釆虫记录、害虫文本信息、害虫图片信息；d) 其他点釆虫记录、害虫图片信息；它们之间的关系如下图所示。1.*1.* 1.*1.*粮 库 信 息粮 仓 信 息 粮 库 釆 虫 记 录 表 粮 库 釆 虫 图 片粮 库
8、 釆 虫 害 虫1.*1.*1.*农 户 信 息 表农 户 采 集 记 录 表农 户 釆 虫 虫 害 信 息农 户 储 粮 釆 虫 图 片粮库釆虫 农户点釆虫1.*1.*1.* 1.*加 工 厂 信 息 表加 工 厂 采 集 记 录 表加 工 厂 釆 虫 图 片加 工 厂 釆 虫 害 虫其 他 点 釆 虫其 他 点 釆 虫 图 片加工厂釆虫 其他点釆虫4.2.3 储粮害虫知识库储粮害虫知识库，是指多角度基本信息及防治信息。主要包括：害虫分类表，害虫图片表，害虫数字特征表，害虫防治工艺等，他们之间的关系如下所示：LS 71.*1.*1.* 1.*1.*1.*1.*1.*DNA条 码害 虫 分 类
9、 表分 类 图 片 数 字 识 别 特 征工 艺 类 型防 治 工 艺 表害 虫 防 治 工 艺 表储粮害虫知识库对象关系图4.2.4 储粮用户咨询主要包括粮库用户、加工厂用户，农户对储粮过程中出现的问题向平台进行咨询的过程，包括：咨询、咨询图片等对象。1.*咨 询 咨 询 图 片4.3 交互数据格式服务器与客户端之间的数据交互格式采用JSON格式。提交举例：提交方式 1（提交 json 对象）：$.ajax(type : POST,contentType : application/json;charset=UTF-8,data : JSON.stringify(“username“ : “
10、12387654321“,“password“ : “12345“),url : Login/PersonLogin ,dataType : json,success : function(l) console.info(l);$(.container).append(“ + JSON.stringify(l) + “););提交方式 2（普通方式提交）：$.ajax(type : POST,data : LS 8“ username“ : “12387654321“,“password“ : “12345“,url : Login/PersonLogin,dataType : json,su
11、ccess : function(l) console.info(l);$(.container).append(“ + JSON.stringify(l) + “););5. 接口组成与功能5.1 接口组成接口主要由示范库粮情、储粮害虫基础信息及防治工艺服务、专家咨询服务以及虫调数据接口组成，主要完成对接入系统内的粮库的综合粮情虫情监测与预报，完成指定时间段范围内的虫调工作以及对粮库用户，加工厂用户和农户提供储粮虫情咨询与防治服务。5.2 接口功能5.2.1 用户认证用户认证接口请求方式：POST请求地址：http:/服务器 IP 地址或域名:端口/third/ common/login/请
12、求参数参数名 参数说明 数据类型 必填username 用户名 String 是password 用户密码 String 是返回参数参数名 参数说明 数据类型is_success 是否成功（true 表示成功；false 表示失败）Booleanerror_msg 错误信息（1、用户名不存在；2、密码不正确）StringLS 9access_token 数据请求令牌 String注：服务器认证通过后，会返回给用户一个 access_token，后续的数据请求都需要携带该数access_token。如果 access_token 失效，需要使用登录名和密码重新登录验证，获取新的access_to
13、ken。5.2.2 示范库粮情维护5.2.2.1 粮库信息查询接口请求方式：GET 地址：http:/服务器 IP 地址或域名:端口/third/depoter/getGraindepot请求参数参数名 参数说明 数据类型access_token 数据请求令牌 Stringgraindepotid 粮库编码 String返回参数参数名 参数说明 数据类型is_success 是否成功 Booleanerror_msg 错误信息（粮仓编码不正确） Stringgraindepotinfo 粮库信息 List的JSONArray Graindeport（粮库信息）参数名 参数说明 数据类型Id I
14、d Longlkbm 粮库编码 Stringgraindirect 储粮区 Stringlkmc 粮库名称 Stringlkdz 粮库地址 Stringlklx 粮库类型 Stringlongtitude 经度 Doublelatitude 纬度 Doublealtitude 海拔 Doublehasreal 是否实时采集 Booleantotalbin 粮仓数 Integerpostcode 邮编 Stringcontact 联系人 Stringphone 联系电话 Stringmodifier 录入人 Stringmodifydate 录入日期 StringLS 105.2.2.2 根据粮
15、库编码查询粮仓信息接口请求方式：GET 地址：http:/服务器 IP 地址或域名:端口/third/ depoter / getDeportinfoByDepotid请求参数参数名 参数说明 数据类型access_token 数据请求令牌 Stringgraindepotid 粮库编码 String返回参数参数名 参数说明 数据类型is_success 是否成功 Booleanerror_msg 错误信息（粮库编码不正确） Stringgranaryinfo 粮仓信息 List的 JSONArrayGranary（粮仓信息）参数名 参数说明 数据类型Id Id Longlkbm 粮库编码 S
16、tringlcbm 粮仓编码 Stringbinname 粮仓名 Stringorientation 朝向 Floatgranarynum 廒间数 Integertypebin 仓型 Stringcapacity 设计容量 Integerstructureofbody 仓体结构 Stringstructureofroof 顶仓结构 Stringdesigncapacity 设计单仓容量 Integerdesigngrainheapheight 设计粮堆高度 Floatlongth 长 Floatwidth 宽 Floatheight 高 FloatCirculatedevice 环流装置 StringCirculatefan 环流风机 Stringfanway 仓房风道 Stringelsedevice 其他设施 Stringcontract 联系人 Stringphone 联系电话 Stringnote 备注 Stringmodifer 录入人 Stringmodifydate 录入日期 String
