API说明
气象API服务以Restful WebServices的方式提供,对于要素型数据以Json格式直接返回,对于文件型数据以Json格式返回文件清单列表,通过文件清单的文件URL进行文件下载。
温馨提示:
1、气象API服务只针对个人实名注册用户、单位实名注册用户、教育科研实名注册用户,暂不针对普通注册用户。如果您是普通注册用户,请先在用户中心的“我的个人信息”中升级您的用户到个人实名注册用户或教育科研实名注册用户。
2、每类资料的API服务仅提供一次免费7天使用,供您接口调用调试与验证。
3、时间、时次没有明确说明的,都是以世界时(GMT)为标准。
4、要素没有明确说明的,缺测为999999,无观测为999998。
如果您在使用气象API过程遇到问题,欢迎请您通过电话(86-10-68407499)、邮件(datacenter@cma.gov.cn)、中国气象数据网 (http://data.cma.cn)页面的用户反馈与我们联系。
1、气象API服务只针对个人实名注册用户、单位实名注册用户、教育科研实名注册用户,暂不针对普通注册用户。如果您是普通注册用户,请先在用户中心的“我的个人信息”中升级您的用户到个人实名注册用户或教育科研实名注册用户。
2、每类资料的API服务仅提供一次免费7天使用,供您接口调用调试与验证。
3、时间、时次没有明确说明的,都是以世界时(GMT)为标准。
4、要素没有明确说明的,缺测为999999,无观测为999998。
如果您在使用气象API过程遇到问题,欢迎请您通过电话(86-10-68407499)、邮件(datacenter@cma.gov.cn)、中国气象数据网 (http://data.cma.cn)页面的用户反馈与我们联系。
调用示例
1、要素型数据调用
例如,您需要调用2017年7月5日3时(GMT)的北京站(54511)的中国地面气象站逐小时观测资料的温度要素,您可以调用如下接口(传入参数没有先后顺序):
其中,userId,pwd:分配给您的帐号和密码,从订单中获取
dataFormat:返回的数据格式,目前仅支持json格式
interfaceId:此数据的接口ID,值为getSurfEleByTimeRangeAndStaID
dataCode:此数据的编码,中国地面气象站逐小时观测资料的编码为SURF_CHN_MUL_HOR
timeRange:时间范围,支持最近7天的数据访问,格式为“[YYYYMMDDHHMISS,YYYYMMDDHHMISS]”,2017年7月5日3时(GMT)格式为[20170705030000,20170705030000]
staIDs:站号,支持1-30个站点,多个站点之间以“,”分隔,北京站(54511)的站号为54511
elements:返回数据字段,多个字段之间使用“,”分隔,其中:Station_Id_C, Year,Mon,Day,Hour为默认字段,Station_Id_C为站号,Year为资料时间的年,Mon为资料时间的月,Day为资料时间的日,Hour为资料时间的时,TEM为温度(气温)
返回结果为:
fieldNames为返回的要素清单,fieldUnits为返回的要素单位清单。
DS为返回数据的内容,包括字段和值,其中Station_Id_C为站号,Year为资料时间的年,Mon为资料时间的月,Day为资料时间的日,Hour为资料时间的时,TEM为温度(气温)。
其中,userId,pwd:分配给您的帐号和密码,从订单中获取
dataFormat:返回的数据格式,目前仅支持json格式
interfaceId:此数据的接口ID,值为getSurfEleByTimeRangeAndStaID
dataCode:此数据的编码,中国地面气象站逐小时观测资料的编码为SURF_CHN_MUL_HOR
timeRange:时间范围,支持最近7天的数据访问,格式为“[YYYYMMDDHHMISS,YYYYMMDDHHMISS]”,2017年7月5日3时(GMT)格式为[20170705030000,20170705030000]
staIDs:站号,支持1-30个站点,多个站点之间以“,”分隔,北京站(54511)的站号为54511
elements:返回数据字段,多个字段之间使用“,”分隔,其中:Station_Id_C, Year,Mon,Day,Hour为默认字段,Station_Id_C为站号,Year为资料时间的年,Mon为资料时间的月,Day为资料时间的日,Hour为资料时间的时,TEM为温度(气温)
返回结果为:
{"returnCode":"0","returnMessage":"Query Succeed","rowCount":"1","colCount":"6","requestParams":"datacode=SURF_CHN_MUL_HOR&staids=54511&timerange=[20170705030000,20170705030000]&elements=Station_Id_C,Year,Mon,Day,Hour,TEM","requestTime":"2017-07-07 01:48:22","responseTime":"2017-07-07 01:48:22","takeTime":"0.014","fieldNames":"区站号(字符) 年 月 日 时 温度/气温","fieldUnits":"- 年 月 日 时 摄氏度(℃)","DS":[{"Station_Id_C":"54511","Year":"2017","Mon":"7","Day":"5","Hour":"3","TEM":"29.7"}]}
其中,returnCode为返回结果编码,0为成功,其他为失败;returnMessage为返回结果描述;rowCount 为返回数据的行数;colCount 为返回数据的列数;requestParams为请求参数;requestTime为请求时间;responseTime为请求返回时间;takeTime为执行所花费的时间(毫秒)。fieldNames为返回的要素清单,fieldUnits为返回的要素单位清单。
DS为返回数据的内容,包括字段和值,其中Station_Id_C为站号,Year为资料时间的年,Mon为资料时间的月,Day为资料时间的日,Hour为资料时间的时,TEM为温度(气温)。
2、文件型数据调用
API清单
1、中国地面气象站定时值观测资料
2、全球高空基本气象观测数据
3、天气雷达组网组合反射率图像产品