如何获取OpenWeather API密钥 (分步指南)

在气象服务与数据整合领域，OpenWeather 是一项强大的工具。它为开发者提供全球天气数据、历史气候记录以及未来天气预报等丰富功能，能够广泛应用于天气预警、旅游规划、农业生产等场景。要使用 OpenWeather API，需要通过官网注册并申请 API 密钥。密钥是调用 API 的核心凭证，用于确保接口安全和访问合规。在申请密钥后，开发者可以通过该 API 实现高效的天气数据集成和分析，为用户提供实时、精准的天气服务。

1. 获取OpenWeather API秘钥步骤

获取OpenWeather API密钥的过程相对简单，只需几个步骤即可完成：

1.访问官方网站注册/登录：https://home.openweathermap.org/users/sign_in

2.邮箱验证：新注册的用户登录成功以后会进入控制台页面，需要到自己填写的邮箱中点击验证。（注意：前往填写的邮箱中去验证）

3.查看是否验证成功：验证成功后页面会有提示，验证成功后进行后续操作。

4.查看API密钥：点击顶部TAB栏中的“API密钥”进入API密钥页面，密钥会在这里显示，右侧可以新建新的密钥。

2. OpenWeather API密钥可用性测试

在获取API密钥后，进行可用性测试是确保其正常工作的重要步骤。以下是使用CURL进行测试的一个案例

输入：

curl -X GET "https://api.openweathermap.org/data/2.5/weather?lat=44.34&lon=10.99&appid={API key}"

输出：

你将得到一个JSON格式的响应，其中包含了地理位置的当前天气状况，如坐标信息、天气信息的列表、数据来源、云量信息、风速信息等。

示例输出：

{
  "coord": {
      "lon": 10.99,
      "lat": 44.34
  },
  "weather": [
      {
          "id": 804,
          "main": "Clouds",
          "description": "overcast clouds",
          "icon": "04d"
      }
  ],
  "base": "stations",
  "main": {
      "temp": 280.2,
      "feels_like": 279.2,
      "temp_min": 278.82,
      "temp_max": 280.52,
      "pressure": 1001,
      "humidity": 61,
      "sea_level": 1001,
      "grnd_level": 933
  },
  "visibility": 10000,
  "wind": {
      "speed": 1.71,
      "deg": 191,
      "gust": 5.87
  },
  "clouds": {
      "all": 100
  },
  "dt": 1732197627,
  "sys": {
      "type": 2,
      "id": 2004688,
      "country": "IT",
      "sunrise": 1732170014,
      "sunset": 1732203845
  },
  "timezone": 3600,
  "id": 3163858,
  "name": "Zocca",
  "cod": 200
}

3. 使用OpenWeather API搭建应用的其他关键考虑因素

在使用OpenWeather API搭建应用时，除了获取和测试API密钥外，还需考虑以下因素：

请求参数（当前天气数据）

参数
`lat`	必需的	纬度。如果您需要地理编码器自动将城市名称和邮政编码转换为地理坐标或反之，请使用我们的地理编码 API
`lon`	必需的	经度。如果您需要地理编码器自动将城市名称和邮政编码转换为地理坐标或反之，请使用我们的地理编码 API
`appid`	必需的	您唯一的 API 密钥（您始终可以在帐户页面的“API 密钥”选项卡下找到它）
`mode`	选修的	响应格式。可能的值为`xml`和`html` 。如果不使用`mode`参数格式默认为JSON。了解更多
`units`	选修的	测量单位。 `standard` 、 `metric`和`imperial` 单位可用。如果不使用`units`参数， `standard` 默认情况下将应用单位。了解更多
`lang`	选修的	您可以使用此参数获取您的语言的输出。了解更多

错误处理

错误代码	错误描述	解决方法
400	错误请求：缺少必需参数或参数格式不正确/值超出范围。	检查请求参数，确保所有必需参数正确传递，格式和值符合要求。缺失或错误的参数名称会在 `ErrorResponse.parameters` 中返回。
401	未经授权：未提供 API 令牌或令牌无访问权限。	确保在请求中添加具有 API 访问权限的令牌。
404	未找到：请求的参数（如 `lat`、`lon`、`date`）在服务数据库中不存在。	确保请求参数正确，不重试相同请求。
429	请求过多：超出 API 请求配额。	等待一段时间后重试，或延长 API 密钥的请求配额。
5xx	意外错误：内部服务器问题。错误代码以 `5xx` 开头。	联系支持团队，提供导致错误的 API 请求示例，以便分析和解决问题。可以重试导致此错误的请求。

数据准确性与覆盖范围

确保目标应用的服务范围与OpenWeather提供的地理数据覆盖相匹配，尤其是全球天气服务需求。验证特定地点数据的准确性以满足用户需求。

免费计划每日限制

每天 1,000 次免费 API 调用超出每日限额的每次 API 调用0.0015 美元

每月最多1,000,000 次免费请求

4. OpenWeather API密钥申请和使用中的常见问题

在申请和使用 OpenWeather API密钥过程中，你可能会遇到以下常见问题：

1. 我需要激活我的 API 密钥吗？

您的 API 密钥将在您成功注册后 2 小时内自动激活。

2. 如何在 API 调用中使用 API 密钥？

为了授权您的请求并处理它，我们要求您在每个 API 调用中使用您唯一的 API 密钥。

为此，请将您的 API 密钥作为appid参数添加到 GET 请求中，如下例所示：

api.openweathermap.org/data/2.5/weather?id=524901&appid=YOUR_API_KEY

只需使用您的 API 密钥，而不是“YOUR_API_KEY”和您的个人 API 密钥，它可以在您的个人帐户的“API 密钥”页面上找到。您还可以在那里创建其他 API 密钥。

3. 提供的历史天气数据的深度是多少？

我们提供 45 年前（自 1979 年 1 月 1 日起）任何地点的历史天气数据。您可以在我们“定价”页面的历史天气系列部分找到有关特定产品的更多信息。

4. 什么是“按需付费”订阅类型？此订阅包含哪些内容？

“按调用付费”订阅类型是指您只需按照对产品的 API 调用次数付费的订阅类型。此订阅类型适用于One Call API 3.0和Solar Irradiance API产品。请注意，每种产品都有单独的“按需付费”订阅和价格。

如果您准备订阅“按需付费”订阅类型，请参阅定价页面。

5. OpenWeather API进阶指引

在获得OpenWeather API密钥之后，即可开启API接口对接，本文整理了多篇使用OpenWeather API的案例，帮助读者更有效地使用OpenWeather API：

获取当前和预报的天气数据、获取指定时间天气数据、获取16天/每日预测数据、获取30天/每日预测数据

6. 常见问题

问题1：什么是幂简集成平台？

幂简集成是蜜堂有信在2023年打造的一款SAAS产品，建设着国内最全的API平台，为开发者提供全面、高效、易用的API集成管理方案，一站搜索、试用、集成国内和国外API。让用户在AI时代全方位接入互联网，用API连接一切服务和算力，实现价值倍增。

问题2：如何找到OpenWeather API

幂简API平台可以通过以下两种方式找到所需API：通过关键词搜索API(例如，输入’OpenWeather API‘这类品类词，更容易找到结果)、或者从API hub分类页进入寻找。

问题3：OpenWeather API的替代品有哪些？

市场上存在免费、付费两种替代者

例如

更多竞品可以在OpenWeather开放平台找到。

7. 总结

本文围绕OpenWeather API的使用展开，涵盖了API密钥的获取与可用性测试、请求参数与错误处理、常见问题解答以及其他关键使用注意事项。同时，结合实际案例和替代产品的对比分析，为开发者提供了多角度的参考，帮助快速入门并优化API的应用效果。无论是初学者还是专业开发者，都可以通过本文获得清晰的指导和实用的建议。