LY/T 3102-2019 林业有害生物监测预报数据交换规范

ICS65.020.99

B60

LY

中华人民共和国林业行业标准

LY/T3102—2019

林业有害生物监测预报数据交换规范

Datainterchangespecificationformonitoringandforecastingofforestpest

（发布稿）

2019-10-23发布2020-04-01实施

国家林业和草原局发布

LY/T3102—2019

目次

前言II

1范围1

2规范性引用文件1

3术语、定义和缩略语1

3.1术语和定义1

3.2缩略语2

4监测预报数据2

4.1监测预报数据说明2

4.2林业有害生物发生与防治数据3

4.3林业有害生物国家级中心测报点调查数据3

4.4林业有害生物应急事件报告报表3

4.5林业有害生物趋势预报数据3

5数据交换处理3

5.1数据交换的参与者3

5.2交换方式3

5.3交换模式4

6数据交换格式4

6.1数据交换格式说明4

6.2数据类型4

6.3消息类型4

6.4推送数据格式4

6.5确认推送数据格式5

6.6请求数据格式5

6.7反馈请求数据格式6

7数据交换接口6

7.1接口调用说明6

7.2数据接口名称6

8数据交换安全要求7

附录A（规范性附录）数据交换JSON格式要求及示例8

附录B（规范性附录）消息类型95

附录C（资料性附录）错误标识符96

参考文献97

I

LY/T3102—2019

前言

本标准按照GB/T1.1-2009给出的规则起草。

本标准由国家林业和草原局信息中心提出。

本标准由全国林业信息数据标准化技术委员会（SAC/TC386）归口。

本标准起草单位：国家林业和草原局信息中心、国家林业和草原局森林和草原病虫害防治总站、北

京东蓝数码科技有限公司。

本标准主要起草人：董振辉、顾红波、于治军、徐钰、刘广安、韩阳、崔东阳、白莹、姜璠。

本标准首次发布。

II

LY/T3138—2019

林业有害生物监测预报数据交换规范

1范围

本标准规定了林业有害生物监测预报数据交换的内容与格式。

本标准适用于林业有害生物发生与防治数据、国家级中心测报点调查数据、应急事件报告报表及趋

势预报等林业有害生物监测预报相关数据的交换。

注：根据实际业务模式，本标准中含林业有害生物防治、林业有害生物应急事件报告报表数据。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T21062.1政务信息资源交换体系第1部分：总体框架

GB/T2260中华人民共和国行政区划代码

GB/T10114县以下行政区划代码编制规则

GB/T15775林业资源分类与代码林木害虫

GB/T15161林业资源分类与代码林木病害

LY/T2022应施检疫的林业植物产品代码

LY/T1681林业有害生物发生及成灾标准

3术语、定义和缩略语

GB/T21062.1—2007和LY/T1681—2006界定的术语和定义，以及下列术语和定义适用于本文件。

3.1术语和定义

3.1.1

林业有害生物forestpest

对森林植物有害的任何植物、动物或病原体的种、株（或品系）或生物型。包括害虫、病害、鼠（兔）

害、有害植物。

[LY/T1681—2006，定义3.1]

3.1.2

林业有害生物发生与防治数据forestpestoccurrenceandcontroldata

1

LY/T3138—2019

按照国家林业主管部门要求各级林业有害生物防治检疫机构定期报送的林业有害生物发生与防治

常规性数据。

3.1.3

林业有害生物国家级中心测报点调查数据forestpestsurveydataofnationalcenterstation

按照国家林业主管部门要求林业有害生物国家级中心测报点对指定的林业有害生物按照相关调查

办法开展监测并上报调查数据。

3.1.4

林业有害生物应急事件报告报表forestpesttrendforecast

按照国家应急管理办公室有关要求，各省级林业有害生物防治检疫管理机构对本地区突发灾害应急

事件情况定期进行报告。

3.1.5

林业有害生物趋势预报forestpesttrendforecast

根据林业有害生物的生物学特性结合气象、资源及监测数据等信息对其发生发展趋势进行预测预

报，一般按预报时间分为短期预报、中期预报、长期预报，按预报对象不同分为发生量预报、发生期预

报、发生范围预报等。

3.1.6

交换interchange

政务部门间通过政务信息资源交换体系技术支撑环境实现政务信息资源在线传送的过程。

[GB/T21062.1—2007，定义2.1]

3.2缩略语

HTTP超文本传输协议（HypertextTransferProtocol）

HTML超文本标记语言（HyperTextMark-upLanguage）

IETF国际互联网工程任务组（TheInternetEngineeringTaskForce）

RFC由IETF发布的一系列备忘录（RequestForComments）

JSON一种轻量级的数据交换格式（JavaScriptObjectNotation）

UTF-8一种Unicode字符编码（8-bitUnicodeTransformationFormat）

UUID通用唯一标识符（UniversallyUniqueIDentifier）

VPN虚拟专用网络（VirtualPrivateNetwork）

SSL安全套接层（SecureSocketsLayer）

4监测预报数据

2

LY/T3138—2019

4.1监测预报数据说明

林业有害生物监测预报数据包括林业有害生物发生与防治数据、国家级中心测报点调查数据、应急

事件报告报表和趋势预报数据四类业务数据。

4.2林业有害生物发生与防治数据

主要包括林业有害生物发生情况数据，与发生情况相关联的防治情况、防治措施、防治药剂药械、

人财物统计等数据，要求县级林业有害生物防治管理机构每月报送。

4.3林业有害生物国家级中心测报点调查数据

主要包括由林业有害生物国家级中心测报点报送的林业有害生物虫情动态和短期预报报告、发生历

期报表、发生量调查表等监测调查数据及气象数据、国家级中心测报点基本情况等数据。

4.4林业有害生物应急事件报告报表

各个省级林业有害生物防治管理机构每周需要对本周所管辖范围内的林区是否发生重大事件进行

报告，如果没有发生病虫害事件则零报送；如果发生病虫害事件，则具体描述事件情况，进行应急报送，

报送内容包括事件名称、事件级别、事件描述、发生区域、有害生物信息、寄主信息、周边区域信息等。

4.5林业有害生物趋势预报数据

主要包括县级林业有害生物防治管理机构的林业有害生物发生期和发生量的预报数据。

5数据交换处理

5.1数据交换的参与者

参与数据交换的业务系统通过数据交换将数据写入应用支撑平台或从应用支撑平台读取数据，实现

与其他业务系统的数据共享和业务协同。包括以下参与者：

a)数据交换的发送者。负责构造请求数据包，并将请求数据包发送至数据交换平台；负责从数据

交换平台接收响应数据包，并对响应数据包进行处理。

b)数据交换的接收者。负责接收、解析、处理请求数据包，根据处理结果构造响应数据包，并将

响应数据包发送至数据交换平台。

c)数据交换平台。负责请求数据包和响应数据包的接收、转换、传递，并对数据交换过程进行

监控和管理。原则上，请求数据包和响应数据包的构造、业务数据体的解析、与交换相关的

业务处理由数据交换发送者或接收者完成。

5.2交换方式

数据交换参与者之间存在两种方式:同步方式和异步方式。

a）同步方式。同步方式过程为数据交换发送者构造请求数据包，并发送至数据交换平台；数据交

换平台将请求数据包发送给数据交换接收者进行处理，最终向发送者返回响应数据包。发送者只有接收

到响应数据包或捕获到数据交换异常后才继续往下执行，这种方式适用于数据交换量小、响应时间要求

严格的情况。

3

LY/T3138—2019

b）异步方式。异步方式过程为数据交换发送者向数据交换平台发出请求数据包后，继续进行其他

处理，而不是等待响应数据包；数据交换平台负责将请求数据包发送给接收者，或接收者主动从数据交

换平台索取请求数据包；接收者在获得请求数据包后进行处理并构造响应数据包，然后发送至数据交换

平台；数据交换平台负责将响应数据包发送给发送者，或发送者主动从数据交换平台索取响应数据包；

发送者在获得响应数据包后进行处理。这种方式适用于数据交换量比较大且对响应时间要求不十分严格

的情况。

5.3交换模式

数据交换参与者之间存在两种模式：同级模式和上下级模式。国家林业主管部门林业有害生物发生

防治相关业务系统之间数据交换为同级模式。国家林业主管部门林业有害生物发生防治业务系统与省级

系统之间数据交换为上下级模式。同级模式时，主动请求数据的系统是交换过程的发送者。上下级模式

时，下级数据交换系统是交换过程的发送者。

数据交换是数据参与者之间对数据采用“推”和“拉”相结合的方式，发送者从接收者处检索属于本

级的数据包，“拉”到本地后再进行处理；发送者将需要报送的数据包“推”到接收者处。

6数据交换格式

6.1数据交换格式说明

交换数据可以采用JSON和XML格式进行包装。本标准中以JSON数据格式为例进行表述，数据交换格

式采用JSONSchema进行描述和验证，数据包默认采用UTF-8的编码方式。

6.2数据类型

数据交换格式中共包括九种数据类型，具体格式见表1。

表1数据类型

类型名称类型描述

String任意字符串数据类型

Null空数据类型

Integer整数数据类型

Number浮点数数据类型

Boolean布尔值数据类型

Object对象数据类型

Array数组数据类型

Any任意数据类型

Union两个以上的数据类型构成的数组类型

6.3消息类型

数据交换格式中共包括二十九种消息类型（mType），每个消息类型标识符用三至十一个字符表示。

4

LY/T3138—2019

消息类型定义见附录B。

6.4推送数据格式

推送数据格式用于主动向接收者交换系统提交数据时使用，具体格式见表2。

表2推送数据格式

标识符名称数据类型备注

mVer发送消息版本号Integer必填内容，默认版本号10000

mKey消息密钥String必填内容，加密公钥，由交换平台指定

mType消息类型String必填内容，见附录B中的消息类型

mMsgID消息IDString必填内容，消息的唯一标识符（32位UUID）

必填内容，根据推送消息填写内容，详见附

mDatas数据内容Any

录A中的JSONSchema描述

mUnitID单位编码String必填内容，由交换平台指定

mUnitCode单位行政区划String必填内容，最大长度6，代码参考GB/T2260

必填内容，yyyy-MM-ddHH:mm:ss格式字符

mTimerFlag时间戳标志String

串

mDelFlag删除标志BoolenTrue表示删除，False表示有效

6.5确认推送数据格式

确认推送数据格式用于回应主动提交数据的发送者交换系统，具体格式见表3。

表3确认推送数据格式

标识符名称数据类型备注

mVer确认消息版本号Integer必填内容，默认版本号10000

必填内容，推送数据的唯一标识符（32位

mMsgID消息IDString

UUID）

mReturnCode消息标识符Integer必填内容（0：接受、1：拒绝）

mErrorCode错误标识符Integer必填内容，参见附录C中的错误标识符

mErrorMsg错误描述String必填内容，错误描述内容字符串

6.6请求数据格式

请求数据格式用于主动向接收者交换系统请求需要的数据，具体格式见表4。

表4请求数据格式

标识符名称数据类型备注

5

LY/T3138—2019

mVer发送消息版本号Integer必填内容，默认版本号10000

标识符名称数据类型备注

mKey消息密钥String必填内容，加密公钥，由交换平台指定

mType消息类型String必填内容，见附录B中的消息类型

必填内容，请求数据的唯一标识符（32位

mMsgID消息IDString

UUID）

必填内容，根据请求数据查询条件填写内容，

mDatas数据内容Any

详见附录A中的JSONSchema描述

mPage分页的页码Integer必填内容

mCount每页的数量Integer必填内容，大于0，小于或等于100

mUnitID单位编码String必填内容，由交换平台指定

mUnitCode单位行政区划String必填内容，最大长度6，代码参考GB/T2260

必填内容，yyyy-MM-ddHH:mm:ss格式字符

mTimerFlag时间戳标志String

串

6.7反馈请求数据格式

反馈请求数据格式用于向发送者提供请求的数据，具体格式见表5。

表5反馈请求数据格式

标识符名称数据类型备注

mVer确认消息版本号Integer必填内容，默认版本号10000

必填内容，请求数据的唯一标识符（32位

mMsgID消息IDString

UUID）

mReturnCode消息标识符Integer必填内容（0：接受；1：拒绝）

mErrorCode错误标识符Integer必填内容，参见附录C中的错误标识符

mErrorMsg错误描述String必填内容，错误代码表示的内容字符串

mDatas数据内容Any必填内容，根据请求数据查询条件填写内容，

详见附录A中的JSONSchema描述

mPage分页的页码Integer必填内容，大于0，小于等于分页的数量

mPageCount分页的数量Integer必填内容，大于0

7数据交换接口

7.1接口调用说明

数据交换接口调用说明描述文件可采用HTML文件格式，命名空间为DEX，查询方法为

queryDefinition，参数为paraType，参数取值参考附录B中的消息类型。调用后返回相应类型接口调用

方法及参数说明的HTML页面。

6

LY/T3138—2019

域名为，端口为9090的林业有害生物发生数据交换接口说明URL地址示例：

:9090/DEX/queryDefinition?paraType=MFS

7.2数据接口名称

数据交换接口名称用于数据交换时进行调用，采取统一外观设计模式进行设计，推送数据接口为

putData.do，请求数据接口为getData.do，数据提交方式为HTTP协议的POST方式，数据格式为附录A中

要求的JSON格式。

域名为，端口为9090的推送数据接口URL地址示例：

:9090/DEX/putData.do

域名为，端口为9090的请求数据接口URL地址示例：

:9090/DEX/getData.do

8数据交换安全要求

数据交换过程需要采用符合国家标准的商用密码产品或者密码技术手段进行信息安全保护。例如，

采用VPN或SSL保护数据传输，或者对传输的数据内容采用非对称国密加密算法进行加密处理。

7

LY/T3138—2019

附录A

（规范性附录）

数据交换JSON格式要求及示例

A.1推送数据格式

A.1.1林业有害生物发生数据

表A.1林业有害生物发生数据mDatas数据属性

标识符名称数据类型备注

id发生数据idString最大长度32，32位UUID

String最大长度12，代码参考

yhswdm有害生物代码

GB/T15775,GB/T15161

String最大长度9，发生乡镇的行政区划代码，代

qhdm区划代码

码参考GB/T10114

sdc世代、次String最大长度1，由交换平台指定

fssj发生时间Stringyyyy-MM-dd格式字符串

String最大长度500,多个树种使用“,”分隔，代

jzwzdm寄主树种代码

码参考LY/T2022

jzmj寄主面积（亩）Number整数12位，小数2位

yjmj应监面积（亩）Number整数12位，小数2位

jcmj监测面积（亩）Number整数10位，小数2位

jcfgl监测覆盖率（%）Number整数10位，小数2位

fbmj分布面积（亩）Number整数10位，小数2位

dckdgbmj低虫口低感病面积（亩）Number整数10位，小数2位

ljfshj累计发生合计（亩）Number整数10位，小数2位

ljqd累计轻度（亩）Number整数10位，小数2位

ljzd累计中度（亩）Number整数10位，小数2位

ljzdu累计重度（亩）Number整数10位，小数2位

fshj发生合计（亩）Number整数10位，小数2位

fsqd发生轻度（亩）Number整数10位，小数2位

fszd发生中度（亩）Number整数10位，小数2位

fszdu发生重度（亩）Number整数10位，小数2位

tbcxfs同病虫新发生（亩）Number整数10位，小数2位

fsl发生率（%）Number整数3位，小数2位

yjcz预计成灾面积（亩）Number整数10位，小数2位

nf年份Number整数4位

8

LY/T3138—2019

yf月份Number整数2位

本节为资料性内容，以JSON为例，JSONSchema示例如下：

{

"$schema":"/draft-04/schema#",

"title":"林业有害生物发生数据",

"type":"object",

"properties":{

"mVer":{"type":"integer"},

"mKey":{"type":"string"},

"mType":{"type":"string"},

"mMsgID":{"type":"string"},

"mDatas":{"type":"array","items":

{"type":"object","properties":

{"id":{"type":"string"},"yhswdm":{"type":"string"},"qhdm":{"type":"string"},"sdc

":{"type":"string"},"fssj":{"type":"string"},"jzwzdm":{"type":"string"},"jzmj":{"type":

"number"},"yjmj":{"type":"number"},"jcmj":{"type":"number"},"jcfgl":{"type":"number"},"fb

mj":{"type":"number"},"dckdgbmj":{"type":"number"},"ljfshj":{"type":"number"},"ljqd":{"t

ype":"number"},"ljzd":{"type":"number"},"ljzdu":{"type":"number"},"fshj":{"type":"number

"},"fsqd":{"type":"number"},"fszd":{"type":"number"},"fszdu":{"type":"number"},"tbcxfs":

{"type":"number"},"fsl":{"type":"number"},"yjcz":{"type":"number"},"nf":{"type":"number

"},"yf":{"type":"number"}}

}

},

"mUnitID":{"type":"string"},

"mUnitCode":{"type":"string"},

"mTimerFlag":{"type":"string"},

"mDelFlag":{"type":"boolean"}

},

"required":["mVer","mKey","mType","mMsgID","mDatas","mUnitID","mUnitCode","mTimerFlag","mDe

lFlag"]

9

LY/T3138—2019

}

10

LY/T3138—2019

JSON示例如下：

{

"mVer":10000,

"mKey":"402894bc5b9f6b76015ba2c310000189",

"mType":"MFS",

"mMsgID":"sgqrzjiaohuanceshushagnhao",

"mDatas":[

{

"id":"0044e004623b445ca18bd070db899382",

"yhswdm":"C24202010005",

"qhdm":"210102001",

"sdc":"2",

"fssj":"2018-05-16",

"jzwzdm":"634006000900,634006000600,634006002900",

"jzmj":3901,

"yjmj":3901,

"jcmj":3901,

"jcfgl":100,

"fbmj":0,

"dckdgbmj":0,

"ljfshj":0,

"ljqd":0,

"ljzd":0,

"ljzdu":0,

"fshj":0,

"fsqd":0,

"fszd":0,

"fszdu":0,

11

LY/T3138—2019

"tbcxfs":0,

"fsl":0,

"yjcz":0,

"nf":2018,

"yf":5

}

],

"mUnitID":"2c9094824a5c4e8888000000310000ff",

"mUnitCode":"310000",

"mTimerFlag":"2016-12-0100:00:00",

"mDelFlag":false

}

A.1.2林业有害生物防治数据

表A.2林业有害生物防治数据mDatas数据属性

标识符名称数据类型备注

id发生数据idString最大长度32，对应发生数据的32位UUID

fzsj防治时间Stringyyyy-MM-dd格式字符串

ylfzzymjhj营林防治作业面积合计（亩）Number整数10位，小数2位

ylfzmjhj营林防治面积合计（亩）Number整数10位，小数2位

rgwlfzzymjhj人工物理防治作业面积合计（亩）Number整数10位，小数2位

rgwlfzmjhj人工物理防治面积合计（亩）Number整数10位，小数2位

swfzzymjhj生物防治作业面积合计（亩）Number整数10位，小数2位

swfzmjhj生物防治面积合计（亩）Number整数10位，小数2位

hxfzzymjhj化学防治作业面积合计（亩）Number整数10位，小数2位

hxfzmjhj化学害防治面积合计（亩）Number整数10位，小数2位

wghzymjhj无公害作业面积合计（亩）Number整数10位，小数2位

wghfzmjhj无公害防治面积合计（亩）Number整数10位，小数2位

zymjhj防治作业面积合计（亩）Number整数10位，小数2位

fzmjhj防治面积合计（亩）Number整数10位，小数2位

yfmj预防面积（亩）Number整数10位，小数2位

ffmj飞防面积（亩）Number整数10位，小数2位

12

LY/T3138—2019

tbcxfz同病虫新防治（亩）Number整数10位，小数2位

标识符名称数据类型备注

wghfzzyl无公害防治作业率（%）Number整数3位，小数2位

fzl防治率（%）Number整数3位，小数2位

czmj成灾面积（亩）Number整数10位，小数2位

whzhmj挽回灾害面积（亩）Number整数10位，小数2位

czl成灾率（%）Number整数3位，小数2位

yfzymj预防作业面积Number整数10位，小数2位

fzfy防治费用（元）Number整数10位

sszs死树株数（株）Number整数12位

swhxfzzymjhj生物化学防治作业面积合计Number整数10位，小数2位

swhxfzmjhj生物化学防治面积合计Number整数10位，小数2位

表A.3林业有害生物防治数据mDatas数据属性子

fsfzid发生防治表ID(关联id)String

fzcsdm防治措施-防治措施代码String最大长度6，由交换平台指定

yjdm防治措施-药剂代码String最大长度10，由交换平台指定

fzzymj防治措施-防治作业面积（亩）Number整数10位，小数2位

fzmj防治措施-实际防治面积（亩）Number整数10位，小数2位

fzyl防治措施-药剂商品量Number整数14位，小数4位

最大长度1位，（1：千克、2：升、3：头、4：

yjdw防治措施-药剂单位String

其他）

fzylbfb防治措施-药剂折百量（%）Number整数14位，小数4位

本节为资料性内容，以JSON为例，JSONSchema示例如下：

{

"$schema":"/draft-04/schema#",

"title":"林业有害生物防治数据",

"type":"object",

"properties":{

"mVer":{"type":"integer"},

"mKey":