Zona Relativa

Un objeto de tipo relative_zone define una zona geométrica virtual dentro del espacio de coordenadas de un sistema de rastreo relativo. Su forma está determinada por un polígono cuyos vértices se expresan en coordenadas locales (X, Y) del mismo sistema de referencia que utilizan los objetos relative_tracker.

A diferencia de otros objetos, la zona relativa es estática y pasiva: no tiene estados ni acciones propias. Su propósito es servir como región de interés que las automatizaciones y los motores de análisis pueden consultar para determinar si un relative_tracker se encuentra dentro o fuera de ella.

Características principales

• Geometría poligonal: La zona se define mediante una lista ordenada de vértices (X, Y) que forman un polígono cerrado.
• Coordenadas relativas: Usa el mismo sistema de coordenadas locales que los relative_tracker, sin depender de GPS ni coordenadas globales.
• Sin estados ni acciones: La zona no cambia por sí sola; otras partes del sistema la referencian para tomar decisiones.
• Integración con rastreo: Permite definir regiones de presencia, zonas restringidas o áreas de análisis dentro de un espacio delimitado (planta industrial, almacén, campo deportivo).

Casos de uso comunes

• Delimitar una zona de seguridad en una planta industrial y alertar si un vehículo autónomo la abandona.
• Definir áreas de trabajo en un almacén para analizar la distribución de operarios.
• Crear regiones de interés en canchas deportivas para el análisis táctico de jugadores.
• Establecer perímetros virtuales en entornos cerrados donde el GPS no está disponible.

Propiedades de estado

Propiedad	Descripción
shape	Polígono de la zona en formato JSON. Contiene un array de vértices, cada uno con campos x e y.
state	Siempre active al inicializarse. Indica que la zona está registrada y disponible en la plataforma.

Ejemplo de shape

{
  "vertices": [
    { "x": 0.0, "y": 0.0 },
    { "x": 5.0, "y": 0.0 },
    { "x": 5.0, "y": 4.0 },
    { "x": 0.0, "y": 4.0 }
  ]
}

Nota: Los vértices deben definirse en orden (horario o antihorario) para que el polígono sea válido. Las unidades son metros en el sistema de coordenadas del espacio relativo.