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. 场景化开发示例

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

一、行业背景与业务痛点

煤炭、铁矿石、粮食、原油成品油等大宗商品的运输以海运为主力。一条典型的业务链是:

市场研判 → 租船订舱 → 航次执行(装货港 → 卸货港)→ 到港接卸 → 时效结算 → 合规复盘

链路上的四类角色各有痛点:

货主 / 贸易商:货在船上,可见性差。船到哪了、为什么降速、会不会延误影响下游生产,只能靠船代口头汇报;在途库存无法纳入供应链计划;市场运力是松是紧靠感觉判断,采购与租船节奏全凭经验。

物流 / 船代公司:找船靠人脉。某卸货港下个月有几条合适吨位的船到港、锚地压了多少船、要等多久才能靠泊,缺乏量化依据;滞期费一亏就是几十万,但事前无法测算。

船东 / 运营方:自有船队动态分散在多个渠道,异常发现滞后;航次油耗与碳强度(CII / EEU / EU ETS)缺乏按航次的自动化核算,合规评级心里没底。

集团管理层:缺少一张能把「市场运力—自有运力—在途货物—风险敞口—碳成本」放在一起看的屏,经营决策靠层层汇报的 PPT。

船讯网 API 完整覆盖这四类角色的数据需求:港口维度的运力数据(靠泊 / 锚地 / 预抵 / 历史挂靠)、船舶维度的实时动态与档案、航次维度的轨迹与 ETA、事件维度的推送告警、环境维度的气象与潮汐,全部可以直接调用,客户不需要自建 AIS 接收、清洗与存储能力。

二、方案定位

建设一个大宗物流运输智能决策平台(企业内部系统),设计目标为:

  • 看得全:从单一港口运力看板升级到区域港口群态势大屏,支持市场研判;
  • 算得准:ETA 不止给一个数,而是给出 P50 / P90 区间与到港—靠泊—完货三段预测,并直接折算成滞期费敞口;
  • 管得住:异常事件分钟级触达,自动排误报、自动分级、自动路由;
  • 合规可算:按航次自动核算油耗、EEOI、CII,给出航速优化与 JIT 到港建议;
  • 数据同源:所有船舶数据来自船讯网,业务数据来自内部系统,以「航次 Voyage」为关联主键。

三、子场景划分

编号子场景业务阶段核心价值
A1港口运力监控与找船运力调研 · 租船决策港口运力量化,候选船画像化,租船从「凭经验」变「看数据」
A2船队货运跟踪与 ETA航次执行在途货物实时可见,ETA 滚动更新,联动接卸计划
A3货运异常预警中心全程风控降速 / 失联 / 搭靠 / 台风四类异常分钟级触达
A4 ★大宗航运态势分析与经营决策大屏经营研判区域运力供需量化、到港节奏预测、拥堵指数演化
A5 ★航次时效预测与滞期费测算航次结算三段时效概率预测 + 滞期费分布 + 谈判与改港建议
A6 ★航次能效与碳强度管理合规与成本按航次 EEOI / CII 核算、年度评级预测、航速优化

四、接口地图(本场景使用的全部接口)

接口用途文档链接
2.1 港口信息查询 SearchPort关键词 → 港口五位码https://apidocs.shipxy.com/471397856e0
2.2 港口当前靠泊船查询 GetBerthShips在泊运力https://apidocs.shipxy.com/471397857e0
2.3 港口当前到锚船查询 GetAnchorShips锚地压港https://apidocs.shipxy.com/471397858e0
2.4 港口预抵船舶查询 GetETAShips未来到港运力https://apidocs.shipxy.com/471397859e0
1.2 船舶模糊查询 SearchShip船名 / 呼号 / IMO / MMSI 反查https://apidocs.shipxy.com/475744017e0
1.1.1 单船位置查询 GetSingleShip候选船实时核验https://apidocs.shipxy.com/475744018e0
1.1.2 多船位置查询 GetManyShip批量核验https://apidocs.shipxy.com/475744019e0
1.1.3 船队位置查询 GetFleetShip全船队动态https://apidocs.shipxy.com/475744020e0
1.3 周边船舶查询 GetSurRoundingShip失联位置周边核验https://apidocs.shipxy.com/475744021e0
1.5 船舶船籍查询 GetShipRegistry船籍国 / 船旗https://apidocs.shipxy.com/475744023e0
1.6 船舶档案查询 SearchShipParticular劳氏档案画像https://apidocs.shipxy.com/475744024e0
9.1.x 监控船队管理船队分组维护https://apidocs.shipxy.com/88895737f0
9.3.4 航速异常推送降速 / 超速告警https://apidocs.shipxy.com/475752284e0
9.4 实时船位推送10 分钟一包船位https://apidocs.shipxy.com/475868776e0
9.5 到离港事件推送ATA / ATB / ATD 事件https://apidocs.shipxy.com/475867640e0
9.6 动态 ETA 推送ETA 滚动更新https://apidocs.shipxy.com/475871604e0
9.7 AIS 信号消失事件推送失联告警https://apidocs.shipxy.com/475871670e0
9.8 搭靠事件推送过驳 / 盗抢风险https://apidocs.shipxy.com/475871672e0
5.1 点到点航线规划 PlanRouteByPoint坐标级航线基准https://apidocs.shipxy.com/475741520e0
5.2 港到港航线规划 PlanRouteByPort航线基准与里程https://apidocs.shipxy.com/475741521e0
5.3 ETA 查询 GetSingleETAPrecise精确到港预测https://apidocs.shipxy.com/475741522e0
3.1 历史轨迹查询 GetShipTrack航迹核对 / 回放 / 能效核算https://apidocs.shipxy.com/474233611e0
3.2 船舶互相搭靠记录查询 SearchshipApproach事后核查https://apidocs.shipxy.com/474233612e0
4.1 船舶历史挂靠记录 GetPortofCallByShip港序链条佐证https://apidocs.shipxy.com/474308123e0
4.2 船舶挂靠指定港口记录 GetPortofCallByShipPort单船单港历史https://apidocs.shipxy.com/474308124e0
4.3 船舶当前挂靠信息 GetShipStatus当前挂靠状态https://apidocs.shipxy.com/474308125e0
4.4 港口挂靠历史船舶 GetPortofCallByPort港口吞吐与泊位周转统计(A4 核心)https://apidocs.shipxy.com/474308126e0
6.1.1 实时气象数据 CurrentWeather作业实况https://apidocs.shipxy.com/475752665e0
6.1.2 未来气象预报 FutureWeather7 天逐小时预报https://apidocs.shipxy.com/475752666e0
6.2.1 全球台风列表 GetAllTyphoon台风态势https://apidocs.shipxy.com/475752661e0
6.2.2 单个台风信息 GetSingleTyphoon路径与风圈https://apidocs.shipxy.com/475752662e0
6.3.2 潮汐数据 GetTideData乘潮窗口https://apidocs.shipxy.com/475759821e0
6.5 海区气象 GetWeather海区预报https://apidocs.shipxy.com/475752660e0
7 海图 GIS 平台开发海图渲染https://apidocs.shipxy.com/88879805f0

五、数据流转总图

fig-A-数据流转总图.png

  1. 基础数据准备(一次性):内部系统导入货主 / 合同 / 货单 / 准入白名单 → 调用船队管理 API 建立自有与承运船队并绑定船舶 → 控制台配置推送接收 URL → 缓存港口与潮汐站静态数据。
  2. 市场研判(A4):定时批量拉港口群靠泊 / 锚地 / 预抵 / 历史挂靠 → 计算拥堵指数与运力供给指数 → 输出供需缺口与到港节奏预测 → 指导租船时机。
  3. 找船阶段(A1):SearchPort 定位港口 → 三类清单扫描运力 → 多条件筛选候选船 → GetSingleShip + SearchShipParticular 核验 → 生成内部航次记录,并进入 A5 测算时效与滞期费。
  4. 航次执行(A2):实时船位推送 + 动态 ETA 推送驱动地图与看板;到离港事件推送闭合每个港口节点;GetShipTrack 提供任意时段回放。
  5. 异常管控(A3):AIS 消失 / 航速异常 / 搭靠三类推送实时进入预警中心 → 周边船舶核验 + 轨迹核对自动排误报 → 分级触达 → 处置归档。
  6. 能效核算(A6):航次结束后用计划航距与实际航迹核算 EEOI / CII,滚动预测年度评级,输出下航次航速优化建议。
  7. 结算归档:ATA / ATB / ATD 与挂靠记录作为航次结算时间依据,A5 的滞期费测算结果与实际对账,回写内部 ERP。

本场景子文档

港口运力监控与找船

船队货运跟踪与 ETA

货运异常预警中心

大宗航运态势分析与经营决策大屏

航次时效预测与滞期费测算

航次能效与碳强度管理

上一页
场景化开发示例
下一页
1、港口运力监控与找船