接口介绍
未来24-168个小时，逐小时的天气预报数据数据，具体包含的数据：温度、天气状况、风力、风速、风向、相对湿度、大气压强、降水概率等。
城市覆盖范围：全球
认证开发者可获得24小时内逐三小时的预报数据，付费用户可选择未来24-168小时内逐1小时预报的数据
请求URL
付费：https://api.heweather.net/s6/weather/hourly?parameters
免费：https://free-api.heweather.net/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 支持数字签名方式进行认证，推荐使用 |
必选 | 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"
}
}
]
}