已接入数据源
—
活跃数据源
—
已装载变量
—
对外开放接口
—
服务运行时长
—
DATA SOURCES
接入的数据源
每个数据源独立定义域与网格坐标,统一映射到语义变量名。运行状态与数据新鲜度直接读取自服务端 /health。
正在读取数据源状态…
ARCHITECTURE
四层抽象,屏蔽数据源差异
从变量语义到网格坐标逐层收敛,让调用方只需要关心「我要什么变量」,而不必关心它来自哪个源、是什么投影。
变量注册表
统一语义变量名与各数据源原始变量名的双向映射,屏蔽 GFS / ECMWF / CMEMS 之间的命名差异。
多源自动融合
同一变量存在多个数据源时,按可配置的优先级自动选择与回退,单点查询无需关心底层来源。
网格坐标抽象
RegularGrid 与 ProjectionGrid 统一为经纬度寻址,支持任意点位查询与包围框区域读取。
定时下载与轮转
APScheduler 驱动定时抓取与失败重试,Zarr 列式存储,过期数据按保留策略自动轮转清理。
QUICK START
几行 curl 就能拿到数据
所有数据接口均为 GET,鉴权支持 Authorization: Bearer <key> 或 URL 参数 apikey。API Key 可在用户中心创建与查看。海图瓦片另需有效海图订阅;Leaflet / 图片标签请用 URL 参数传密钥(无法带 Header)。
GET/v1/forecast
curl "http://HOST:8090/v1/forecast?latitude=37.5&longitude=122.3&hourly=temperature_2m,wind_speed_10m&forecast_days=3&apikey=YOUR_KEY"
GET/v1/marine
curl "http://HOST:8090/v1/marine?latitude=37.5&longitude=122.3&hourly=wave_height,ocean_u_current&apikey=YOUR_KEY"
GET/v1/typhoon/active
curl "http://HOST:8090/v1/typhoon/active?apikey=YOUR_KEY"
# 活跃 / 已停编 / 全部(可按年份)
curl "http://HOST:8090/v1/typhoon/list?status=all&year=2025&apikey=YOUR_KEY"
# 历史台风,可按年份 / 海域筛选(basin: WP/EP/NA/IO)
curl "http://HOST:8090/v1/typhoon/history?year=2025&basin=WP&apikey=YOUR_KEY"
GET/v1/grid
curl "http://HOST:8090/v1/grid?bbox=120,35,125,40&variables=wind_u_component_10m,wind_v_component_10m&time=2026-09-15T12:00&apikey=YOUR_KEY"
GET/v1/photon/field
curl "http://HOST:8090/v1/photon/field?layer=wind&bbox=100,0,150,40&resolution=1.5&apikey=YOUR_KEY"
# 多帧动画,用于时间轴播放
curl "http://HOST:8090/v1/photon/animation?layer=temperature&bbox=-180,-60,180,60&step=6&max_frames=8&apikey=YOUR_KEY"
GET/v1/map/{layer}/{z}/{x}/{y}.png
# 图层清单(融合预览:base → coastosm → hires → seamark)
curl "http://HOST:8090/v1/map/layers?apikey=YOUR_KEY"
# TileJSON,可直接交给 Leaflet / MapLibre
curl "http://HOST:8090/v1/map/base/tilejson.json?apikey=YOUR_KEY"
# 单张 XYZ 瓦片(y 可带 .png;无图时返回 204)
curl -o tile.png "http://HOST:8090/v1/map/base/6/52/25.png?apikey=YOUR_KEY"
# 短别名,与 /v1/map/... 完全等价
curl -o tile.png "http://HOST:8090/tiles/base/6/52/25.png?apikey=YOUR_KEY"
完整参数说明见 交互式接口文档,
机器可读定义见 /openapi.json。