Windy Weather
本指南说明如何将 Windy API 整合到您的 superun 应用程序中.此整合使用边缘函数来安全地代理所有 API 请求,确保您的 API 金钥永远不会传送到客户端.文档
有关 Windy API 的更多详细资讯,请参阅官方文件:- Windy API 文件 - 完整的 API 参考
环境变数
调用SupabaseEdgeFunctionSecretsCreate 工具会弹出密钥配置界面,plugin_secret_prefix 必须为 SUPERUN.在该界面中,您可以:
- 使用共享密钥 — superun 提供开箱即用的共享测试密钥,勾选即可快速体验,无需自行申请.
- 填入自己的密钥 — 如需用于生产环境,请在输入框中填写您自己的 API 密钥.
WINDY_POINT_FORECAST_KEY- Windy 点预报 API 金钥WINDY_MAP_FORECAST_KEY- Windy 地图预报 API 金钥WINDY_WEBCAMS_KEY- Windy 网路摄影机 API 金钥
步骤 1:建立边缘函数
建立一个 Supabase 边缘函数来安全地代理 Windy API 请求.此范例展示了如何处理不同的 Windy API 端点:点预报
地图预报
网路摄影机 API
步骤 2:前端整合
直接从前端呼叫边缘函数.API 金钥会安全地保存在服务器上:API 功能
Windy API 提供三种主要服务:点预报 API
- 特定座标的即时天气状况
- 多天预报（最多 10 天）
- 多种天气参数（温度,风速,降水量等）
- 高解析度天气资料（最高 1 公里解析度）
地图预报 API
- 用于地图叠加层的天气资料视觉化
- 多种资料来源（ECMWF,GFS 等）
- 可自订的参数和模型
- 区域和全球覆盖范围
网路摄影机 API
- 附近网路摄影机位置,用于视觉天气验证
- 即时摄影机画面
- 基于位置的搜寻,支持半径过滤
- 天气状况验证
使用指南
使用 Windy API 时:- 遵守速率限制和使用配额
- 适当缓存天气资料以减少 API 呼叫
- 优雅地处理错误,并在可用时提供备用资料