1、监管区域与事件推送（总览大屏）

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

一、场景说明

业务视角：油田平台群、风电场、LNG 接收站、大桥通航孔、海洋牧场等海上设施分布在数百公里海岸线上，物理围栏不存在，值班力量有限。过去靠雷达扫描、望远镜瞭望和电话核实，一个大屏看不全几十个设施，发现闯入往往滞后数小时。

本子场景把船讯网区域监控 API作为核心：每个设施的安全范围建模为一个多边形电子围栏，船舶进入（到达）、离开、疑似穿越时，船讯网实时推送事件到平台。左屏各监管区域的状态卡，右屏 24 小时事件流与执法任务看板，中央海图呈现全部区域与船舶分布。事件自动找人 → 自动派发 → 自动取证，全程无需人工盯防。

客户视角：海事监管机构值班中心、设施运营方中控室、海警 / 综合执法支队。

二、实现流程

步骤	阶段	使用接口	关键计算 / 业务逻辑
1.1 区域建档	① 数据获取	AddArea	设施坐标 → 多边形顶点 → `area_id`
1.2 区域维护	① 数据获取	9.2.2–9.2.4	更新 / 查询 / 删除
1.3 推送配置	① 数据获取	控制台	推送 URL 绑定
1.4 事件接收	① 数据获取	9.2.5	event_type 1=到达 / 2=离开 / 3=疑似穿越
1.5 快照对账	① 数据获取	GetAreaShip	每 15 分钟拉区域内船舶清单
1.6 船舶详情	① 数据获取	GetManyShip	事件船舶批量补充实时动态
2.1 区域状态聚合	② 计算处理	—	区域内船舶数、今日事件数、未处置数
2.2 白名单比对	② 计算处理	—	MMSI 与内部白名单（施工 / 运维 / 报备船）比对
2.3 漏报核查	② 计算处理	—	快照有船但 1h 无推送 → 漏报日志
3.1 告警分级	③ 业务判断	—	高（高风险区 + 未命中白名单）/ 中 / 低
3.2 派发路由	③ 业务判断	—	按区域 → 值班组 / VTS / 海事处
4.1 看板呈现	④ 输出应用	海图 GIS	区域状态卡 + 事件流 + 全辖区海图
4.2 任务联动	④ 输出应用	—	自动创建执法任务（船舶 + 区域 + 时间）
4.3 月度统计	④ 输出应用	—	事件数 / 处置率 / 平均响应时长（回流 B5）

三、接口调用与响应

3.1 AddArea 创建监管区域

{"code": 0, "data": {"area_id": "AREA_2026_P7", "create_time": 1726000000}}

参数要点：area_polygon 格式为 lng,lat-lng,lat-...（先经度后纬度）；顶点顺序需一致且不应自相交；area_level 为业务侧分级字段（接口本身不区分），用于前端染色与告警分级。

3.2 区域事件推送（9.2.5）

{"msg_type": "area_event",
 "items": [{"area_id": "AREA_2026_P7", "area_name": "渤海油田 P7 平台警戒区",
            "mmsi": 412500123, "ship_name_cn": "鲁日渔 1268", "ship_type_cn": "渔船",
            "event_type": 1, "event_type_cn": "到达",
            "event_time": 1726000800, "lat": 38.65, "lng": 120.15}]}

event_type	中文	含义
1	到达	船进入区域
2	离开	船完全离开区域
3	疑似穿越	短暂进入并快速离开（< 5 分钟）

接入要点：推送需做幂等（同一事件可能重复推送）；推送通道故障时降级为 15 分钟轮询 GetAreaShip；区域创建后必须在控制台绑定推送 URL（高级服务，需商务开通）。

3.3 GetAreaShip 区域船舶快照

{"code": 0, "data": {"ships": [{"mmsi": 412500123, "ship_name_cn": "鲁日渔 1268",
   "ship_type_cn": "渔船", "dwt": 480, "lat": 38.65, "lng": 120.15,
   "sog": 6.2, "cog": 295, "last_time": 1726000700}],
   "scode": "", "continue": 0}}

参数要点：region 格式必须与 AddArea 一致；data_type 可选 json（单次约 2600 条）或 binary（约 8000 条，需专用解析）；output 可选 base（基础字段）或 full（含船东船型）；scode 非空时需携带续查，continue=0 表示查完；单次建议 ≤ 1°×1°，且需购买对应区域权限。

3.4 GetManyShip 事件船舶批量补充

mmsis 逗号分隔，上限 100 条。

四、计算逻辑

4.1 区域状态聚合

中文说明：把「区域快照的当前船舶数」与「今日推送事件分类计数」合并成一个区域状态对象；当前有船即为监控中状态，今日有到达事件即累计到达数，有疑似穿越即单独计数（穿越往往是快速闯入，需要重点看）。

4.2 白名单比对与告警分级

中文说明：先看船舶 MMSI 是否命中内部白名单（施工船、运维船、已报备船），命中即为正常作业不告警；未命中则按区域等级分级——一级区域（油田 / LNG 等高风险）判红并立即派发执法，二级区域判黄需人工核实，三级区域仅记录。

4.3 推送与快照交叉核对（防漏报）

中文说明：推送可能丢、快照可能滞后，两者必须交叉验证。每 15 分钟做一次对账：快照里有船但近 1 小时没有对应推送 → 判定为漏报，写告警日志并触发人工复核；推送有到达但快照里没有 → 说明船已离开，属正常，不做处理。这个对账逻辑是整个监管系统可信度的基础，不能省。

4.4 执法任务联动

中文说明：红色级闯入事件自动生成执法任务，任务号由「MMSI + 事件时间」构成保证唯一，责任人按区域映射到值班组，优先级由事件类型决定；任务写入内部执法系统后回写 event_id，形成「事件 → 任务 → 处置 → 归档」的闭环链条，供 B5 统计执法效能时消费。

五、输出的应用形态

监管区域总览大屏：中央海图呈现全部监管区域（高风险区红虚线、常规区蓝实线）与闯入船舶红点高亮；左屏各区域状态卡；右屏 24 小时事件流与执法任务看板。

单事件详情：上部事件概要，中部处置时间轴（触发 → 推送 → 核实 → 派发 → 处置 → 闭环），下部取证信息（轨迹回放、周边船舶核验、白名单比对结果）。

六、数据边界与常见问题

数据边界：区域定义、进出事件、区域内船舶动态来自船讯网；设施台账（坐标 / 等级 / 白名单）、执法流程、值班通讯录来自内部系统；以 area_id ↔ 设施台账 ID 关联。

Q1：区域多边形顶点怎么写？ lng,lat-lng,lat-...，先经度后纬度；顶点顺序必须一致；自相交会创建失败。

Q2：GetAreaShip 必须用 AddArea 创建的区域吗？ 不必须，任意合法多边形都可查（需有对应区域权限），但建议保持一致便于对账。

Q3：能否只用轮询不用推送？ 可以，但响应从秒级降到分钟级且更耗配额，仅建议作为降级方案。

1、监管区域与事件推送（总览大屏）

一、场景说明#

二、实现流程#

三、接口调用与响应#

3.1 AddArea 创建监管区域#

3.2 区域事件推送（9.2.5）#

3.3 GetAreaShip 区域船舶快照#

3.4 GetManyShip 事件船舶批量补充#

四、计算逻辑#

4.1 区域状态聚合#

4.2 白名单比对与告警分级#

4.3 推送与快照交叉核对（防漏报）#

4.4 执法任务联动#

五、输出的应用形态#

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