接口介绍
未来24-168个小时，逐小时的天气预报数据数据，具体包含的数据：温度、天气状况、风力、风速、风向、相对湿度、大气压强、降水概率等。
城市覆盖范围：全球
认证开发者可获得24小时内逐三小时的预报数据，付费用户可选择未来24-168小时内逐1小时预报的数据
请求URL
付费：https://api.heweather.com/s6/weather/hourly?[parameters]
免费：https://free-api.heweather.com/s6/weather/hourly?[parameters]
parameters代表请求参数，包括必选和可选参数。所有请求参数均使用&进行分隔，参数值存在中文或特殊字符的情况，需要对参数进行 url encode。
请求参数
| 参数 | 描述 | 选择 | 示例值 |
|---|---|---|---|
| location | 需要查询的城市或地区，可输入以下值： 1. 城市ID：城市列表 2. 经纬度格式：经度,纬度（经度在前纬度在后，英文 ,分隔，十进制格式，北纬东经为正，南纬西经为负3. 城市名称，支持中英文和汉语拼音 4. 城市名称，上级城市 或 省 或 国家，英文 ,分隔，此方式可以在重名的情况下只获取想要的地区的天气数据，例如 西安,陕西5. IP 6. 根据请求自动判断，根据用户的请求获取IP，通过 IP 定位并获取城市数据 |
必选 | 1. location=CN101010100 2. location=116.40,39.9 3. location=北京、 location=北京市、 location=beijing 4. location=朝阳,北京、 location=chaoyang,beijing 5. location=60.194.130.1 6. location=auto_ip |
| lang | 多语言，可以不使用该参数，默认为简体中文 详见多语言参数 |
可选 | lang=en |
| unit | 单位选择，公制（m）或英制（i），默认为公制单位 详见度量衡单位参数 |
可选 | unit=i |
| key | 用户认证key，登录控制台可查看 支持数字签名方式进行认证，推荐使用 |
必选 | key=xxxxxxxxxxxxxx |
返回字段和数值说明
basic 基础信息
| 参数 | 描述 | 示例值 |
|---|---|---|
| location | 地区／城市名称 | 海淀 |
| cid | 地区／城市ID | CN101080402 |
| lat | 地区／城市纬度 | 39.956074 |
| lon | 地区／城市经度 | 116.310316 |
| parent_city | 该地区／城市的上级城市 | 北京 |
| admin_area | 该地区／城市所属行政区域 | 北京 |
| cnty | 该地区／城市所属国家名称 | 中国 |
| tz | 该地区／城市所在时区 | +8.0 |
update 接口更新时间
| 参数 | 描述 | 示例值 |
|---|---|---|
| loc | 当地时间，24小时制，格式yyyy-MM-dd HH:mm | 2017-10-25 12:34 |
| utc | UTC时间，24小时制，格式yyyy-MM-dd HH:mm | 2017-10-25 04:34 |
hourly 逐小时天气
| 参数 | 描述 | 示例 |
|---|---|---|
| time | 预报时间，格式yyyy-MM-dd HH:mm | 2013-12-30 13:00 |
| tmp | 温度 | 2 |
| cond_code | 天气状况代码 | 101 |
| cond_txt | 天气状况代码 | 多云 |
| wind_deg | 风向360角度 | 290 |
| wind_dir | 风向 | 西北 |
| wind_sc | 风力 | 3-4 |
| wind_spd | 风速，公里/小时 | 15 |
| hum | 相对湿度 | 30 |
| pres | 大气压强 | 1030 |
| pop | 降水概率，百分比 | 30 |
| dew | 露点温度 | 5 |
| cloud | 云量，百分比 | 15 |
status 接口状态
| 参数 | 描述 | 示例值 |
|---|---|---|
| status | 接口状态，具体含义请参考接口状态码及错误码 | ok |
数据返回示例
{ "HeWeather6": [ { "basic": { "cid": "CN101010100", "location": "北京", "parent_city": "北京", "admin_area": "北京", "cnty": "中国", "lat": "39.90498734", "lon": "116.40528870", "tz": "8.0" }, "hourly": [ { "cloud": "8", "cond_code": "100", "cond_txt": "晴", "hum": "84", "pop": "0", "pres": "1018", "time": "2017-10-27 01:00", "tmp": "8", "wind_deg": "49", "wind_dir": "东北风", "wind_sc": "微风", "wind_spd": "2" }, { "cloud": "8", "cond_code": "100", "cond_txt": "晴", "hum": "81", "pop": "0", "pres": "1018", "time": "2017-10-27 04:00", "tmp": "8", "wind_deg": "29", "wind_dir": "东北风", "wind_sc": "微风", "wind_spd": "2" }, { "cloud": "6", "cond_code": "100", "cond_txt": "晴", "hum": "95", "pop": "0", "pres": "1019", "time": "2017-10-27 07:00", "tmp": "8", "wind_deg": "37", "wind_dir": "东北风", "wind_sc": "微风", "wind_spd": "2" }, { "cloud": "2", "cond_code": "100", "cond_txt": "晴", "hum": "75", "pop": "0", "pres": "1018", "time": "2017-10-27 10:00", "tmp": "14", "wind_deg": "108", "wind_dir": "东南风", "wind_sc": "微风", "wind_spd": "3" }, { "cloud": "0", "cond_code": "100", "cond_txt": "晴", "hum": "62", "pop": "0", "pres": "1016", "time": "2017-10-27 13:00", "tmp": "16", "wind_deg": "158", "wind_dir": "东南风", "wind_sc": "微风", "wind_spd": "6" }, { "cloud": "0", "cond_code": "100", "cond_txt": "晴", "hum": "73", "pop": "0", "pres": "1016", "time": "2017-10-27 16:00", "tmp": "15", "wind_deg": "162", "wind_dir": "东南风", "wind_sc": "微风", "wind_spd": "6" }, { "cloud": "3", "cond_code": "100", "cond_txt": "晴", "hum": "92", "pop": "0", "pres": "1018", "time": "2017-10-27 19:00", "tmp": "13", "wind_deg": "206", "wind_dir": "西南风", "wind_sc": "微风", "wind_spd": "4" }, { "cloud": "19", "cond_code": "100", "cond_txt": "晴", "hum": "96", "pop": "0", "pres": "1019", "time": "2017-10-27 22:00", "tmp": "13", "wind_deg": "212", "wind_dir": "西南风", "wind_sc": "微风", "wind_spd": "1" } ], "status": "ok", "update": { "loc": "2017-10-26 23:09", "utc": "2017-10-26 15:09" } } ] }