和风天气接口
时间: 2025-06-06 19:15:23 浏览: 24
### 和风天气 API 接口使用说明
和风天气(He Weather)是一款功能强大的天气查询服务,支持多种编程语言集成。以下是关于其 API 的使用方法和集成方式的详细介绍:
#### 1. 注册与获取 API Key
在使用和风天气 API 之前,需要先注册账户并获取 API Key。API Key 是访问接口的必要凭证[^1]。用户可以通过登录和风天气官网,进入开发者中心完成注册,并申请免费或付费版本的 API Key。
#### 2. API 请求地址
和风天气提供多个 API 接口,以下为常用的请求地址:
- **实时天气查询**:`https://devapi.qweather.com/v7/weather/now`
- **逐小时天气预报**:`https://devapi.qweather.com/v7/weather/24h`
- **逐天天气预报**:`https://devapi.qweather.com/v7/weather/3d`
每个接口都需要通过 HTTPS 协议进行调用,并附带相应的参数和 API Key[^2]。
#### 3. 请求参数
请求和风天气 API 时,需提供以下关键参数:
- `key`:用户的 API 密钥。
- `location`:查询地点,可以是城市名称、城市 ID 或经纬度坐标。
- `lang`:返回结果的语言,默认为简体中文(zh-CN)。
- `unit`:单位系统,默认为公制单位(m)。
示例代码如下:
```python
import requests
def fetch_weather(location):
url = "https://devapi.qweather.com/v7/weather/now"
params = {
"key": "your_api_key", # 替换为你的 API Key
"location": location,
"lang": "zh-CN",
"unit": "m"
}
response = requests.get(url, params=params)
if response.status_code == 200:
return response.json()
else:
return None
weather_data = fetch_weather("北京")
if weather_data:
print(weather_data)
else:
print("请求失败")
```
#### 4. 返回结果解析
和风天气 API 的返回结果为 JSON 格式,包含以下主要字段:
- `code`:状态码,表示请求是否成功。
- `updateTime`:数据更新时间。
- `fxLink`:天气预报网页链接。
- `now`:实时天气信息,包括温度、湿度、天气状况等。
例如,实时天气查询的结果可能如下所示:
```json
{
"code": "200",
"updateTime": "2023-10-01T12:00+08:00",
"fxLink": "https://www.qweather.com/weather/beijing.html",
"now": {
"text": "多云",
"icon": "101",
"temp": "22",
"feelsLike": "20",
"humidity": "50",
"precip": "0.0",
"windDir": "东南风",
"windSpeed": "10",
"windScale": "2"
}
}
```
#### 5. 注意事项
- 免费版 API 有调用频率限制,通常为每分钟 10 次或每日 500 次,请根据实际需求选择合适的套餐[^3]。
- 确保请求的地点参数正确无误,否则可能导致返回空数据或错误信息。
- 在生产环境中,建议将 API Key 存储在安全的地方,避免泄露。
阅读全文
相关推荐
















