逐日天气预报和昨日天气
获取指定城市未来最多 15 天每天的白天和夜间预报,以及昨日的历史天气。付费用户可获取全部数据,免费用户只返回 3 天天气预报。
更新频率查看
请求地址示例
- 北京今天和未来 4 天的预报 https://api.seniverse.com/v3/weather/daily.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c&start=0&days=5
- 北京的昨日天气、今天和未来 3 天的预报(昨日天气独立于逐日天气预报,需要单独购买) https://api.seniverse.com/v3/weather/daily.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c&start=-1&days=5
参数
参数名 | 类型 | 默认值 | 必须 | 备注 |
---|---|---|---|---|
key | String | 无 | 是 | 你的 API 密钥 |
location | Location | 无 | 是 | 所查询的位置 |
language | Language | zh-Hans | 否 | 语言 |
unit | Unit | c | 否 | 单位 |
start | Start | 0 | 否 | 起始时间 |
days | Int | 权限允许的最多天数 | 否 | 天数 |
返回结果
{
"results": [{
"location": {
"id": "WX4FBXXFKE4F",
"name": "北京",
"country": "CN",
"path": "北京,北京,中国",
"timezone": "Asia/Shanghai",
"timezone_offset": "+08:00"
},
"daily": [{ //返回指定days天数的结果
"date": "2015-09-20", //日期
"text_day": "多云", //白天天气现象文字
"code_day": "4", //白天天气现象代码
"text_night": "晴", //晚间天气现象文字
"code_night": "0", //晚间天气现象代码
"high": "26", //当天最高温度
"low": "17", //当天最低温度
"precip": "0", //降水概率,范围0~100,单位百分比(目前仅支持国外城市)
"wind_direction": "", //风向文字
"wind_direction_degree": "255", //风向角度,范围0~360
"wind_speed": "9.66", //风速,单位km/h(当unit=c时)、mph(当unit=f时)
"wind_scale": "", //风力等级
"rainfall": "0.0", //降水量,单位mm
"humidity": "76" //相对湿度,0~100,单位为百分比
}, {
"date": "2015-09-21",
"text_day": "晴",
"code_day": "0",
"text_night": "晴",
"code_night": "0",
"high": "27",
"low": "17",
"precip": "0",
"wind_direction": "",
"wind_direction_degree": "157",
"wind_speed": "17.7",
"wind_scale": "3",
"rainfall": "0.0",
"humidity": "76"
}, {
... //更多返回结果
}],
"last_update": "2015-09-20T18:00:00+08:00" //数据更新时间(该城市的本地时间)
}]
}
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
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