海洋天气预报

使用 Open-Meteo 海洋 API 与天气 API 提供的海洋与航行天气信息。免费，无需 API 密钥，全球可用。

两个 API 联合使用 —— 在所有命令中替换 LAT、LON 和 TZ：

• 海洋 API（marine-api.open-meteo.com）—— 波浪、涌浪、海温、洋流、潮汐
• 天气 API（api.open-meteo.com）—— 风速、阵风、气温、气压、能见度

可通过网络搜索或用户输入获取任意位置的坐标。使用最近的时区（IANA 格式，例如 Europe/London、America/New_York、Atlantic/Canary）。

当前状况

海况：

curl -s "https://marine-api.open-meteo.com/v1/marine?latitude=LAT&longitude=LON&current=wave_height,wave_direction,wave_period,swell_wave_height,swell_wave_direction,swell_wave_period,sea_surface_temperature&timezone=TZ"

风与大气：

curl -s "https://api.open-meteo.com/v1/forecast?latitude=LAT&longitude=LON&current=temperature_2m,wind_speed_10m,wind_direction_10m,wind_gusts_10m,apparent_temperature,pressure_msl,cloud_cover,visibility&timezone=TZ"

运行两个请求，并将结果合并为一份综合简报。

小时预报

海洋（最多 16 天，可调整 forecast_days）：

curl -s "https://marine-api.open-meteo.com/v1/marine?latitude=LAT&longitude=LON&hourly=wave_height,wave_direction,wave_period,swell_wave_height,swell_wave_direction,swell_wave_period,swell_wave_peak_period,wind_wave_height,wind_wave_direction,sea_surface_temperature,ocean_current_velocity,ocean_current_direction,sea_level_height_msl&forecast_days=3&timezone=TZ"

风力（最多 16 天）：

curl -s "https://api.open-meteo.com/v1/forecast?latitude=LAT&longitude=LON&hourly=wind_speed_10m,wind_direction_10m,wind_gusts_10m,temperature_2m,pressure_msl,visibility,cloud_cover,precipitation_probability&forecast_days=3&timezone=TZ"

每日摘要

海洋：

curl -s "https://marine-api.open-meteo.com/v1/marine?latitude=LAT&longitude=LON&daily=wave_height_max,wave_direction_dominant,wave_period_max,swell_wave_height_max,swell_wave_direction_dominant,swell_wave_period_max&forecast_days=7&timezone=TZ"

天气：

curl -s "https://api.open-meteo.com/v1/forecast?latitude=LAT&longitude=LON&daily=wind_speed_10m_max,wind_gusts_10m_max,wind_direction_10m_dominant,temperature_2m_max,temperature_2m_min,sunrise,sunset,uv_index_max,precipitation_probability_max&forecast_days=7&timezone=TZ"

潮汐（海平面）

curl -s "https://marine-api.open-meteo.com/v1/marine?latitude=LAT&longitude=LON&hourly=sea_level_height_msl&forecast_days=3&timezone=TZ"

高潮/低潮：在 sea_level_height_msl 数组中查找局部最大值和最小值。海平面包含潮汐信号 + 倒置气压效应。

洋流

curl -s "https://marine-api.open-meteo.com/v1/marine?latitude=LAT&longitude=LON&hourly=ocean_current_velocity,ocean_current_direction&forecast_days=3&timezone=TZ"

结果展示

始终以结构化航海简报形式呈现海洋数据：

当前状况格式

海况：    [wave_height]m 波浪，[wave_period]s 周期，来自 [direction]
涌浪：    [swell_wave_height]m 来自 [direction]，[swell_wave_period]s 周期
风力：    [wind_speed] km/h [direction]，阵风 [wind_gusts] km/h
温度：    空气 [temperature]C（体感 [apparent_temperature]C），海水 [sea_surface_temperature]C
天空：    [cloud_cover]% 云量，[visibility/1000]km 能见度

航行评估

根据数据对条件进行评级：

• 平静 — 波高 < 0.5m，风速 < 12 km/h（蒲福风级 0-2）
• 轻风 — 波高 0.5-1m，风速 12-19 km/h（蒲福风级 3）
• 中等 — 波高 1-2m，风速 20-38 km/h（蒲福风级 4-5）
• 大浪 — 波高 2-3m，风速 39-49 km/h（蒲福风级 6）
• 巨浪 — 波高 3-4m，风速 50-61 km/h（蒲福风级 7）
• 危险 — 波高 > 4m 或风速 > 62 km/h（蒲福风级 8+）

标记预警：

• 小船警告：阵风 > 50 km/h 或波高 > 3m
• 大风警告：持续风速 > 62 km/h 或波高 > 5m
• 建议活动适宜性：航行、潜水、钓鱼、游泳、冲浪

蒲福风级对照表

风向转换

将角度转为罗盘方向：除以 22.5，四舍五入，索引到 [N, NNE, NE, ENE, E, ESE, SE, SSE, S, SSW, SW, WSW, W, WNW, NW, NNW]。

快速参考：0=N，45=NE，90=E，135=SE，180=S，225=SW，270=W，315=NW。

单位说明

用户可能更习惯使用节（knots）表示风速。换算方式：knots = km/h * 0.539957。可在天气 API URL 中添加 &wind_speed_unit=kn 直接获取节为单位的数据。

常见航海地点（参考）

数据来源

• ECMWF WAM（欧洲中期天气预报中心）
• NOAA GFS Wave（全球预报系统）
• DWD GWAM/EWAM（德国气象局）
• 分辨率：根据区域和模型不同，为 5-25 公里
• 更新频率：每天多次更新
• 预报范围：最长可达 16 天（forecast_days=16）

注意事项

• 所有数据均为 JSON 格式。若可用 jq 工具，请使用它解析；否则直接读取原始 JSON。
• 每小时数据返回大型数组。如需快速查看，使用 current 参数；如用于规划，使用 daily；仅当用户需要详细分解时，才使用 hourly。
• 建议结合海洋与天气 API 调用，以提供完整的航行信息。单独使用任一接口均无法满足完整航行简报需求。
• 海平面数据可近似反映潮汐变化，但不会明确标注高潮或低潮。可通过每小时数据数组中的局部极大值和极小值推导得出。
• 对于沿海地区，数据精度取决于距离最近网格点的距离。开阔海域覆盖良好；而港口和海湾区域的精度可能较低。

文档：https://open-meteo.com/en/docs/marine-weather-api