服务介绍

根据船舶mmsi编码查询船舶的基础静态信息以及船舶的实时动态信息，包括船舶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/GetSingleShip	Get

请求调用示例

https://api.shipxy.com/apicall/v3/GetSingleShip?key=1F6D701272402D1E7D8D316CCE519123&mmsi=413961925

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

返回响应

⚪0成功

application/json

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

Bodyapplication/json

示例

{
    "status": 0,
    "msg": "",
    "data": {
        "mmsi": 413961925,
        "imo": 0,
        "call_sign": "P",
        "ship_name": "WANHONGYUAN369",
        "ship_cnname": "皖鸿远369",
        "data_source": 0,
        "ship_type": 70,
        "length": 68,
        "width": 13,
        "left": 8,
        "trail": 18,
        "draught": 4.8,
        "dest": "TAIZHOU,CN",
        "destcode": "CNTZO",
        "eta": "2025-03-31 02:09:00",
        "navistat": 0,
        "lat": 32.192517,
        "lng": 119.628093,
        "sog": 6.2,
        "cog": 80.8,
        "hdg": 511,
        "rot": 0,
        "last_time": "2025-04-28 16:05:48",
        "last_time_utc": 1745827548
    }
}

1.1.1 单船位置查询

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例

请求参数

请求示例代码

返回响应

1.1.1 单船位置查询

服务介绍#

适用场景#

请求限制#

在线调试#

请求地址#

请求调用示例#

请求参数

请求示例代码

返回响应

服务介绍

适用场景

请求限制

在线调试

请求地址

请求调用示例