天气API对接教程：气象大数据平台
中国气象大数据平台是由北京天译科技有限公司运营的专业气象数据服务平台，面向高校、科研机构、企业和个人开发者提供丰富的气象数据服务。平台提供预报、实况、预警、空气质量、指数和图形产品等六大类数据，覆盖全国4万多个县乡镇站点和全球18万个城市站点。用户可通过API接口自由定制数据要素、预报时长和更新频率。平台已与腾讯、百度、360等知名企业建立长期合作，并支持各类天气应用开发，应用场景涵盖天气预报AP
产品概述
简介
气象大数据平台隶属于北京天译科技有限公司，是中国天气网面向高校、科研院所、社会各行业用户及个人开发者，通过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 | 请求未定制类型数据 | 请求未定制类型数据 |
魔乐社区（Modelers.cn) 是一个中立、公益的人工智能社区，提供人工智能工具、模型、数据的托管、展示与应用协同服务，为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作，由全产业链共同建设、共同运营、共同享有，推动国产AI生态繁荣发展。
更多推荐
17
0- 0
已为社区贡献2条内容
所有评论(0)