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

海上设施安全监管与决策平台

一、行业背景与业务痛点

海上油田平台、海上风电场、LNG 接收站与码头、跨海大桥、海洋牧场等海上设施,常年面临「被动 + 无人」的安全困境:设施多位于离岸数十海里的开阔海域,物理围栏不存在,值班力量有限;渔船拖网、商船抛锚、无序施工甚至恶意闯入随时可能发生在设施周边,轻则损坏海缆与结构,重则引发平台安全事故。

传统监管手段的不足:

  • 雷达 / 视频监控:覆盖半径有限且建设成本高,一个平台群要全覆盖代价极大;
  • 人工瞭望:无法 7×24 值守,夜间与恶劣天气基本失效;
  • 事后追责:缺乏完整证据链,闯入行为往往只能口头警告,震慑不足;
  • 指挥决策靠经验:哪个区域最近最危险、下周该把巡逻力量放在哪里,只能凭值班员的经验判断;
  • 运维调度靠电话:多设施、多工序、多艘运维船的排程靠人工协调,天气一变就全面打乱。

而 AIS 全域船舶动态 恰恰是海上设施监管最经济的数字围栏原料——船讯网把 AIS 数据加工成「区域事件推送 + 周边船舶 + 历史轨迹 + 气象环境」四类服务,正好补齐这块短板。

二、方案定位

建设一个海上设施安全监管与决策平台(监管单位或设施运营方的内部系统),核心设计目标:

  • 电子围栏化:把每个设施的安全范围划成可配置的多边形监管区域,进出行为自动推送,替代人工瞭望;
  • 圈层化防御:以设施为圆心建立 10 / 3 / 1 海里三级安全圈,越近的船越早进入处置视野;
  • 证据链闭环:从区域事件、周边快照到轨迹回放、搭靠记录,异常行为自动留痕,支撑执法与追责;
  • 态势可决策:不止看「现在有几条船」,还要看「哪里最危险、什么时候最危险、执法跟不跟得上」——这是 B5 与 B6 要解决的;
  • 排程可执行:把气象、潮汐、禁航、船舶可用性合成一张可执行的运维排程表,并在天气变化时自动重排——这是 B7 要解决的。

船舶数据全部来自船讯网;设施台账、白名单、执法流程来自客户内部系统,以「设施 ID + 区域 ID」关联。

三、监管对象与子场景划分

典型监管对象(均使用真实地理位置):渤海油田作业区(渤海中部采油平台群)、东海风电场 A/B 区(江苏如东外海风机阵列)、LNG 接收站警戒区(江苏滨海)、跨海大桥通航孔(东海大桥—洋山)、海洋牧场保护区(象山港外)。

编号子场景业务阶段核心价值
B1监管区域与事件推送(总览大屏)值班监控电子围栏事件实时推送,一个大屏看全部区域态势
B2设施周边安全监控近程防御三级安全圈 + 逼近态势推算(CPA / TCPA),威胁分级处置
B3偏航识别与轨迹回放行为研判区分正常过境与主动逼近,回放取证
B4气象海况与航行警告环境防御作业窗口、防台、禁航区与设施联动
B5 ★海上安全态势监管大屏与执法效能分析指挥决策全辖区态势量化、风险趋势预测、热点时段预测、执法闭环效能
B6 ★水域通航密度与碰撞风险预测风险前置航迹密度统计、会遇态势批量预测、碰撞风险指数与高风险时段
B7 ★设施运维作业窗口智能排程与船舶调度运维执行多设施多工序窗口排程、船舶调度匹配、预报变更自动重排

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

接口用途文档链接
9.2.1 区域创建 AddArea创建电子围栏https://apidocs.shipxy.com/475752271e0
9.2.2–9.2.4 区域更新 / 查询 / 删除区域全生命周期管理https://apidocs.shipxy.com/475752273e0
9.2.5 区域事件推送到达 / 离开 / 疑似穿越https://apidocs.shipxy.com/475752275e0
9.1.x 监控船队管理运维船 / 守护船编队https://apidocs.shipxy.com/88895737f0
9.3.4 航速异常推送圈内目标动态补充https://apidocs.shipxy.com/475752284e0
9.4 实时船位推送运维船实时位置https://apidocs.shipxy.com/475868776e0
9.7 AIS 信号消失推送关机规避监管识别https://apidocs.shipxy.com/475871670e0
9.8 搭靠事件推送贴近设施行为https://apidocs.shipxy.com/475871672e0
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 周边船舶查询 GetSurRoundingShip10 海里圈层扫描https://apidocs.shipxy.com/475744021e0
1.4 区域船舶查询 GetAreaShip区域内船舶快照 / 密度统计https://apidocs.shipxy.com/475744022e0
1.5 船舶船籍查询 GetShipRegistry船籍国https://apidocs.shipxy.com/475744023e0
1.6 船舶档案查询 SearchShipParticular船舶画像(吨位 / 尺度 / 船东)https://apidocs.shipxy.com/475744024e0
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.3 船舶当前挂靠信息 GetShipStatus当前状态佐证https://apidocs.shipxy.com/474308125e0
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
6.1.1 实时气象数据 CurrentWeather设施风浪流实况https://apidocs.shipxy.com/475752665e0
6.1.2 未来气象预报 FutureWeather7 天逐小时预报https://apidocs.shipxy.com/475752666e0
6.5 海区气象 GetWeather沿岸 / 近海 / 远海预报https://apidocs.shipxy.com/475752660e0
6.6 单点海洋气象 GetWeatherByPoint单点海洋要素https://apidocs.shipxy.com/475752659e0
6.2.1 台风列表 GetAllTyphoon台风态势https://apidocs.shipxy.com/475752661e0
6.2.2 单个台风信息 GetSingleTyphoon路径 / 风圈 / 预测https://apidocs.shipxy.com/475752662e0
6.3.1 国内潮汐观测站列表 GetTides按港口找观测站https://apidocs.shipxy.com/475759820e0
6.3.2 潮汐数据 GetTideData逐日高低潮时刻与潮高https://apidocs.shipxy.com/475759821e0
6.4.2 全球潮汐数据 GetGlobalTideData境外设施潮汐https://apidocs.shipxy.com/475759840e0
8.1 航行警告查询 GetNavWarning军事任务 / 实弹射击等https://apidocs.shipxy.com/475669720e0
7 海图 GIS 平台开发海图渲染https://apidocs.shipxy.com/88879805f0

五、数据流转总图

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

  1. 区域建档(一次性):设施台账录入内部系统 → 调 AddArea 为每个设施创建监管区域(返回 area_id)→ 配置事件推送接收 URL → 区域与设施绑定。
  2. 实时值守(B1):区域事件推送(到达 / 离开 / 疑似穿越)驱动总览大屏事件流;每 15 分钟调 GetAreaShip 做区域内船舶快照,与推送事件交叉核对防漏报。
  3. 近程防御(B2):每 5 分钟对重点设施调 GetSurRoundingShip 扫描 10 海里圈层 → 距离分圈 → CPA / TCPA 推算 → 超阈值告警与处置动作。
  4. 行为研判(B3):告警目标自动进入轨迹回放——GetShipTrack 拉轨迹 → 与 PlanRouteByPoint / PlanRouteByPort 基准航线比对偏航 → 区分漂航 / 过境 / 主动逼近 → 必要时核查搭靠记录与港序 → 生成证据报告。
  5. 环境联动(B4):逐小时刷新设施气象与 7 天预报 → 6 小时 / 事件驱动刷新台风 → 每日拉取航行警告 → 潮汐按 30 天缓存 → 作业窗口与防台建议输出到值班计划。
  6. 态势决策(B5):汇总 B1–B4 的事件与处置数据 → 计算辖区态势 KPI → 事件趋势预测与时空热点预测 → 执法效能指标 → 一张大屏给指挥中心。
  7. 风险前置(B6):周期采样 GetAreaShip 与历史轨迹 → 网格化航迹密度与断面流量统计 → 主流航迹走廊提取 → 批量会遇态势计算 → 碰撞风险指数与高风险时段预测。
  8. 运维排程(B7):设施工序阈值 + 气象预报 + 潮汐窗口 + 禁航剔除 + 运维船可达性 → 排程优化 → 7 天甘特;预报更新触发冲突检测与自动重排。
  9. 执法闭环:闯入事件立执法任务 → 轨迹 + 事件 + 快照打包取证 → 处置结果归档 → 月度统计回流 B5。

本场景子文档

监管区域与事件推送(总览大屏)

设施周边安全监控

偏航识别与轨迹回放

气象海况与航行警告

海上安全态势监管大屏与执法效能分析

水域通航密度与碰撞风险预测

设施运维作业窗口智能排程与船舶调度

上一页
6、航次能效与碳强度管理
下一页
1、监管区域与事件推送(总览大屏)