国家气象信息中心-中国气象数据网

English 联系我们
中国气象数据网APP
气象实况APP
气象实况小程序
微信
中国气象数据网
微信号
扫一扫,立刻关注
开通PLUS会员
PLUS会员是为用户打造的增值服务,满足用户高需求。开通PLUS会员后,用户可享有如下功能和特权,如想了解更多PLUS会员服务内容,请点击PLUS会员首页(http://data.cma.cn/plus/index.html)
  • 更高下载权限
  • 成长加速
  • 更多数据产品
  • 极速下载
  • 数据订阅
  • 优先体验新功能
注册 登录
[フレーム]
API使用说明
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、要素型数据调用

例如,您需要调用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":"- 年 月 日 时 摄氏度(°C)","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、文件型数据调用

例如,您需要调用2017年7月6日10:00到10:06(GMT)时次的北京大兴(Z9010)的雷达基本反射率图像产品,您可以调用如下接口(传入参数没有先后顺序):
其中,userId,pwd:分配给您的帐号和密码,从订单中获取
dataFormat:返回的数据格式,目前仅支持json格式
interfaceId:此数据的接口ID,值为getRadaPUPByTimeRangeAndStaID
dataCode:此数据的编码,雷达基本反射率图像产品的编码为RADA_L3_ST_REF_GIF
timeRange:时间范围,支持最近7天的数据访问,格式为"[YYYYMMDDHHMISS,YYYYMMDDHHMISS]",2017年7月6日10:00到10:06(GMT)格式为[20170706100000,20170706100600]
staIDs:站号,支持单站点,北京大兴(Z9010)的站号为Z9010
elements:返回数据字段,多个字段之间使用","分隔,其中: Station_Id_C为站号,DATETIME为资料时间,FORMAT为文件格式,FILE_NAME为文件名
返回的结果为:
{"returnCode":"0","returnMessage":"Query Succeed","fileCount":"2","colCount":"8","requestParams":"datacode=RADA_L3_ST_REF_GIF&staids=Z9010&timerange=[20170706100000,20170706100600]&elements=Station_Id_C,DATETIME,FORMAT,FILE_NAME","requestTime":"2017-07-07 02:48:08","responseTime":"2017-07-07 02:48:08","takeTime":"0.183","fieldNames":"文件名 文件格式 文件大小 文件URL 区站号(字符) 资料时间","fieldUnits":"- - byt - - -","DS":[{"FILE_NAME":"RADA_CHN_DOR_L3_ST_NOC-R-Z9010-20170706100000.PNG","FORMAT":"PNG","FILE_SIZE":"240442","FILE_URL":"http://10.20.76.55/cimiss-web/file?url=L3NwYWNlL2NpbWlzc19CQUJKL2RhdGEvbWV0ZGIvcmFkYTIvRE9SX0wzX1NUX05PQy1SLzIwMTcw%0ANzA2L1o5MDEwL1JBREFfQ0hOX0RPUl9MM19TVF9OT0MtUi1aOTAxMC0yMDE3MDcwNjEwMDAwMC5Q%0ATkc%3D","IMGBASE64":" ","Station_Id_C":"Z9010","DATETIME":"2017-07-06 10:00:00"},{"FILE_NAME":"RADA_CHN_DOR_L3_ST_NOC-R-Z9010-20170706100600.PNG","FORMAT":"PNG","FILE_SIZE":"240082","FILE_URL":"http://10.20.76.55/cimiss-web/file?url=L3NwYWNlL2NpbWlzc19CQUJKL2RhdGEvbWV0ZGIvcmFkYTIvRE9SX0wzX1NUX05PQy1SLzIwMTcw%0ANzA2L1o5MDEwL1JBREFfQ0hOX0RPUl9MM19TVF9OT0MtUi1aOTAxMC0yMDE3MDcwNjEwMDYwMC5Q%0ATkc%3D","IMGBASE64":" ","Station_Id_C":"Z9010","DATETIME":"2017-07-06 10:06:00"}]}
其中,returnCode为返回结果编码,0为成功,其他为失败;returnMessage为返回结果描述;fileCount为返回的文件数;colCount 为返回数据的列数;requestParams为请求参数;requestTime为请求时间;responseTime为请求返回时间;takeTime为执行所花费的时间(毫秒)。
fieldNames为返回的字段清单,fieldUnits说明是返回的数据是文件。
DS为返回数据的内容,包括:FILE_NAME为文件名;FORMAT为文件格式;FILE_SIZE为文件大小(bytes), FILE_URL为文件的URL,您可以直接下载;Station_Name为站名;Station_Id_C为站号; DATETIME为时次,格式为"YYYY-MM-DD HH:MI:SS"。
API清单
1、中国地面气象站定时值观测资料
http://api.data.cma.cn:8090/api?userId=<帐号>&pwd=<密码>&dataFormat=json&
interfaceId=getSurfEleByTimeRangeAndStaID&dataCode=SURF_CHN_MUL_HOR_3H&
timeRange=<时间范围>&staIDs=<台站列表>&elements=Station_Id_C,Year,Mon,Day,Hour,<要素列表>

其中,userId,pwd:分配给您的帐号和密码,从订单中获取
dataFormat:返回的数据格式,目前仅支持json格式
interfaceId:此数据的接口ID,值为getSurfEleByTimeRangeAndStaID
dataCode:此数据的编码,中国地面气象站逐小时观测资料的编码为SURF_CHN_MUL_HOR_3H
timeRange:时间范围,支持最近7天的数据访问,格式为"[YYYYMMDDHHMISS,YYYYMMDDHHMISS]"
staIDs:站号,支持1-30个站点,多个站点之间以","分隔,参见中国地面气象站点清单文档
elements:返回数据字段,多个字段之间使用","分隔,其中:Station_Id_C, Year,Mon,Day,Hour为默认字段,Station_Id_C为站号,Year为资料时间的年,Mon为资料时间的月,Day为资料时间的日,Hour为资料时间的时,<要素列表>为您订单中订制的要素,参见中国地面气象站要素清单
天气现象要素说明
2、全球高空基本气象观测数据
http://api.data.cma.cn:8090/api?userId=<帐号>&pwd=<密码>&dataFormat=json&
interfaceId=getUparEleByTimeAndStaIDAndPress&dataCode=UPAR_GLB_MUL_FTM_7DAY&
times=<时间>&staIds=<站号>&pLayers=<层次列表>&elements=<要素列表>

其中,userId,pwd:分配给您的帐号和密码,从订单中获取
dataFormat:返回的数据格式,目前仅支持json格式
interfaceId:此数据的接口ID,值为getUparEleByTimeAndStaIDAndPress
dataCode:此数据的编码,全球高空气象站定时值资料的编码为UPAR_GLB_MUL_FTM_7DAY
times:时间,格式为"YYYYMMDDHHMISS"
staIDs:站号,支持单站点,参见全球高空气象站点清单文档
pLayers:层次,多个层次之间使用","分隔,为您订单中订制的层次,参见高空气象站要素与层次清单
elements:返回要素数据字段,多个字段之间使用","分隔,参见高空气象站要素与层次清单
3、天气雷达组网组合反射率图像产品
http://api.data.cma.cn:8090/api?userId=<帐号>&pwd=<密码>&dataFormat=json&
interfaceId=getRadaFileByTimeRange&dataCode=RADA_L3_MST_V3_CREF_PNG&
timeRange=<时间范围>&elements=Station_Id_C,DATETIME,FORMAT,FILE_NAME

其中,userId,pwd:分配给您的帐号和密码,从订单中获取
dataFormat:返回的数据格式,目前仅支持json格式
interfaceId:此数据的接口ID,值为getRadaFileByTimeRange
dataCode:此数据的编码,天气雷达组网组合反射率图像产品的编码为RADA_L3_MST_V3_CREF_PNG
timeRange:时间范围,支持最近7天的数据访问,格式为"[YYYYMMDDHHMISS,YYYYMMDDHHMISS]"
staIDs:站号,支持单站点,参见雷达站点清单文档
elements:返回数据字段,多个字段之间使用","分隔,其中: Station_Id_C为站号,DATETIME为资料时间,FORMAT为文件格式,FILE_NAME为文件名
京ICP备05004897号-1 | 京公网安备11040102700021号 | 常见问题 | 网站地图

Copyright 2005-2017 国家气象信息中心(中国气象局气象数据中心)

地址 : 北京海淀区中关村南大街46号 邮编 : 100081

E_mail : datacenter@cma.gov.cn 电话 : (8610)68407499

扫码登录
账户登录
二维码失效
点击刷新
登录手机中国气象数据网扫描二维码
立即注册 更快 更安全
第三方登录
科技资源共享网登录
我的订单
我的数据筐
我的收藏
用户反馈
在线客服
返回顶部
对不起,目前没有公告

AltStyle によって変換されたページ (->オリジナル) /