标准规范下载简介
QX/T 618-2021 气象数据服务接口规范.pdfICS07.060 CCS A 47
Service interface specification for meteorological data
范围 规范性引用文件 术语和定义 接口组成 接口名称 接口参数 返回码 返回数据结构 附录A(资料性) 接口示例, 附录B(规范性) 常用接口参数定义 附录C(规范性) 常用返回码定义 附录D(规范性) 返回数据结构 参考文献
11#楼地下室基础施工方案QX/T 6182021
本文件按照GB/T1.1一2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由全国气象基本信息标准化技术委员会(SAC/TC346)提出并归口。 本文件起草单位:国家气象信息中心、广东省气象探测数据中心、四川省气象探测数据中心、内蒙古 气象信息中心、陕西气象信息中心。 本文件主要起草人·何文春、高峰、孙周军、宋智、徐拥军、王琦、温建伟、倪学磊、何林
本文件按照GB/T1.1一2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由全国气象基本信息标准化技术委员会(SAC/TC346)提出并归口。 本文件起草单位:国家气象信息中心、广东省气象探测数据中心、四川省气象探测数据中心、内蒙古 气象信息中心、陕西气象信息中心。 本文件主要起草人:何文春、高峰、孙周军、宋智、徐拥军、王琦、温建伟、倪学磊、何林
本文件规定了气象数据服务接口的组成、名称、参数、返回码和返回数据结构。 本文件适用于气象数据服务接口的设计、开发和应用
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文 件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于 本文件。 GB/T2260—2007 中华人民共和国行政区划代码 GB/T2659—2000 世界各国和地区名称代码 QX/T37—2020 气象台站历史沿革数据文件格式 QX/T102—2009 气象资料分类与编码 QX/T202—2013 表格驱动码气象数据传输文件规范 QX/T327—2016 气象卫星数据分类与编码规范 OX/T3782017 公共气象服务产品文件盒名规范
下列术语和定义适用于本文件。 3.1 气象数据 meteorologicaldata 对使用各种观、探测手段获取的大气状态、现象及其变化过程的记录以及各类衍生资料进行通信、 解释和处理而使用的信息的形式化表示。 3.2 服务接口 serviceinterface 3.3 返回码returncode 接口调用后返回的,用以标识调用成功与否、错误原因等信息状态码 注:一般用一个数字表示。 3.4 返回数据结构 structure for returned data 内存对象的数据结构
QX/T618—20213.5序列化serialization将计算机内存对象转换为可保存或传输的数据格式的过程。注:序列化的格式一般有XML、JSON、JSONP、TEXT、HTML等,3.6小驼峰命名法LowerCamelCase软件编程中的一套命名规则(惯例)注:变量名或函数名由一个或多个单词连结而成,单词间没有分隔符,第一个单词的字母均为小写,从第二个单词开始以后的每个单词的首字母大写、其余字母小写。4接口组成4.1接口由4部分组成:接口名称、接口参数、返回码、返回数据结构。其中,接口名称表达数据访问的具体功能,接口参数表达数据访问的输入条件,返回码表达数据访问的调用状态,返回数据结构表达返回数据的内存结构4.2一个接口可以有一个或多个参数,每个参数应明确为必选或可选。4.3接口示例见附录A。5接口名称5.1接口名称由4部分组成:接口功能、资料类型、数据内容、主要条件,其中接口功能、资料类型、数据内容不可为空,主要条件可为空。5.2接口名称采用小驼峰命名法,命名格式为:(接口功能)《资料类型)《数据内容》(主要条件)。5.3各组成部分的取值规则应符合表1的规定。表1接口名称各组成部分的取值规则组成部分代码含义备注get检索气象数据、元数据等接口功能接口功能及其取值可按需扩展stat统计气象数据Surf地面气象资料Upar高空气象资料Ocen海洋气象资料Radi气象辐射资料Agme农业气象和生态气象资料资料类型Nafp数值预报产品参照QX/T102—2009的5.1Cawn大气成分资料Hpxy历史气候代用资料Disa气象灾害资料Rada天气雷达资料Sate卫星气象资料2
表1接口名称各组成部分的取值规则(续)
接口参数分为6类。其中,5类用于限定资料范围,分别按照资料的种类、要素、时间、空间、特殊 5个主要维度进行定义;1类用于定义其他接口参数。参数类别及其描述的输人条件应符合表2 正
嘉兴市名典公寓施工组织设计表2参数类别及其描述的输入条件
6.2.1参数的定义由6部分组成:名称、含义、赋值类型、赋值格式、赋值示例、使用说明,其中,名称采 用小驼峰命名法;赋值类型指整数、浮点数、字符串等编程语言的数据类型 6.2.2气象数据访问常用接口参数定义应符合附录B的规定。除此之外的参数可根据需要参照常用 参数的定义进行扩展。
QX/T 6182021
返回码分为2类,即成功和失败。
7.2.1返回码的定义由2部分组成:返回码取值和含义。 7.2.2成功类的返回码取值为0。失败类的返回码取值为负数,取值规则为一《错误类别代码>顺序 号)。其中,错误类别代码及名称应符合表3的规定,顺序号为3位数字,从001开始, 7.2.3常用返回码定义应符合附录C的规定。除此之外的返回码可按需、参照常用返回码的定义进 行扩展。
表3错误类别代码及名称
8.1服务接口返回数据的结构分为3类:站点类、格点类和信息类,结构及其适用数据范围应符合表4 的规定。
8.2返回数据结构的具体描述分别符合附录D中D.2、D.3和D.4的规定外墙斩假石抹灰工程施工工艺标准,均使用2种形式进行表达: 内存对象结构和序列化格式
8.2返回数据结构的具体描述分别符合附录D中D.2、D.3和D.4的规定,均使用2种形式进行表达: 内存对象结构和序列化格式