English 联系我们
中国气象数据网APP
微信
中国气象数据网
微信号
扫一扫,立刻关注
我的数据筐 注册登录
API使用说明
API说明
  气象API服务以Restful WebServices的方式提供,对于要素型数据以Json格式直接返回,对于文件型数据以Json格式返回文件清单列表,通过文件清单的文件URL进行文件下载。
  温馨提示:
    1、气象API服务只针对个人实名注册用户、单位实名注册用户、教育科研实名注册用户,暂不针对普通注册用户。如果您是普通注册用户,请先在用户中心的“我的个人信息”中升级您的用户到个人实名注册用户或教育科研实名注册用户。
    2、每类资料的API服务仅提供一次免费7天使用,供您接口调用调试与验证。
    3、时间、时次没有明确说明的,都是以世界时(GMT)为标准。
    4、要素没有明确说明的,缺测为999999,无观测为999998。
  如果您在使用气象API过程遇到问题,欢迎请您通过电话(86-10-68407499)、邮件(data@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为温度(气温)
  返回结果为:
{"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、全球高空气象站定时值资料
4、基本反射率图像产品
5、组合反射率图像产品
6、垂直累积液态水含量图像产品
7、1小时累计降水图像产品
8、T639全球中期天气数值预报系统模式产品
9、GRAPES_MESO中国及周边区域数值预报产品
扫码登录
账户登录
二维码失效
点击刷新
登录手机中国气象数据网扫描二维码
立即注册 更快 更安全
我的订单
我的数据筐
我的收藏
用户反馈
在线客服
返回顶部