区域（Zones）

区域用于把摄像头画面划分成有业务含义的范围，例如“车道”“门廊”“收银台”。Securex NVR 会根据目标边界框的底部中心点判断目标是否进入区域，因此区域应覆盖目标脚部/车轮实际经过的位置。

工作原理

Zone 本身不会创建新的检测任务；它建立在目标检测之上。目标先被检测和跟踪，然后系统再判断该目标的底部中心点是否位于多边形区域内。只要这个点进入区域，就可以用于 Review、通知、自动化和筛选。

区域名称不要与摄像头名称相同。
多个摄像头可以使用相同的区域名称，用于表达同一个物理区域。
区域坐标通常是归一化坐标，画面左上角为起点；建议使用图形编辑器绘制，而不是手算。
区域可按目标类型限制，只让 person、car 等指定目标参与区域事件。

配置示例

cameras:
  front_yard:
    zones:
      driveway:
        coordinates: 0.10,0.95,0.90,0.95,0.82,0.55,0.20,0.55
        objects:
          - person
          - car

与对象过滤器配合

区域可以和 min_area、max_area、threshold、min_score 等对象过滤条件配合。建议先把全局/摄像头级对象检测调稳定，再增加区域级约束；否则很难判断是“没有检测到目标”还是“目标没有进入区域”。

常见问题

现象	检查方向
目标框已经覆盖区域但没有进入 Zone	检查边界框底部中心点是否真正进入区域，而不是只看矩形是否重叠。
区域事件太多	缩小区域，或为区域限制 objects；再结合通知/Review 条件。
画面换分辨率后区域不准	重新在当前 detect 画面上绘制区域并保存。
同一区域有多台摄像头	可使用相同 Zone 名称，但每台摄像头都要单独绘制坐标。

验证

在实时/调试画面观察目标框、目标标签和 Zone 状态；随后到 Review / Explore 中按区域筛选。如果 UI 已显示目标进入 Zone，但通知没有触发，应继续检查通知或自动化规则，而不是继续修改 Zone。

Zones

Zones give semantic meaning to parts of a camera frame, such as a driveway, porch, entrance, or checkout area. Zone membership is evaluated using the bottom-center point of a tracked object bounding box, so draw the polygon where feet or wheels actually travel.

How zones work

A zone does not run a second detector. Objects are detected and tracked first, then Securex NVR evaluates whether the object anchor point is inside the polygon. Zone presence can then be used by Review, notifications, filters, and automations.

Do not use the same name for a zone and a camera.
The same zone name may be used on multiple cameras when they cover the same physical area.
Use the visual editor whenever possible instead of calculating polygon coordinates manually.
Limit a zone to selected object labels when only people, vehicles, or other classes matter.

Configuration example

cameras:
  front_yard:
    zones:
      driveway:
        coordinates: 0.10,0.95,0.90,0.95,0.82,0.55,0.20,0.55
        objects:
          - person
          - car

Recommended setup

Confirm the detect stream is stable and tracked boxes are accurate.
Draw the polygon around the real travel area.
Use a stable identifier such as driveway or front_door.
Add object restrictions only when needed.
Verify zone entry in the live/debug view before building notifications around it.

Object filters

Zone logic can be combined with object filters such as area and confidence thresholds. Tune detection first, then add zone-level constraints. This keeps troubleshooting clear: first confirm the object exists, then confirm that it entered the zone.

Troubleshooting

Symptom	What to check
Bounding box overlaps the zone but no entry	The bottom-center anchor must be inside the polygon.
Too many zone events	Tighten the polygon or restrict object labels.
Zone is offset after a stream change	Redraw it against the current detect resolution.
Several cameras cover one area	Reuse the logical zone name, but draw coordinates independently per camera.

Verification

Verify the zone indicator in live/debug view, then filter Review or Explore by the zone. If zone membership is correct but a downstream alert is missing, troubleshoot the alert rule instead of the zone geometry.

Zonas

Las zonas dan significado a partes del encuadre, por ejemplo una entrada, un porche o un estacionamiento. La pertenencia se calcula con el punto central inferior del cuadro del objeto, por lo que el polígono debe cubrir el lugar real por donde pasan pies o ruedas.

Cómo funcionan

La zona no ejecuta otro detector. Primero se detecta y sigue el objeto; después Securex NVR comprueba si su punto de anclaje está dentro del polígono. Esa información puede usarse en Review, notificaciones, filtros y automatizaciones.

No use el mismo nombre para una zona y una cámara.
Se puede reutilizar un nombre de zona en varias cámaras que cubren el mismo lugar físico.
Use el editor visual siempre que sea posible.
Limite la zona a etiquetas de objeto concretas cuando sea necesario.

Ejemplo de configuración

cameras:
  front_yard:
    zones:
      driveway:
        coordinates: 0.10,0.95,0.90,0.95,0.82,0.55,0.20,0.55
        objects:
          - person
          - car

Proceso recomendado

Compruebe que el stream de detección y las cajas de seguimiento sean estables.
Dibuje el polígono sobre el área de paso real.
Use un identificador estable como driveway o front_door.
Añada filtros de objetos solo cuando aporten valor.
Verifique la entrada en la vista en vivo/depuración antes de crear alertas.

Filtros de objetos

Las zonas se pueden combinar con filtros de tamaño y confianza. Ajuste primero la detección y después las restricciones de zona para poder localizar fácilmente la causa de un fallo.

Problemas comunes

Síntoma	Qué revisar
La caja toca la zona pero no entra	El punto central inferior debe estar dentro del polígono.
Demasiados eventos	Ajuste el polígono o limite las etiquetas.
Zona desplazada tras cambiar el stream	Vuelva a dibujarla con la resolución de detección actual.
Varias cámaras para un área	Use el mismo nombre lógico, pero coordenadas distintas por cámara.

Verificación

Confirme la zona en la vista de depuración y luego filtre Review/Explore. Si la zona funciona pero una alerta no llega, revise la regla de notificación.