天气预报API [返回]

ThinkPage天气预报API是一个基于ThinkPage天气预报系统的编程接口。您可以方便的利用天气预报API接口开发您自己的天气预报应用程序或网站。与天气预报插件一样，我们提供了全国及世界主要城市实时天气和5天内天气预报，并有SMART智能、中央气象台、The Weather Channel、MSN、Yahoo五种数据源，以及简体、繁体、英文三种语言供您选择。我们还提供了完善的API文档、城市ID列表和天气代码说明，帮助您轻松的完成API接口的整合和开发。天气预报API仅对VIP用户开放。

基本信息

您的API密钥	只有VIP用户才能访问API接口哦
API请求地址	http://www.thinkpage.cn/weather/api.svc/方法名?参数
参考信息	城市ID列表
	天气代码及图标说明

API列表

方法名

getWeather

说明

获取指定城市的实时天气信息和未来天气预报。

参数

参数名	类型	说明
city	string	城市ID或IP地址(查看城市ID列表)。同时查询多个城市时用逗号分隔，如：101010100,101020100。若您的城市还未收录在我们的城市列表中，您可以使用自定义城市功能。
language	string	语言。参数值3种可选：zh-chs(简体中文), zh-cht(繁体中文), en(英文)
provider	string	天气数据源。参数值5种可选：smart(智能), cma(中央气象台)，twc(The Weather Channel), msn(微软), yahoo(雅虎)
unit	string	温度单位。参数值2种可选：c(摄氏)，f(华氏)
key	string	您的API密钥

请求方式

HTTP GET

请求地址示例

http://www.thinkpage.cn/weather/api.svc/getWeather?city=101010100&language=zh-chs&provider=smart&unit=c&key=

返回结果

返回结果为JSON格式。相比较XML，JSON数据冗余少解析快。关于如何解析JSON，请参考 http://www.json.org/json-zh.html

{
    "Stat": "OK",                       //错误信息。正常返回时值为"OK"。
    "Weathers": [{                      //城市天气数组。同时查询多个城市时，该数组则包含多个对象。
        "CityId": "101010100",          //城市ID
        "CityName": "北京",             //城市名
        "Country": "CH",                //国家。仅数据源为yahoo时有效。
        "Current": {                    //实时天气信息
            "Chill": "5",               //当前实时体感温度
            "Code": "20",               //天气图标代码 (查看说明)
            "Direction": "北",          //风向
            "Humidity": "93",           //湿度。单位：百分比%。
            "Index": null,              //生活指数。目前不对API接口开放。
            "Pressure": "1015.92",      //气压。单位：百帕hPa。
            "Rising": "1",              //气压变化。0或steady为稳定，1或rising为升高，2或falling为降低。
            "Speed": "3.22",            //风速。单位：km/h。
            "Sunrise": "6:58 am",       //日出时间。
            "Sunset": "4:56 pm",        //日落时间。
            "Temperature": "5",         //当前实时温度
            "Text": "雾",               //天气情况
            "Visibility": "3.49"        //能见度。单位：公里km。
        },
        "Forecast": [{                  //天气预报数组。smart和cma返回6天预报，msn返回5天预报，yahoo返回2天预报。
            "Code": "31",               //天气图标代码
            "Cop": "20%",                //降水概率。
            "Date": "\/Date(1321371000000+0800)\/",     //日期
            "Day": "周二",              //星期
            "Extra": null,              //无效字段
            "High": "11",               //最高温度
            "Info": null,               //无效字段
            "Link": null,               //无效字段
            "Low": "1",                 //最低温度
            "Text": "晴"                //天气情况
        }, {                            //第二天天气预报
            "Code": "30",
            "Cop": null,
            "Date": "\/Date(1321457400000+0800)\/",
            "Day": "周三",
            "Extra": null,
            "High": "14",
            "Info": null,
            "Link": null,
            "Low": "5",
            "Text": "晴间多云"
        }],
        "LastBuildDate": "11\/15\/2011 11:30:00 PM",    //数据更新时间
        "Region": ""                                    //地区。一般不用。
    }]
}