1. 大宗物流运输智能决策平台
Shipxy
  • 船讯网API服务概述
  • 文档目录
  • 注册与创建应用
  • 多语言SDK引入
  • 标准API服务
    • 1 船舶查询
      • 1.1 船舶位置查询
        • 1.1.1 单船位置查询
        • 1.1.2 多船位置查询
        • 1.1.3 船队位置查询
      • 1.2 船舶模糊查询
      • 1.3 周边船舶查询
      • 1.4 区域船舶查询
      • 1.5 船舶船籍查询
      • 1.6 船舶档案查询
      • 1.7 档案服务扩展
    • 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. 大宗物流运输智能决策平台

3、货运异常预警中心

所属:大宗物流运输智能决策平台

A3 货运异常预警中心#

一、场景说明#

业务视角:大宗海运的风险窗口不只发生在台风巨浪,更多是「静悄悄」的异常——船莫名降速(机械故障或扣船前兆)、AIS 信号消失(关闭应答器,走私 / 制裁规避常用手段)、与不明船舶贴近并航(海上过驳 / 盗抢风险)、台风逼近航线(货损与延误)。过去这些要靠船东每周汇报或船代事后才知道,发现往往滞后数日。
本子场景以船讯网事件推送为触发源,建立「事件自动找人」机制:左屏分级预警事件流(红 / 橙 / 黄三级),右屏处置台(最后位置、周边船舶、误报统计、处置按钮),中央海图定位事件位置。从异常发生到处置人收到通知全程 < 5 分钟。
客户视角:风控 / 合规部门、船东运营调度、货主供应链风控。

二、实现流程#

fig-A3-实现流程.png
步骤阶段使用接口关键计算 / 业务逻辑
1.1 AIS 消失事件① 数据获取9.7>15 分钟未上报触发;恢复后推送恢复事件
1.2 航速异常事件① 数据获取9.3.4航速低于下限或高于上限并持续 duration_min
1.3 搭靠事件① 数据获取9.8贴近停靠或并排行驶 > 5 分钟
1.4 周边核验① 数据获取GetSurRoundingShip失联位置 10 海里内船舶清单
1.5 轨迹核对① 数据获取GetShipTrack消失前后轨迹
1.6 搭靠历史① 数据获取SearchshipApproach30 天内搭靠记录
1.7 台风态势① 数据获取GetAllTyphoon + GetSingleTyphoon风圈与预测路径
2.1 误报过滤② 计算处理—港内遮蔽 + 区域性中断两步核验
2.2 航速延误传导② 计算处理—新增航时 = 剩余 ÷ 异常航速 − 剩余 ÷ 订舱航速
2.3 搭靠风险判定② 计算处理—30 天搭靠对手数 + 是否高风险海域
2.4 台风距离计算② 计算处理—大圆距离 + 风圈半径对比
3.1 风险分级③ 业务判断—高 / 中 / 低三级
3.2 处置路由③ 业务判断—按类型派发到对应处置人
4.1 预警通知④ 输出应用—IM / 短信 / 邮件多通道
4.2 处置记录④ 输出应用—误报 / 已处置 / 立案归档

三、接口调用与响应#

3.1 AIS 信号消失推送(9.7)#

{"msg_type": "ais_disappear", "fleet_id": "FLEET_2026_散货A",
 "items": [{"mmsi": 477221800, "ship_name_en": "NEW OCEAN", "event_type": 1,
            "event_type_cn": "信号消失", "last_lat": 36.07, "last_lng": 120.32,
            "last_time": 1726000100, "last_sog": 6.8, "last_navistat": "在航"}]}
event_type:1 = 信号消失(>15 分钟未上报),2 = 信号恢复。建议在事件流上做「消失 ↔ 恢复」配对,自动闭环。

3.2 航速异常推送(9.3.4)#

订阅参数:min_speed / max_speed / duration_min(默认 30 分钟,避免小幅波动误报)。
{"msg_type": "speed_alert", "fleet_id": "FLEET_2026_散货A",
 "items": [{"mmsi": 477221800, "ship_name_en": "NEW OCEAN", "event_type": 1,
            "event_type_cn": "低于下限", "current_speed": 6.5, "min_speed": 8.0,
            "alert_time": 1726000500}]}

3.3 搭靠事件推送(9.8)#

判定规则由服务端固定:两船贴近停靠(距离 < 0.3 海里且相对速度 < 0.5 节)持续 5 分钟以上,或并排行驶(航向差 < 30°、相对距离 < 0.5 海里)持续 5 分钟以上。
{"msg_type": "approach_event",
 "items": [{"ship_a_mmsi": 477221800, "ship_a_name": "NEW OCEAN",
            "ship_b_mmsi": 412500123, "ship_b_name": "鲁日渔 1268",
            "event_lat": 36.10, "event_lng": 120.45, "duration_min": 18,
            "speed_a": 0.3, "speed_b": 0.4}]}

3.4 GetSurRoundingShip 周边核验#

{"code": 0, "data": [{"mmsi": 477332200, "ship_name_cn": "苏盐城 0088", "distance_nm": 3.2,
                      "bearing_deg": 85, "sog": 12.5, "cog": 95, "last_time": 1726000800}]}
返回按距离升序排序,半径固定 10 海里。

3.5 SearchshipApproach 搭靠历史#

{"code": 0, "data": [{"counter_mmsi": 412500123, "counter_name": "鲁日渔 1268",
                      "start_time": 1725500000, "end_time": 1725501200,
                      "duration_min": 20, "avg_distance_nm": 0.3, "avg_speed": 0.5}]}

3.6 台风列表与详情#

{"code": 0, "data": {"typhoon_id": "T202609_KRATHON", "current_lat": 21.5, "current_lng": 119.8,
 "max_wind_ms": 28, "pressure_hpa": 985, "move_speed_kmh": 18, "move_dir_deg": 320,
 "wind_circle": {"level_7_quadrants": {"ne": 280, "se": 280, "sw": 280, "nw": 280},
                 "level_10_quadrants": {"ne": 130, "se": 130, "sw": 130, "nw": 130},
                 "level_12_quadrants": {"ne": 60, "se": 60, "sw": 60, "nw": 60}},
 "forecast": [{"fhour": 0, "utc": 1726011600, "lat": 21.5, "lng": 119.8, "max_wind_ms": 28},
              {"fhour": 12, "utc": 1726018800, "lat": 22.8, "lng": 118.5, "max_wind_ms": 30}]}}
关键:wind_circle 半径单位是公里,换算海里需 ÷ 1.852。

四、计算逻辑#

4.1 AIS 消失的两步误报过滤#

中文说明:AIS 消失最常见的原因不是恶意关机,而是港内遮蔽与区域性信号中断。第一步拉取消失前 2 小时轨迹,若最后一个点在港口 2 海里内且航速低于 0.5 节,判定为港内停泊遮蔽,降级为提示;第二步拉取失联位置周边船舶,若周边船舶中大部分也在同一时间窗内停止上报,说明是区域性信号问题,同样降级;两步都不成立才维持高风险告警。

4.2 航速异常的延误传导#

中文说明:把剩余里程分别按当前异常航速与订舱约定航速计算所需时间,两者之差即为新增航时;把新增航时叠加到合同 ETA 得到修正后的 ETA;再按 6 小时、24 小时两个台阶给出预警等级与处置动作——注意判断顺序必须从大到小,先判严重延误。

4.3 搭靠风险判定#

中文说明:先看事件发生位置是否落在内部配置的高风险海域(如已知海盗区、制裁规避高发区),是则直接判红;否则统计近 30 天内与该船发生搭靠的不同对端船舶数量,对手数 ≥5 判红(疑似多次过驳),2–4 判黄(需船东核实),≤1 判绿(正常补给)。

4.4 台风与航线关联#

中文说明:用大圆距离公式计算台风中心与航次剩余航线折线的最短距离(逐预测点位 × 逐航线点取最小值);影响半径取 7 级风圈四象限最大半径(公里 ÷ 1.852 转海里)再加安全余量(默认 100 海里);当前位置命中即为「正在受影响」,预测点命中即为「预计受影响」并给出提前量小时数。

五、输出的应用形态#

异常预警总览:左侧分级预警事件流(红 / 橙 / 黄),右侧处置台(最后位置 KPI、周边船舶、误报统计、处置按钮),中央事件位置海图(高风险红点、中风险橙点、失联船最后航迹红虚线、台风位置与预测路径)。
台风影响详情:上部台风参数表,中部受影响船舶清单(距台风中心海里、预计进入风圈时间、风险等级),下部绕航建议与绕航成本。
大宗物流运输-异常预警中心.png

六、数据边界与常见问题#

数据边界:事件源、轨迹、周边船舶、台风来自船讯网;风险海域配置、处置人通讯录、误报阈值、订舱信息来自内部系统;以「mmsi + 时间窗」自动匹配内部航次。
Q1:消失事件恢复后会再次推送吗? 会,event_type=2 为恢复事件,建议在事件流上做配对自动闭环。
Q2:搭靠判定阈值能调整吗? 服务端判定规则不开放调整,业务侧可用 SearchshipApproach 做二次筛选。
Q3:台风预测多久更新? 每 6 小时一次(中央气象台发布时点),建议按此频率轮询或事件驱动。

上一页
2、船队货运跟踪与 ETA
下一页
4、大宗航运态势分析与经营决策大屏