GB/T 34283-2017 国家突发事件预警信息发布系统管理平台与终端管理平台接口规范

ICS07.060

A47(3B

中华人民共和国国家标准

GB/T34283—2017

国家突发事件预警信息发布系统管理平台

与终端管理平台接口规范

Interfacespecificationsofnationalemergenciesearlywarningreleasesystem?s

managementplatformandterminalmanagementplatform

2017-09-07发布2018-04-01实施

发布

GB/T3428—2017

目次

冃IJBI

1范围1

2规范性引用文件1

3术语和定义1

4终端管理平台接入国家突发事件预警信息发布系统管理平台的要求与规范2

附录A（规范性附录）国家突发事件预警信息发布系统管理平台与终端管理平台信息编码规范及

示例5

附录E（规范性附录）预警信息各字段编码规范11

附录C（资料性附录）国家突发事件预警信息发布系统管理平台预警信息编码示例17

参考文献19

GB/T3428—2017

百

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

本标准由中国气象局提出。

本标准由全国气象基本信息标准化技术委员会(SAC/TC346)归口。

本标准起草单位：中国气象局公共气象服务中心(国家预警信息发布中心)。

本标准主要起草人:曹之玉、韩强、高翔、李晓、唐娴、张昊。

I

GB/T3428—2017

国家突发事件预警信息发布系统管理平台

与终端管理平台接口规范

1范围

本标准规定了国家突发事件预警信息发布系统管理平台与终端管理平台之间的接口规范。

本标准适用于全国各级国家突发事件预警信息发布系统管理平台与终端管理平台之间的接入。

2规范性引用文件

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

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

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

3术语和定义

下列术语和定义适用于本文件。

3.1

预警信息earlywarning

预警发布责任单位根据事件可能造成的危害程度、紧急程度和发展态势而发布的预先告知或态势

通告等警示类信息。一般包括突发事件的类别、预警级别、起始吋间、可能影响范围、警示事项、应采取

的措施和发布机关等。

3.2

预警信息发布earlywarningrelease

由预警发布责任单位根据有关法律、行政法规和上级主管部门规定的权限和程序，利用现有发布渠

道，通过国家突发事件预警信息发布系统，将预警信息公之于众的过程。

3.

国家突发事件预警信息发布系统nationalemergenciesearlywarningreleasesystem

根据国家突发事件应急体系建设规划，由中央和地方共同建设的国家、省、市、县四级相互衔接的实

现面向应急责任人和社会公众多手段广覆盖精确发布预警信息的突发事件预警信息发布平台。

3.4

国家突发事件预警信息发布系统管理平台managementplatformofnationalemergenciesearly

warningreleasesystem

国家突发事件预警信息发布系统中实现预警信息的采集、审核、签发、复核、发布策略配置以及预警

信息上下传输等功能的子系统。

3.5

终端管理平台terminalmanagementplatform

管理预警信息发布终端的系统。根据终端类型一般需具有向预警发布终端发送信息、获取预警发

布终端发送结果、监控预警发布终端实时状态的功能。

1

GB/T34283—2017

3.6

预警终端earlywarningterminals

利用图像、声音或文字的形式发布预警信息的设备或系统。包括高音喇叭自动播放系统、北斗终

端、手机、传真系统等。

3.7

发布手段releasemeans

实现预警信息发布，使之能够被公众以图像、声音或文字的形式辨识的信息传播媒介。如电视、广

播、邮件、大喇叭、显示屏、手机短信、网站、微博、微信等。

4终端管理平台接入国家突发事件预警信息发布系统管理平台的要求与规范

4.1概述

终端管理平台接入到国家突发事件预警信息发布系统管理平台应完成终端管理平台注册、预警终

端备案等要求，预警信息发布、发布结果反馈、终端设备状态上报应按照相应的规范实施。

4.2终端管理平台注册

4.2.1注册方法

终端管理平台接入到国家突发事件预警信息发布系统管理平台首先应进行注册。

终端管理平台以标识编码方式在国家突发事件预警信息发布系统管理平台注册，标识编码格式见

A.1。注册应向所在地的预警信息发布中心进行人工申请，并提交申请材料，包括终端管理平台设备生

产厂家、单位或公司地址、单位或企业法人、联系方式、终端管理平台部署所在地行政区划代码等信息。

4.2.2下发接口开发包和鉴权码

终端管理平台注册完成后，当地预警信息发布中心向注册单位或公司提供接口开发包及文档，相关

接口函数的调用在文档里有详细说明，开发包升级后，不影响之前的接口函数调用。国家突发事件预警

信息发布系统管理平台根据终端管理平台的标识编码给出该终端管理平台的鉴权码（鉴权码由12位固

定长度字符串组成，由国家突发事件预警信息发布系统管理平台生成）。

终端管理平台的固定IP（IPv4十进制编码）与标识编码和鉴权码三者共同构成终端管理平台在国

家突发事件预警信息发布系统管理平台中的唯一标识。

4.3连接建立与退出

4.3.1概述

终端管理平台与国家突发事件预警信息发布系统管理平台信息交换采用TCP/IP长连接方式，连

接的建立与退出通过相应接口实现。

4.3.2连接建立

建立终端管理平台与国家突发事件预警信息发布系统管理平台之间的连接,接口说明见表1。

2

GB/T34283—2017

表1连接接口说明

函数名称DSD_Connec(filename,dir)

功能描述初始化连接

filename：终端管理平台配置文件（绝对路径,路径长度小于200字节）；

参数说明

dir：终端管理平台工作目录（绝对路径，路径长度小于200字节）

返回值1：连接成功；非1：连接失败

4.3.3连接退出

退出终端管理平台与国家突发事件预警信息发布系统管理平台之间的连接，接口说明见表2。

表2退出接口说明

函数名称DSD_Disconnec()

功能描述断开连接

参数说明无参数

返回值1:退出成功；非1:退出失败

4.4预警终端备案

终端管理平台需将所管理的终端设备信息向国家突发事件预警信息发布系统管理平台备案，设备

备案规范格式见附录A中A.2,备案接口说明见表3。

表3备案接口说明

函数名称DSD_UpdateResource(filename,id)

功能描述预警终端备案

filename：终端备案描述文件，文件命名规则见A.6.3；

参数说明

id：终端标识编码，命名规则见A.2.1

返回值1：终端备案成功；非1：终端备案失败

4.5预警信息获取与解析

国家突发事件预警信息发布系统管理平台自动推送预警信息至终端管理平台，同吋发送消息报告。

终端管理平台通过消息提醒获取预警信息文件，获取预警信息接口说明见表4。

表4解析接口示例

函数名称DSD_GeMessage()

功能描述终端管理平台与国家突发事件预警信息发布系统管理平台信息交互

参数说明参数为空

返回值见表A.5“收到新预警文件”相关功能描述；无消息返回空

3

GB/T34283—2017

终端管理平台从国家突发事件预警信息发布系统管理平台获取预警信息后，按照预警信息各字段

编码规范（见附录B）和国家突发事件预警信息发布系统管理平台预警信息编码格式（示例参见附录

C）,对所获取的预警信息数据进行解析。

4.6发布结果反馈

终端管理平台完成预警信息发布后，收集各终端的发布结果，反馈到国家突发事件预警信息发布系

统管理平台。汇总内容包括发送终端数量、成功发送数量、发送失败数量、每一个预警终端的发布结果

等。发布结果反馈规范见A.4,发布结果反馈接口说明见表5。

表5发布结果反馈

函数名称DSD_ReportResul(filename,warningid)

功能描述上报发布结果统计报告

filename：发布结果反馈文件，文件命名规则见A.6.1；

参数说明

warningid：预警id（同接收预警的id）

返回值1:消息发送指令成功；非1:消息发送指令失败

4.7终端状态上报

终端管理平台应向国家突发事件预警信息发布系统管理平台汇总终端实吋状态信息。终端状态上

报规范格式见A.5,终端状态上报接口说明见表6。

表6终端状态上报接口说明

函数名称DSD_ReportStatus(filename,id)

功能描述上报所有终端的当前状态

filename：终端状态报告文件，文件命名规则见A.6.2;

参数说明

id：上报操作指令

返回值1:消息发送指令成功；非1:消息发送指令失败

4

GB/T3428—2017

附录A

（规范性附录）

国家突发事件预警信息发布系统管理平台与终端管理平台信息编码规范及示例

A.1终端管理平台标识编码

定义为12位字符：DDDDZZZZZZUU。其中：

a）DDDD是终端生产厂家在国家突发事件预警信息发布系统中的入网编码，由国家预警信息发

布中心统一分配（全国唯一）；

b）ZZZZZZ是终端管理平台部署位置的6位行政区域代码，见GB/T2260—2007,定义到县级；

c）UU（0〜99）终端管理平台属性下的自然编码，用以区分多个同属性平台。

A.2预警终端备案文件格式

A.2.1终端标识编码

定义为24位字符:DDDDZZZZZZUUCCCCCCCCCCCCo

其中前12位是终端管理平台的标识编码，后12位是终端管理平台所管理设备的编号。

A.2.2预警终端编码规则

预警终端备案信息各字段编码见表A.l0

表A.1字段编码

序号名称可选/必选属性走义注释/取值范围

(clientdetail)

1Version必选数字规范版本号>1.0

2FileType必选字符串说明该文件类型clientdetail

(Detail)

设备备案类型：1—新增2-

3Flag必选数字取值范围：1,2,3

更新3—删除

<Client)

4ClientID必选数字预警终端唯一编码见A.2.1

终端类型：0—高音喇叭自

5ClientStyle必选数字动播放系统1—北斗终端0,1,2,3

2—手机3—传真系统……

预警终端所在地经纬度信

6ClientCoordinate必选数字经纬度之间逗号分离

息（经度，纬度）

遵循GB/T2260—2007以

12位，设备所在地区城乡划

7ClientAreacode必选数字及国家统计局网站“统计用

分代码

区划和城乡划分代码”

5

GB/T3428—2017

表A.1(续)

序号名称可选/必选属性定义注释/取值范围

设备创建时间(YYYYMM

8ClientSetupTime必选日期

DDSS：FF)

(Client)

9ClientModel可选字符串设备型号如果型号不明，可以填空

10ClientAddress必选字符串设备部署详细地址精确到街道(村)

11ClientPerson可选字符串设备维护联系人姓名

12ClientTel可选字符串设备维护联系人电话

(/Client)

</Detail>

(/clientdetail)

A.预警终端备案信息示例

预警终端备案信息示例见表A.2。

表A.2预警终端备案信息示例

预警设备备案文件示例

<xmlversion="1.0"encoding="UTF-8"?>

(clientdetail)

<Version)1.0(/Version)

〈FileType>clientdetail</FileType>

<Detail)

<Flag>l</Flag>

<Client)

<ClientID>00011130010600000000001</ClientID>:

(ClientStyle)1</ClientStyle>

(ClientCoordinate)109.594532,3&9726565〈/ClientCoordirmte〉

<ClientAreacode)113001</ClientAreacode)

<ClientSetupTime>2013092416;03:10</ClientSetupTime>

(ClientModel></ClientModel)

<ClientAddress>北京市XX区XX大街XX号〈/ClientAddress〉

<ClientPerson)张XX,李XX,王XX</ClientPerson)

<ClientTel>010-XXXXXXXX,010-XXXXXXXX</ClientTel>

<Note>这是备注项，可省略</Note>

</Client>

</Detail)

</clientdetail)

6

GB/T3428—2017

A.4发布结果反馈

A.4.1概述

用于终端管理平台将信息发送到终端设备后，收集完成每个终端的发布结果并反馈给国家突发事

件预警信息发布系统管理平台。

A.4.2文件名命名格式

预警信息唯一标识_6位发送系统行政区划-发送系统名称_6位接收系统行政区划-接收系统名称一

时间（年月日时分秒毫秒）_AI-3_0.XMLo其中：

a）预警信息唯一标识:是预警信息的唯一标识，此标识通过接收的CAP文件中获得；

b）6位发送系统行政区划：当前接收系统所在的行政区划；

c）发送系统名称:发送回执文件系统的名称，该名称为英文名称；

d）6位接收系统行政区划：接收系统所在的行政区划；

e）接收系统名称:接收回执文件系统的名称，此名称为英文名；

f）时间：当前系统的时间，规则为yyyyMMddHHmmssSSS；

g）-AI-3-0:回执文件类型,AI-3表示设备发布结果报告。

A.4.发布结果反馈各字段编码

发布结果反馈各字段编码见表A.3。

表A.发布结果反馈各字段编码

序号名称可选/必选属性定义注释/取值范围

(report)

1Version必选数字规范版本号>1.0

o—发布结果反馈

2FileType必选数字反馈的类型

1—资源监控或状态汇报

如果是资源监控或状态轮

3Identifier可选字符串警信息唯一编号

询，这项填空

4FactoryServerlD必选字符串终端管理平台编码见A.1

反馈类型是资源监控或状

5TotalCoun必选数字发布终端总数

态汇报时该字段为空

反馈类型是资源监控或状

6SuccCoun必选数字发布成功终端总数

态汇报时该字段为空

反馈类型是资源监控或状

7FailCoun必选数字发布失败终端总数

态汇报时该字段为空

时间格式为YYYYMMDD

8Starime可选日期状态收集开始时间