如何获取OpenWeather API Key 密钥（分步指南）

在气象服务与数据整合领域，OpenWeather 是一项强大的工具。它为开发者提供全球天气数据、历史气候记录以及未来天气预报等丰富功能，能够广泛应用于天气预警、旅游规划、农业生产等场景。要使用 OpenWeather 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`	必需的
`lon`	必需的
`appid`	必需的
`mode`	选修的
`units`	选修的
`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的应用效果。无论是初学者还是专业开发者，都可以通过本文获得清晰的指导和实用的建议。