接口介绍
未来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"
}
}
]
}