1. 1.1 船舶位置查询
Shipxy
  • 船讯网API服务概述
  • 文档目录
  • 注册与创建应用
  • 多语言SDK引入
  • 标准API服务
    • 1 船舶查询
      • 1.1 船舶位置查询
        • 1.1.1 单船位置查询
          GET
        • 1.1.2 多船位置查询
          GET
        • 1.1.3 船队位置查询
          GET
      • 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 船舶位置查询

1.1.2 多船位置查询

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

服务介绍#

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

适用场景#

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

请求限制#

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

在线调试#

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

请求地址#

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

请求调用示例#

https://api.shipxy.com/apicall/v3/GetManyShip?key=1F6D701272402D1E7D8D316CCE519123&mmsis=413961925,477232800,477172700
**注:**例子中的 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/GetManyShip?key=1F6D701272402D1E7D8D316CCE519123&mmsis=413961925%2C477232800%2C477172700'

返回响应

⚪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.2,
            "dest": "TAIZHOU, CN",
            "destcode": "CNTZO",
            "eta": "2025-12-30 17:18:00",
            "eta_utc": 1767086280,
            "navistat": 255,
            "lat": 32.569047,
            "lng": 119.9824,
            "sog": 6.4,
            "cog": 226.0,
            "hdg": 511.0,
            "rot": 0.0,
            "last_time": "2026-06-20 14:29:34",
            "last_time_utc": 1781936974
        },
        {
            "mmsi": 477232800,
            "imo": 9789647,
            "call_sign": "VRSG2",
            "ship_name": "COSCO PISCES",
            "ship_cnname": "",
            "data_source": 0,
            "ship_type": 100,
            "length": 400,
            "width": 59,
            "left": 24,
            "trail": 241,
            "draught": 12.3,
            "dest": "ESVLC>SGSIN(PWBGA)  ",
            "destcode": "",
            "eta": "2026-07-16 14:00:00",
            "eta_utc": 1784181600,
            "navistat": 0,
            "lat": 36.662522,
            "lng": -1.853852,
            "sog": 19.1,
            "cog": 227.6,
            "hdg": 228.0,
            "rot": 0.01,
            "last_time": "2026-06-20 14:29:26",
            "last_time_utc": 1781936966
        },
        {
            "mmsi": 477172700,
            "imo": 9783538,
            "call_sign": "VRRV4",
            "ship_name": "COSCO SHIPPING LIBRA",
            "ship_cnname": "",
            "data_source": 1,
            "ship_type": 100,
            "length": 399,
            "width": 59,
            "left": 33,
            "trail": 256,
            "draught": 15.3,
            "dest": "ROTTERDAM, NL",
            "destcode": "NLRTM",
            "eta": "2026-06-16 11:45:00",
            "eta_utc": 1781581500,
            "navistat": 5,
            "lat": 51.975318,
            "lng": 4.030185,
            "sog": 0.0,
            "cog": 159.5,
            "hdg": 110.0,
            "rot": 0.0,
            "last_time": "2026-06-20 14:27:36",
            "last_time_utc": 1781936856
        }
    ]
}
上一页
1.1.1 单船位置查询
下一页
1.1.3 船队位置查询