Documentación
Guía de uso, funcionalidades, fuentes de datos, arquitectura y licencias de código abierto de Vigía.
Resumen
Vigía es una plataforma de código abierto para la evaluación y gestión de riesgos, con cobertura nacional y el mayor nivel de detalle en sus tres municipios de estudio original en el Valle del Cauca, Colombia: Sevilla, Caicedonia y Zarzal. Cruza amenazas naturales de deslizamiento, inundación e incendio forestal con la población y la infraestructura crítica expuestas, combinando índices de amenaza estáticos con pronósticos y monitoreo en vivo de fuentes abiertas. Fuera de esos tres municipios, algunas capas (deslizamientos, inundaciones, precipitación, clima) siguen respondiendo con datos reales, pero de menor resolución y a partir de fuentes distintas, señaladas explícitamente — ver Fuentes de datos y Metodología.
La aplicación no mantiene una base de datos propia: cada vista es una capa de agregación en tiempo real sobre servicios geoespaciales públicos (ArcGIS, WMS, WMTS, APIs REST) — descrito en detalle en Arquitectura y Fuentes de datos.
Índices de amenaza y créditos
Los índices de susceptibilidad a deslizamientos e incendios forestales que sostienen esta plataforma fueron desarrollados por RED LabOT, la Red de Laboratorios de Observación de la Tierra de las Américas.
NASA Lifelines
Vigía forma parte de la comunidad de NASA Lifelines, una iniciativa de la División de Ciencias de la Tierra de la NASA y la firma DevGlobal que impulsa el uso de datos satelitales para fortalecer la acción humanitaria.
Guía de uso
Cuatro pasos para pasar de abrir Vigía a entender el riesgo de tu vereda, con una captura de pantalla real de cada uno. Cada paso trae además una nota técnica más corta, por si quieres saber exactamente de dónde sale cada número.
Cuando abres Vigía, ya estás viendo un mapa — por defecto, el de Sevilla. En la barra lateral, el selector de "Ubicación" (Departamento y Ciudad/Municipio) cambia el mapa a cualquiera de los 1.122 municipios de Colombia. A la derecha hay seis franjas verticales con un ícono cada una: Deslizamientos, Inundaciones, Incendios, Precipitación, Clima y Sismología (más Riesgo compuesto, que junta las cinco amenazas). Clima es un reporte del tiempo, no una amenaza. Toca cualquier franja y el mapa completo cambia a esa vista — no se abre una página nueva, todo pasa en la misma pantalla.
Cada amenaza carga su propio mapa Leaflet con capas independientes que se activan y desactivan con las casillas de la esquina superior izquierda (por ejemplo, "Humedad del suelo (SMAP)" o "Fallas geológicas (SGC)"). La leyenda de colores está siempre en la esquina inferior — de verde (muy bajo) a rojo (muy alto). Sevilla, Caicedonia y Zarzal siguen teniendo el mayor nivel de detalle (índices de campo de RED LabOT); cualquier otro municipio recibe los mismos modelos propios calculados en vivo, con las estimaciones señaladas donde aplican.
En la barra lateral del panel principal, la tarjeta de población te muestra cuánta gente vive en el municipio seleccionado, separada por año y por si vive en el pueblo o en el campo. Cambia el municipio con el selector de ubicación —por ejemplo, a Santiago de Cali— y las cifras se actualizan solas, para cualquiera de los 1.122 municipios del país.
Los números vienen de las proyecciones poblacionales del DANE (2020–2035, actualización post-COVID del CNPV 2018), extraídas una sola vez para los 1.122 municipios y versionadas como JSON estático — sin llamada de red por consulta. El desglose urbano/rural existe a nivel nacional; los modelos de amenaza por vereda mostrados debajo se calculan para el municipio seleccionado en cada momento.
El botón celeste "Conoce tu nivel de exposición", en la esquina superior izquierda del panel principal, es la forma más rápida de saber qué tan expuesto estás tú. Elige primero tu municipio y después tu vereda (o "Casco Urbano" si vives en el pueblo). El mapa se acerca a tu zona y muestra las cuatro amenazas juntas, ya activadas.
Cada casilla de la leyenda (Deslizamientos, Inundaciones, Incendios, Precipitación) se puede apagar por separado para comparar una amenaza a la vez sobre la misma zona. El selector de subdivisión se llama "Vereda" en municipios genuinamente rurales, o "Zona" en ciudades grandes (más de 100.000 habitantes, el umbral de categoría de Ley 617 de 2000) — misma capa de límites de Esri Colombia en ambos casos, solo cambia el término mostrado porque en una ciudad grande esas subdivisiones no son uniformemente rurales. El botón "Exportar como PDF" — visible en la esquina superior derecha de esta ventana — captura el mapa exactamente como lo estás viendo y genera un PDF descargable para guardar o imprimir.
Dentro del mapa de "Riesgo compuesto", toca cualquier vereda coloreada. Se abre una ventana con el nombre del lugar, el nivel de riesgo (Bajo, Medio, Alto...), qué hacer al respecto (Informar, Prepararse o Actuar) y el detalle de cada una de las cinco amenazas por separado, sismología incluida. También tiene su propio botón para exportar ese reporte a PDF.
El nivel de riesgo compuesto es el mayor entre las cinco amenazas normalizadas (la amenaza más alta gobierna, siguiendo la doctrina de la OMM/GDACS), mientras que el puntaje de 0 a 1 es un promedio ponderado al estilo del Índice de Riesgo INFORM. El texto del reporte es una plantilla que se rellena con los mismos números que ya se ven en el mapa — no usa generación de lenguaje ni la puerta de enlace de IA de la app.
Otros detalles útiles
Funcionalidades
Qué hace cada módulo de la plataforma.
Fuentes de datos
Vigía no tiene una base de datos propia: cada vista consulta directamente estos servicios públicos, en su mayoría abiertos y sin necesidad de autenticación.
Índices de amenaza
Capas estáticas publicadas en ArcGIS Online por RED LabOT y la Secretaría de Infraestructura del Valle del Cauca — abiertas, sin autenticación.
Pronósticos y monitoreo en vivo
Servicios internacionales gratuitos de agencias científicas y ambientales, sin necesidad de clave salvo donde se indica.
Demografía y límites administrativos
Fuentes gubernamentales y de datos abiertos usadas para población, veredas y cascos urbanos.
Infraestructura
Puntos de interés comunitarios, con la misma filosofía de datos abiertos que el resto de la plataforma.
Sismología
Actividad sísmica en vivo de la Red Sismológica Nacional de Colombia (SGC) como fuente principal, con el catálogo global del USGS como verificación y el catálogo histórico oficial del SGC, más un resumen opcional de reportes comunitarios de daños en Sevilla. Los sismos no se pueden pronosticar: estas fuentes mejoran la detección en vivo, no la predicción.
Riesgo compuesto (multiamenaza)
Sin fuente externa propia — esta categoría solo combina, en el servidor, los cinco modelos de amenaza que ya alimentan las categorías anteriores.
Metodología: modelo propio de amenaza por deslizamiento
Cálculo propio, no un índice oficialEl color del mapa de deslizamientos ya no proviene de una capa publicada por un tercero, sino de un modelo que esta misma app calcula en el servidor. Sigue, de forma simplificada, la estructura de NASA LHASA v1 (Stanley & Kirschbaum, 2017): un factor estático de susceptibilidad del terreno combinado con un disparador dinámico de lluvia reciente. Esta sección documenta paso a paso qué dato entra en cada cálculo y exactamente cómo se procesa, para que el resultado sea auditable en vez de una caja negra.
Caché por factor
Cada insumo del modelo se cachea de forma independiente, según qué tan rápido cambia — solo la primera solicitud dentro de cada ventana de caché paga el costo completo de recalcular los ~55 centroides.
- Elevación / pendiente
- 30 días — el terreno no cambia
- Red vial (Overpass)
- 6 horas — mismo caché que el resto de capas de OpenStreetMap
- Fallas geológicas (SGC)
- 30 días — la cartografía geológica no cambia
- Inventario de movimientos en masa (SGC)
- 30 días — es un inventario histórico estático
- Lluvia / disparador
- 1 hora — los días más recientes se revisan con nuevas observaciones
Qué no es este modelo
- No es una calibración validada contra deslizamientos ocurridos en la zona — los pesos y umbrales (0.35/0.15/0.2/0.3, 0.6/0.4, 45°, 1 km, 2 km, 2 km, razón de saturación 2) son elegidos por criterio propio siguiendo la estructura de LHASA v1, no ajustados con datos locales.
- LHASA v1 usa cinco predictores estáticos; este modelo reproduce tres de ellos (pendiente, vías y fallas geológicas) y suma un cuarto factor propio (movimientos en masa históricos) que LHASA v1 no incluye. Cobertura de suelo (ESA WorldCover) — el único predictor de LHASA que sigue faltando — se evaluó pero se descartó: solo existe como archivo raster satelital (COG/GeoTIFF) sin una API de consulta por punto viable desde una función serverless. Geología/fallas y el inventario histórico se habían descartado por el mismo motivo hasta encontrar sus respectivas capas del SGC, que resultaron ser la excepción: vectores pequeños y directamente consultables, no rásteres.
- El inventario de movimientos históricos solo tiene 55 puntos en toda la zona de estudio y sin fecha de ocurrencia confiable — es evidencia real de inestabilidad pasada, pero disperso y no exhaustivo. Que una vereda quede lejos de los 55 puntos conocidos no significa que nunca haya tenido un movimiento en masa, solo que ninguno quedó registrado en este inventario.
- Se calcula en el centroide de cada vereda, no en una grilla densa — una sola pendiente y distancia a vía representan a toda la vereda, a diferencia de los ~11.721 puntos que sí tenía la capa de RED LabOT dentro de su área de cobertura.
Metodología: modelo propio de amenaza por inundación
Cálculo propio, no un índice oficialLa capa "Modelo propio de inundación" del mapa de inundaciones extiende la zonificación oficial de RED LabOT —que solo cubre el área zonificada de Sevilla y Caicedonia— a los tres municipios, incluido Zarzal, calculando un puntaje propio por vereda. La zonificación oficial no se descarta: es, al contrario, el insumo de mayor peso del modelo, donde tiene cobertura.
Caché por factor
- Zonificación oficial de inundación
- 1 hora — mismo caché que la capa pública original
- Hidrografía (quebradas y ríos)
- 30 días — el curso de un cauce cambia muy lentamente
- Pendiente / planicie
- reutilizada — es el mismo valor ya cacheado por el modelo de deslizamiento
Qué no es este modelo
- No es un modelo hidráulico ni hidrológico — no simula caudal, láminas de agua ni tiempos de llegada de una creciente. Es una susceptibilidad relativa por vereda, del mismo tipo que la zonificación oficial que extiende, no un pronóstico de inundación (para eso está el pronóstico de caudal en vivo de GEOGLOWS, ya en el mismo mapa).
- La capa de hidrografía usada para el factor de cercanía a cauces solo tiene 19 trazas con nombre — es una aproximación a la red de drenaje real, no un mapa completo de todo arroyo o canal menor.
- Los pesos y umbrales (0.5/0.3/0.2, 1 km, 8°) son elegidos por criterio propio, siguiendo la misma lógica de factores-por-distancia-e-inclinación del modelo de deslizamiento, no ajustados con datos locales de inundaciones ocurridas.
- Cada traza de cauce de la capa de hidrografía trae también un identificador (rivid) que coincide con el esquema de tramos que ya usa el pronóstico de GEOGLOWS en este mapa — un posible factor dinámico futuro (p. ej. ponderar por el período de retorno en vivo del tramo más cercano), señalado aquí pero no implementado: a diferencia de cada otro insumo de este modelo, que es una sola consulta cacheada, eso implicaría decenas de consultas individuales por tramo en cada solicitud.
Metodología: riesgo compuesto (multiamenaza)
Cálculo propio, no un índice oficialLa capa "Riesgo compuesto" combina las cinco amenazas que esta app ya modela por vereda —deslizamientos, inundaciones (modelo propio), incendios forestales, precipitación y sismología— en una sola evaluación, siguiendo dos enfoques ya usados en la práctica internacional en vez de inventar uno nuevo: la doctrina de la OMM/GDACS de que "la amenaza más alta gobierna" para el nivel de alerta, y la composición ponderada al estilo del Índice de Riesgo INFORM para un puntaje continuo de referencia. El resultado se traduce además al marco de acción Informar/Prepararse/Actuar que ya usa IDEAM en Colombia.
Caché por insumo
Este módulo no introduce nuevas fuentes externas — cada insumo hereda el caché que ya tenía en su propia categoría.
- Deslizamientos e inundaciones
- reutilizada — mismo caché que cada modelo individual (vía aggregateVeredas)
- Incendios forestales (cruce por centroide)
- 1 hora — mismo caché que la capa AmenazaIncendios original
- Precipitación (NASA POWER, 7 días)
- 3 horas — mismo caché que /api/precipitacion/amenaza
- Sismología (USGS en vivo / SGC histórico)
- 5 min / 1 día — mismo caché que /api/sismologia/eventos
Qué no es este modelo
- No incluye el pronóstico de caudal en vivo de GEOGLOWS. Ese pronóstico es por tramo de río, no por vereda, y cruzarlo con ~55 veredas exigiría decenas de consultas de identificación de tramo en vivo por solicitud — una integración pesada y frágil fuera del alcance de esta primera versión. La amenaza "inundaciones" en el riesgo compuesto es, en cambio, el modelo propio de inundación por vereda (zonificación + cercanía a cauce + planicie del terreno) que ya representa esa amenaza en las otras tres categorías.
- No usa un modelo de lenguaje ni la puerta de enlace de IA de esta app. El reporte narrativo es texto de plantilla determinista, relleno con los mismos números que ya se muestran en el mapa y el panel — nunca generación libre.
- Los pesos iguales de 25% por amenaza y los umbrales de nivel (0.2/0.4/0.6/0.8) son una elección de diseño razonable, no una calibración validada contra eventos multiamenaza ocurridos en la zona — igual que cada modelo individual que combina.
- Incendios y precipitación no tienen un puntaje continuo propio publicado, así que su contribución al puntaje compuesto es una aproximación ordinal (índice de nivel entre los niveles totales), no una medida continua nativa como sí lo son deslizamientos e inundaciones.
Metodología: estimación nacional de exposición por deslizamiento
Estimación por área, no un índice de campoEl panel "Exposición en zona de susceptibilidad" sigue mostrando el índice de campo de RED LabOT en Sevilla y Caicedonia, sin cambios. Para cualquier otro municipio del país —donde RED LabOT no tiene cobertura— se calcula en su lugar una estimación por área que combina tres fuentes abiertas nacionales, documentada aquí paso a paso para que quede claro qué es un dato real y qué es un reparto proporcional.
Qué no es esta estimación
- No es un índice de campo verificado punto por punto como el de RED LabOT — es un reparto proporcional de totales municipales (población, infraestructura) según el % de área de cada nivel de amenaza, sin conocer la ubicación real de esa población o infraestructura dentro del municipio.
- No reporta menores de 5 ni mayores de 60 años fuera de Sevilla/Caicedonia — la fuente nacional de población (DANE) no tiene esa desagregación por edad a nivel de todo el país, y esta app no aproxima esas cifras con un indicador no relacionado.
- El conteo de infraestructura depende de qué tan completo esté el mapeo comunitario de OpenStreetMap en ese municipio — no es un registro oficial como los campos propios de la capa de RED LabOT.
Metodología: selección de las 6 estaciones de caudal por municipio
El panel de inundaciones muestra hasta 6 estaciones por municipio en vez de las 1-3 originales. Esta sección documenta cómo se eligen: primero las estaciones curadas y verificadas en campo donde existen, y luego —para completar hasta 6, en cualquier municipio del país— tramos adicionales resueltos en vivo por GEOGLOWS.
Arquitectura
Cómo está construida la plataforma, de la interfaz al dato.
Framework y renderizado
Next.js 16 (App Router) con React 19 y TypeScript. Las páginas son Server Components por defecto; los mapas y controles interactivos se marcan "use client" solo donde necesitan estado o efectos del navegador.
Acceso a datos, sin base de datos propia
Cada fuente externa tiene un módulo server-only en lib/<amenaza>/client.ts que llama directamente a su API/WMS/WMTS pública. No hay capa de persistencia: la app es una capa de agregación en vivo sobre servicios públicos ya existentes.
Rutas de API y hooks de datos
Cada módulo servidor se expone mediante una ruta en app/api/**/route.ts, que envuelve el resultado en un sobre JSON consistente ({ data } o { error }) con manejo de errores. Los componentes cliente consumen esas rutas con hooks de SWR (lib/**/use-*.ts) para caché y revalidación en el navegador.
Estrategia de caché
El caché de fetch de Next (next: { revalidate }) se ajusta por fuente según qué tan rápido cambia: FIRMS cada 15 min, capas de ArcGIS cada hora, límites administrativos cada semana, y las proyecciones del DANE no hacen ninguna llamada de red — se leen de un JSON estático versionado en el repositorio.
Mapas
Leaflet y react-leaflet, importados dinámicamente con next/dynamic({ ssr: false }) para evitar que el renderizado en servidor choque con las dependencias de window/document de Leaflet. Cada amenaza combina GeoJSON, CircleMarker, TileLayer, WMSTileLayer e ImageOverlay según la forma de su fuente.
Estilos y sistema de diseño
Tailwind CSS v4 con tokens de diseño definidos en app/globals.css (escalas de color en oklch por amenaza/categoría), componentes de shadcn/ui sobre primitivas de Base UI, y next-themes para el tema claro/oscuro/sistema.
Ventanas emergentes sin barra de navegador
lib/open-info-popup.ts abre la vista de referencia "Conoce tu nivel de exposición" en una ventana emergente sin menú, barra de herramientas ni barra de direcciones — para no interrumpir el mapa en vivo que el usuario tenía abierto. La documentación, en cambio, abre en una pestaña normal del navegador porque es contenido extenso pensado para desplazarse, imprimirse o guardarse como marcador.
Exportación a PDF
El botón "Exportar como PDF" del selector de exposición usa html2canvas-pro para capturar el mapa como imagen (se eligió sobre el html2canvas original, sin mantenimiento, porque este último no soporta las funciones de color CSS modernas —lab()/oklch()— que usan los tokens de Tailwind v4) y jsPDF para componer el documento final.
Despliegue
Vercel. Vercel Analytics solo se activa en producción (process.env.NODE_ENV === 'production').
Licencia y uso del código
El repositorio de Vigía es público para que cualquiera pueda leer su código, auditarlo y aprender de él, creado por Alejandro Pino (SIG · Director Técnico). La plataforma en sí — el sitio que estás usando — es de uso público y gratuito. El código fuente, en cambio, todavía no tiene una licencia de código abierto: las dependencias que trae la app sí la tienen y se listan a continuación, agrupadas por su propia licencia.