1. 3 历史行为
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. 3 历史行为

3.1 船舶历史轨迹查询

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

服务介绍#

通过船舶的mmsi编号和时间段,查询船舶历史经过的轨迹点。

适用场景#

1、物流跟踪。跟踪船舶历史轨迹信息,可以结合海图进行轨迹查询、轨迹展示和轨迹回放。
2、船舶行为分析。根据船舶历史轨迹中每个点位信息,可以结合气象、航行警告等信息分析船舶是否有异常的行为。

请求限制#

此服务使用前需要在控制台创建您应用的key。请求服务时,会根据您所属权限的类型限制访问的数量,您当前使用服务的权限清单在控制台中可以查看。服务默认只能查询1个月以内的船舶轨迹,如果需要查询更久之前的船舶轨迹记录,请联系商务开通。

在线调试#

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

请求地址#

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

请求调用示例#

https://api.shipxy.com/apicall/v3/GetShipTrack?key=1F6D701272402D1E7D8D316CCE519123&mmsi=477172700&start_time=1744017189&end_time=1744019589
**注:**例子中的 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/GetShipTrack?key=1F6D701272402D1E7D8D316CCE519123&mmsi=477172700&start_time=1744017189&end_time=1744019589&output='

返回响应

⚪0成功
application/json
成功返回船舶历史轨迹数据
Bodyapplication/json

示例
{
    "status": 0,
    "msg": "",
    "data": [
        {
            "data_source": 0,
            "utc": 1744017444,
            "lng": 121.730682,
            "lat": 38.272802,
            "sog": 16.6,
            "cog": 295.2
        },
        {
            "data_source": 0,
            "utc": 1744017749,
            "lng": 121.703605,
            "lat": 38.282833,
            "sog": 16.7,
            "cog": 294.9
        }
    ]
}
修改于 2026-06-23 00:55:03
上一页
3 历史行为
下一页
3.2 船舶互相搭靠记录查询
Built with