天气预报

这个页面能做什么：配置 H5 导览端的天气功能。开启后，游客在 H5 右侧功能按钮区能看到"天气"按钮，点开可查看景区位置的实时天气、逐小时/逐天预报、空气质量、天气预警等信息，还可以展示一句你自定义的温馨提示（如"雨天路滑，请注意安全"）。页面下方还能精细控制各类天气数据的缓存时长。

入口

管理后台左侧菜单：智慧导览 → 景区服务 → 天气预报

填坐标：在「天气信息坐标」输入框填写景区位置的坐标，格式为 经度,纬度（如 116.3974,39.9093）。推荐直接点 拾取坐标 按钮，在弹出地图上点选景区位置，坐标自动填入。
开入口：打开「显示天气入口」开关，H5 右侧按钮区才会出现"天气"按钮。
按需配置：填写天气提示文案，并按需打开「显示天气预警」「实况指标」开关（含义见下表）。
调缓存（可选）：页面下半部分的缓存时长一般保持默认值即可，确有需要再调整。
点击页面底部的 保存设置，提示"保存成功"后生效。
改了坐标之后，点一下底部的 清除天气缓存，让新位置的天气立即生效（原因见下方注意事项）。
「重置」按钮会把表单恢复成已保存的内容，未保存的修改会丢弃。

字段	说明	是否必填	默认值
天气信息坐标	天气数据的定位点，格式 `经度,纬度`，可点"拾取坐标"在地图上选	建议填写（不填则天气定位不准）	空
显示天气入口	开启后，H5 导览端右侧功能按钮区显示"天气"按钮	选填	关闭
天气提示文案	显示在 H5 天气弹窗中的一句提示，如"雨天路滑，请注意安全"	选填	空
显示天气预警	开启后，H5 天气弹窗在提示文案下方展示天气预警卡片（台风、暴雨等官方预警）	选填	关闭
实况指标	开启后显示空气质量、紫外线等指标信息	选填	关闭

天气数据不是游客每开一次就实时请求一次，而是缓存一段时间后复用，以节省天气接口的调用配额。以下各项单位为分钟，可填范围 1–1440：

配置项	对应数据	默认值（分钟）	页面建议
实时天气缓存	当前天气实况	10	推荐 10~30 分钟
逐小时预报缓存	未来 24 小时逐小时预报	30	推荐 30~60 分钟
逐天预报缓存	未来数天逐天预报	60	推荐 1~6 小时
空气质量缓存	当前空气质量	30	推荐 30~60 分钟
天气预警缓存	气象预警信息	5	推荐 5~20 分钟
天气指数缓存	穿衣、紫外线等生活指数	360	推荐 6~12 小时
分钟降水缓存	分钟级降水预报	5	推荐 5~10 分钟
空气质量逐天预报缓存	未来数天空气质量	480	推荐 8~12 小时
潮汐缓存	潮汐数据	480	推荐 8~12 小时
台风缓存	台风路径	20	推荐活跃期 20 分钟 / 非活跃期 60 分钟
太阳辐照缓存	太阳辐照数据	360	推荐 6 小时

缓存时长怎么调

改了坐标记得「清除天气缓存」

天气数据是按坐标缓存的。修改坐标后如果直接保存，游客端在缓存到期前仍会显示旧位置的天气。改完坐标请点底部的「清除天气缓存」按钮，让所有缓存立即作废、按新坐标重新获取。

前置条件：和风天气凭据

天气数据来自和风天气（QWeather），其账号凭据（API Key 等）需由技术人员在服务器 .env 文件中配置，管理后台无法填写。如果凭据未配置或已过期，H5 端天气功能会显示异常提示。遇到此情况请联系技术人员检查服务器配置，与页面上的设置无关。