Open-Meteo API Skill

本指南详细说明如何构建与调用 Open-Meteo 的四类核心 API：Geocoding API, Weather Forecast API, Ensemble API, 和 Air Quality API。

💡 核心工作流与判断逻辑

当用户询问天气、空气质量或坐标时，请遵循以下处理逻辑：

1. 是否需要查询坐标？
   • 如果用户提供的是地名（如“巴黎”、“Tokyo”）、邮编或行政区名，必须先调用 Geocoding API 将其转换为 latitude 和 longitude。
2. 选择目标 API：
   • 常规天气/历史天气（如温度、降水、风速、气压层）：使用 Weather Forecast API。
   • 不确定性/概率/多模型对比（如不同 member 的预报、置信区间、最长 35 天长期预报）：使用 Ensemble API。
   • 空气质量/AQI/污染物/花粉：使用 Air Quality API（注意：花粉主要限欧洲花粉季）。
3. 时间与时区处理（极易错点）：
   • 请求时强烈建议带上 timezone=auto（根据坐标自动推断时区）或明确的时区名称（如 Europe/Berlin），否则默认使用 GMT，这会导致 daily 变量的日边界切分不符合当地情况。
   • 如果用户需要 UTC 时间戳，传递 timeformat=unixtime，但展示给用户按天聚合的数据时，必须根据返回结果中的 utc_offset_seconds 做修正计算。
4. 多地点请求：
   • 所有 API（Geocoding 除外）都支持通过逗号分隔的 latitude 和 longitude 一次查询多个地点。
   • 坑：多地点请求会使返回的 JSON 结构从单一对象变为对象数组。处理响应时必须予以区分！