ICS07.060 CCS A 47 GB 中华人民共和国国家标准 GB/T42877-2023 气象数据服务接口规范 Service interface specification for meteorological data 2023-08-06发布 2023-12-01实施 国家市场监督管理总局 国家标准化管理委员会 发布 GB/T42877-2023 目 次 前言 工 1范围 1 2规范性引用文件 1 3术语和定义1 4接口组成 2 5接口名称 2 6接口参数 7返回码 4 8返回数据结构 4 9证实方法 5 附录A(资料性)气象数据服务接口示例6 附录B(规范性)接口参数定义 11 附录C(规范性)返回码取值含义 20 附录D(规范性)返回数据结构 21 参考文献 31 GB/T42877-2023 前言 本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草. 请注意本文件的某些内容可能涉及专利.本文件的发布机构不承担识别专利的责任. 本文件由中国气象局提出. 本文件由全国气象基本信息标准化技术委员会(SAC/TC346)归口. 本文件起草单位：国家气象信息中心、广东省气象探测数据中心、四川省气象探测数据中心、陕西气 象信息中心、内蒙古自治区气象信息中心、华云信息技术工程有限公司. 本文件主要起草人：何文春、高峰、徐拥军、王琦、倪学磊、孙周军、宋智、何林、温建伟、郑波、刘媛媛. I GB/T42877-2023 气象数据服务接口规范 1范围 本文件规定了气象数据服务接口的组成、名称、参数、返回码与返回数据结构，并描述了对应的证实 方法. 本文件适用于气象数据服务接口的设计开发、调取应用和气象数据的提供、使用. 2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款.其中，注日期的引用文 件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括的修改单）适用于 本文件. GB/T2260一2007中华人民共和国行政区划代码 GB/T2659一2000世界各国和地区名称代码 GB/T40153一2021气象资料分类与编码 QX/T37一2020气象台站历史沿革数据文件格式 QX/T202一2013表格驱动码气象数据传输文件规范 QX/T327一2016气象卫星数据分类与编码规范 QX/T378一2017公共气象服务产品文件命名规范 3术语和定义 下列术语和定义适用于本文件. 3.1 气象数据meteorological data 使用各种观测、探测手段获取的地球表面和地球大气的状态、现象及其变化过程的记录，以及以此 为基础，通过各种技术方法进行加工处理生成的各类衍生和加工产品. [来源：GB/T40153一2021 3.1，有修改] 3.2 [服务]接口service interface 信息系统为开放特定业务功能而发布的可供其他系统调用的应用编程函数. 3.3 数据类别data category 具有共同属性（或特征）的数据的集合. [来源：GB/T38667一2020 3.9，有修改] 3.4 返回码return code 服务接口调用后返回的、用以标识调用成功与否和错误原因等信息的状态码. 注：一般用一个数字表示， GB/T42877-2023 3.5 返回数据结构structure for returned data 服务接口调用后返回的内存对象的数据组织方式. 3.6 序列化serialization 将计算机内存对象转换为可保存或传输的数据格式的过程. 注：保存或传输的数据格式一般有XML、JSON、JSONP、TEXT、HTML等. 4接口组成 4.1接口应由4部分组成： a)接口名称：表达数据访问的具体功能； b)接口参数：表达数据访问的输入条件； c)返回码：表达数据访问的调用状态； d)返回数据结构：表达返回数据的内存对象结构. 4.2一个接口可有一个或多个参数，每个参数应明确为必选或可选.接口示例见附录A 接口参数定 义、返回码取值和返回数据结构应分别符合附录B、附录C和附录D的规定. 5接口名称 5.1接口名称应由4部分组成：接口功能、数据类别、数据内容、主要条件.其中，接口功能、数据类别、 数据内容不应为空，主要条件可为空. 5.2接口名称宜采用小驼峰命名法”，命名格式为：{接口功能}{数据类...
GB/T 42877-2023 气象数据服务接口规范.pdf
