DEV Community

aimall
aimall

Posted on

每天一个高质量 API · Day 1:Open-Meteo 全球实时天气(free-weather-openmeteo)

系列「每天一个高质量 API」第 1 篇。搜蚁智选(souyi.net.cn)是一个面向 AI Agent 的 API 发现与统一调用平台。今天聊 Open-Meteo 全球实时天气(free-weather-openmeteo)。

给你的 Agent 一个经纬度,立刻拿到当前温度、风速与天气代码——零密钥、全球覆盖。

这个 API 能做什么

Open-Meteo 提供全球任意经纬度的实时与预报天气数据,覆盖温度、风速、天气代码、降水等字段。经搜蚁智选封装后,Agent 只要传 latitude / longitude 即可,不用自己拼 URL、不用管密钥。

为什么 AI Agent 需要它

  • 出行 / 物流 Agent:根据目的地天气决定是否改期、提醒用户带伞。
  • IoT / 农业 Agent:按实时温度触发灌溉、通风策略。
  • 日程助手:把「明天北京冷不冷」这类自然语言转成一次 API 调用。

怎么用

方式一:直连上游(免费、无需 Key)

curl "https://api.open-meteo.com/v1/forecast?latitude=39.9042&longitude=116.4074&current_weather=true"
Enter fullscreen mode Exit fullscreen mode

方式二:经搜蚁智选一键调用(带 Key,统一计费 / 限流 / 可观测)

curl -X POST https://souyi.net.cn/api/v1/ai/request \
  -H "X-API-Key: YOUR_AIMALL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_id":"free-weather-openmeteo","call_data":{"latitude":39.9042,"longitude":116.4074}}'
Enter fullscreen mode Exit fullscreen mode

这些免费 API 的上游本身免密;经搜蚁智选代理后,多个数据源可以聚合到同一个 Agent 工作流里,统一走 X-API-Key + 统一计费、限流与可观测,省去每个上游单独接一遍。

返回示例

{
  "latitude": 39.9042,
  "longitude": 116.4074,
  "current_weather": {
    "temperature": 21.3,
    "windspeed": 8.1,
    "winddirection": 210,
    "weathercode": 1
  }
}
Enter fullscreen mode Exit fullscreen mode

价格

免费。上游 Open-Meteo 免密;经平台调用按 price_per_call 计(本资产为 0,仅记录调用量)。

怎么拿到 Key

注册 souyi.net.cn → 控制台一键生成 X-API-Key → 即可调用平台全部 API(含本系列 10 个)。

小结

天气是最通用的上下文信号。把 Open-Meteo 接进 Agent,让它「知道外面天气怎样」,成本为零。

下一篇(Day 2):Frankfurter 汇率(ECB)(free-currency-frankfurter)。系列持续更新,关注不迷路。

Top comments (0)