1. 9 监控推送
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 点到点航线规划
    • 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 海图应用
    • 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 实时船位推送
      POST
    • 9.5 船舶到离港事件推送
      POST
    • 9.6 船舶动态ETA推送
      POST
    • 9.7 船舶AIS信号消失事件推送
      POST
    • 9.8 船舶搭靠事件推送
      POST
  • 文档附录
    • 船舶类型对照表
    • 服务码返回说明
    • 海区对照表
    • 航行状态对照表
    • 绕航节点清单
    • 航标类型对照表
  1. 9 监控推送

9.4 实时船位推送

POST
/push/realtimePosition

服务介绍#

设置监控的船队船舶,船讯网自动监控船队的实时位置,每10分钟推送一包船舶实时位置数据,数据格式与船舶位置查询基本一致。
需要提前在控制台中创建船队并绑定船舶,或者通过监控船队管理的api创建船队。绑定船舶超出权限的数量会绑定失败,在约定的数量范围内,船舶列表可以进行替换。

适用场景#

货运物流与船舶管理#

货物跟踪与供应链管理:货主和物流企业可以通过实时船舶位置数据,准确掌握货物所在的船舶位置、航行状态以及预计到达时间等信息,从而更好地安排后续的物流环节,如港口装卸、仓储、运输等,优化供应链管理,提高货物交付的及时性和准确性。
航线优化与调度:航运企业依据实时船舶位置数据,结合气象、台风、潮汐等信息,动态调整船舶的航线和航速,避开恶劣天气区域和拥堵航道,选择最优航线,提高运输效率,节省运营成本。
船舶运营管理:船东和船舶管理公司能够实时监控旗下船舶的动态,了解船舶的航行位置、速度、航向等信息,及时发现异常情况并进行干预,如船舶偏离预定航线、速度异常等,确保船舶的正常运营。同时,还可通过对船舶位置数据的分析,优化船舶的运营调度,合理安排船舶的任务和停靠港口。

请求限制#

此服务为高级服务,需要申请高级权限才可使用,使用前需要在控制台创建您应用的key,并且在key下绑定监控的船队船舶以及接收推送消息的url地址。您当前使用服务的权限清单在控制台中可以查看,开通服务权限请。

请求地址#

接口名称请求地址请求方式
实时船位推送在控制台中创建配置接收数据的urlPost推送

请求参数

无

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/push/realtimePosition'

返回响应

⚪0成功
application/json
成功接收推送
Bodyapplication/json

示例
{
    "data": [
        {
            "mmsi": 563018400,
            "imo": 9761463,
            "call_sign": "9V3642",
            "ship_name": "XIN LONG YANG",
            "ship_cnname": null,
            "data_source": 0,
            "last_time": "2025-05-27 15:28:34",
            "last_time_utc": 1748330914,
            "lat": 31.375355,
            "lng": 121.687177,
            "ship_type": 80,
            "length": 333,
            "width": 60,
            "left": 37,
            "trail": 56,
            "draught": 5.6,
            "dest": "CXD",
            "destcode": "",
            "eta": "2025-05-12 00:00:00",
            "eta_utc": 1746979200,
            "navistat": 5,
            "sog": 0,
            "cog": 360,
            "hdg": 118,
            "rot": 0
        },
        {
            "mmsi": 538007628,
            "imo": 9334143,
            "call_sign": "V7VR3",
            "ship_name": "MATSON LANAI",
            "ship_cnname": null,
            "data_source": 1,
            "last_time": "2025-05-27 15:12:59",
            "last_time_utc": 1748329979,
            "lat": 48.37769,
            "lng": 171.07297,
            "ship_type": 70,
            "length": 260,
            "width": 32,
            "left": 17,
            "trail": 68,
            "draught": 10.2,
            "dest": "LONG BEACH,US",
            "destcode": "USLGB",
            "eta": "2025-06-03 00:30:00",
            "eta_utc": 1748881800,
            "navistat": 0,
            "sog": 22.2198448,
            "cog": 80.6,
            "hdg": 82,
            "rot": 0
        }
    ]
}
修改于 2026-06-22 08:34:47
上一页
9.3.4 船舶航速异常推送
下一页
9.5 船舶到离港事件推送
Built with