欢迎访问学兔兔标准下载网,学习、交流 分享 !
返回首页 |B 43
湖 南 省 地 方 标 准
DB43/T 3292—2025
地震应急信息服务接口规范
Specification for earthquake emergency information service interface
2025 - 07 - 18 发布 2025 - 10 - 18 实施
湖南省市场监督管理局 发 布
前 言
本文件按照GB/T 1.1—2020《标准化工作导则 第1部分:标准化文件的结构和起草规则》的规定起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由湖南省地震局提出并归口。
本文件起草单位:湖南省地震局、湖南省城市地质调查监测所、湖南省广播电视局、湖南省地震学会、湖南省地质调查所、湖南省震灾风险防治中心、湖南地震台、长沙市地震局、湖南大学、电子科技大学、四川典智科技有限公司。
本文件主要起草人:康承旭、高磊、樊雯雁、唐红亮、何禹、谌敏、郭海、田优平、佘旭明、张义梅、曾祺、张朝阳、周四望、王坤鹏、张鑫、王杰。
地震应急信息服务接口规范
1 范围
本文件规定了湖南省地震应急信息服务系统接口的访问步骤和接口定义。
本文件适用于终端与地震应急信息服务系统间的接入和使用。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB/T 18207.1 防震减灾术语 第1部分:基本术语
GB/T 18207.2 防震减灾术语 第2部分:专业术语
GB/T 32402 通信名词术语 数据通信 因特网
3 术语和定义
GB/T 18207.1、GB/T 18207.2和GB/T 32402界定的以及下列术语和定义适用于本文件。 3.1
地震应急 earthquake emergency response
破坏性地震发生前所做的各种应急准备以及地震发生后采取的紧急抢险救灾行动。
[来源:GB/T 18207.1—2008,6.1] 3.2
地震应急信息服务系统 earthquake emergency information service system
为行政部门以及学校、医院等人口密集区域提供地震灾害应急信息服务的软件系统。 3.3
接口 interface
一组定义、程序及协议的集合。
3.4
加密 encryption
由于安全的考虑将数据进行编码,即将标准数据编码转换成专用的编码。加密数据通常要经过解码才能被用户使用。
[来源:GB/T 32402—2015,3.1.102] 3.5
认证 authentication
识别个人或处理的合法性的过程。
[来源:GB/T 32402—2015,3.1.37]
3.6
时间戳 timestamp
格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数。
4 访问步骤
4.1 接入说明
对接终端运行在地震系统行业网或湖南省电子政务外网,接口采用HTTP协议以POST方式实现, 访问地址采用统一资源定位符(URL)。调用地震应急信息服务系统的参数以及返回的服务响应结果编码均采用UTF-8字符集。
4.2 注册登录
用户应注册获取用户名和密码,并在登录地震应急信息服务系统时获取认证码。认证码是用户身份的唯一标识,每个认证码均赋予有效期,在有效期内可重复使用。
4.3 生成请求地址
在地震应急信息服务系统资源地址中加入认证参数、时间参数、地震事件参数等生成服务资源请求地址。认证参数在请求头中进行设置,其他参数在服务资源地址或请求体中进行设置。
4.4 获取服务响应
采用HTTP协议中的POST方法调用地震应急信息服务系统资源地址,服务响应以JSON数据交换格式返回。地震应急信息服务系统接口支持多用户并行访问,获取服务响应的有效时间应小于500毫米,获取服务返回数据格式见表1。
表1 返回数据格式
5 接口定义
5.1 用户登录
用户登录请求参数采用JSON字符串封装和附录C规定的加密公钥加密,终端可通过HTTP协议中的POST方法调用本接口。用户登录请求参数要求见表2,调用示例及响应结果见附录B中表B.1。
表2 用户登录数据格式
5.2 地震评估事件
用户在获取地震评估事件数据资源地址中加入districtCode、startTime、endTime参数,形式为“?districtCode=&startTime=&endTime=”,并在消息头中设置用户登录成功后获得的认证信息,形式为“Authorization=<认证信息>”。获取地震评估事件数据请求参数要求见
表3,调用示例及响应结果见附录B中表B.2。
表3 地震评估事件数据格式
5.3 地震影响场
用户在获取地震影响场数据资源地址中加入eventId参数,形式为“? eventId=”,并在消息头中设置用户登录成功后获得的认证信息,形式为“Authorization=<认证信息>”。获取地震影响场数据请求参数要求见表4,注:返回的空间数据,坐标系统一为2000国家大地坐标系(CGCS2000)。调用示例及响应结果见附录B中表B.3。
表4 地震影响场数据格式
5.4 灾害损失预评估结果
用户在获取灾害损失(如:人员伤亡) 预评估结果资源地址中加入eventId参数,形式为“? eventId=”,并在消息头中设置用户登录成功后获得的认证信息,形式为“Authorization=<认证信息>”。评估结果数据格式要求见表5,调用示例及响应结果见附录B中表B.4。
表5 评估结果数据格式
附 录 A
(资料性)
响应代码及响应消息
表A.1给出了响应代码及响应消息。
表A.1 响应代码及响应消息
附 录 B (资料性)
地震应急信息服务接口示例表
表B.1、表B.2、表B.3和表B.4分别给地震应急信息服务接口、获取地震评估事件、地震影响场接口和地震灾害损失预评估接口的示例。
表B.1 地震应急信息服务接口示例
表B.2 获取地震评估事件示例
表B.3 地震影响场接口示例
表B.4 地震灾害损失预评估接口示例
附 录 C
(规范性)
地震应急信息服务系统加密公钥
下面规定地震应急信息服务系统的加密公钥。
0438b2a736dd2c29eda14588437e618ab8a442a8a6e3346a35d87b8e9ea8506651619908c0e19def2bf19 f38b0a65c4cb5a2c139ea6b64ae7feb26ad212e2e3293