1. 1 船舶查询
Shipxy
  • 概述
  • 注册与创建应用
  • 多语言SDK引入
  • AI大模型接入MCP服务
  • 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 船舶历史轨迹查询
      GET
    • 3.2 船舶互相搭靠记录查询
      GET
  • 4 挂靠记录
    • 4.1 船舶历史挂靠记录
      GET
    • 4.2 船舶挂靠指定港口记录
      GET
    • 4.3 船舶当前挂靠信息
      GET
    • 4.4 港口挂靠历史船舶
      GET
  • 5 航线规划
    • 5.1 点到点航线规划
      GET
    • 5.2 港到港航线规划
      GET
    • 5.3 预计到达时间(ETA)查询
      GET
  • 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 海区气象
      GET
    • 6.6 单点海洋气象
      GET
    • 6.7 历史气象记录
      GET
  • 7 海图应用
    • 7.1 船位光栅瓦片
    • 7.2 港口位置瓦片
  • 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.3 周边船舶查询

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

服务介绍#

通过船舶的MMSI进行查询,获取以当前船舶位置为圆心以10海里为半径的圆形区域内的船舶数据。返回的船舶数据列表按照由近及远进行排序,返回的数据包括船舶imo编号、呼号、船舶中英文名称、船舶类型、长度宽度以及AIS最新更新上报的船舶实时位置、航行状态、船舶目的港口、船舶实时速度、预计到达目的港的时间、航首向航迹向等。

适用场景#

1、海上施工安全监控。以施工船为中心,获取10海里半径内的船舶数据列表,监控这些船舶的位置和动向,如果有船舶接近施工区域,施工方可以及时发出警告或调整施工计划;
2、海上避碰预警。以航行船为中心,监控附近船舶的位置和航向,评估碰撞风险,如果检测到潜在的碰撞风险,船方可以及时采取避碰措施;
3、海上应急救援。以遇险船舶为中心,定位并协调附近的船舶进行搜救。

请求限制#

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

在线调试#

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

请求地址#

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

请求调用示例#

https://api.shipxy.com/apicall/v3/GetSurRoundingShip?key=1F6D701272402D1E7D8D316CCE519123&mmsi=413881597
**注:**例子中的 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/GetSurRoundingShip?key=1F6D701272402D1E7D8D316CCE519123&mmsi=413881597'

返回响应

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

示例
"status": 0,
"msg": "",
"total": 221,
"data": [
    {
        "mmsi": 413761246,
        "imo": 0,
        "call_sign": "YR0",
        "ship_name": "PINGNANHONGSHUN3778",
        "ship_cnname": "平南宏顺3778",
        "data_source": 0,
        "last_time": "2025-05-15 14:55:58",
        "last_time_utc": 1747292158,
        "lat": 23.453682,
        "lng": 110.52463,
        "ship_type": 70,
        "length": 81,
        "width": 16,
        "left": 10,
        "trail": 5,
        "draught": 4.3,
        "dest": "GUANGZHOU,CN",
        "destcode": "CNGZG",
        "eta": "2025-04-17 21:30:00",
        "eta_utc": 1744896600,
        "navistat": 1,
        "sog": 0,
        "cog": 0,
        "hdg": 0,
        "rot": 0
    },
    {
        "mmsi": 413761521,
        "imo": 0,
        "call_sign": "YR7",
        "ship_name": "PINGNANRONGDA333",
        "ship_cnname": "平南荣达333",
        "data_source": 0,
        "last_time": "2025-05-15 14:56:47",
        "last_time_utc": 1747292207,
        "lat": 23.472812,
        "lng": 110.50188,
        "ship_type": 70,
        "length": 82,
        "width": 16,
        "left": 7,
        "trail": 9,
        "draught": 1.2,
        "dest": "XZ                  ",
        "destcode": "",
        "eta": "2025-05-28 09:00:00",
        "eta_utc": 1748394000,
        "navistat": 1,
        "sog": 0,
        "cog": 0,
        "hdg": 0,
        "rot": 0
    },
    {
        "mmsi": 413762746,
        "imo": 0,
        "call_sign": "JKKKJK",
        "ship_name": "GUIPINGHANGKAI3358",
        "ship_cnname": "桂平航凯3358",
        "data_source": 0,
        "last_time": "2025-05-15 14:54:37",
        "last_time_utc": 1747292077,
        "lat": 23.468075,
        "lng": 110.513635,
        "ship_type": 70,
        "length": 61,
        "width": 13,
        "left": 7,
        "trail": 8,
        "draught": 0,
        "dest": "",
        "destcode": "",
        "eta": "",
        "eta_utc": 0,
        "navistat": 255,
        "sog": 0,
        "cog": 18.2,
        "hdg": 511,
        "rot": -2.77
    },
     ......
]
}
修改于 2026-06-23 00:51:14
上一页
1.2 船舶模糊查询
下一页
1.4 区域船舶查询
Built with