Guía de integración para enviar eventos LPR/ANPR desde Genetec Security Center (AutoVu) hacia la plataforma SITIA.

Genetec Security Center

Descripción General

Genetec Security Center es una plataforma integral de seguridad que consolida videovigilancia, control de acceso, comunicaciones y análisis avanzados en una única interfaz; su módulo AutoVu añade capacidades de reconocimiento automático de placas vehiculares (ALPR), tanto con cámaras móviles (SharpZ3) como fijas (SharpV), para identificar vehículos buscados o no autorizados, controlar estacionamientos mediante el módulo Free-Flow, e integrar estos datos con otros sistemas para optimizar seguridad, cumplimiento y operación con alta precisión y eficiencia.

🏗️ Arquitectura de Integración

Requisitos

Versiones compatibles: Genetec Security Center 5.10 o superior.
Licencia: No se requiere una licencia adicional. La integración puede operar con la funcionalidad de exportación XML incluida por defecto en Genetec Security Center, o con JSON si se cuenta con la licencia correspondiente.
Conectividad: Conectividad de red desde el servidor de Genetec ALPR Manager hacia el endpoint de SITIA.
Formato de fecha: Debe configurarse como dd/MM/yyyy para compatibilidad con SITIA.

Configuración Obligatoria de Fechas

La plataforma SITIA requiere que las fechas se envíen en formato dd/MM/yyyy. Esta configuración es obligatoria para el correcto procesamiento de los eventos.

Documentación de Referencia

Esta guía se basa en la documentación oficial de Genetec:

Documento: Genetec Security Center Administrator Guide 5.10 o superior
Sección: 46. Exportador de datos de terceros de AutoVu

Acerca de AutoVu Third-party Data Exporter

El Exportador de Datos de Terceros de AutoVu™ es una función que usa un protocolo de conexión HTTPS o SFTP para exportar de forma segura eventos de reconocimiento automático de placas vehiculares (ALPR), por ejemplo, lecturas y aciertos, a extremos externos. El exportador de datos admite varios formatos de archivo, como XML, JSON y otros, para exportar los datos.

Opciones de Licencia

Cuando una función del ALPR Manager tiene que enviar datos a un punto final, necesita establecer una conexión. Cada conexión requiere una licencia. El tipo de licencia depende de la cantidad de conexiones necesarias para cada ALPR Manager y de los formatos de datos admitidos.

Opción de licencia	Formato de datos compatible	Conexiones admitidas
Ninguno	XML	1
`AU-PI-T2MEAEXPORT`	JSON2, XML	1
`AU-PI-3RDPARTYEXPORTER-1X`	JSON, JSON2, JSONLAP, UTMC, XML	1
`GSC-AV-PI-3RDPARTYEXPORTER-1X`	JSON, JSON2, JSONLAP, UTMC, XML	1
`AU-PI-3RDPARTYEXPORTER-3X`	JSON, JSON2, JSONLAP, UTMC, XML	3
`GSC-AV-PI-3RDPARTYEXPORTER-3X`	JSON, JSON2, JSONLAP, UTMC, XML	3

Nota Importante sobre Licenciamiento

La plataforma SITIA es compatible con los formatos XML y JSON. Dado que Genetec Security Center incluye la capacidad de exportar en formato XML sin costo adicional (opción "Ninguno"), no es estrictamente necesario adquirir una licencia adicional para la integración. Si se desea enviar eventos en formato JSON, se deberá contar con una de las licencias pagadas.

Limitaciones

Se aplican las siguientes limitaciones importantes:

La función se exporta a una velocidad de 20 eventos por segundo con una conexión HTTPS. Si el total de eventos por segundo excede esta tasa, se recomienda configurar el Protocolo de cola para Alto volumen (requiere RabbitMQ).
Si una unidad Patroller tiene más de 2000 eventos para descargar, se recomienda utilizar una conexión HTTPS o configurar el modo de Alto volumen.
El número máximo de puntos finales por función de ALPR es nueve.
La función no exporta eventos relacionados con AutoVu™ Free-Flow.

Configuración del Punto de Conexión HTTPS

Siga estos pasos para configurar la exportación de eventos de lectura de patentes hacia SITIA.

Configuración del Exportador de Datos en Genetec

Habilitar el Exportador de Datos

Desde la página de inicio de Config Tool, vaya a Sistema > Funciones.
Seleccione el ALPR Manager que desea configurar.
En la pestaña de Propiedades, habilite la opción de Exportador de datos.

Configurar el Protocolo de Envío

Seleccione el Protocolo de envío a cola en el menú desplegable.
- Estándar: Modo predeterminado, adecuado para la mayoría de los casos.
- Alto volumen: Seleccione este modo si necesita exportar un gran volumen de eventos (requiere RabbitMQ).
Haga clic en el botón + para agregar un nuevo punto final.

Configurar los Parámetros del Endpoint

En la sección de Parámetros, configure lo siguiente:

Nombre del punto final: SITIA-Carabineros
URL del servidor: https://sandboxsapp.carabineros.cl/api/integration-test/events/vehicle-detected
Formato de exportación: Seleccione JSON (recomendado, si posee la licencia) o XML (incluido por defecto, no requiere licencia adicional).

URL del Servidor

La URL proporcionada corresponde al ambiente de Sandbox. Para producción, recibirá una URL diferente.

Configurar los Datos a Exportar

En la sección de Archivo con formato específico, configure:

Qué exportar: Seleccione Reads.
Exportar imágenes: Opcional. Puede seleccionar esta opción para incluir imágenes de la lectura. (Recomendado)
Formato de fecha: Seleccione dd/MM/yyyy para compatibilidad con SITIA.

Formato de Fecha Requerido

Es obligatorio configurar el formato de fecha como dd/MM/yyyy para garantizar la correcta interpretación de las fechas por parte de la plataforma SITIA.

Configurar la Autorización

En la sección de Autorización, configure los siguientes ajustes:

Modo de autorización: Client Credentials
URL del token: https://sandboxsapp.carabineros.cl/api/login
Identificación del cliente (ClientId): El valor proporcionado por SITIA.
Secreto del cliente (ClientSecret): El valor proporcionado por SITIA.
Alcance (Scope): *

Configuración de Autorización OAuth2

Aplicar Cambios

Haga clic en Aplicar para guardar la configuración. El sistema comenzará a exportar los eventos de lectura de patentes al endpoint de SITIA.

Ejemplos de Datos

A continuación se muestran ejemplos de los formatos de datos que Genetec puede exportar.

{
  "Read": {
    "Address": "1234 1st Avenue, City Name, X1Y",
    "Attributes": {
      "State Name": "QC",
      "Vehicle Type": "-",
      "Relative Motion": "Approaching",
      "Context": "Quebec",
      "Characters Height": "26",
      "Confidence Score": "97",
      "Vehicle Make": "Skoda",
      "Speed": "70 km/h"
    },
    "CameraName": "LprCamera",
    "ContextImage": "",
    "DateLocal": "10/01/2022",
    "DateUtc": "10/01/2022",
    "InventoryLocation": "",
    "IsHit": "Yes",
    "Latitude": "0",
    "LatitudeDegree": "0",
    "LatitudeDMS": "N0",
    "LatitudeMinute": "0",
    "LatitudeSecond": "0",
    "Longitude": "0",
    "LongitudeDegree": "0",
    "LongitudeDMS": "W0",
    "LongitudeMinute": "45",
    "LongitudeSecond": "47",
    "OverviewImage": "",
    "ParkingLot": "",
    "PatrollerId": "6446e421b257",
    "PatrollerName": "DefaultPatroller",
    "PermitName": "AV50",
    "Plate": "******",
    "PlateImage": "",
    "SharpName": "AV1",
    "State": "State Name",
    "TimeLocal": "05:52:21",
    "TimeUtc": "09:52:21",
    "UserId": "5845088e1036",
    "UserName": "PatrollerDefault",
    "VehicleID": "c4d439602832"
  }
}

<?xml version="1.0" encoding="utf-8"?>
<Read xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Address />
  <attributes>
      <Attributes>
          <Attribute name="State Name">-</Attribute>
          <Attribute name="Relative Motion">Approaching</Attribute>
          <Attribute name="Context">Chile</Attribute>
          <Attribute name="Characters Height">17</Attribute>
          <Attribute name="Plate Tilt">2</Attribute>
          <Attribute name="Sensor Id">Lpr1</Attribute>
          <Attribute name="Vehicle Type">Passenger Vehicle</Attribute>
          <Attribute name="Vehicle Type Confidence Score">98</Attribute>
          <Attribute name="Vehicle Type.v2">Car or Pickup</Attribute>
          <Attribute name="Vehicle Make"></Attribute>
          <Attribute name="Vehicle Make Confidence Score"></Attribute>
          <Attribute name="Vehicle Color"></Attribute>
          <Attribute name="Vehicle Color Confidence Score"></Attribute>
          <Attribute name="Vehicle Hitch">-</Attribute>
          <Attribute name="Vehicle Spare Tire"></Attribute>
          <Attribute name="Vehicle Rear Attachment"></Attribute>
          <Attribute name="Vehicle Orientation"></Attribute>
          <Attribute name="Vehicle Model"></Attribute>
          <Attribute name="Vehicle Model Confidence Score">85</Attribute>
          <Attribute name="Vehicle Corners In Context Image">(0.15096594,0.2658453),(0.37802178,0.2658453),(0.37802178,0.66794264),(0.15096594,0.66794264)</Attribute>
          <Attribute name="Plate Corners in Context Image">(0.17144021,0.5584196),(0.21586171,0.5559459),(0.2171415,0.57974774),(0.17270422,0.5823889)</Attribute>
          <Attribute name="Plate Corners in LPR Image">(0.1169172,0.5508944),(0.16594586,0.5481641),(0.1673584,0.5744346),(0.118312284,0.5773496)</Attribute>
          <Attribute name="Confidence Score">95</Attribute>
          <Attribute name="Lpr Exposure">( 30)  0.5984 ms  16.0 dB Iris:100.0%  Flash:100%</Attribute>
          <Attribute name="Context Exposure">(154)  0.5304 ms   5.3 dB Iris: 31.9%  Flash:  0% ec:(0.536, 0.705, 0.464) Scene:20323.1</Attribute>
          <Attribute name="Input A">Low</Attribute>
          <Attribute name="Input B">Low</Attribute>
          <Attribute name="Lpr Exposure Extra Info">Ig=199.2, Ip= 83.0, If=153.0</Attribute>
      </Attributes>
  </attributes>
  <CameraName>1234 1st Avenue, City Name, X1Y</CameraName>
  <ConfidenceScore>95</ConfidenceScore>
  <ContextImage />
  <Date>13/01/2025</Date>
  <DateLocal>13/01/2025</DateLocal>
  <DateUtc>13/01/2025</DateUtc>
  <InventoryLocation />
  <IsHit>No</IsHit>
  <Latitude>0</Latitude>
  <LatitudeDegree>0</LatitudeDegree>
  <LatitudeDMS>N0 0 0</LatitudeDMS>
  <LatitudeMinute>0</LatitudeMinute>
  <LatitudeSecond>0</LatitudeSecond>
  <Longitude>0</Longitude>
  <LongitudeDegree>0</LongitudeDegree>
  <LongitudeDMS>E0 0 0</LongitudeDMS>
  <LongitudeMinute>0</LongitudeMinute>
  <LongitudeSecond>0</LongitudeSecond>
  <OverviewImage />
  <ParkingLot />
  <PatrollerId>00000000-0000-0000-0000-000000000000</PatrollerId>
  <PatrollerName />
  <PermitName />
  <Plate>*********</Plate>
  <PlateImage />
  <SharpName>AV1</SharpName>
  <State>-</State>
  <Time>14:25:30</Time>
  <TimeLocal>14:25:30</TimeLocal>
  <TimeUtc>17:25:30</TimeUtc>
  <UserId>00000000-0000-0000-0000-000000000000</UserId>
  <UserName />
  <VehicleID>876f20b5-0ae8-46ff-8b35-3584ba372ab9</VehicleID>
</Read>

Genetec

En esta página