DB37/T 2930-2017 气象服务信息数据接口规范

ICS07.060

A47

DB37

山东省地方标准

DB37/T2930—2017

气象服务信息数据接口规范

Specificationforweatherserviceinformationdatainterface

2017-02-21发布2017-03-21实施

山东省质量技术监督局发布

DB37/T2930—2017

目次

前言................................................................................II

1范围..............................................................................1

2规范性引用文件....................................................................1

3术语和定义........................................................................1

4访问方法..........................................................................2

5授权机制..........................................................................4

6效能要求..........................................................................4

7接口说明..........................................................................4

附录A（资料性附录）JSON格式和XML格式示例.........................................5

附录B（资料性附录）返回码清单......................................................6

附录C（资料性附录）天气预报编码....................................................8

附录D（资料性附录）接口说明示例...................................................10

参考文献............................................................................11

I

DB37/T2930—2017

前言

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

本标准由山东省气象标准化技术委员会（鲁TC16）提出并归口。

本标准起草单位：山东省气象服务中心。

本标准主要起草人：周雪松、李玉华、褚希、徐彩艳、任广治、张鹏、姚蔚、石春玲。

II

DB37/T2930—2017

气象服务信息数据接口规范

1范围

本标准规定了气象服务信息的访问方法、授权机制、效能要求和接口说明。

本标准适用于气象行业和相关气象服务信息应用单位或个人进行气象服务信息系统的设计、研发和

维护。

2规范性引用文件

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

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

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

RFC2616超文本传输协议（HypertextTransferProtocol）

3术语和定义

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

3.1

域名系统DNSdomainnamesystem

因特网上作为域名和IP地址相互映射的一个分布式数据库，能够使用户更方便的访问互联网，而不

用去记住能够被机器直接读取的IP数串。

3.2

可扩展标记语言XMLextensiblemarkuplanguage

一种用于标记电子文件使其具有结构性的标记语言。

注：可从以下网址获得：（/TR/REC-xml/）。

3.3

JavaScript对象表示法JSONjavascriptobjectnotation

一种基于Javascript的轻量级数据交换格式。

3.4

统一资源定位符URLuniformresourelocator

对可以从互联网上得到的资源的位置和访问方法的一种简洁的表示。

3.5

表述性状态转移RESTrepresentationalstatetransfer

1

DB37/T2930—2017

一组架构约束条件和原则，通常基于使用HTTP、URI、XML以及HTML这些现有的广泛流行的协议和标

准，根据这些原则设计以系统资源为中心的Web服务。

注：包括使用不同语言编写的客户端如何通过HTTP处理和传输资源状态。

3.6

气象服务信息weatherserviceinformation

在决策、公众和专业气象服务中向政府、社会和生产部门提供的信息。

注：气象服务信息数据格式类别包括文本、数字、图片、视频等。

4访问方法

4.1访问方式

对气象服务信息的访问对应唯一的资源标识符（URL网址），应采用RFC2616中的HTTP协议的GET

方式进行。

服务请求字符串及返回结果编码宜采用RFC3629/STD63（2003）定义的UTF-8字符集。如使用其他

字符集，应在返回结果中标明。

4.2访问步骤

4.2.1需授权气象服务信息数据资源访问步骤

对于需要授权的气象服务信息数据接口（即需要用户认证的服务），访问步骤如下：

a)身份认证并获取授权：通过平台注册用户申请相关服务资源，经审核后获取合法授权（用户名

密码、IP认证或Key值）；

b)获取服务资源地址：通过平台获取气象服务信息数据接口资源访问地址；

c)构建加密服务资源的访问地址：在气象服务信息数据访问接口资源地址上加入用户名和密码或

Key值参数，形式为“&username=<username>&password=<password>”或“&key=<key>”，生

成新的服务网址（经过IP认证的用户可以直接访问）；

d)服务资源访问：通过加密的气象信息服务资源访问地址访问气象服务信息，获取返回结果。

4.2.2不需授权气象服务信息数据资源访问步骤

对于不需要授权的气象服务信息数据接口（即不需要用户认证的服务），访问步骤如下：

a)获取服务资源地址：通过平台获取气象服务信息数据接口资源访问地址；

b)服务资源访问：通过气象信息服务资源访问地址访问气象信息服务，获取返回结果。

4.3服务请求

4.3.1请求字符串的组成

服务请求字符串应包含数据接口地址，可包含应用识别码、请求参数、授权码等部分。

4.3.2数据接口地址

数据接口地址按照RFC1738中URL的有关规定编写。其中，主机地址宜采用域名，不宜采用IP地址。

23页。

4.3.3应用识别码

2

DB37/T2930—2017

每个数据接口服务应由数据接口地址标识，如数据接口地址相同则需另加应用识别码组成唯一标

识。

应用识别码应保持唯一性，并标明服务请求的具体气象服务信息。

4.3.4服务请求参数

参数可包含位置、时间、气象信息服务数据种类等信息。

位置参数可采用下列四种编码之一：

a)中华人民共和国行政区划代码，区划代码符合GB/T2260有关规定；

b)气象站标识；

c)经纬度信息；

d)其他约定的位置编码。

时间编码可采用下列两种编码之一：

a)字符型时间，格式为yyyymmddHHiiss，如20140926160150，其中yyyy表示4位年，mm表示

两位月，dd表示两位日，HH表示两位时，ii表示两位分，ss表示两位秒；

b)unix时间戳，为1970年1月1日00：00：00至当前时间的总秒数。例如当前时间为：2014-09-26

16:01:50，对应的时间戳：1411718510。

服务请求参数字符串按照下列规则拼装：

a)当请求参数为一个要素时，应直接给出要素编码；

b)当请求参数为两个以上要素时，要素间采用分隔符进行分割，宜使用日常符号，如“|”、“,”

等，不应使用URL标准已经规定有特殊用途的符号，如“+”、“&”等；

c)当请求参数为时间段时，时间段使用数学区间表示的方法，且应使用下列四种表示方法：

•前开后开：(yyyymmddHHiiss,yyyymmddHHiiss)；

•前开后闭：(yyyymmddHHiiss,yyyymmddHHiiss]；

•前闭后开：[yyyy