Open-Meteo 文档使用指南

前面我写了一篇对 Open-Meteo 项目做简短介绍的推文：《Open-Meteo 助你实现气象数据自由！》。文中提到我要写一个系列专辑来介绍 Open-Meteo 项目的使用细节，那么今天我就来带着大家来近距离了解一下 Open-Meteo 的使用技巧。

优秀的说明文档

优秀的项目都一定会有优秀的说明文档，Open-Meteo 也不例外。我们可以通过主页 open-meteo.com 显示的 Documentation 按钮或者顶部导航栏中的 API Docs 按钮进入文档页面。

Open-Meteo 的说明文档页面，其实并不仅仅是一个说明文档，它还兼具了 API 测试调试的功能，可以直接根据自己的需要配置对应的参数信息直接调取数据。

我们先以主页默认的天气预报的 API 的页面为例，来看一看它的文档调试功能。

如下图所示，我们可以根据需要输入想要查询的经纬度坐标来获取对应位置的数据。

点击右侧的加号，还可以增加多个位置点。

在时间选择上，我们可以选择按预报长度设置获取未来多少天的预报，同时也可以设置对过去多长时间历史数据的获取。

除了按预报长度以外，我们还可以按起始和终止时间来选择预报区间。

完成了对时间和空间的配置，下面我们可以选择预报要素，从下图可以看到 Open-Meteo 提供了丰富的预报要素选择，除了常规的风温湿压降水以外，还包括了体感问题（Apparent Temperature）、降雪量、雪深、云、能见度、土壤温度和湿度等要素的预报。

继续往下看，可以发现它不仅提供了常规的预报要素，还可以提供如紫外线指数（UVI）、对流有效能量（CAPE)等专业的预报要素；此外，它还可以提供丰富的太阳辐射相关的预报产品；除了地面的预报要素以外，Open-Meteo 还提供了不同气压层高度的风温湿压要素的预报。

除了上述显示的逐小时级别的预报数据以外，它还可以提供一些 15 分钟间隔的预报数据。

毫不夸张地说，Open-Meteo 提供了极为丰富的预报产品种类。它不仅提供了丰富的预报要素，也提供了丰富的预报模型选择。下图显示的是 Open-Meteo 提供的可供选择的预报模型种类。

可以看到，Open-Meteo 除了能提供我们耳熟能详的 GFS、ECMWF，还能提供中国气象局的 GRAPES、日本的 JMA、德国的 DWD、法国 MeteoFrance等等，甚至有些预报模型说实话我之前都从没接触过。

根据 Open-Meteo 自己的说法，它除了给你这么多中预报源的选项以外，它还默认给你做了一层优化，即根据你的位置自动匹配质量最好的预报源，甚至声称可以做到所有模型的无缝衔接。

在要素种类方面，除了上述说到的逐小时、逐15分钟的要素以外，它也提供了逐日的要素，里面除了常规气象的要素以外，还能提供如日出日落、日间和夜间持续时间、紫外线指数等要素。

Open-Meteo 还提供“当前天气”的数据，但是根据它的解释，当前天气实际上是通过逐小时天气预报获取的，而非真实的观测数据。

当我们选择完了预报要素、时空配置、模型种类以后，最后我们还可以选择输出结果的单位信息，比如气温是使用摄氏度还是华氏度？风速是使用 m/s 还是 km/h 等等。

所有上面的配置完成以后，我们在预览窗口点击 Reload Chart 就可以直接查看这些数据的折线图！

它可以一次性把多种不同预报源的预报结果显示在一起，方便用户对不同预报源的结果做直接的比对，简直不要太方便，它在最后甚至还贴心地给你写好了 URL 地址。

当然，除了预览以外，如果我们点击 Python 标签，它会给你显示一段使用 Python 预报编写的数据查询的 demo，你就可以仿照这个 demo 很方便地把代码嵌入到自己的项目里。

在这部分调试功能结束以后，文档的后半部分对预报来源、预报要素、API 参数、枚举值含义等信息做了非常详细的解释和说明。

除了上述的天气预报以外，Open-Meteo 还提供了一些其他的与气象密切相关的功能和接口，例如地理查询、海拔高度查询、AQI数据、洪水查询等功能。其调试功能都大同小异，可以自行探索。

开放的授权形式

正如它的项目名称一样，Open-Meteo 秉持了一种开放的态度，对于使用者给予了最大程度的开放。根据官网对非商业用途套餐的简要描述：

Open-Meteo API 可免费用于非商业用途。我们不限制访问，但要求公平使用和署名。

请确保您的每日请求保持在 10,000 次以下。请注意，我们保留阻止滥用我们服务的应用程序和 IP 地址的权利。

虽然 Open-Meteo 的项目代码是开源的，但是该项目 API 的运营是会产生服务器和宽带成本的，但即便如此，该项目的 API 仍然对非商业用户的免费调用不做限制。当然，对于商业用途的用户，Open-Meteo 提供了一些商用套餐，但价格却非常便宜，每个月的标准商用套餐才29欧元，折合人民币才200多。