CONSOLE

数据查询控制台

两套调用方式分开配置:数据查询模式按点取逐小时预报时序,光子渲染模式按图层取可直接上屏的规则网格场, 离线海图用同一套凭证预览本地瓦片。填好下面两项接入配置后,三种模式都会用同一份凭证。

正在检测服务…
凭证保存在浏览器本地 localStorage,不会上传;生成演示密钥调用 /v1/auth/trial 开一个免审批体验账号并取出密钥, 仅用于本地联调。要长期使用的正式账号请到 注册页 提交申请,审批通过后到 用户中心 查看额度。 /v1/photon/layers 与页面本身无需密钥即可访问。

三种调用模式

点查询、光子场、离线海图预览参数形态不同,这里分开列出,避免混用。

1

数据查询模式

point query · 逐点时间序列

给一个经纬度,返回该点的逐小时 / 逐日 / 实况时序。变量用统一语义名请求,服务端自动选源、算衍生量(如风速、体感温度)。

GET/v1/forecast气温 / 风 / 湿度 / 气压 / 降水
GET/v1/marine波高 / 波向 / 波周期 / 洋流
GET/v1/tide逐小时潮高 + 高低潮
GET/v1/tide/nearest最近验潮站
GET/v1/typhoon/list活跃 / 已停编台风列表
GET/v1/typhoon/detail/{id}实况 + 预报路径
GET/v1/geo/search地名 → 经纬度
GET/v1/geo/reverse经纬度 → 最近地名
请求示例

          
2

光子场渲染模式

field rendering · 规则网格场

给一个图层 id 与包围框,返回 GRIB2 惯例的规则网格场:header 描述几何与要素编码,components 按行优先展平数值,可直接交给渲染器上屏。

GET/v1/photon/layers图层目录(无需密钥)
GET/v1/photon/times图层可用时刻
GET/v1/photon/field单时刻场
GET/v1/photon/animation多帧场(时间播放)
请求示例

          
打开可视化页
3

离线海图预览

map tiles · Leaflet / MapLibre

浏览本地 MBTiles 融合底图(底图 + 沿海 OSM + 海图)。需上方同一套 API Key,且账号具备有效海图订阅。预览在弹窗中打开,不离开本页。

GET/v1/map/{layer}/…标准瓦片
GET/tiles/{layer}/…短别名
GET/v1/map/layers图层清单
GET/map/leaflet.html浏览器预览
请求示例

          

天气预告查询

定点预报可查气象 / 海洋时序;潮汐可查逐小时潮高与高低潮;台风路径可查看活跃与已停编台风。

查询点
—
预报末时刻
—
预报时效数
—
返回耗时
—

实况 / 最新时刻

待查询
—
—

变化趋势

待查询

逐小时预报

待查询
查询后在此显示逐小时数据表。
原始响应(JSON)
—