Métodos de Integración
ISS
Guía de integración para enviar eventos LPR desde ISS SecurOS Auto hacia la plataforma SITIA.
ISS
Guía de Integración ISS SecurOS Auto - Eventos LPR
🏢 ISS (Intelligent Security Systems)
ISS (Intelligent Security Systems) es una empresa líder mundial en soluciones de videovigilancia inteligente y análisis de video. Con sede en EE.UU. y presencia global, ISS se especializa en:
| Área | Descripción |
|---|---|
| Video Analytics | Análisis de video en tiempo real con IA |
| LPR/ANPR | Reconocimiento automático de matrículas |
| VMS | Sistema de gestión de video empresarial |
| Integración | APIs abiertas para sistemas de terceros |
📡 SecurOS Auto - Descripción General
SecurOS Auto (anteriormente SecurOS LPR) es la solución de reconocimiento automático de placas vehiculares de ISS. Es un módulo especializado dentro de la plataforma SecurOS.
Características Principales:
| Característica | Descripción |
|---|---|
| Motor OCR Propietario | Algoritmo de reconocimiento optimizado por región |
| Multi-país | Soporte para placas de +100 países (América, Europa, Asia) |
| Alta Precisión | >98% de precisión en condiciones óptimas |
| Velocidad | Hasta 250 km/h de velocidad vehicular |
| Multi-carril | Hasta 4 carriles por cámara |
| Edge & Server | Procesamiento en cámara o servidor central |
| Integración Nativa | REST API, SDK, webhooks, ODBC |
Módulos de SecurOS Auto:
┌─────────────────────────────────────────────────────────────┐
│ SecurOS Auto Suite │
├─────────────────────────────────────────────────────────────┤
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ SecurOS Auto │ │ SecurOS Auto │ │ SecurOS Auto │ │
│ │ Basic │ │ Parking │ │ Access │ │
│ │ (Detección) │ │(Estacionam.) │ │ (Control) │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ SecurOS Auto │ │ SecurOS Auto │ │ SecurOS Auto │ │
│ │ Traffic │ │ Tolling │ │ Analytics │ │
│ │ (Tráfico) │ │ (Peajes) │ │(Estadísticas)│ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────────┘🔧 Arquitectura de Integración
┌─────────────────────────────────────────────────────────────────────────┐
│ CAPA DE CAPTURA │
├─────────────────────────────────────────────────────────────────────────┤
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 📷 Cámara IP │ │ 📷 Cámara IP │ │ 📷 Cámara IP │ │
│ │ Axis │ │ Hikvision │ │ Hanwha │ │
│ │ (ONVIF) │ │ (ONVIF) │ │ (ONVIF) │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ └──────────────────┼──────────────────┘ │
│ │ RTSP / ONVIF │
│ ▼ │
└────────────────────────────┼────────────────────────────────────────────┘
│
┌────────────────────────────┼────────────────────────────────────────────┐
│ CAPA DE PROCESAMIENTO │
├────────────────────────────┼────────────────────────────────────────────┤
│ ▼ │
│ ┌─────────────────────────┐ │
│ │ 🖥️ SecurOS Server │ │
│ │ ┌─────────────────┐ │ │
│ │ │ SecurOS Auto │ │ │
│ │ │ Recognition │ │ │
│ │ │ Engine │ │ │
│ │ └─────────────────┘ │ │
│ │ ┌─────────────────┐ │ │
│ │ │ Event Manager │ │ │
│ │ └─────────────────┘ │ │
│ │ ┌─────────────────┐ │ │
│ │ │ REST API │ │ │
│ │ │ Puerto: 8080 │ │ │
│ │ └─────────────────┘ │ │
│ └───────────┬─────────────┘ │
│ │ │
└──────────────────────────┼──────────────────────────────────────────────┘
│
│ HTTP/HTTPS Webhook
│ REST API Callback
▼
┌─────────────────────────────────────────────────────────────────────────┐
│ SISTEMA EXTERNO / SITIA │
├─────────────────────────────────────────────────────────────────────────┤
│ ┌─────────────────────────┐ │
│ │ 🔌 Endpoint Receptor │ │
│ │ POST /api/lpr/iss │ │
│ └───────────┬─────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────┐ │
│ │ 🗄️ Base de Datos │ │
│ │ PostgreSQL/ClickHouse │ │
│ └─────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘Métodos de Integración Disponibles:
| Método | Descripción | Uso Recomendado |
|---|---|---|
| REST API | Consultas HTTP síncronas | Consultar eventos históricos |
| Webhooks | Push HTTP en tiempo real | Recibir eventos inmediatos |
| SDK C++/C# | Librería nativa | Integración profunda |
| ODBC | Conexión directa a BD | Reporting, BI |
| SecurOS Script | Scripting interno | Automatización en servidor |
Documentación de Referencia
Recursos Oficiales ISS:
| Documento | Descripción |
|---|---|
| SecurOS Auto Integration Guide | Guía completa de integración |
| REST API Reference | Especificación de endpoints |
| SDK Developer Manual | Desarrollo con SDK nativo |
| Installation Guide | Instalación y configuración |
| SecurOS Scripting Guide | Automatización con scripts |
Limitaciones
| Limitación | Descripción |
|---|---|
| Sistema Operativo | Solo Windows (no Linux nativo) |
| GPU | Solo NVIDIA CUDA (no AMD/Intel) |
| Latencia | 50-200ms procesamiento por frame |
| Concurrencia API | 100 requests/segundo por defecto |
| Retención Local | Limitada por espacio en disco |
| Caracteres Especiales | Algunas placas diplomáticas/especiales |
| Condiciones Nocturnas | Requiere iluminación IR adecuada |
| Placas Dañadas | Precisión reducida en placas sucias/dañadas |
| Ángulo Máximo | 30° horizontal, 25° vertical |
| Distancia Mínima | 3 metros para resolución óptima |
| Webhooks Retry | 3 intentos con backoff exponencial |
Configuración del Punto de Conexión HTTPS
Configurar los Parámetros del Endpoint
La empresa integradora, debe configurar el siguiente endpoint de envío de las lecturas:
- URL: https://sandboxsapp.carabineros.cl/api/integration-test/events/vehicle-detected
- Token Bearer: Proporcionado por SITIA.
Ejemplos de Datos
{
"patente": "PATO32",
"fecha_evento": "19-01-2026 17:41:31.747",
"camera": {
"id": "Identificador de lectura",
"nombre": "Nombre del Dispositivo",
"coordenadas": null
},
"imagen_base64": "Imagen de contexto"
}