API说明
API Key 您访问气象API的Key:
提示:登录后,您也可以在个人信息中查看您访问气象API的Key。
提示:登录后,您也可以在个人信息中查看您访问气象API的Key。
用户类型调用API次数说明:
气象API以Restful WebServices的方式提供,对于要素型数据以Json格式直接返回,对于文件型数据以Json格式返回文件清单列表,通过文件清单的文件URL进行文件下载。
注:1、本文档中时间、时次没有明确说明的,都是以世界时(GMT)为标准。
2、要素如果缺测为999999,要素如果无观测为999998。
如果您在使用气象API过程遇到问题,欢迎请您通过电话(86-10-68407499)、邮件(data@cma.gov.cn)、中国气象数据网 (http://data.cma.cn)页面的用户反馈与我们联系。
序号 | 用户类型 | API调用次数/天 |
1 | 普通注册用户 | 10 |
2 | 个人实名注册用户 | 20 |
3 | 单位实名注册用户 | 50 |
4 | 教育科研实名注册用户 | 50 |
气象API以Restful WebServices的方式提供,对于要素型数据以Json格式直接返回,对于文件型数据以Json格式返回文件清单列表,通过文件清单的文件URL进行文件下载。
注:1、本文档中时间、时次没有明确说明的,都是以世界时(GMT)为标准。
2、要素如果缺测为999999,要素如果无观测为999998。
如果您在使用气象API过程遇到问题,欢迎请您通过电话(86-10-68407499)、邮件(data@cma.gov.cn)、中国气象数据网 (http://data.cma.cn)页面的用户反馈与我们联系。
接口简介
接口URL:
其中,key是给您分配的key,是您身份的标志
data是您所调用接口的资料编码
其他调用参数根据您调用的资料不同有不同的参数
其中,key是给您分配的key,是您身份的标志
data是您所调用接口的资料编码
其他调用参数根据您调用的资料不同有不同的参数
接口示例
例如,您需要调用2017年3月6日2时(GMT)的北京站(54511)的中国地面气象站逐小时观测资料的所有要素,您可以调用如下接口:
返回结果为:
{"returnCode":"0","takeTime":"16","responseTime":"2017-03-06 11:23:37","requestTime":"2017-03-06
11:23:37","colCount":"22","rowCount":"1","requestParams":"elements=PRS,PRS_Sea,PRS_Max,PRS_Min,TEM,TEM_Max,TEM_Min,RHU,RHU_Min,VAP,PRE_1h,Station_Id_C,Year,Mon,Day,Hour,WIN_D_Avg_10mi,WIN_S_Avg_10mi,WIN_D_S_Max,WIN_S_Max,WIN_D_INST_Max,WIN_S_Inst_Max","returnMsg":"success","DS":
[{"PRS":1015.6000,"PRS_Sea":1019.6000,"PRS_Max":1016.2000,"PRS_Min":1015.6000,"TEM":5.4000,"TEM_Max":5.4000,"TEM_Min":3.5000,"RHU":28,"RHU_Min":28,"VAP":2.5000,"PRE_1h":0.0000,"Station_Id_C":"54511","Year":2017,"Mon":3,"Day":6,"Hour":2,"WIN_D_Avg_10mi":60,"WIN_S_Avg_10mi":2.7000,"WIN_D_S_Max":60,"WIN_S_Max":2.7000,"WIN_D_INST_Max":79,"WIN_S_Inst_Max":4.0000}]}
11:23:37","colCount":"22","rowCount":"1","requestParams":"elements=PRS,PRS_Sea,PRS_Max,PRS_Min,TEM,TEM_Max,TEM_Min,RHU,RHU_Min,VAP,PRE_1h,Station_Id_C,Year,Mon,Day,Hour,WIN_D_Avg_10mi,WIN_S_Avg_10mi,WIN_D_S_Max,WIN_S_Max,WIN_D_INST_Max,WIN_S_Inst_Max","returnMsg":"success","DS":
[{"PRS":1015.6000,"PRS_Sea":1019.6000,"PRS_Max":1016.2000,"PRS_Min":1015.6000,"TEM":5.4000,"TEM_Max":5.4000,"TEM_Min":3.5000,"RHU":28,"RHU_Min":28,"VAP":2.5000,"PRE_1h":0.0000,"Station_Id_C":"54511","Year":2017,"Mon":3,"Day":6,"Hour":2,"WIN_D_Avg_10mi":60,"WIN_S_Avg_10mi":2.7000,"WIN_D_S_Max":60,"WIN_S_Max":2.7000,"WIN_D_INST_Max":79,"WIN_S_Inst_Max":4.0000}]}
其中,returnCode为返回结果编码,0为成功,其他为失败;takeTime为执行所花费的时间(毫秒);responseTime为请求返回时间;requestTime为请求时间;requestParams为请求的要素清单;returnMsg为返回结果描述。
DS为返回的气象数据内容,包括气象要素和值。
例如,您需要调用2017年3月2日6:18(GMT)时次的北京大兴(Z9010)的雷达基本反射率图像产品,您可以调用如下接口:
返回的结果为:
{"returnCode":"0","takeTime":"554","responseTime":"2017-03-03 11:15:22","requestTime":"2017-03-03
11:15:21","colCount":"5","rowCount":"1","requestParams":"
ements=Station_Id_C,DateTime,fileSize,fileName,FilePath","
returnMsg":"success","DS":
[{"Station_Id_C":"Z9010","FILE_URL":"http://101.201.177.119/dlradar/space/cimiss_BABJ/data/metdb/rada2/DOR_L3_ST_NOC-R/20170302/Z9010/RADA_CHN_DOR_L3_ST_NOC-R-Z9010-20170302061800.PNG?Expires=1488511462&OSSAccessKeyId=CcULE6lAfEbIFtKD&Signature=bKIzGhgnD8FZsoJlBtMsQvWy9p0%3D","FILE_NAME":"RADA_CHN_DOR_L3_ST_NOC-R-Z9010-20170302061800.PNG","FILE_SIZE":269588,"DATETIME":20170302061800}]}
11:15:21","colCount":"5","rowCount":"1","requestParams":"
ements=Station_Id_C,DateTime,fileSize,fileName,FilePath","
returnMsg":"success","DS":
[{"Station_Id_C":"Z9010","FILE_URL":"http://101.201.177.119/dlradar/space/cimiss_BABJ/data/metdb/rada2/DOR_L3_ST_NOC-R/20170302/Z9010/RADA_CHN_DOR_L3_ST_NOC-R-Z9010-20170302061800.PNG?Expires=1488511462&OSSAccessKeyId=CcULE6lAfEbIFtKD&Signature=bKIzGhgnD8FZsoJlBtMsQvWy9p0%3D","FILE_NAME":"RADA_CHN_DOR_L3_ST_NOC-R-Z9010-20170302061800.PNG","FILE_SIZE":269588,"DATETIME":20170302061800}]}
其中,returnCode为返回结果编码,0为成功,其他为失败;takeTime为执行所花费的时间(毫秒);responseTime为请求返回时间;requestTime为请求时间;requestParams为请求的要素清单;returnMsg为返回结果描述。
DS为返回的气象数据内容,包括:Station_Id_C为站名;FILE_URL为文件的URL,您可以直接下载;FILE_NAME为文件名;FILE_SIZE为文件大小(bytes);DATETIME为时次。
API文档