服务介绍

根据位置坐标查询全球的大气气象和海洋气象实时数据。

大气气象数据：气温、100m风速/风向、10m风速/风向、能见度、大气气压、降雨量、天气状况描述。

海洋气象数据：海浪高度/方向/周期、涌浪高度/方向/周期、风浪高度/方向/周期、洋流方向/速度、海水高度/温度、海平面气压。

数据精度：0.08°*0.08°每网格

数据频率：每小时一包气象预报数据

适用场景

1、航线规划与优化。动态调整航线：在船舶航行过程中，实时获取海洋气象数据，当遇到突发的恶劣天气或气象条件发生变化时，及时调整航线。

2、船舶航行安全。灾害性天气预警：提前获取台风、风暴潮、寒潮大风、海雾等灾害性天气的预报信息。

3、港口运营与管理。船舶进出港调度：港口管理部门可以根据海洋气象数据，合理安排船舶的进出港时间。

请求限制

此服务为高级服务，需要申请高级权限才可使用，使用前需要在控制台创建您应用的key。请求服务时，会根据您所属权限的类型限制访问的数量，您当前使用服务的权限清单在控制台中可以查看。开通服务权限请联系商务。

在线调试

提供无开发经验的用户在线访问接口数据，了解服务获取样例。需要提前创建船讯网API key并具备权限，对应的API Key需要到https://api.shipxy.com/v3/console/overview 获取，参见 https://33iwh234s7.apifox.cn/8961339m0

请求地址

请求地址	请求方式
https://api.shipxy.com/apicall/v3/CurrentWeather	Get

请求调用示例

https://api.shipxy.com/apicall/v3/CurrentWeather?key=1F6D701272402D1E7D8D316CCE519123&lng=123.58414&lat=27.37979

**注：**例子中的 1F6D701272402D1E7D8D316CCE519123 是船讯网的官方 key，已经绑定域名 api.shipxy.com，用户无权也无法使用该 key 获取数据，使用该 key 会返回 status 14 的状态码，提示来源域错误。用户如需试用服务，请在控制台创建自己的key。

返回响应

⚪0成功

application/json

成功返回实时气象数据

Bodyapplication/json

示例

{
    "status": 0,
    "msg": "",
    "data": {
        "observation_time": "2026-01-01T10:00:00Z",
        "atmospheric_data": {
            "temperature": 12.314,
            "wind_speed_100m": 8.994,
            "wind_direction_100m": 37.562,
            "wind_speed": 13.067,
            "wind_direction": 38.758,
            "atmospheric_pressure": 102.206,
            "weather": "阴",
            "precipitation": 0,
            "visibility": 13.032,
        }
      "ocean_data": {
            "wave_direction": 44.949,
            "wave_height": 0.77,
            "wave_period": 4.75,
            "swell_direction": 67.553,
            "swell_height": 0.377,
            "swell_period": 7.647,
            "wind_wave_direction": 38.313,
            "wind_wave_height": 0.66,
            "wind_wave_period": 2.867,
            "ocean_current_direction": 203.454,
            "ocean_current_speed": 0.402,
            "sea_water_height": 9.659,
            "sea_water_temp": 14.905,
            "sea_level_pressure": 102.275
        }
    }
}

6.1.1 实时气象数据

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

6.1.1 实时气象数据

服务介绍#

适用场景#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例