1. 2 港口查询
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. 2 港口查询

2.4 港口预抵船舶查询

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

服务介绍#

使用港口五位码和时间周期查询在未来某一时间段预计到达该港口的船舶列表和船舶信息。

适用场景#

1、海上监管。根据港口在未来某一时间段即将到港的船舶,筛选不同的船舶类型和船籍国,可以提前分配海关或边检资源,并且结合船舶历史异常AIS事件或搭靠等信息,分析风险船舶。
2、物流找船。在发货仓附近的港口筛选即将到达的货运船舶列表,再通过船舶档案的经营公司信息或企业运力池维护的船舶通讯录,开始发货邀约等。
3、航运分析。分析港口承载情况以及港口所有预抵船舶的属性信息。

请求限制#

此服务为高级服务,需要申请高级权限才可使用,使用前需要在控制台创建您应用的key。请求服务时,会根据您所属权限的类型限制访问的数量,您当前使用服务的权限清单在控制台中可以查看。开通服务权限请联系商务:https://api.shipxy.com/v3/console/support

在线调试#

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

请求地址#

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

请求调用示例#

https://api.shipxy.com/apicall/v3/GetETAShips?key=1F6D701272402D1E7D8D316CCE519123&port_code=CNSHG&start_time=1746612218&end_time=1747044218&ship_type=0
**注:**例子中的 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/GetETAShips?key=1F6D701272402D1E7D8D316CCE519123&port_code=CNSHG&start_time=1746612218&end_time=1747044218&ship_type=undefined'

返回响应

⚪0成功
application/json
成功返回预抵船舶信息
Bodyapplication/json

示例
{
    "status": 0,
    "msg": "",
    "total": 1410,
    "data": [
        {
            "mmsi": 210563000,
            "ship_name": "SPECTRUM OF THE SEAS",
            "imo": 9778856,
            "dwt": 0,
            "ship_type": "客船",
            "length": 348,
            "width": 42,
            "draught": 8.9,
            "preport_cnname": "八代",
            "last_time": "2025-05-09 13:42:55",
            "last_time_utc": 1746769375,
            "eta": "2025-05-10 05:38:46",
            "eta_utc": 1746826726,
            "dest": "上海",
            "ship_flag": "塞浦路斯"
        }
    ]
}
修改于 2026-06-23 00:54:20
上一页
2.3 港口当前到锚船查询
下一页
3 历史行为
Built with