4、气象海况与航行警告

所属：海上设施安全监管与决策平台

一、场景说明

业务视角：海上设施的作业计划高度依赖环境窗口——吊装需要浪高与风速低于阈值，人员倒班需要乘潮进出港，台风季需要提前撤离；军事任务 / 实弹射击警告则直接改变周边通航格局。过去值班员要看 4 个不同的网站（气象局 / 台风网 / 海军公告 / 潮汐表）拼凑信息，时效与一致性都差。

本子场景把船讯网气象系列接口整合为「环境防御」工作台：左屏设施实况卡（风浪流气压水温）+ 24 小时预报 + 潮汐表 + 海区预报；右屏台风详情卡 + 航行警告列表 + 自动影响分析；中央海图叠加台风路径与风圈、警告禁航区、设施位置与大风区渲染。

客户视角：设施值班长、运维调度、安全管理部。

二、实现流程

步骤	阶段	使用接口	关键计算 / 业务逻辑
1.1 设施实况	① 数据获取	CurrentWeather	经纬度 → 风浪流实况（0.08° 格点）
1.2 7 天预报	① 数据获取	FutureWeather	逐小时 168 个数据点
1.3 海区预报	① 数据获取	GetWeather	沿岸 / 近海 / 远海分区预报
1.4 台风清单	① 数据获取	GetAllTyphoon	`data_mark="ing"` 过滤进行中
1.5 台风详情	① 数据获取	GetSingleTyphoon	风圈 + 预测点位
1.6 航行警告	① 数据获取	GetNavWarning	12 类警告
1.7 潮汐两步	① 数据获取	GetTides + GetTideData	逐日高低潮时刻与潮高
2.1 作业窗口计算	② 计算处理	—	与工序阈值比对，连续满足 ≥ 4h → 窗口
2.2 台风影响判定	② 计算处理	—	d < 7 级风圈 + 100 海里 → 命中
2.3 警告落图	② 计算处理	—	`range_points` → 多边形 / 圆形
2.4 乘潮窗口	② 计算处理	—	潮高 > 需求 + 0.3m 安全余量
3.1 综合决策	③ 业务判断	—	四类输出合并 + 安全约束优先
4.1 建议表	④ 输出应用	—	一周作业建议（下发 B7 排程）
4.2 推送联动	④ 输出应用	—	推值班计划系统

三、接口调用与响应

3.1 CurrentWeather 实时气象

{"code": 0, "data": {"wind_speed_ms": 8.5, "wind_dir_deg": 45, "wind_level": 5,
 "pressure_hpa": 1015, "wave_height_m": 1.2, "wave_dir_deg": 90, "swell_height_m": 0.8,
 "current_speed_ms": 0.3, "current_dir_deg": 180, "sst_celsius": 18.5, "forecast_time": 1726000800}}

服务端按 0.08° 网格取最近格点，输入坐标会自动吸附，无需精确对齐。返回大气要素（风速 / 风向 / 风级 / 气压）与海洋要素（有效浪高 / 浪向 / 涌 / 洋流 / 海表水温）。高级服务，需商务开通。

3.2 FutureWeather 未来 7 天逐小时

返回 7 × 24 = 168 个时序点，每个点含 utc、wind_speed_ms、wind_dir_deg、wave_height_m 等。

3.3 GetWeather 海区气象

{"code": 0, "data": {"regions": [{"region_name": "渤海", "forecast_aging": "未来 24 小时",
 "wind": "东北风 6-7 级", "wave": "2.5-3.5 米", "visibility": "5-8 公里",
 "warning": "海上大风黄色预警"}]}}

weather_type：0 = 全部、1 = 沿岸、2 = 近海、3 = 远海。返回人读格式文本，与格点数值互为补充。

3.4 GetNavWarning 航行警告

{"code": 0, "data": [{"warning_id": "NW20260914001", "warning_type": 1,
 "warning_type_cn": "实弹射击", "title": "东海北部实弹射击警告",
 "content": "09-15 至 09-16，每日 08:00-18:00，禁止进入以下区域...",
 "start_time": 1726012800, "end_time": 1726180800, "range_type": "polygon",
 "range_points": [{"lng": 122.5, "lat": 30.5}, {"lng": 123.5, "lat": 30.5},
                  {"lng": 123.5, "lat": 31.0}, {"lng": 122.5, "lat": 31.0}]}]}

range_type 为 polygon 时含 range_points，为 circle 时含 center_lat/lng + radius_nm，两者都可直接落图。

3.5 潮汐两步

{"code": 0, "data": [{"date": "2026-09-14", "tides": [{"type": "high", "time": "06:20", "height_m": 3.5}]}]}

start_date 与 end_date 单次跨度 ≤ 90 天。境外设施使用 GetGlobalTides 与 GetGlobalTideData。

四、计算逻辑

4.1 作业窗口计算

中文说明：逐小时检查预报点是否同时满足浪高与风速阈值；连续满足的小时段累计，长度 ≥ 工序所需时长的才算一个有效作业窗口；同时统计连续不满足的时段，长度 ≥ 6 小时的记为「不可作业窗口」，用于排程时避开。

4.2 台风影响研判

中文说明：取台风 7 级风圈四象限的最大半径（公里 ÷ 1.852 转海里）加 100 海里安全余量作为影响半径；对当前位置与每个预测点，分别计算与各设施的大圆距离；命中即生成影响记录，预测点命中时给出提前量小时数（用于「提前 48 小时撤离」的触发），提前量 > 24 小时为中危、≤ 24 小时为高危。

4.3 航行警告落图与关联

中文说明：把 polygon 类型的 range_points 直接作为禁航多边形落图，circle 类型按中心点与半径生成圆；再与每个监管区域多边形做相交检测，相交即通知值班调整巡检航线，并为守护船 / 倒班船生成绕行建议（用 PlanRouteByPoint 的 avoid 参数测算绕行成本）。

4.4 潮汐乘潮窗口

中文说明：大吃水船进港需要乘高潮。所需乘潮高度 = 船舶吃水 − 码头基准水深，再加 0.3 米安全余量得到目标潮高；筛选潮高 ≥ 目标值的高潮点，以高潮时刻为中心 ± 1–2 小时作为乘潮窗口（涨潮侧 1 小时、落潮侧 2 小时）。

五、输出的应用形态

气象海况总览：左屏三张气象卡（实况 / 预报 / 潮汐）+ 海区预报提示；右屏台风参数表 + 航行警告列表 + 影响分析表；中央海图叠加台风路径与风圈、禁航警告区、设施位置。

台风路径风圈详情：上部台风参数表，中部路径时序图（中心气压 / 最大风速随时间变化），下部受影响设施清单（距台风中心海里、预计进入风圈时间、风险等级）。

六、数据边界与常见问题

数据边界：气象、台风、潮汐、航行警告来自船讯网；设施工序阈值、倒班船计划、撤离预案、禁航解释规则来自内部系统。

Q1：风圈半径单位？ 公里，换算海里需 ÷ 1.852。

Q2：航行警告有哪 12 类？ 军事任务、实弹射击、演习、救援、科考、勘探、管道作业、沉船打捞、灯塔维护、海上工程、跨海大桥施工、其他，以接口返回的 warning_type_cn 为准。

Q3：潮汐能批量拉多个港口吗？ 每个站单独调用一次，建议并行 5–10 个并缓存 30 天。

4、气象海况与航行警告

一、场景说明#

二、实现流程#

三、接口调用与响应#

3.1 CurrentWeather 实时气象#

3.2 FutureWeather 未来 7 天逐小时#

3.3 GetWeather 海区气象#

3.4 GetNavWarning 航行警告#

3.5 潮汐两步#

四、计算逻辑#

4.1 作业窗口计算#

4.2 台风影响研判#

4.3 航行警告落图与关联#

4.4 潮汐乘潮窗口#

五、输出的应用形态#

六、数据边界与常见问题#