端点列表
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /weather/query | 天气查询（支持城市名/坐标/IP） |
| GET | /weather/gps | GPS 反向地理编码 + 天气查询 |
| GET | /weather/location | IP 地理定位调试 |
| GET | /weather/health | 健康检查 |
参数说明 (/weather/query)
| 参数 | 类型 | 说明 | 优先级 |
|---|---|---|---|
city | string | 城市名（中英文均可） | 1（最高） |
lat | number | 纬度（需配合 lon） | 2 |
lon | number | 经度（需配合 lat） | 2 |
ip | string | 指定 IP 地址查询 | 3 |
使用示例
按城市名查询
GET /weather/query?city=北京
按坐标查询
GET /weather/query?lat=39.9&lon=116.4
GPS 反向定位 + 天气
GET /weather/gps?lat=39.9&lon=116.4
IP 定位调试
GET /weather/location
详细信息
- 天气数据源：Open-Meteo (免费、无需 API Key)
- 地理编码：Open-Meteo Geocoding API
- 反向地理：BigDataCloud → Nominatim/OSM → 坐标（三重回退，可靠性高）
- IP 定位回退链：Cloudflare cf → ipinfo.io → ipwho.is
- GPS 定位：/weather/gps 接收浏览器坐标，反向解析为城市名
- 缓存策略：5 分钟内存缓存
- 预报范围：当前天气 + 48 小时逐时 + 7 天每日
- WMO 天气代码：双语描述（中/英）
实时天气预览
加载中...