Open-Meteo 天气

获取任意位置的实时天气状况和未来 7 天每日预报。使用免费的 Open-Meteo API，内置地理编码功能。无需 API 密钥、无需身份验证，非商业用途无速率限制。

快速参考

单位设置

默认使用公制单位。在会话中首次请求天气信息时，询问用户：“您更喜欢摄氏度还是华氏度？”并记住用户的偏好，用于整个会话。

• 使用公制（默认）：无需额外参数。
• 使用英制：在预报 URL 后添加以下参数：

&temperature_unit=fahrenheit&wind_speed_unit=mph&precipitation_unit=inch

响应中的 current_units 和 daily_units 对象会反映所选的单位系统。

地理编码

在调用预报 API 前，需将城市名称解析为纬度和经度。

端点： GET https://geocoding-api.open-meteo.com/v1/search

示例：

curl "https://geocoding-api.open-meteo.com/v1/search?name=Berlin&count=1&language=en"

从响应中提取：

如果 results 为空或缺失，请告知用户该位置未找到，并请其提供更具体的名称。

若多个城市同名，请使用 count=5 并列出选项（名称、省/州、国家），让用户选择正确的城市。

实时天气状况

在预报请求中包含 current 参数。

请求参数：

current=temperature_2m,relative_humidity_2m,apparent_temperature,weather_code,wind_speed_10m,wind_direction_10m,precipitation

响应字段：

单位由 current_units 对象定义。呈现数值时始终包含单位。

将 wind_direction_10m 的度数转换为最近的方位：

N（338–22）、NE（23–67）、E（68–112）、SE（113–157）、S（158–202）、SW（203–247）、W（248–292）、NW（293–337）。

未来 7 天预报

在请求中包含 daily 参数。始终添加 timezone=auto，以确保时间显示为当地时区。

请求参数：

daily=temperature_2m_max,temperature_2m_min,precipitation_sum,precipitation_probability_max,sunrise,sunset,wind_speed_10m_max,weather_code&timezone=auto

所有 daily 字段均为按天索引的数组。daily.time 包含日期字符串（格式为 YYYY-MM-DD）。

天气代码

weather_code 字段返回的 WMO 天气解释代码：

向用户展示天气时，请使用描述文字，不要显示数字代码。

响应格式化

提供简洁摘要。不要显示原始 JSON、API 地址或技术细节。

实时天气格式：

{城市}, {国家} 的天气
{天气描述}，{温度}（体感温度 {体感温度}）
湿度：{湿度}%
风速：{风速}，来自 {风向}
降水量：{降水量}

预报格式：

在显示实时天气后，以紧凑列表形式展示未来 7 天预报，每天一行：

周一 2月24日：部分多云，8/3℃，10% 降水概率，风速 15 km/h
周二 2月25日：降雨，6/2℃，80% 降水概率，降水量 4.2mm，风速 25 km/h

当用户提出具体问题（如“明天会下雨吗？”、“周五的气温是多少？”）时，直接回答问题，无需展示完整预报。

错误处理

如果任何 API 调用返回非 200 状态码，或无法解析响应，请告知用户天气服务暂时不可用，并建议几分钟后重试。不要显示原始错误信息或状态码。