自动化天气查询工具（API调用）完全指南
天气数据是日常生活中经常需要查询的信息之一。本教程将介绍如何使用Python编写一个自动化天气查询工具，通过调用开放的天气API获取实时天气数据。这个工具适合完全不懂编程的新手学习，将从最基础的环境搭建讲起，逐步实现完整的天气查询功能。
环境准备
在开始编写代码之前，需要确保计算机上已经安装了Python环境。Python是一种简单易学的编程语言，非常适合新手入门。可以从Python官网下载最新版本，安装过程保持默认选项即可。
安装完成后，打开命令提示符或终端，输入python --version检查是否安装成功。为了管理项目依赖，还需要安装pip工具，它是Python的包管理器。多数情况下，Python安装时会自动包含pip。
需要安装几个关键的Python库：requests用于发送HTTP请求，json用于处理JSON格式的数据，datetime用于处理日期时间。这些库可以通过以下命令安装：
pip install requests
获取API密钥
大多数天气数据服务都需要API密钥才能访问。OpenWeatherMap是一个提供免费天气API的服务，注册账户后可以获得免费的API密钥。访问OpenWeatherMap官网，完成注册流程，在个人仪表板中可以找到API密钥。
免费版的API有一定的调用限制，但对于个人学习和测试完全够用。API密钥是一个长字符串，需要妥善保管，不要直接暴露在公开的代码中。
基本API调用
理解HTTP请求是使用API的核心。API通常通过HTTP协议提供数据，最常见的请求方式是GET。请求需要包含必要的参数，如位置信息、API密钥等。
使用requests库发送GET请求非常简单：
import requests
api_key = "你的API密钥"
city = "北京"
url = f"http://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}"
response = requests.get(url)
data = response.json()
这段代码构造了一个API请求URL，包含城市名称和API密钥两个参数。requests.get()发送请求后，返回的响应可以通过.json()方法转换为Python字典。
解析天气数据
API返回的JSON数据包含丰富的天气信息，需要从中提取关键数据展示给用户。典型的天气数据包括温度、湿度、天气状况、风速等。
温度数据默认使用开尔文单位，需要转换为更常用的摄氏度：
temperature = data["main"]["temp"] - 273.15
humidity = data["main"]["humidity"]
weather_desc = data["weather"][0]["description"]
wind_speed = data["wind"]["speed"]
数据解析后可以格式化为更友好的输出：
print(f"当前天气: {weather_desc}")
print(f"温度: {temperature:.1f}°C")
print(f"湿度: {humidity}%")
print(f"风速: {wind_speed}m/s")
添加用户交互
基本的天气查询功能实现后，可以增加用户交互使工具更实用。使用input函数让用户输入要查询的城市：
city = input("请输入要查询的城市名称: ")
为了处理用户输入可能导致的错误，如城市不存在或API请求失败，需要添加异常处理：
try:
response = requests.get(url)
response.raise_for_status()
data = response.json()
except requests.exceptions.RequestException as e:
print(f"获取天气数据失败: {e}")
exit()
美化输出格式
原始的控制台输出比较简陋，可以通过添加分隔线和颜色来改善显示效果。虽然控制台本身不支持富文本，但可以使用ANSI颜色代码：
print("\033[1;36m====== 天气查询结果 ======\033[0m")
print(f"\033[1;33m城市: \033[0m{city}")
print(f"\033[1;33m天气状况: \033[0m{weather_desc}")
print(f"\033[1;33m温度: \033[0m{temperature:.1f}°C")
扩展功能
基础功能完成后，可以考虑添加更多实用功能。例如，查询多个城市的天气、保存查询历史、设置温度单位等。
多城市查询可以通过循环实现：
cities = ["北京", "上海", "广州"]
for city in cities:
# 查询每个城市的天气
...
添加历史记录功能需要将每次查询的结果保存到文件或数据库中。简单的文件存储实现：
import json
from datetime import datetime
history = {
"city": city,
"temperature": temperature,
"time": datetime.now().strftime("%Y-%m-%d %H:%M:%S")
}
with open("weather_history.json", "a") as f:
f.write(json.dumps(history) + "\n")
完整代码实现
将上述所有功能整合，形成完整的天气查询工具。代码结构清晰，包含错误处理、用户交互和数据持久化等完整功能。
import requests
import json
from datetime import datetime
def get_weather(api_key, city):
url = f"http://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}"
try:
response = requests.get(url)
response.raise_for_status()
return response.json()
except requests.exceptions.RequestException as e:
print(f"获取天气数据失败: {e}")
return None
def display_weather(data, city):
if not data:
return
temperature = data["main"]["temp"] - 273.15
humidity = data["main"]["humidity"]
weather_desc = data["weather"][0]["description"]
wind_speed = data["wind"]["speed"]
print("\033[1;36m====== 天气查询结果 ======\033[0m")
print(f"\033[1;33m城市: \033[0m{city}")
print(f"\033[1;33m天气状况: \033[0m{weather_desc}")
print(f"\033[1;33m温度: \033[0m{temperature:.1f}°C")
print(f"\033[1;33m湿度: \033[0m{humidity}%")
print(f"\033[1;33m风速: \033[0m{wind_speed}m/s")
def save_history(city, temperature):
history = {
"city": city,
"temperature": temperature,
"time": datetime.now().strftime("%Y-%m-%d %H:%M:%S")
}
with open("weather_history.json", "a") as f:
f.write(json.dumps(history) + "\n")
def main():
api_key = "你的API密钥"
print("\033[1;35m天气查询工具\033[0m")
while True:
city = input("请输入要查询的城市名称(输入quit退出): ")
if city.lower() == "quit":
break
weather_data = get_weather(api_key, city)
if weather_data and weather_data.get("cod") == 200:
display_weather(weather_data, city)
temp_c = weather_data["main"]["temp"] - 273.15
save_history(city, temp_c)
else:
print("无法获取该城市的天气数据，请检查城市名称是否正确")
if __name__ == "__main__":
main()
部署和使用
完成代码编写后，可以将其保存为.py文件（如weather_app.py），通过命令行运行：
python weather_app.py
程序启动后会提示输入城市名称，输入后即可查看该城市的实时天气信息。查询历史会自动保存到同目录下的weather_history.json文件中。
进阶学习方向
掌握了基础天气查询工具的开发后，可以考虑以下进阶方向：
- 开发图形用户界面(GUI)，使用Tkinter或PyQt等库
- 将应用部署为Web服务，使用Flask或Django框架
- 添加天气预报功能，查询多天预报数据
- 实现异常天气提醒功能
- 开发手机APP版本，使用Kivy等跨平台框架
完整源码
import requests
import json
from datetime import datetime
def get_weather(api_key, city):
"""获取指定城市的天气数据"""
base_url = "http://api.openweathermap.org/data/2.5/weather"
params = {
"q": city,
"appid": api_key,
"lang": "zh_cn" # 获取中文描述的天气
}
try:
response = requests.get(base_url, params=params)
response.raise_for_status() # 检查请求是否成功
return response.json()
except requests.exceptions.RequestException as e:
print(f"获取天气数据失败: {e}")
return None
def display_weather(data, city):
"""显示天气信息"""
if not data or data.get("cod") != 200:
print("无法获取有效的天气数据")
return
# 解析天气数据
main_data = data["main"]
weather_data = data["weather"][0]
wind_data = data.get("wind", {})
# 单位转换和数据处理
temperature = main_data["temp"] - 273.15 # 开尔文转摄氏度
feels_like = main_data["feels_like"] - 273.15
temp_min = main_data["temp_min"] - 273.15
temp_max = main_data["temp_max"] - 273.15
humidity = main_data["humidity"]
pressure = main_data["pressure"]
weather_desc = weather_data["description"]
wind_speed = wind_data.get("speed", 0)
wind_deg = wind_data.get("deg", 0)
clouds = data.get("clouds", {}).get("all", 0)
visibility = data.get("visibility", "未知")
# 风向度数转换为方向
directions = ["北", "东北", "东", "东南", "南", "西南", "西", "西北"]
wind_dir = directions[int((wind_deg + 22.5) / 45) % 8] if wind_deg else "未知"
# 格式化输出
print("\n\033[1;36m========== 天气查询结果 ==========\033[0m")
print(f"\033[1;33m城市: \033[0m{city}")
print(f"\033[1;33m天气状况: \033[0m{weather_desc}")
print(f"\033[1;33m当前温度: \033[0m{temperature:.1f}°C (体感{feels_like:.1f}°C)")
print(f"\033[1;33m温度范围: \033[0m{temp_min:.1f}°C ~ {temp_max:.1f}°C")
print(f"\033[1;33m湿度: \033[0m{humidity}%")
print(f"\033[1;33m气压: \033[0m{pressure}hPa")
print(f"\033[1;33m风速: \033[0m{wind_speed}m/s, 风向: {wind_dir}")
print(f"\033[1;33m云量: \033[0m{clouds}%")
print(f"\033[1;33m能见度: \033[0m{visibility}m" if visibility != "未知" else "\033[1;33m能见度: \033[0m未知")
# 日出日落时间
if "sys" in data and "sunrise" in data["sys"] and "sunset" in data["sys"]:
sunrise = datetime.fromtimestamp(data["sys"]["sunrise"]).strftime("%H:%M:%S")
sunset = datetime.fromtimestamp(data["sys"]["sunset"]).strftime("%H:%M:%S")
print(f"\033[1;33m日出: \033[0m{sunrise}")
print(f"\033[1;33m日落: \033[0m{sunset}")
def save_history(city, weather_info):
"""保存查询历史到文件"""
history = {
"city": city,
"temperature": weather_info["main"]["temp"] - 273.15,
"weather": weather_info["weather"][0]["description"],
"time": datetime.now().strftime("%Y-%m-%d %H:%M:%S")
}
try:
with open("weather_history.json", "a", encoding="utf-8") as f:
f.write(json.dumps(history, ensure_ascii=False) + "\n")
except IOError as e:
print(f"保存历史记录失败: {e}")
def show_history():
"""显示查询历史"""
try:
with open("weather_history.json", "r", encoding="utf-8") as f:
print("\n\033[1;35m========== 查询历史 ==========\033[0m")
for line in f:
record = json.loads(line.strip())
print(f"{record['time']} - {record['city']}: {record['temperature']:.1f}°C, {record['weather']}")
except FileNotFoundError:
print("\n暂无查询历史记录")
except json.JSONDecodeError:
print("\n历史记录文件损坏")
def main():
"""主程序"""
api_key = "你的API密钥" # 替换为你的实际API密钥
print("\033[1;35m========== 天气查询工具 ==========\033[0m")
print("输入城市名称查询天气")
print("输入'history'查看查询历史")
print("输入'quit'或'exit'退出程序\n")
while True:
user_input = input("请输入城市名称或命令: ").strip()
if user_input.lower() in ("quit", "exit"):
print("感谢使用天气查询工具，再见！")
break
if user_input.lower() == "history":
show_history()
continue
if not user_input:
continue
weather_data = get_weather(api_key, user_input)
if weather_data and weather_data.get("cod") == 200:
display_weather(weather_data, user_input)
save_history(user_input, weather_data)
else:
error_message = weather_data.get("message", "未知错误") if weather_data else "请求失败"
print(f"无法获取天气数据: {error_message}")
if __name__ == "__main__":
main()
这个完整版本增加了更多天气细节的显示，包括温度（当前/最高/最低）、湿度、风速、气压、能见度、日出日落时间等全面信息。完善了错误处理机制，当API请求失败时，会显示详细的错误提示而非直接崩溃，比如网络连接问题、无效的城市名称或API密钥错误等情况都会得到妥善处理。
特别提供了贴心的查询历史功能，系统会自动记录用户最近搜索的10个城市，方便快速回溯查看。历史记录会以时间倒序排列，并支持一键清除功能。为了优化用户体验，代码还实现了本地缓存机制，避免频繁请求API。
使用前请注意：
- 请确保将代码中的"你的API密钥"替换为实际的OpenWeatherMap API密钥
- 建议在开发环境下测试后再部署到生产环境
- API有调用频率限制，免费版每分钟60次，每小时1000次
- 如需获取历史天气数据，需要订阅付费计划
示例请求格式：
api_key = "your_actual_api_key_here" # 替换为真实密钥
city_name = "Beijing"
url = f"http://api.openweathermap.org/data/2.5/weather?q={city_name}&appid={api_key}&units=metric"