服务介绍

根据船队ID查询船队下所有船舶的基础静态信息以及船舶的实时动态信息，包括船舶imo编号、呼号、船舶中英文名称、船舶类型、长度宽度以及AIS最新更新上报的船舶实时位置、航行状态、船舶目的港口、船舶实时速度、预计到达目的港的时间、航首向航迹向等。

适用场景

船队船位置查询可以批量跟踪自有船队的实时位置和船舶的状态信息。船位查询服务有访问量的限制，如果您需要船舶位置的更新频率很高，推荐您使用船舶实时位置推送服务，每10分钟即可更新船舶实时位置信息，可以监控一个船队列表中的所有船舶。

请求限制

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

在线调试

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

请求地址

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

请求调用示例

https://api.shipxy.com/apicall/v3/GetFleetShip?key=1F6D701272402D1E7D8D316CCE519123&fleet_id=3e42a3db-6cdf-4c62-9473-8ad00348d646

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

返回响应

⚪0成功

application/json

成功返回船队船位置查询结果

Bodyapplication/json

示例

{
    "status": 0,
    "msg": "",
    "total": 2,
    "data": [
        {
            "fleet_id": "3e42a3db-6cdf-4c62-9473-8ad00348d646",
            "mmsi": 413865704,
            "imo": 0,
            "call_sign": "0",
            "ship_name": "HANGLONG808",
            "ship_cnname": "航龙808",
            "data_source": 0,
            "last_time": "2026-06-20 14:34:30",
            "last_time_utc": 1781937270,
            "lat": 29.590707,
            "lng": 106.805153,
            "ship_type": 70,
            "length": 109.0,
            "width": 16.0,
            "left": 8.0,
            "trail": 100.0,
            "draught": 2.6,
            "dest": "CHONGQING, CN",
            "destcode": "CNCKG",
            "eta": "2026-06-17 00:00:00",
            "eta_utc": 1781625600,
            "navistat": 255,
            "sog": 3.70233464,
            "cog": 277.9,
            "hdg": 511.0,
            "rot": 0.0
        },
        {
            "fleet_id": "3e42a3db-6cdf-4c62-9473-8ad00348d646",
            "mmsi": 241673000,
            "imo": 9852119,
            "call_sign": "SVDF6",
            "ship_name": "SEA EMERALD",
            "ship_cnname": "",
            "data_source": 0,
            "last_time": "2026-06-20 14:33:45",
            "last_time_utc": 1781937225,
            "lat": 21.149013,
            "lng": 110.407802,
            "ship_type": 80,
            "length": 336.0,
            "width": 60.0,
            "left": 31.0,
            "trail": 55.0,
            "draught": 20.3,
            "dest": "CNZNG               ",
            "destcode": "",
            "eta": "2026-06-18 05:30:00",
            "eta_utc": 1781731800,
            "navistat": 5,
            "sog": 0.09922179,
            "cog": 254.9,
            "hdg": 348.0,
            "rot": 0.0
        }
    ]
}

1.1.3 船队位置查询

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

1.1.3 船队位置查询

服务介绍#

适用场景#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例