正在读取服务状态…

多源气象与海洋数据
一个接口调通

聚合 GFS 气象、GFS Wave 波浪、MF 全球洋流 与 台风路径 四类数据源, 按语义变量名自动选源与融合,对外提供统一 HTTP 接口:既能按点取逐小时预报,也能按区域取光子渲染场数据。

无需注册,/health 公开可用 Zarr 列式存储,按点查询毫秒级返回
已接入数据源
—
活跃数据源
—
已装载变量
—
对外开放接口
—
服务运行时长
—
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"

完整参数说明见 交互式接口文档, 机器可读定义见 /openapi.json。