地震http

ICS点击此处添加中国标准文献分类号DB山西省地方标准DB/XXXXX—XXXX地震服务信息数据接口规范Specificationforseismicserviceinformationdatainterface点击此处添加与国际标准一致性程度的标识XXXX-XX-XX发布XXXX-XX-XX实施发布前言本标准按照GB/T1.
1-2009给出的规则起草.
本标准由山西省地震局提出并归口.
本标准起草单位:山西省地震局监测信息中心.
本标准主要起草人:地震服务信息数据接口规范范围本标准规定了地震服务信息数据接口的术语和定义、访问方法、授权机制、效能要求和接口说明.

本标准适用于地震服务信息数据接口的设计和使用.
规范性引用文件下列文件对于本文件的应用是必不可少的.
凡是注日期的引用文件,仅注日期的版本适用于本文件.

GB/T18207.
2-2005防震减灾术语第2部分:专业术语GB17740-2017地震震级的规定GB/T17742-2008中国地震烈度表GB/T22568-2008公共地震信息发布术语和定义下列术语和定义适用于本文件,其中GB/T18207.
2—2005和GB/T17742-2008界定的术语和定义适用于本文件.
为便于使用以下重复列出GB/T18207.
2—2005和GB/T17742-2008中的一些术语和定义.
天然地震spontaneousearthquake地球内部活动引发的地震,主要包括构造地震和火山地震.
[GB/T18207.
2-2005,定义3.
1.
1]诱发地震inducedearthquake人类活动引发的地震,主要包括矿山诱发地震和水库诱发地震.
[GB/T18207.
2-2005,定义3.
1.
2]陷落地震collapseearthquake由于地下岩层陷落引起的地震.
[GB/T18207.
2-2005,定义3.
1.
3]地震参数seismicparameter描述地震基本特征的物理量.
包括发震时刻、震中位置、震源深度和震级.

[改自GB/T18207.
2-2005,定义3.
1.
9、GB17740-2017,定义2.
16]地震烈度seismicintensity地震引起的地面震动及其影响的强弱程度.
[GB/T17742-2008,定义2.
1]地震服务信息earthquakeserviceinformation在决策、公众和专业地震服务中向政府、社会和生产部门提供的地震信息.

注:地震服务信息数据格式类别包括文本、数据、图片等.
JSONJavaScriptObjectNotation是一种基于JavaScriptProgrammingLanguage轻量级的数据交换格式.
统一资源定位符URLUniformresourelocator对可以从互联网上得到的资源的位置和访问方法的一种简洁的表示.
访问方法访问地址地震服务数据接口访问地址应采用统一资源定位符(URL).
URL中的服务器地址宜采用域名,不宜采用IP地址.

访问步骤地震服务数据接口按以下步骤访问:用户应通过地震服务数据接口单位提供的地震服务数据系统平台(以下简称"平台")申请注册用户和密码.
或应由地震服务数据接口单位给用户在平台上创建用户和密码.

用户应通过用户名和密码登陆平台,申请地震服务数据接口访问账号APPID和地震服务数据接口访问密钥Key(Key应具有有效期,有效期内用户可重复使用,超过有效期系统为用户重新生成Key值);用户通过用户名和密码登陆平台,获取地震服务数据接口资源访问地址;用户应在地震服务数据资源地址中加入APPID和Key,形式为"&appid=&Key",生成服务资源请求地址;用户采用HTTP协议中的POST方法调用地震服务数据资源请求地址,获取返回结果.

服务请求服务请求字符串编码服务数据请求字符串编码宜采用UTF-8字符集.
服务请求参数时间参数时间参数应使用中华人民共和国北京时间,宜采用YYYY-MM-DDHH:mm:ss的格式.
其中,YYYY表示年(4位),MM表示月(2位),DD表示日(2位),HH表示小时(2位,24小时制),mm表示分钟(2位),ss表示秒钟(2位).
年月日必须使用短横线(-)为分隔符分隔,时分秒必须使用冒号(:)为分隔符分隔,年月日与时分秒间间隔一个或一个以上空格.

[改写GB/T22568-2008,发布要求4.
2.
1.
2]位置参数位置参数,根据公共地震信息发布的地震事件发布要求,采用以下编码:地震地点参数:应提供地震震中的地理经纬度.
地理经纬度宜采用东(西)经XXX.
XX度,北(南)纬XX.
XX度格式.
其中经度严格按照XXX.
XX(整数3位,小数2位);纬度XX.
XX(整数2位,小数2位).

[改写GB/T22568-2008,发布要求4.
2.
1.
3]深度参数宜采用XXXkm格式(整数最多3位).
[改写GB/T22568-2008,发布要求4.
2.
1.
5]震级参数震级参数应使用GB17740-1999中规定的地震震级M.
宜采用X.
X级格式(整数1位,小数1位).
[改写GB/T22568-2008,发布要求4.
2.
1.
4]请求字符串的组成服务请求字符串应包含服务请求参数、访问密钥等信息,不应包含明文密码等敏感信息.

服务响应返回格式地震服务数据接口宜以JSON格式返回结果(JSON格式示例见附录A).
返回结果应包括响应代码、响应消息和数据体三部分.
其中:响应代码resCode格式宜为整数型(响应代码见附录B);响应消息resMsg格式宜为字符型,返回内容应为响应代码resCode的详细说明(响应消息见附录B);数据体data格式宜为数组型,返回内容应为地震服务数据的具体描述.
返回结果编码返回结果编码宜采用UTF-8字符集.
授权机制用户授权要求地震服务数据接口宜通过加密算法对用户进行授权.
用户授权算法宜将接口请求参数按照顺序拼接成字符串,加上时间戳(格式为YYMMDD)形成新的字符串,对新字符串中的MD5消息摘要算法的32位加密,形成Key值.

其中,YYYY表示年(4位),MM表示月(2位),DD表示日(2位).
效能要求并行性地震服务数据接口应提供多用户并行访问支持.
响应时间地震服务数据接口响应时间应小于500ms.
接口说明地震服务数据接口单位应提供接口说明,并应与地震服务数据接口一起提交用户使用.

接口说明应包括地震服务数据接口描述、调用请求方式、参数说明、常用参数代码等内容,并给出数据接口调用示例代码(数据接口说明见附录C).

附录A(资料性附录)JSON格式示例JSON格式:{"resCode":"…","resMsg":"…","data":{[……]}}JSON格式返回数据示例见表B.
1.
表B.
1JSON格式返回数据示例名称数据类型说明resCode整数型Int响应代码resMsg字符型String响应消息data数组型Array数据体附录B(资料性附录)响应代码及响应消息响应代码及响应消息见表B.
1表B.
1响应代码及响应消息序号响应代码响应消息1000获取成功2101APPID不存在或Key错误3102接口权限不足4103服务不存在5104非法请求6105APPID当前被禁用7106账号未登录8201APPID、Key不能为空9202参数不足10203参数含非法字符11204参数错误12205账号不存在或密码错误13302数据解析出错14303资源不存在15304配置解析出错16305资源服务器异常17306数据库异常18401未知异常附录C(资料性附录)地震服务数据接口说明示例地震服务数据接口说明见表C.
1(以山西太原市阳曲县M1.
3地震地震参数为例).