从0到1：手把手教你调用天气API

目录

一、探秘天气 API

二、前期准备：申请 API Key

三、环境搭建：Python 与依赖库安装

（一）安装 Python

（二）安装依赖库

四、编写调用代码

（一）引入依赖库

（二）鉴权处理

（三）构建请求

（四）发送请求与处理响应

五、封装成调用模板

（一）函数定义

（二）参数设置

六、实战应用：获取并展示天气

（一）调用示例

（二）数据展示

七、总结与拓展

---

一、探秘天气 API

在日常生活中，天气状况深刻影响着我们的出行、着装，甚至是心情。而在软件开发领域，天气 API 就像是一座桥梁，将气象数据与我们的应用程序紧密相连，为其赋予实时获取天气信息的能力。无论是开发一款贴心的生活类 APP，还是打造一个功能丰富的网站，天气 API 都能为用户提供极具价值的天气资讯，大幅提升用户体验。接下来，我将以心知天气 API 为例，为大家详细介绍如何调用天气 API，制作开箱即用的调用模板，并进行环境配置说明和带鉴权处理的代码实现。

二、前期准备：申请 API Key

在调用心知天气 API 之前，我们首先需要申请一个 API Key，它就像是一把钥匙，为我们打开了访问心知天气数据的大门。只有拥有了这把 “钥匙”，我们的应用程序才能合法地向心知天气服务器发送请求，获取所需的天气信息。下面，我将为大家详细介绍申请 API Key 的步骤。

1. 注册账号：首先，打开心知天气的官方网站心知天气开放平台 ，在页面右上角找到 “注册” 按钮，点击进入注册页面。在这里，您需要填写有效的邮箱地址、设置密码，并按照提示完成验证码的验证。填写完成后，点击 “注册” 按钮，系统将发送一封验证邮件到您填写的邮箱。登录邮箱，点击验证链接，完成账号注册。

1. 找到申请入口：成功注册并登录心知天气开放平台后，在页面中找到 “控制台” 选项，点击进入控制台页面。在控制台页面中，您可以看到各种与您账号相关的信息和设置选项。在左侧菜单栏中，找到 “API 密钥” 选项，点击它，即可进入 API Key 的申请页面。

1. 填写信息获得 API Key：在 API Key 申请页面，您可能需要填写一些基本信息，如应用名称、应用描述等。这些信息可以帮助您更好地管理和识别自己的 API Key。填写完成后，点击 “创建 API Key” 按钮，系统将为您生成一个独一无二的 API Key。请务必妥善保管这个 API Key，它是您访问心知天气 API 的重要凭证，一旦泄露，可能会导致您的 API 访问出现安全问题。

三、环境搭建：Python 与依赖库安装

在开始编写调用心知天气 API 的代码之前，我们需要先搭建好 Python 开发环境，并安装必要的依赖库。下面，我将为大家详细介绍环境搭建的步骤。

（一）安装 Python

Python 是一种广泛使用的高级编程语言，具有简洁、易读、易维护等特点，非常适合用于开发各类应用程序，包括调用 API 获取天气数据。你可以按照以下步骤安装 Python：

1. 下载 Python 安装包：打开你的浏览器，访问 Python 官方网站Python 官网 。在官网首页，你可以看到 “Downloads” 按钮，点击它，进入下载页面。在下载页面中，根据你的操作系统类型（Windows、Mac OS 或 Linux），选择对应的 Python 版本进行下载。建议下载最新的稳定版本，以获取更好的性能和功能支持。

1. 运行安装程序：下载完成后，找到下载的 Python 安装包，双击运行它。在安装向导界面中，你可以选择 “Install Now” 进行快速安装，也可以选择 “Customize installation” 进行自定义安装。如果选择自定义安装，你可以指定 Python 的安装路径、选择要安装的组件等。在安装过程中，请务必勾选 “Add Python to PATH” 选项，这样可以将 Python 的安装路径添加到系统环境变量中，方便后续在命令行中使用 Python 命令。

1. 验证安装结果：安装完成后，打开命令提示符（在 Windows 系统中，可以通过按下 Win+R 键，输入 “cmd” 并回车来打开；在 Mac OS 系统中，可以通过打开 “终端” 应用来打开）。在命令提示符中输入 “python --version”，如果显示出 Python 的版本号，说明 Python 已经成功安装。

（二）安装依赖库

在 Python 中，我们可以使用requests库来发送 HTTP 请求，获取心知天气 API 返回的天气数据。requests库是一个非常强大且易用的 HTTP 库，它简化了 HTTP 请求的发送和处理过程。你可以使用以下命令安装requests库：

打开命令提示符，输入以下命令：

pip install requests

在执行上述命令时，请确保你的网络连接正常，以便pip工具能够从 Python Package Index（PyPI）上下载并安装requests库。如果你的网络连接较慢，可能需要一些时间来完成安装。安装完成后，你可以在命令提示符中输入以下命令来验证requests库是否安装成功：

pip show requests

如果显示出requests库的相关信息，如版本号、作者、概要等，说明requests库已经成功安装。

四、编写调用代码

在完成环境搭建和 API Key 申请后，我们就可以开始编写调用心知天气 API 的代码了。下面，我将为大家详细介绍如何使用 Python 编写调用代码，实现获取指定城市的天气信息。

（一）引入依赖库

在 Python 文件开头，我们需要引入requests库，它将帮助我们发送 HTTP 请求，获取心知天气 API 返回的天气数据。引入requests库的代码如下：

import requests

（二）鉴权处理

心知天气 API 使用 API Key 进行鉴权，API Key 是我们访问 API 的身份凭证。在发送请求时，我们需要将 API Key 添加到请求头或请求参数中，以便服务器验证我们的身份。在 Python 代码中，我们可以通过在请求头中添加X-Seniverse-Key字段来实现鉴权，代码如下：

# 设置API Key

api_key = 'your_api_key'

# 设置请求头

headers = {

'X-Seniverse-Key': api_key

}

请将your_api_key替换为你在心知天气开放平台申请到的 API Key。这样，当我们发送请求时，服务器就可以通过验证X-Seniverse-Key字段来确认我们的身份，确保只有合法的用户才能访问 API。

（三）构建请求

接下来，我们需要确定 API 地址，并根据心知天气 API 的文档说明，构建包含城市、日期等参数的请求。心知天气 API 提供了丰富的接口，我们可以根据自己的需求选择合适的接口。例如，如果我们想要获取当前城市的实时天气信息，可以使用以下 API 地址：

# 设置API地址

url = 'https://api.seniverse.com/v3/weather/now.json'

然后，我们需要设置请求参数，包括城市名称、语言、单位等。以获取北京市的实时天气信息为例，设置请求参数的代码如下：

# 设置请求参数

params = {

'location': 'beijing',

'language': 'zh-Hans',

'unit': 'c'

}

在上述代码中，location参数表示城市名称，language参数表示返回结果的语言类型，zh-Hans表示简体中文，unit参数表示温度单位，c表示摄氏度。你可以根据自己的需求修改这些参数。

（四）发送请求与处理响应

构建好请求后，我们就可以使用requests库发送请求，并处理服务器返回的响应了。在发送请求时，我们使用requests.get()方法，并传入 API 地址、请求头和请求参数。同时，我们还需要处理可能出现的异常情况，确保程序的稳定性。解析返回的 JSON 数据，提取我们需要的天气信息。完整的代码如下：

import requests

# 设置API Key

api_key = 'your_api_key'

# 设置请求头

headers = {

'X-Seniverse-Key': api_key

}

# 设置API地址

url = 'https://api.seniverse.com/v3/weather/now.json'

# 设置请求参数

params = {

'location': 'beijing',

'language': 'zh-Hans',

'unit': 'c'

}

try:

# 发送请求

response = requests.get(url, headers=headers, params=params)

# 检查请求是否成功

response.raise_for_status()

# 解析返回的JSON数据

data = response.json()

# 提取天气信息

city = data['results'][0]['location']['name']

weather = data['results'][0]['now']['text']

temperature = data['results'][0]['now']['temperature']

print(f"{city}的实时天气：{weather}，温度：{temperature}℃")

except requests.exceptions.RequestException as e:

print(f"请求发生错误：{e}")

在上述代码中，我们使用try-except语句捕获可能出现的异常。如果请求成功，我们使用response.json()方法将返回的 JSON 数据解析为 Python 字典，然后从中提取城市名称、天气状况和温度信息并打印输出。如果请求发生错误，我们将打印错误信息，方便调试。

五、封装成调用模板

（一）函数定义

为了使代码更加模块化和易于复用，我们可以将获取天气数据的代码封装成一个函数。这样，在需要获取天气信息的地方，只需调用这个函数即可，而无需重复编写相同的代码。函数定义如下：

import requests

def get_weather(city, api_key, language='zh-Hans', unit='c'):

# 设置请求头

headers = {

'X-Seniverse-Key': api_key

}

# 设置API地址

url = 'https://api.seniverse.com/v3/weather/now.json'

# 设置请求参数

params = {

'location': city,

'language': language,

'unit': unit

}

try:

# 发送请求

response = requests.get(url, headers=headers, params=params)

# 检查请求是否成功

response.raise_for_status()

# 解析返回的JSON数据

data = response.json()

# 提取天气信息

city = data['results'][0]['location']['name']

weather = data['results'][0]['now']['text']

temperature = data['results'][0]['now']['temperature']

return {

'city': city,

'weather': weather,

'temperature': temperature

}

except requests.exceptions.RequestException as e:

print(f"请求发生错误：{e}")

return None

在上述代码中，我们定义了一个名为get_weather的函数，它接受四个参数：city表示要查询天气的城市名称，api_key是心知天气 API 的密钥，language表示返回结果的语言类型，默认为简体中文，unit表示温度单位，默认为摄氏度。函数内部按照之前讲解的步骤，构建请求、发送请求并处理响应，最后返回一个包含城市、天气和温度信息的字典。如果请求过程中发生错误，函数将打印错误信息并返回None。

（二）参数设置

在函数定义中，我们已经设置了一些默认参数，如language='zh-Hans'和unit='c'。这样做的好处是，当用户调用函数时，如果不传入这些参数，函数将使用默认值，从而简化了函数的调用。例如，如果我们只需要查询北京市的天气信息，并且使用默认的语言和温度单位，可以这样调用函数：

api_key = 'your_api_key'

weather_info = get_weather('beijing', api_key)

if weather_info:

print(f"{weather_info['city']}的实时天气：{weather_info['weather']}，温度：{weather_info['temperature']}℃")

如果用户需要查询其他语言的天气信息，或者使用其他温度单位，可以在调用函数时传入相应的参数。例如，查询纽约市的天气信息，并且使用英文显示结果，温度单位为华氏度，可以这样调用函数：

api_key = 'your_api_key'

weather_info = get_weather('new york', api_key, language='en', unit='f')

if weather_info:

print(f"{weather_info['city']}的实时天气：{weather_info['weather']}，温度：{weather_info['temperature']}℉")

通过设置默认参数，我们的函数可以适应不同的场景，提高了模板的通用性。同时，用户在使用函数时也更加灵活，可以根据自己的需求传入不同的参数，获取所需的天气信息。

六、实战应用：获取并展示天气

（一）调用示例

现在，我们已经拥有了一个功能强大的获取天气信息的模板函数，接下来让我们看看如何使用它来获取北京明天的天气信息。心知天气 API 提供了获取未来天气预报的接口，我们只需要对之前的代码稍作修改，就可以实现这个功能。

首先，修改 API 地址为获取天气预报的接口地址：

# 设置API地址，获取未来天气预报

url = 'https://api.seniverse.com/v3/weather/daily.json'

然后，修改请求参数，指定查询的天数和具体日期。例如，我们要获取北京明天的天气信息，可以这样设置参数：

# 设置请求参数

params = {

'location': 'beijing',

'language': 'zh-Hans',

'unit': 'c',

'days': 2, # 获取未来2天的天气预报，包含今天

'start': 1 # 从明天开始（索引从0开始，0表示今天，1表示明天）

}

最后，修改函数内部解析数据的部分，提取明天的天气信息：

def get_weather(city, api_key, language='zh-Hans', unit='c', days=2, start=0):

# 设置请求头

headers = {

'X-Seniverse-Key': api_key

}

# 设置API地址，获取未来天气预报

url = 'https://api.seniverse.com/v3/weather/daily.json'

# 设置请求参数

params = {

'location': city,

'language': language,

'unit': unit,

'days': days,

'start': start

}

try:

# 发送请求

response = requests.get(url, headers=headers, params=params)

# 检查请求是否成功

response.raise_for_status()

# 解析返回的JSON数据

data = response.json()

# 提取天气信息

city = data['results'][0]['location']['name']

weather = data['results'][0]['daily'][start]['text_day']

temperature = data['results'][0]['daily'][start]['high'] + '/' + data['results'][0]['daily'][start]['low']

return {

'city': city,

'weather': weather,

'temperature': temperature

}

except requests.exceptions.RequestException as e:

print(f"请求发生错误：{e}")

return None

使用这个修改后的函数获取北京明天的天气信息，示例代码如下：

api_key = 'your_api_key'

weather_info = get_weather('beijing', api_key, start=1)

if weather_info:

print(f"{weather_info['city']}明天的天气：{weather_info['weather']}，温度：{weather_info['temperature']}℃")

（二）数据展示

在实际应用中，我们通常需要将获取到的天气数据以更易读、更直观的方式展示给用户。展示方式有很多种，对于简单的测试和调试，我们可以将数据打印到控制台，方便查看和分析。比如在之前的代码中，我们已经使用print函数将天气信息打印出来：

if weather_info:

print(f"{weather_info['city']}明天的天气：{weather_info['weather']}，温度：{weather_info['temperature']}℃")

这样，当我们运行代码时，就能在控制台看到清晰的天气信息。如果是开发一个 Web 应用，我们可以将天气数据渲染到 HTML 页面上，使用 HTML 和 CSS 来设计美观的界面，为用户呈现友好的视觉效果。比如使用 JavaScript 的document对象来操作 DOM，将天气数据插入到 HTML 页面的指定位置：

<!DOCTYPE html>

<html lang="zh-CN">

<head>

<meta charset="UTF-8">

<title>天气信息</title>

</head>

<body>

<h1 id="city"></h1>

<p id="weather"></p>

<p id="temperature"></p>

<script>

// 假设已经从后端获取到天气数据

const weatherInfo = {

"city": "北京",

"weather": "多云",

"temperature": "25/18"

};

document.getElementById('city').innerText = weatherInfo.city + '的天气';

document.getElementById('weather').innerText = '天气状况：' + weatherInfo.weather;

document.getElementById('temperature').innerText = '温度：' + weatherInfo.temperature + '℃';

</script>

</body>

</html>

如果是开发移动应用，我们可以使用相应的移动开发框架，如 React Native、Flutter 等，利用它们提供的组件来展示天气数据，实现与用户的交互。

七、总结与拓展

通过上述步骤，我们已经成功实现了使用 Python 调用心知天气 API，获取并展示天气信息的功能。整个过程主要包括申请 API Key、搭建 Python 开发环境并安装依赖库、编写调用代码、封装成调用模板以及在实战中应用获取并展示天气数据。

在实际应用中，你可以根据自己的需求对代码进行进一步的优化和扩展。例如，结合 Web 开发技术，使用 Flask、Django 等 Web 框架，将天气数据展示在网页上，实现一个功能完善的天气查询网站。你还可以将天气数据与地图相结合，使用百度地图 API、高德地图 API 等，在地图上标注出不同城市的天气状况，为用户提供更加直观的天气信息展示。此外，考虑到 API 的调用频率限制和网络请求的性能问题，你可以添加缓存机制，将获取到的天气数据缓存起来，在一定时间内重复使用，减少对 API 的调用次数，提高应用的响应速度。希望本文能为你在调用天气 API 方面提供有益的参考，让你能够轻松地将天气信息集成到自己的应用程序中，为用户带来更好的体验。