3、偏航识别与轨迹回放

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

一、场景说明

业务视角：圈层告警只说明「船离设施近」，还不能回答「它为什么在这」。值班员过去要凭经验研判（是正常过境、避让渔区、还是蓄意闯入），常常判断错误导致误报或漏报。

本子场景提供研判工具：拉取目标船分钟级历史轨迹，与规划航线（点到点 / 港到港生成）比对计算偏航距离与偏航时段；结合航速变化区分漂航（设备故障）、绕航（避让渔区）、主动逼近（蓄意闯入）；以时间轴回放还原全过程，关键节点（转向、加速、进圈）自动标注；近 7 天与设施的距离趋势辅助判断屡犯；回放结论一键生成证据报告，支撑执法与追责。

客户视角：监管执法支队研判岗、设施运营方安全部、法务 / 合规。

二、实现流程

步骤	阶段	使用接口	关键计算 / 业务逻辑
1.1 轨迹拉取	① 数据获取	GetShipTrack	分钟级点位拉取
1.2 基准航线	① 数据获取	PlanRouteByPoint / PlanRouteByPort	起点 + 终点 → `route` 折线
1.3 当前状态	① 数据获取	GetShipStatus	上一港 / 当前港
1.4 港序链条	① 数据获取	GetPortofCallByShip	完整挂靠记录
1.5 船籍	① 数据获取	GetShipRegistry	船籍国 / 地区
2.1 轨迹清洗	② 计算处理	—	剔除漂点 + 合并重复
2.2 偏航计算	② 计算处理	—	点到航线折线最近距离
2.3 意图识别	② 计算处理	—	漂航 / 绕航 / 主动逼近三分支
2.4 空间相交	② 计算处理	—	偏航段与警戒圈的线-圆相交
2.5 屡犯趋势	② 计算处理	—	近 7 天每日与设施最小距离
3.1 责任认定	③ 业务判断	—	船长 / 船东 / 不可抗力
3.2 处置建议	③ 业务判断	—	驱离 / 立案 / 警示
4.1 时间轴回放	④ 输出应用	海图 GIS	进度条 + 关键节点标注
4.2 证据报告	④ 输出应用	—	一键生成 PDF / 云文档

三、接口调用与响应

3.1 GetShipTrack 历史轨迹（核心）

{"code": 0, "data": [{"utc": 1725903600, "lat": 38.65, "lng": 120.15, "sog": 12.0, "cog": 90, "data_source": "AIS"}]}

跨度默认 ≤ 1 个月，更久需商务开通；data_source 区分 AIS 与 PRED，取证场景必须只使用 AIS 点。

3.2 PlanRouteByPoint 基准航线

{"code": 0, "data": {"distance": 87.3, "duration_days": 0.3,
 "route": [{"lng": 120.15, "lat": 38.65}, {"lng": 121.50, "lat": 38.20}]}}

参数：start_point / end_point 为 lng,lat；end_port_code 可替代 end_point；through 为途经点；avoid 为绕行设置。

3.3 GetShipStatus 当前挂靠

{"code": 0, "data": {"mmsi": 412500123, "current_sea_area": "渤海", "previousport_code": "CNRZH",
 "previousport_cnname": "日照港", "currentport_code": "", "is_at_port": false}}

用途：佐证目标声称的作业意图（声称去某港但当前无挂靠，说明声称可疑）。

3.4 GetPortofCallByShip 港序链条

返回每次挂靠的 ata / atb / atd、到离港吃水、stay_time、泊位信息，用于验证「声称去某港作业」是否属实。

3.5 GetShipRegistry 船籍

{"code": 0, "data": {"mmsi": 412500123, "registry": "中国", "registry_port": "青岛"}}

四、计算逻辑

4.1 轨迹预处理

中文说明：按时间升序排序，剔除时间倒序或重复的点；用相邻点的大圆距离除以时间差推算航速，超过 60 节的视为 AIS 漂点剔除。清洗后的轨迹才用于偏航计算，否则一个漂点就能制造一段假偏航。

4.2 偏航段检测

中文说明：逐个轨迹点计算它到规划航线折线的最短距离（先把经纬度换算成海里平面坐标）；距离超过阈值即开始累计连续点数，连续点数达到下限才算一段有效偏航（避免单个噪声点造成误报）；偏航结束时记录起止时间、持续时长与段内最大偏距。

阈值建议：监管航道 0.5 海里，远海商船可放宽到 1–2 海里。

4.3 意图识别（三分支）

中文说明：取偏航段内航速的起止差与平均航向，计算「船到设施的方位角」与「平均航向」的夹角。航速没有明显上升且航向与设施方向偏离大于 60° → 漂航（设备或推进故障，中风险）；航速上升超过 1.5 节且航向指向设施（夹角 < 30°）→ 主动逼近（高风险）；航速基本不变 → 绕航（避让渔区，低风险）；其余为待人工研判。

业务示例：鲁日渔 1268 在偏航段内航速 5.2 → 8.2 节、航向由 295° 转向平台方向 → 判定主动逼近。

4.4 与设施警戒圈的空间相交

中文说明：判断偏航段折线是否穿过设施警戒圈。逐线段检查：两端点任一在圈内即相交；否则再检查线段中点到圆心距离是否在圈内（对短线段足够精确，正式实现可改用点到线段最短距离）。相交则记录进圈时刻与离开时刻，得到滞留时长，联动 B2 的最高级响应与执法流程。

4.5 屡犯趋势与港序佐证

中文说明：对过去 7 天逐日拉轨迹，计算每日与设施的最小距离，得到距离趋势序列——距离逐日变小说明是「屡犯且越来越近」，这是责任认定的重要依据。港序佐证则是把船舶声称的去向港与 GetPortofCallByShip 的实际挂靠记录比对，不符即为陈述不实。

4.6 责任认定

中文说明：主动逼近且历史有同类违规 → 船东主责（管理失职）；主动逼近但首次 → 船长主责（本次蓄意）；漂航 → 船长主责（设备故障未及时处理）；绕航避让 → 不可抗力（属正常航行）；其余待人工研判。责任认定结论写入证据报告，作为执法依据。

五、输出的应用形态

轨迹对比回放：中央海图叠加规划航道（蓝虚线）、正常航迹段（橙实线）、偏航段（红虚线 + 转向 / 加速 / 进圈三个关键节点标注）；左屏船舶选择、偏航分析结论卡、指标表与回放进度条；右屏轨迹关键节点表与近 7 天船-设施距离趋势。

偏航分析报告：上部事件概要与责任认定，中部分段轨迹与关键节点，下部法规依据与处置建议，一键导出 PDF。

六、数据边界与常见问题

数据边界：轨迹、航线、挂靠、船籍来自船讯网；设施警戒圈定义、航道配置、执法模板、处罚依据、历史违规记录来自内部系统。

Q1：GetShipTrack 跨度限制？ 默认 1 个月，更久需商务开通历史归档（通常 1 年）。

Q2：偏航阈值如何配置？ 监管航道建议 0.5 海里，远海商船 1–2 海里，由业务侧按设施类型配置。

Q3：证据报告必须包含什么？ 原始轨迹 JSON（含 data_source 标注）、关键节点截图、法规依据条款、责任认定意见、处置人签字。

3、偏航识别与轨迹回放

一、场景说明#

二、实现流程#

三、接口调用与响应#

3.1 GetShipTrack 历史轨迹（核心）#

3.2 PlanRouteByPoint 基准航线#

3.3 GetShipStatus 当前挂靠#

3.4 GetPortofCallByShip 港序链条#

3.5 GetShipRegistry 船籍#

四、计算逻辑#

4.1 轨迹预处理#

4.2 偏航段检测#

4.3 意图识别（三分支）#

4.4 与设施警戒圈的空间相交#

4.5 屡犯趋势与港序佐证#

4.6 责任认定#

五、输出的应用形态#

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