气象数据统一服务接口（MUSIC）简介

气象数据统一服务接口（MUSIC：Meteorological Unified Service Interface Community），基于国省统一的数据环境（CIMISS），面向气象业务和科研，提供全国统一、标准、丰富的数据访问服务和应用编程接口（API），为国、省、地、县各级应用系统提供唯一权威的数据接入服务。

1、强大的服务功能。访问接口提供全面的数据获取功能，包括：站点资料的检索、统计，格点资料的解析、裁剪和抽取，文件产品的查询、下载，台站信息的检索等。此外，不断发展和提供丰富的计算和应用服务，包括：历年同期的统计服务，等值线和色斑图的制作服务，历史数据统计分析服务，等等。

2、多样的服务方式。针对气象应用系统，提供多种不同的服务方式，包括客户端调用服务、web service、REST服务和脚本服务。其中，客户端调用主要面向大数据量的获取，提供高效的数据传输，如数值预报系统；web service和REST服务主要针对前台交互应用，提供便捷的编程体验，如气象业务内网；脚本调用主要服务于非编程人员，不用编程即可获取数据，如科研用户。

3、跨平台、多语言的开发支持。web service、REST服务支持所有平台和语言的调用。客户端调用服务和脚本服务，支持主流的操作系统，包括Linux 32/64bit、AIX、HP-UX、Windows 32/64bit等，提供多种语言的客户端开发包，包括C#、Java、C/C++、Fortran、PHP、Python等。

4、极度精简、稳定不变的客户端。客户端开发包，主要实现检索参数传入和数据结果返回的功能，不具备其他业务逻辑，访问接口的功能扩展只在服务端进行，不会影响客户端，因此，可以保证用户业务系统的连续和稳定，访问接口功能的增强对用户完全透明。

5、标准的调用方法。针对不同的服务方式，共提供9个标准的调用方法。其中，用户使用调用方法，选择合适的接口、资料和返回格式，来获取气象数据。

服务方式	调用方法ID	调用方法名称	返回数据格式	适用资料
客户端调用	callAPI_to_array2D	获取二维（站）点数据	站点资料结构体/类（ RetArray2D）	站点资料、格点资料(抽取点)、台站信息
	callAPI_to_gridArray2D	获取二维格点场数据	格点资料结构体/类（RetGridArray2D）	格点资料(场数据)
	callAPI_to_saveAsFile	获取检索结果并存入文件	文件信息结构体/类（ RetFilesInfo） + 数据文件	站点资料、格点资料(点/面)、台站信息
	callAPI_to_downFile	下载服务端文件	文件信息结构体/类（ RetFilesInfo） + 数据文件	文件产品（雷达、卫星、数值预报等）
	callAPI_to_fileList	获取文件列表信息	文件信息结构体/类（ RetFilesInfo）	文件产品（雷达、卫星、数值预报等）
	callAPI_to_serializedStr	获取序列化的字符串结果	String（序列化的）	站点资料、格点资料(点/面)、台站信息、文件产品(文件URL等信息)
web service	callAPI_to_serializedStr	获取序列化的字符串结果	String（序列化的）	站点资料、格点资料(点/面)、台站信息、文件产品(文件URL等信息)
	callAPI_to_array	获取二维字符串结果	Array（无描述信息）	站点资料、格点资料(点/面)、台站信息、文件产品（雷达、卫星、数值预报）
REST服务	rest	获取序列化的字符串结果	String（序列化的）	站点资料、格点资料(点/面)、台站信息、文件产品(文件URL等信息)
调用脚本	（脚本配置）	获取文件	文件	站点资料、格点资料(点/面)、台站信息、文件产品（雷达、卫星、数值预报等）

6、多种选择的返回格式。支持内存对象（结构体/类对象）、序列化字符串（XML/JSON/HTML/TEXT等）、数据文件（XML/JSON/HTML/TEXT等）、以及GIS数据格式（KML）、等等，以满足不同的应用需求和编程习惯。其中，内存对象和数据文件，只在客户端开发包中提供，适用于大数据量的获取和计算；序列化字符串，适用于数据的快速解析和前端显示应用；GIS数据格式，适用于GIS叠加显示分析。

7、可配置、针对业务的访问接口。每个访问接口，都是针对一个具体应用场景而定义：在后台，通过配置，设置其参数，匹配适用的资料种类，即可发布使用。目前已配置217个访问接口。用户在API网页上没有找到自己所需的接口时，即可联系数据服务人员，由其配制出一个新的接口提供服务。供接口选择的参数是系统预先定义的，涵盖各种检索条件，目前共有88个。

8、丰富的气象资料和产品。 CIMISS管理的所有资料，均可通过访问接口提供服务，目前包括：地面资料28种 、高空资料21种 、海洋资料 4种 、辐射资料 3种 、农气资料 29种 、数值模式 39种 、大气成分 10种 、历史代用 0种 、气象灾害 0种、雷达资料 110种 、卫星资料 159种 、科考资料 0种 、服务产品 17种 、台站信息等其它资料 5种。

9、详细的资料说明。针对每个资料，描述其时间序列、要素清单。尤其是针对模式产品，详细描述其预报时次、预报时效、统计时段、格网信息、预报要素及其层次信息等。

10、丰富的示例代码。针对每一个编程语言、每一种服务方式、每一个服务功能、每一个返回格式，都编制发布详细的示例代码和示例结果。此外，针对每个语言，都发布一个完整的DEMO工程，汇集所有的示例代码和常用工具方法，供用户直接加载和使用。

11、详细的标识代码信息。标识代码，是指针对某类气象要素，使用特定的一组数值，表示其取值意义。如，高空垂直探测意义中，65536表示标准层，32768表示对流层顶，等等。标识代码，对于用户认识数据的具体含义、以及设置API的检索条件中，都非常重要。统一访问接口目前整理了75类要素的标识代码，而且按需在不断补充中。

12、支持异构、不同存储技术的多源数据库。不同形态的气象资料，适用于不同的存储技术，CIMISS正在发展多种存储技术相结合的存储系统。访问接口，通过实现不同存储技术的适配器，接入多种不同的数据库，提供统一服务，目前支持的数据库包括：oracle数据库、分布式关系型数据库、NetCDF文件库等。

13、新技术的应用，极大提升服务时效。统一访问接口，使用redis内存数据库做缓存，提高了接口处理速度；使用ICE作为客户端调用的通信中间件，提供高效的数据传输；在web service之外，发布了更轻量级的REST服务，极大地降低了使用门槛、提高了编程体验。目前，访问接口支持50+并发的常用应用场景的数据获取。

14、国省联合开发，开放式发展建设。统一访问接口，于2014年4月启动全新改版，自主研发，国省信息中心技术人员联合建设，目前发布V1.4版本。在接口的持续发展中，将继续贯彻国省联合开发的模式，并建立开源社区，汇集全国的技术力量，开放式发展。

了解接口
一、接口简介
气象数据统一服务接口，基于国省统一的数据环境（CIMISS），提供全面的数据获取功能，包括：站点资料的检索、统计，格点资料的解析、裁剪和抽取，文件产品的查询、下载，台站信息的检索等。此外，不断发展和提供丰富的计算和应用服务，包括：历年同期的统计服务，等值线和色斑图的制作服务，历史数据统计分析服务，等等。

二、应用接入流程

三、接入流程说明
1、了解与选择资料
根据自己应用将实现的功能，明确应用所需的资料，然后在接口网站【气象资料】栏目中查找资料。气象资料分为14大类，14大类下面是具体的气象资料，其中台站信息归入“其它资料”中。点击感兴趣的资料，可在页面右边查看该资料的时间序列和要素清单。

点击“接口列表”，查看可调用该资料的接口清单。选择某个接口，进入接口的详细说明页面（即：2、了解资料接口）。

2、了解资料的接口
如果您的应用所需的资料存在于CIMISS环境中，如何获取资料将成为您关注的对象。资料接口是用户从CIMISS环境中获取资料的通道，每类资料根据常用的场景配置了相应的接口。当您需要获取某时刻的地面资料时，您可使用按时间检索地面数据要素（getSurfEleByTime）的接口。在调用接口前要先看接口参数描述中的参数的赋值方式、参数是否为必选，以及接口对资料检索时间的限制条件等信息。

3、查看示例代码
点击“示例代码”，获取该类接口的支持的开发模式与语言、不同的返回对象的编程示例以及相应的示例结果。

更多的使用示例参考使用示例页面。

4、申请API账号
在线注册申请。
步骤一：快速注册一个网站用户，无需审核即可登录。
步骤二：网站用户登陆后，在“用户空间”中申请一个或多个API账户。API账户，经管理员审核后，状态变为“审核通过”，方可使用。

5、选择开发模式与语言
目前支持客户端、REST、Web Service三种服务方式，支持JAVA、C#、C/CPP、PHP、Python等语言。
其中，客户端调用主要面向大数据量的获取，提供高效的数据传输，如数值预报系统；Web Service和REST服务主要针对前台交互应用，提供便捷的编程体验，如气象业务内网。
采用Web Service与REST方式开发程序，不需要下载SDK包。采用Web Service只需在服务器上获取wsdl服务，比如http://DNS/cimiss-web/services/ws?wsdl，注DNS为：（DNS列表内容），REST只需从服务器上获取服务action，比如http://DNS/cimiss-web/api?paramas，注DNS为：（DNS列表内容），params为检索接口参数。

序号	DNS
1	10.20.76.55:80

6、下载SDK与DEMO
SDK是支持C/S开发的客户端开发包，其中包含了数据请求、数据解析、数据高效传输等必要的功能。
DEMO为开发使用接口示范工程，DEMO工程中包含客户端、REST、Web Service三种开发模式。依据选择的开发语言下载相应的DEMO工程，配置相应的服务器ip与申请的API账户即可执行。
SDK与DEMO在【客户端&文档】页面下载。

7、开发应用程序
参考DEMO程序，从API网站选择合适的资料与相应的接口，开发应用程序。

ps：

1.接口的调用方法

2.返回的数据格式