天气 API
上次做飞信天气预报的时候简单搜索了一下中国天气网的 API ，当然是没有官方文档的，最初是谁挖掘出来的也不可考了。刚才在增加新功能的时候又顺手搜了一下相关资料，发现这个 API 还真不简单。中国天气网有三个 API 适用于不同场合的使用。
http://m.weather.com.cn/data/101050101.html 这个接口返回的格式如下。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 |
{
"weatherinfo": {
"city": "哈尔滨", // 城市中文名
"city_en": "haerbin", // 城市英文名
"date_y": "2012年8月18日", // 发布日期
"date": "", // ?
"week": "星期六", // 周信息
"fchh": "18", // 信息发布时的整点小时数（感谢读者 白白乌鸦 的提醒）
"cityid": "101050101", // 城市ID
"temp1": "18℃~26℃", // 今日气温
"temp2": "17℃~29℃", // 明日气温
"temp3": "18℃~23℃", // 第三日气温
"temp4": "13℃~24℃", // 第四日气温
"temp5": "15℃~31℃", // 第五日气温
"temp6": "14℃~32℃", // 第六日气温
"tempF1": "64.4℉~78.8℉", // 今日气温（华氏）
"tempF2": "62.6℉~84.2℉", // 明日气温（华氏）
"tempF3": "64.4℉~73.4℉", // 第三日气温（华氏）
"tempF4": "55.4℉~75.2℉", // 第四日气温（华氏）
"tempF5": "59℉~87.8℉", // 第五日气温（华氏）
"tempF6": "57.2℉~89.6℉", // 第六日气温（华氏）
"weather1": "多云", // 今日天气
"weather2": "晴转多云", // 明日天气
"weather3": "雷阵雨转小雨", // 第三日天气
"weather4": "多云", // 第四日天气
"weather5": "晴", // 第五日天气
"weather6": "晴", // 第六日天气
"img1": "1", // 天气图标编号，此处的编号及其图片获取规则尚不清楚，如有知道详情的恳请评论告知，我将添加说明
"img2": "99", // 天气图标编号
"img3": "0", // 天气图标编号
"img4": "1", // 天气图标编号
"img5": "4", // 天气图标编号
"img6": "7", // 天气图标编号
"img7": "1", // 天气图标编号
"img8": "99", // 天气图标编号
"img9": "0", // 天气图标编号
"img10": "99", // 天气图标编号
"img11": "0", // 天气图标编号
"img12": "99", // 天气图标编号
"img_single": "1", // ? 可能是天气图标编号
"img_title1": "多云", // ? 可能是天气图标对应的 title
"img_title2": "多云", // ? 可能是天气图标对应的 title
"img_title3": "晴", // ? 可能是天气图标对应的 title
"img_title4": "多云", // ? 可能是天气图标对应的 title
"img_title5": "雷阵雨", // ? 可能是天气图标对应的 title
"img_title6": "小雨", // ? 可能是天气图标对应的 title
"img_title7": "多云", // ? 可能是天气图标对应的 title
"img_title8": "多云", // ? 可能是天气图标对应的 title
"img_title9": "晴", // ? 可能是天气图标对应的 title
"img_title10": "晴", // ? 可能是天气图标对应的 title
"img_title11": "晴", // ? 可能是天气图标对应的 title
"img_title12": "晴", // ? 可能是天气图标对应的 title
"img_title_single": "多云", // ? 可能是天气图标对应的 title
"wind1": "西南风小于3级转西风3-4级", // 今日风向风力信息
"wind2": "西风小于3级转西南风3-4级", // 明日风向风力信息
"wind3": "西南风小于3级转3-4级", // 第三日风向风力信息
"wind4": "西南风小于3级转3-4级", // 第四日风向风力信息
"wind5": "西南风小于3级转3-4级", // 第五日风向风力信息
"wind6": "西南风小于3级转3-4级", // 第六日风向风力信息
"fx1": "西南风", // ?
"fx2": "西风", // ?
"fl1": "小于3级转3-4级", // 今日风力信息
"fl2": "小于3级转3-4级", // 明日风力信息
"fl3": "小于3级转3-4级", // 第三日风力信息
"fl4": "小于3级转3-4级", // 第四日风力信息
"fl5": "小于3级转3-4级", // 第五日风力信息
"fl6": "小于3级转3-4级", // 第六日风力信息
"index": "热",
"index_d": "天气较热，建议着短裙、短裤、短套装、T恤等夏季服装。年老体弱者宜着长袖衬衫和单裤。",
"index48": "炎热",
"index48_d": "天气炎热，建议着短衫、短裙、短裤、薄型T恤衫、敞领短袖棉衫等清凉夏季服装。",
"index_uv": "中等", // 紫外线信息
"index48_uv": "弱", // 48 小时紫外线信息
"index_xc": "较适宜", // 洗车指数（感谢读者 刘睿 的提醒）
"index_tr": "适宜", // 旅游指数
"index_co": "舒适", // 舒适指数
"st1": "25",
"st2": "17",
"st3": "28",
"st4": "19",
"st5": "18",
"st6": "16",
"index_cl": "较适宜", // 晨练指数
"index_ls": "适宜", // 晾晒指数
"index_ag": "极易发" // 感冒指数（感谢读者 刘睿 的提醒）
}
} |
上面这个就是我现在在用的，返回的数据最全面，也是绝大多数博客中都会介绍的。另外还有两个接口比较简洁。
http://www.weather.com.cn/data/sk/101010100.html 这个接口返回的数据是实况数据，像下面这样的。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
{
"weatherinfo": {
"city": "北京", // 城市中文名
"cityid": "101010100", // 城市 ID
"temp": "24", // 温度
"WD": "西南风", // 风向
"WS": "1级", // 风力
"SD": "92%", // 湿度
"WSE": "1", // ?
"time": "19:15", // 发布时间
"isRadar": "1", // 是否有雷达图
"Radar": "JC_RADAR_AZ9010_JB" // 雷达图编号，雷达图的地址在 http://www.weather.com.cn/html/radar/雷达图编号.shtml
}
} |
还有一个接口http://www.weather.com.cn/data/cityinfo/101010100.html 这个接口返回的数据如下。
1 2 3 4 5 6 7 8 9 10 11 12 |
{
"weatherinfo": {
"city": "北京", // 城市中文名
"cityid": "101010100", // 城市 ID
"temp1": "22℃", // ?
"temp2": "31℃", // ?
"weather": "阴转晴", // 天气
"img1": "n2.gif", // ? 天气图标编号
"img2": "d0.gif", // ? 天气图标编号
"ptime": "18:00" // 发布时间
}
} |
另外中国天气网还有一个根据 IP 来判断访问者所在地的引擎，地址在http://61.4.185.48:81/ ，直接访问的话会提示“This is the geoip engine created for weather.com.cn. ”，访问http://61.4.185.48:81/g/ 可以返回你的 IP 所在地相应信息，包括 IP 和城市编号，但是没有城市名称。
2013 年 8 月 2 日更新：返回数据最多的那个接口，即本文中最开始介绍的接口，其中的图片获取规则因为博文发布时间久远，我已经遗忘了。如果有哪位读者知道的话，恳请评论告知，我好添加到文章中，方便各位的共享。
另外，天气网本身有另一个用于 Flash 的接口。在天气网上查询任意一个城市的天气，可以看到其页面上有一个 Flash 绘制的“整点天气实况”，就是当天的气温曲线。里面的数据是从http://flash.weather.com.cn/sk2/101050101.xml 这个接口获得的。返回数据如下。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
<?xml version="1.0"?> <sktq id="101050101" ptime="13-08-02 16:00" city="哈尔滨"> <qw h="16" wd="30" fx="190" fl="2" js="0" sd="64"/> <qw h="15" wd="30" fx="203" fl="3" js="0" sd="61"/> <qw h="14" wd="30" fx="174" fl="3" js="0" sd="63"/> <qw h="13" wd="30" fx="179" fl="3" js="0" sd="62"/> <qw h="12" wd="29" fx="162" fl="3" js="0" sd="66"/> <qw h="11" wd="29" fx="214" fl="2" js="0" sd="66"/> <qw h="10" wd="28" fx="214" fl="2" js="0" sd="70"/> <qw h="09" wd="28" fx="220" fl="2" js="0" sd="70"/> <qw h="08" wd="26" fx="178" fl="2" js="0" sd="75"/> <qw h="07" wd="25" fx="145" fl="1" js="0" sd="76"/> <qw h="06" wd="24" fx="171" fl="1" js="0" sd="79"/> <qw h="05" wd="24" fx="131" fl="2" js="0" sd="79"/> <qw h="04" wd="24" fx="146" fl="2" js="0" sd="77"/> <qw h="03" wd="24" fx="163" fl="2" js="0" sd="75"/> <qw h="02" wd="24" fx="126" fl="2" js="0" sd="84"/> <qw h="01" wd="24" fx="127" fl="1" js="0" sd="81"/> <qw h="00" wd="25" fx="137" fl="2" js="0" sd="78"/> <qw h="23" wd="25" fx="99" fl="2" js="0" sd="78"/> <qw h="22" wd="25" fx="140" fl="2" js="0" sd="76"/> <qw h="21" wd="26" fx="133" fl="2" js="0" sd="78"/> <qw h="20" wd="27" fx="149" fl="1" js="0" sd="71"/> <qw h="19" wd="28" fx="187" fl="2" js="0" sd="67"/> <qw h="18" wd="29" fx="161" fl="2" js="0" sd="59"/> <qw h="17" wd="30" fx="138" fl="2" js="0" sd="60"/> <qw h="16" wd="30" fx="130" fl="3" js="0" sd="57"/> </sktq> |
稍作解析： sktq 是“实况天气”的汉语拼音首字母缩写，这个节点的 id 是城市 ID ，ptime 即是发布时间， city 是城市的名称。根节点内是一系列 qw 节点， qw 即是“气温”的汉语拼音缩写；每个节点中， h 是整点小时数，即此节点数据发布时间的小时位； wd 是温度，以摄氏计； fx 是风向，貌似是个角度，具体的规则我还不太清楚； fl 是风力级数； js 是降水，以毫米计； sd 是相对湿度，以百分数计。这一系列节点是以时间逆序排列的，也就是说，接近当前时间的排在前面。
要使用这个接口的数据，跟其他接口一样，也需要解决读者评论中提到的跨域问题，我个人的建议是用自己的服务器做代理转发，经过代理层之后是要用 JSON 还是 JSONP 或者 Flash 跨域，就随自己喜好和项目需求了吧。
2013 年 8 月 22 日更新：四个图片接口依次如下：http://m.weather.com.cn/img/c0.gif， http://m.weather.com.cn/img/b0.gif ， http://www.weather.com.cn/m/i/weatherpic/29x20/d0.gif ， http://www.weather.com.cn/m2/i/icon_weather/29x20/n00.gif 。其中图片编号 99 代表空图片。
对于想手动获取城市代码的朋友，也有几个接口提供给大家。获取省级代码的接口： http://www.weather.com.cn/data/list3/city.xml?level=1 ，获取城市代码的接口（比如安徽省是 22 ）：http://www.weather.com.cn/data/list3/city22.xml?level=2 ，获取区域代码的接口（比如安庆是 2206）：http://www.weather.com.cn/data/list3/city2206.xml?level=3 。需要注意的是这几个接口并不是返回 XML 文档，而是返回纯文本，需要自行分割匹配。
Flash 实况地址在这里： http://flash.weather.com.cn/sk2/shikuang.swf?id=101050101 。
本次更新的内容都来自于 http://g.kehou.com/t1033317914.html，在此对接口的挖掘者和分享者表示感谢！也感谢读者朋友的反馈。
转载，地址http://blog.mynook.info/2012/08/18/weather-com-cn-api.html