1. 1 船舶查询
Shipxy
  • 船讯网API服务概述
  • 文档目录
  • 注册与创建应用
  • 多语言SDK引入
  • 标准API服务
    • 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
      • 1.7 档案服务扩展
        GET
    • 2 港口查询
      • 2.1 港口信息查询
      • 2.2 港口当前靠泊船查询
      • 2.3 港口当前到锚船查询
      • 2.4 港口预抵船舶查询
    • 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后端代理接入
      • 7.9 坐标系转换指南
      • 7.10 私有化部署开发指南
        • 01 私有化地图加载绘制
        • 02 船舶与轨迹绘制实践
        • 03 气象图层效果绘制
    • 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 船舶搭靠事件推送
    • 文档附录
      • 船舶类型对照表
      • 服务码返回说明
      • 海区对照表
      • 航行状态对照表
      • 绕航节点清单
      • 航标类型对照表
      • 区域船二进制解析说明
      • 常见问题
  • AI智能体应用
    • AI大模型接入MCP服务
    • 智能体场景应用
      • 运力资源智能体
      • 船舶风控智能体
      • 运输规划智能体
      • 航次时效预测智能体
      • 船舶安全监控智能体
      • 多式联运协同智能体
      • 大宗贸易态势分析智能体
  • 视频监控AI识别预警服务
    • 视频监控服务接入指南
    • 视频监控API服务说明
    • 视频监控场景应用指南
    • 视频监控服务FAQ与最佳实践
  • 场景化开发示例
    • 大宗物流运输智能决策平台
      • 1、港口运力监控与找船
      • 2、船队货运跟踪与 ETA
      • 3、货运异常预警中心
      • 4、大宗航运态势分析与经营决策大屏
      • 5、航次时效预测与滞期费测算
      • 6、航次能效与碳强度管理
    • 海上设施安全监管与决策平台
      • 1、监管区域与事件推送（总览大屏）
      • 2、设施周边安全监控
      • 3、偏航识别与轨迹回放
      • 4、气象海况与航行警告
      • 5、海上安全态势监管大屏与执法效能分析
      • 6、水域通航密度与碰撞风险预测
      • 7、设施运维作业窗口智能排程与船舶调度
  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=%E4%B8%AD%E7%87%83%E6%B2%B9&max='

返回响应

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

示例
{
    "status": 0,
    "msg": "",
    "total": 3,
    "data": [
        {
            "match_type": 1,
            "mmsi": 413272392,
            "imo": 0,
            "call_sign": "",
            "ship_name": "ZHONG RAN YOU 18",
            "ship_cnname": "中燃油18",
            "data_source": 0,
            "last_time": "2026-09-01 21:01:57",
            "last_time_utc": 1788267717,
            "shiptype": 80
        },
        {
            "match_type": 1,
            "mmsi": 413200157,
            "imo": 0,
            "call_sign": "BJFOUF",
            "ship_name": "ZHONGRANYOU18",
            "ship_cnname": "中燃油18",
            "data_source": 0,
            "last_time": "2026-06-22 07:42:30",
            "last_time_utc": 1782085350,
            "shiptype": 80
        },
        {
            "match_type": 1,
            "mmsi": 413272420,
            "imo": 0,
            "call_sign": "BPKB2",
            "ship_name": "ZHONG RAN YOU 18",
            "ship_cnname": "中燃油18",
            "data_source": 0,
            "last_time": "2026-09-24 13:25:24",
            "last_time_utc": 1790227524,
            "shiptype": 80
        }
    ]
}
上一页
1.1.3 船队位置查询
下一页
1.3 周边船舶查询