天气API对接教程：气象大数据平台

原创已于 2025-11-28 09:38:13 修改 · 213 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#大数据 #java #php #c# #vue #javascript #前端

于 2025-11-28 09:32:02 首次发布

天气API 专栏收录该内容

1 篇文章

订阅专栏

产品概述

简介

气象大数据平台隶属于北京天译科技有限公司，是中国天气网面向高校、科研院所、社会各行业用户及个人开发者，通过API接口方式提供气象数据产品服务的官方载体。随着气象大数据平台的逐渐完善，会面向广大用户提供更为丰富的气象数据，从而满足不同用户的不同需求。用户通过气象大数据平台的定制数据，自由选择想要全国4万多个县、乡镇站点，全球18万个城市站点，自由选择目前六大气象产品中的任意要素，预报时长，以及更新频率，方便直观。

产品特色

气象大数据平台涉及的数据品类包括预报，实况，预警，空气质量，指数，图形产品，格点数据等，类型丰富。数据来源使用方式简单便捷，跨平台。

应用场景

网站全国城市天气预报，天气预报服务性的APP应用，电视盒子天气预报应用，游戏场景和天气结合，农业灾害预防，保险行业和天气结合，医疗单位和疾病防治中心和天气服务结合提升优化服务质量，单车出行应用服务用户出行。

使用说明

使用流程

1.注册申请气象大数据平台帐号

登录气象大数据平台官方网站http://www.weatherdt.com，点击右上角“注册”按钮进行注册并激活帐号，如下图所示：

开发指南

1.接口URL

http://api.weatherdt.com/common/?area=站表ID&type=天气数据大类&key=741c428fc7116c6f718cb14f2dda49sm

2.站点拼装规则

http://api.weatherdt.com/common/?area=站表ID|站表ID|站表ID&type=天气数据大类&key=741c428fc7116c6f718cb14f2dda49sm

单站点

请求URL: http://api.weatherdt.com/common/?area=站表ID&type=天气数据大类&key=741c428fc7116c6f718cb14f2dda49sm

多站点

站点类型只能是4种类型的1种(中国站点,国外站点,旅游景点,机场),不能混,混着请求报错

站点数量N(2<=N<=20),超出范围报错

请求URL: http://api.weatherdt.com/common/?area=areaId|areaId&type=天气数据大类&key=741c428fc7116c6f718cb14f2dda49sm

3.要素拼装规则

单站点请求可以请求所有数据大类全部要素(推荐方式，简洁)

http://api.weatherdt.com/common/?area=areaId&type=index&key=741c428fc7116c6f718cb14f2dda49sm

http://api.weatherdt.com/common/?area=areaId&type=index|forecast|alarm&key=741c428fc7116c6f718cb14f2dda49sm

多站点请求可以请求所有数据大类全部要素

http://api.weatherdt.com/common/?area=areaId|areaId&type=air&key=741c428fc7116c6f718cb14f2dda49sm

http://api.weatherdt.com/common/?area=areaId|areaId&type=air|forecast|alarm&key=741c428fc7116c6f718cb14f2dda49sm

4.参数说明

参数	是否必须	示例	说明
area	必须	10010101001\|10010101002	站号，多个之间使用\|分隔，最多支持20个站号
type	必须	type=forecast\|alarm\|air\|observe或者单独一个数据大类	请求数据类型，多个大类之间使用\|分割
key	必须	741c428fc7116c6f718cb14f2dda49sm	密钥，与订单对应

5.接口错误编码表

编码	错误说明	备注
CC1000	参数错误	检查参数拼写
CC1003	订单过期	请重新购买服务
CC1004	访问次数超限	请合理访问接口
CC1005	站点数过多错误	单次访问请少于20个站点
CC1006	访问接口路径错误	访问接口路径错误
CC1100	连接超时	请稍后访问
CC1101	密钥错误	检查密钥
CC1102	系统无响应	请稍后访问
CC1200	请求无效站点错误	检查请求站点
CC1201	请求站点与要素过多错误	检查站点数量或要素数量
CC1300	请求要素格式错误	检查要素请求格式
CC1301	请求未定制类型数据	检查定制类型数据
CC1302	请求类型定制天数超出错误	检查请求类型的定制天数
CC1303	请求多站点与指数多要素错误	检查站点数量或指数要素数量

6.接口返回JSON示例

{
  air: {
    //空气质量

    101010100: {
      //站号

      2001006: {
        //数据大类

        "006": "2.0", //SO2

        "007": "32.0", //CO

        "003": "65.0", //NO2

        "004": "2.0", //O3

        "000": "201611041000", //更新时间

        "001": "290.0", //PM2.5

        "005": "166.0", //PM10

        "002": "290.0", //AQI
      },
    },
  },

  alarm: {
    //预警

    101010100: {
      //站号

      1001003: [
        //数据大类

        {
          "006": "02", //预警级别编号

          "010": "201611032200545111大雾黄色", //预警信息

          "008": "2016-11-03 22:00", //预警发布时间

          "011": "10101-20161103220000-1202.html", //天气网跳转地址

          "009":
            "北京市气象台03日22时00分发布大雾黄色预警,预计当前至4日10时左右本市有雾，部分地区能见度小于500米，请注意防范。", //预警发布内容

          "001": "北京市", //预警发布单位的省级名称

          "005": "大雾", //预警类别名称

          "004": "12", //预警类别编号

          "003": "", //预警发布单位的县级名称

          "007": "黄色", //预警级别名称

          "002": "", //预警发布单位的市级名称
        },

        {
          "006": "03", //预警级别编号

          "010": "201611031750545111霾橙色", //预警信息

          "008": "2016-11-03 17:50", //预警发布时间

          "011": "10101-20161103175000-1303.html", //天气网跳转地址

          "009":
            "北京市气象台03日17时50分更新发布霾橙色预警,预计3日夜间至4日，本市将出现中度到重度霾，能见度低，请注意防范。", //预警发布内容

          "001": "北京市", //预警发布单位的省级名称

          "005": "霾", //预警类别名称

          "004": "13", //预警类别编号

          "003": "", //预警发布单位的县级名称

          "007": "橙色", //预警级别名称

          "002": "", //预警发布单位的市级名称
        },
      ],
    },
  },

  forecast: {
    //预报

    "24h": {
      //逐24小时

      101010100: {
        //站号

        1001001: [
          //数据大类

          {
            "006": "0", //晚上风力

            "008": "0", //晚上方向

            "007": "0", //白天方向

            "003": "15", //白天温度

            "004": "4", //晚上温度

            "001": "53", //白天天气现象编码

            "005": "0", //白天风力

            "002": "53", //晚上天气现象编码
          },

          {
            "006": "0", //晚上风力

            "008": "0", //晚上方向

            "007": "0", //白天方向

            "003": "17", //白天温度

            "004": "3", //晚上温度

            "001": "01", //白天天气现象编码

            "005": "0", //白天风力

            "002": "02", //晚上天气现象编码
          },

          {
            "006": "0", //晚上风力

            "008": "0", //晚上方向

            "007": "0", //白天方向

            "003": "10", //白天温度

            "004": "4", //晚上温度

            "001": "02", //白天天气现象编码

            "005": "0", //白天风力

            "002": "07", //晚上天气现象编码
          },
        ],

        "000": "201611040800", //更新时间
      },
    },
  },

  observe: {
    //实况

    101010100: {
      //站号

      1001002: {
        //数据大类

        "006": "0", //当前降水量(单位是毫米)

        "007": "1004", //当前气压(单位百帕)

        "003": "1", //当前风力(单位是级,不用转码)

        "004": "2", //当前风向编号

        "000": "10:25", //实况发布时间

        "005": "79", //当前湿度(单位%)
        "002": "7", //当前温度(单位摄氏度)
      },
    },
  },
  index: {
    //指数
    "24h": {
      //逐24小时
      101010100: {
        //站号
        1001004: [
          //数据大类
          {
            "002": {
              "002002": "较冷", //指数等级
              "002003": "建议着厚外套加毛衣等服装。年老体弱者宜着大衣、呢外套加羊毛衫。", //指数释义
              "002001": "穿衣指数", //指数名称
            },
            "000": "20161104",
            "005": {
              "005001": "交通指数", //指数名称
              "005003": "天气较好，但能见度很低，交通气象条件很差，车辆行驶缓慢，尽量减少出行。", //指数释义
              "005002": "很差", //指数等级
            },
            "004": {
              "004001": "感冒指数", //指数名称
              "004003": "昼夜温差大，且空气湿度较大，易发生感冒，请注意适当增减衣服，加强自我防护避免感冒。", //指数释义
              "004002": "易发", //指数等级
            },
          },
          {
            "002": {
              "002002": "较冷", //指数等级
              "002003": "建议着厚外套加毛衣等服装。年老体弱者宜着大衣、呢外套加羊毛衫。", //指数释义
              "002001": "穿衣指数", //指数名称
            },
            "000": "20161105",
            "005": {
              "005001": "交通指数", //指数名称
              "005003": "天气较好，路面干燥，交通气象条件良好，车辆可以正常行驶。", //指数释义
              "005002": "良好", //指数等级
            },
            "004": {
              "004001": "感冒指数", //指数名称
              "004003": "昼夜温差很大，易发生感冒，请注意适当增减衣服，加强自我防护避免感冒。", //指数释义
              "004002": "易发", //指数等级
            },
          },
          {
            "002": {
              "002002": "较冷", //指数等级
              "002003": "建议着厚外套加毛衣等服装。年老体弱者宜着大衣、呢外套加羊毛衫。", //指数释义
              "002001": "穿衣指数", //指数名称
            },
            "000": "20161106",
            "005": {
              "005001": "交通指数", //指数名称
              "005003": "阴天，路面干燥，交通气象条件良好，车辆可以正常行驶。", //指数释义
              "005002": "良好", //指数等级
            },
            "004": {
              "004001": "感冒指数", //指数名称
              "004003": "各项气象条件适宜，无明显降温过程，发生感冒机率较低。", //指数释义
              "004002": "少发", //指数等级
            },
          },
        ],
        "000": "201611040800", //更新时间
      },
    },
  },
};

数据编码

1.产品大类编码表

编码	中文名称	英文名称
001	预报	forecast
002	实况	observe
003	预警	alarm
004	指数	index
006	空气质量	air

2.数据频率表

数据类型	更新频率
常规预报	每天发布3次发布时间分别为：08时、12时、18时
实况	每小时更新一次
预警	不定期更新，为保证预警的时效性，建议程序启动后每隔10分钟进行一次轮循
指数	每天发布3次发布时间分别为：08时、12时、18时
空气质量	每小时更新一次

3.风向编号表

风向编号	中文名称	英文名称
0	无持续风向	No wind
1	东北风	Northeast
2	东风	East
3	东南风	Southeast
4	南风	South
5	西南风	Southwest
6	西风	West
7	西北风	Northwest
8	北风	North
9	旋转风	Whirl wind

4.风力编号表

风力编号	中文名称	英文名称
0	微风	<5.4m/s
1	3-4级	5.5~7.9m/s
2	4-5级	8.0~10.7m/s
3	5-6级	10.8~13.8m/s
4	6-7级	13.9~17.1m/s
5	7-8级	17.2~20.7m/s
6	8-9级	20.8~24.4m/s
7	9-10级	24.5~28.4m/s
8	10-11级	28.5~32.6m/s
9	11-12级	32.7~36.9m/s

5.天气现象编码表

天气现象编码	中文名称	英文名称
0	晴	Sunny
1	多云	Cloudy
2	阴	Overcast
3	阵雨	Shower
4	雷阵雨	Thundershower
5	雷阵雨伴有冰雹	Thundershower with hail
6	雨夹雪	Sleet
7	小雨	Light rain
8	中雨	Moderate rain
9	大雨	Heavy rain
10	暴雨	Storm
11	大暴雨	Heavy storm
12	特大暴雨	Severe storm
13	阵雪	Snow flurry
14	小雪	Light snow
15	中雪	Moderate snow
16	大雪	Heavy snow
17	暴雪	Snowstorm
18	雾	Foggy
19	冻雨	Ice rain
20	沙尘暴	Duststorm
21	小到中雨	Light to moderate rain
22	中到大雨	Moderate to heavy rain
23	大到暴雨	Heavy rain to storm
24	暴雨到大暴雨	Storm to heavy storm
25	大暴雨到特大暴雨	Heavy to severe storm
26	小到中雪	Light to moderate snow
27	中到大雪	Moderate to heavy snow
28	大到暴雪	Heavy snow to snowstorm
29	浮尘	Dust
30	扬沙	Sand
31	强沙尘暴	Sandstorm
53	霾	Haze
99	无	Unknown
32	浓雾	Dense fog
49	强浓雾	Strong fog
54	中度霾	Moderate haze
55	重度霾	Severe haze
56	严重霾	Severe haze
57	大雾	Dense fog
58	特强浓雾	Extra heavy fog
301	雨	rain
302	雪	snow

6.php请求代码示例(ip)

<?php			
$url='http://api.weatherdt.com/common/?area=101020100&type=forecast&key=XXXXXX';			
$resultJson=file_get_contents($url);			
echo $resultJson;			
?>

7.JAVA请求代码示例(ip)

URL url = new URL("http://api.weatherdt.com/common/?area=101020100&type=forecast&key=XXXXXX");			
HttpURLConnection uRLConnection = (HttpURLConnection)url.openConnection();				
uRLConnection.setDoOutput(true);				
uRLConnection.connect();				
InputStream is = uRLConnection.getInputStream();				
BufferedReader br = new BufferedReader(new InputStreamReader(is));				
String respJson = "";				
String readLine = null;				
while((readLine =br.readLine()) != null){				   
    respJson +=readLine;				
}				
is.close();				
br.close();	
uRLConnection.disconnect();

8.C#请求代码示例(域名)

string url = "http://api.weatherdt.com/common/?area=101010100|101010200&type=forecast&key="XXXXXXXX";				
Uri httpURL = new Uri(url,true);				
HttpWebRequest httpReq = (HttpWebRequest)WebRequest.Create(httpURL);				
HttpWebResponse httpResp = (HttpWebResponse)httpReq.GetResponse();				
Stream respStream = httpResp.GetResponseStream();				
StreamReader respStreamReader = new StreamReader(respStream, Encoding.UTF8);				
string jsonContent=respStreamReader.ReadToEnd();				
Console.WriteLine(jsonContent);

图形产品文档

1.接口URL

http://api.weatherdt.com/pic/?area=101&type=1001&date=20160822&key=613e381aa0e0c9d377e2bce4cf14db87

area:地区,(101)全国

type:图片类型,只能请求一种类型

date:图片日期,形式(YYYYMMDD)

key:密钥

2.产品返回json串说明

{
  "date": "20160822",//日期
  "pictype":"1001",//图形产品类型
  "content": [//图片地址和时间
    {
      "picurl": "",//图片地址
      "time": "201600820080002400"//图片日期
    },
    {
      "picurl": "",//图片地址
      "time": "201600820080004800"//图片日期
    }]
}

3.接口错误编码表

编码	错误说明	备注
CC1000	参数错误	检查参数拼写
CC1100	连接超时	请稍后访问
CC1101	密钥错误	检查密钥
CC1102	访问日期超出订购日期范围	访问日期超出订购日期范围
CC1103	缓存已过期	缓存已过期
CC1200	请求无效站点错误	检查请求站点
CC1300	请求未定制类型数据	请求未定制类型数据