Hasta hoy la API respondía por SIATA con un solo endpoint: clima, lluvia y PM2.5 de cada estación del Valle de Aburrá. Desde hoy la fuente siata-geoportal cubre todo lo que publica el sistema de alerta temprana de Medellín, en diez endpoints bajo /co/siata-geoportal.
| Endpoint | Qué devuelve |
|---|---|
/co/siata-geoportal/weather/v1 | Temperatura, humedad, viento y presión por estación, con serie horaria de 12 horas e índice UV |
/co/siata-geoportal/weather-series/v1 | Una estación minuto a minuto: temperatura, humedad, viento y presión en la última hora, o cada cinco minutos en las últimas seis |
/co/siata-geoportal/river-levels/v1 | Nivel de ríos, quebradas y alcantarillados con umbrales de inundación, estado, semáforo de alerta, ventanas y morfología de la cuenca |
/co/siata-geoportal/rainfall/v1 | Lluvia acumulada en siete ventanas (5 minutos a 30 días), totales mensuales y si está lloviendo ahora |
/co/siata-geoportal/air-quality/v1 | PM2.5, PM10, ozono, NO2, SO2 y CO por estación, cada uno con concentración, índice ICA numérico y categoría |
/co/siata-geoportal/citizen-sensors/v1 | La red ciudadana de sensores de PM2.5, unos 230 sensores de bajo costo |
/co/siata-geoportal/forecast/v1 | Pronóstico a dos días por municipio: temperaturas máxima y mínima y probabilidad de lluvia por franja del día |
/co/siata-geoportal/alerts/v1 | Avisos oficiales del sistema de alerta temprana |
/co/siata-geoportal/seismic-events/v1 | Últimos sismos registrados por acelerógrafos y sismógrafos, con magnitud, epicentro y lo que midió cada estación |
/co/siata-geoportal/cameras/v1 | Unas 90 cámaras con la URL de su última imagen |
Todos los endpoints de estaciones aceptan los mismos filtros opcionales: latitude y longitude con radius_km para las estaciones cercanas, ordenadas de la más cercana a la más lejana, y municipality o station_code para acotar. Un body vacío devuelve el valle completo.
Niveles de ríos con umbrales#
Cada estación de nivel trae ahora los umbrales de inundación de la fuente y un status derivado de ellos, así que no hace falta interpretar el nivel a mano.
curl https://api.croma.run/co/siata-geoportal/river-levels/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"station_code": "520"
}'La respuesta incluye level_m, thresholds (safe_m, caution_m, minor_flood_m, major_flood_m), status (normal, elevated, caution, minor_flood, major_flood), el nivel máximo y medio de las últimas tres horas y, con include_series: true, una lectura por minuto de esas tres horas.
Calidad del aire con índice ICA#
air-quality pasa de un contaminante a seis, y cada lectura trae la concentración, el índice ICA numérico y su categoría (Buena, Moderada, Dañina a la salud de grupos sensibles, ...), además del contaminante que domina el índice de la estación.
Qué cambia para quien usa el endpoint anterior#
POST /co/siata/v1 queda obsoleto desde el 27 de agosto de 2026 y dejará de responder el 1 de diciembre de 2026. Hasta entonces sigue funcionando igual y cada respuesta lleva las cabeceras Deprecation, Sunset y un Link con rel="successor-version", como describe la política de versionado.
Para migrar:
- Clima (
meteorology):POST /co/siata-geoportal/weather/v1, mismos campos por estación más la serie de 12 horas. - Lluvia (
rain):POST /co/siata-geoportal/rainfall/v1.accumulated_mmahora es un objeto con siete ventanas;intensity_mm_hno tiene equivalente. - Calidad del aire (
air_quality):POST /co/siata-geoportal/air-quality/v1.pm25eair_quality_indexpasan apm25.concentrationypm25.index.
Las respuestas de esta fuente se guardan en caché durante un minuto. La guía completa está en SIATA Geoportal y la ficha de la fuente en SIATA.