1. 1 船舶查询
Shipxy
  • 船讯网API服务概述
  • 注册与创建应用
  • 多语言SDK引入
  • AI大模型接入MCP服务
  • 视频监控AI识别预警服务
    • 视频监控服务接入指南
    • 视频监控API服务说明
    • 视频监控场景应用指南
    • 视频监控服务FAQ与最佳实践
  • AI智能体应用
    • 运力资源智能体
    • 船舶风控智能体
    • 运输规划智能体
    • 航次时效预测智能体
    • 船舶安全监控智能体
    • 多式联运协同智能体
    • 大宗贸易态势分析智能体
  • 1 船舶查询
    • 1.1 船舶位置查询
      • 1.1.1 单船位置查询
      • 1.1.2 多船位置查询
      • 1.1.3 船队位置查询
    • 1.2 船舶模糊查询
      GET
    • 1.3 周边船舶查询
      GET
    • 1.4 区域船舶查询
      GET
    • 1.5 船舶船籍查询
      GET
    • 1.6 船舶档案查询
      GET
  • 2 港口查询
    • 2.1 港口信息查询
      GET
    • 2.2 港口当前靠泊船查询
      GET
    • 2.3 港口当前到锚船查询
      GET
    • 2.4 港口预抵船舶查询
      GET
  • 3 历史行为
    • 3.1 船舶历史轨迹查询
    • 3.2 船舶互相搭靠记录查询
  • 4 挂靠记录
    • 4.1 船舶历史挂靠记录
    • 4.2 船舶挂靠指定港口记录
    • 4.3 船舶当前挂靠信息
    • 4.4 港口挂靠历史船舶
  • 5 航线规划
    • 5.1 点到点航线规划
    • 5.2 港到港航线规划
    • 5.3 预计到达时间(ETA)查询
  • 6 天气气象
    • 6.1 新全球气象
      • 6.1.1 实时气象数据
      • 6.1.2 未来气象预报
    • 6.2 全球台风
      • 6.2.1 获取全球台风列表
      • 6.2.2 获取单个台风信息
    • 6.3 国内港口潮汐
      • 6.3.1 查询国内潮汐观测站列表
      • 6.3.2 查询单个观测站潮汐详情
    • 6.4 全球港口潮汐
      • 6.4.1 查询全球潮汐观测站列表
      • 6.4.2 查询单个观测站潮汐详情
    • 6.5 海区气象
    • 6.6 单点海洋气象
    • 6.7 历史气象记录
  • 7 海图GIS平台开发
    • 7.1 快速入门：从注册到接入
    • 7.2 地图引擎基础：地图控制与业务绘制
    • 7.3 船位展示服务
    • 7.4 历史轨迹服务
    • 7.5 图层与气象服务
    • 7.6 航线绘制与区域回放服务
    • 7.7 Vue项目接入指南
    • 7.8 API Key安全实践：后端代理接入
  • 8 海事数据
    • 8.1 航行警告查询
  • 9 监控推送
    • 9.1 监控船队管理
      • 9.1.1 创建船队
      • 9.1.2 更新船队信息
      • 9.1.3 查询船队
      • 9.1.4 删除船队
      • 9.1.5 船队船舶增加
      • 9.1.6 船队船舶批量更新
      • 9.1.7 船队船舶删除
    • 9.2 区域监控推送
      • 9.2.1 区域创建
      • 9.2.2 区域更新
      • 9.2.3 区域查询
      • 9.2.4 区域删除
      • 9.2.5 区域监控推送内容
    • 9.3 船舶航速提醒推送
      • 9.3.1 新增船舶订阅
      • 9.3.2 删除订阅船舶信息
      • 9.3.3 查询订阅船舶列表
      • 9.3.4 船舶航速异常推送
    • 9.4 实时船位推送
    • 9.5 船舶到离港事件推送
    • 9.6 船舶动态ETA推送
    • 9.7 船舶AIS信号消失事件推送
    • 9.8 船舶搭靠事件推送
  • 文档附录
    • 船舶类型对照表
    • 服务码返回说明
    • 海区对照表
    • 航行状态对照表
    • 绕航节点清单
    • 航标类型对照表
  1. 1 船舶查询

1.2 船舶模糊查询

GET
https://api.shipxy.com/apicall/v3/SearchShip

服务介绍#

船舶模糊查询服务，是使用关键字（mmsi、imo、船名、呼号等）作为查询条件，模糊查询出所有符合条件的船舶静态信息；当使用imo作为输入时，可以查询该imo编号下，曾经使用的所有mmsi记录；当使用船名作为查询输入时，可以查询该船名所有历史使用船舶的信息。
注：mmsi（Maritime Mobile Service Identity），中文称为水上移动业务标识码，是一种九位数字码，用于船舶无线电通信系统中，能够独特识别各类台站和成组呼叫台站。MMSI具有唯一性，每条船都有一个对应的MMSI码，通常被称为"一船一码"或"九位码"，同一条船舶mmsi编号有可能在售卖后变更，mmsi前三位代表国家和地区。
imo（International Maritime Organization），是国际海事组织为每一条船分配的唯一识别码，由七位数字组成，用于全球范围内对船舶身份、技术信息及安全记录的追踪与管理。

适用场景#

船舶模糊查询服务，一般在系统或平台中做模糊查询匹配，查询出来的mmsi编号可以作为单船位置查询、船舶历史轨迹的输入参数，结合起来实现模糊查询并匹配船舶的实时位置、状态、历史行进轨迹等。如果您已经有明确的船舶mmsi记录清单，则无需使用此服务，可直接使用单船位置查询、多船位置查询等服务监控管理您的船队。

请求限制#

此服务使用前需要在控制台创建您应用的key。船舶模糊查询不限制访问次数，只要开通权限后可调用多次，您当前使用服务的权限清单在控制台中可以查看。

在线调试#

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

请求地址#

请求地址请求方式备注
https://api.shipxy.com/apicall/v3/SearchShipGet当使用船名或imo模糊匹配时，会返回多个结果，可以参考AIS最新上报的时间，来做区分。船舶在变更过船东或者在某些租赁环节会变更mmsi，旧的mmsi依旧会有记录，可根据实际场景进行筛选。

请求调用示例#

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

请求参数

Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.shipxy.com/apicall/v3/SearchShip?key=1F6D701272402D1E7D8D316CCE519123&keywords=cosco&max='

返回响应

⚪0成功
application/json
成功返回船舶模糊查询结果
Bodyapplication/json

示例
{
    "status": 0,
    "msg": "",
    "total": 3,
    "data": [
        {
            "match_type": 1,
            "mmsi": 413543265,
            "imo": 0,
            "call_sign": "333303B",
            "ship_name": "COSCO12",
            "data_source": 0,
            "last_time": "2025-03-19 17:47:48",
            "last_time_utc": 1742377668,
            "shiptype": 70
        },
        {
            "match_type": 1,
            "mmsi": 477765900,
            "imo": 9484003,
            "call_sign": "VRKF9",
            "ship_name": "COSCO ADEN",
            "data_source": 1,
            "last_time": "2026-08-07 16:31:33",
            "last_time_utc": 1786091493,
            "shiptype": 100
        },
        {
            "match_type": 1,
            "mmsi": 674000256,
            "imo": 0,
            "call_sign": "",
            "ship_name": "A8G01",
            "data_source": 1,
            "last_time": "2026-07-19 01:44:09",
            "last_time_utc": 1784396649,
            "shiptype": 30
        }
    ]
}
上一页
1.1.3 船队位置查询
下一页
1.3 周边船舶查询