SIATA Geoportal

Consulta el geoportal de SIATA (Sistema de Alerta Temprana de Medellín y el Valle de Aburrá) para todo lo que publican sus redes de estaciones: clima con serie de 12 horas e índice UV, niveles de ríos, quebradas y alcantarillados con umbrales de inundación y el semáforo de alerta de la fuente, lluvia acumulada en siete ventanas más los totales mensuales, calidad del aire por contaminante con el índice ICA numérico, la red ciudadana de sensores de PM2.5, el pronóstico a dos días por municipio, los avisos oficiales, los últimos sismos y las últimas imágenes de la red de cámaras. Esta fuente reemplaza a SIATA, que está obsoleta.

Clima

POST /co/siata-geoportal/weather/v1

Campo	Tipo	Notas
`latitude`	number	Opcional. -90 a 90. Debe enviarse junto con `longitude`.
`longitude`	number	Opcional. -180 a 180. Debe enviarse junto con `latitude`.
`radius_km`	number	Opcional. Radio en km alrededor del punto, 0-100. Por defecto `10`.
`municipality`	string	Opcional. Conserva solo las estaciones de ese municipio, p. ej. `Medellín`, `Itagüí`. Se ignoran tildes y mayúsculas.
`station_code`	string	Opcional. Devuelve solo la estación con ese código, p. ej. `520`.

curl https://api.croma.run/co/siata-geoportal/weather/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "latitude": 6.2442, "longitude": -75.5812, "radius_km": 5 }'

Todos los campos son opcionales. Un body vacío devuelve todas las estaciones; latitude + longitude limita la respuesta a las estaciones cercanas, ordenadas de la más cercana a la más lejana y con distance_km en cada una; municipality y station_code la limitan aún más. Sin filtro de ubicación, distance_km es null en todas las estaciones.

Campo	Notas
`stations[].temperature_c`, `humidity_pct`, `wind_speed_ms`, `wind_direction_deg`, `wind_direction_cardinal`, `pressure_hpa`	Las últimas lecturas de la estación. `null` cuando la estación no ha reportado.
`stations[].series_12h`	Temperatura y humedad por hora en las últimas 12 horas, de la más antigua a la más reciente, cada una con su marca de tiempo ISO `at`.
`stations[].updated_at`	Marca de tiempo ISO de la última actualización de la estación en la fuente.
`uv`	La lectura UV del valle: `index`, la `category` de la fuente (`Bajo`, `Moderado`, `Alto`, …), `temperature_c`, `measured_at` y la `series` horaria de hoy. `null` cuando el sensor no ha reportado.

Las lecturas se actualizan en la fuente cada cinco minutos. La respuesta se guarda en caché durante un minuto.

Serie de una estación meteorológica

POST /co/siata-geoportal/weather-series/v1

Campo	Tipo	Notas
`station_code`	string	Obligatorio. Código de la estación, p. ej. `202`. Los códigos vienen del endpoint `weather`.
`window`	enum	`1h` para la última hora con resolución de un minuto, `6h` para las últimas seis horas con resolución de cinco minutos. Por defecto `1h`.

curl https://api.croma.run/co/siata-geoportal/weather-series/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "station_code": "202", "window": "1h" }'

Campo	Notas
`found`	`false` cuando la fuente no tiene una estación con ese código. En ese caso no se devuelve nada más.
`points[]`	Lecturas en la ventana, de la más antigua a la más reciente: `at` (marca de tiempo ISO), `temperature_c`, `humidity_pct`, `wind_speed_ms`, `pressure_hpa`. Un punto por minuto con `1h`, uno cada cinco minutos con `6h` (`resolution_minutes`). Una variable que la estación no mide es `null`.
`mean`, `mean_3h`	El promedio de cada variable según la fuente en toda la ventana, y en las últimas tres horas (solo con `6h`).
`temperature_percentiles`	Los percentiles de temperatura de la estación (`p10` a `p90`) tal como los reporta la fuente, como contexto.

Los códigos de estación vienen del endpoint weather. La respuesta se guarda en caché durante un minuto.

Niveles de ríos y quebradas

POST /co/siata-geoportal/river-levels/v1

Campo	Tipo	Notas
`latitude`	number	Opcional. -90 a 90. Debe enviarse junto con `longitude`.
`longitude`	number	Opcional. -180 a 180. Debe enviarse junto con `latitude`.
`radius_km`	number	Opcional. Radio en km alrededor del punto, 0-100. Por defecto `10`.
`municipality`	string	Opcional. Conserva solo las estaciones de ese municipio, p. ej. `Medellín`, `Itagüí`. Se ignoran tildes y mayúsculas.
`station_code`	string	Opcional. Devuelve solo la estación con ese código, p. ej. `520`.
`include_series`	boolean	Opcional. Con `true`, cada estación trae `series_3h`, una lectura por minuto de las últimas tres horas. Por defecto `false`.

curl https://api.croma.run/co/siata-geoportal/river-levels/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "latitude": 6.2442, "longitude": -75.5812, "radius_km": 5 }'

Campo	Notas
`stations[].kind`	`river` para un sensor de río o quebrada, `sewer` para un sensor de alcantarillado.
`stations[].level_m`, `measured_at`	Último nivel del agua en metros y su marca de tiempo ISO. `null` cuando la estación no ha reportado.
`stations[].thresholds`	Umbrales de inundación de la estación en metros: `safe_m`, `caution_m`, `minor_flood_m`, `major_flood_m`. `null` en los sensores de alcantarillado.
`stations[].status`	Dónde está el último nivel frente a esos umbrales: `normal`, `elevated`, `caution`, `minor_flood` o `major_flood`. `null` cuando falta alguno.
`stations[].max_level_3h_m`, `mean_level_3h_m`	Nivel máximo y medio de las últimas tres horas.
`stations[].series_3h`	Una lectura por minuto de las últimas tres horas, de la más antigua a la más reciente. Solo con `include_series`; `null` en caso contrario.
`stations[].alert_color`, `alert_level`	El semáforo de la fuente (`green`, `yellow`, `orange`, `red`) y su nivel de alerta, de `0` (normal) a `3`. `null` cuando no está evaluado.
`stations[].windows`	El nivel representativo en cada ventana (`last_30m`, `last_1h`, `last_3h`, `last_24h`, `last_72h`, `last_30d`), cada una con su `level_m`, `measured_at` y `alert_color`.
`stations[].basin`, `land_cover_pct`	Morfología de la cuenca que drena la estación (área, perímetro, longitud del cauce, elevaciones, pendientes, densidad de drenaje, tiempo de concentración, porcentaje urbanizado) y sus coberturas en porcentaje. `null` cuando la fuente no las tiene para la estación.
`advisories`	Avisos operativos que la fuente muestra actualmente para estas capas, en texto plano. Vacío cuando no hay ninguno.

Los niveles y umbrales se actualizan en la fuente cada cinco minutos; los semáforos, ventanas y sensores de alcantarillado entre 15 minutos y una hora. La respuesta se guarda en caché durante un minuto.

Lluvia

POST /co/siata-geoportal/rainfall/v1

Campo	Tipo	Notas
`latitude`	number	Opcional. -90 a 90. Debe enviarse junto con `longitude`.
`longitude`	number	Opcional. -180 a 180. Debe enviarse junto con `latitude`.
`radius_km`	number	Opcional. Radio en km alrededor del punto, 0-100. Por defecto `10`.
`municipality`	string	Opcional. Conserva solo las estaciones de ese municipio, p. ej. `Medellín`, `Itagüí`. Se ignoran tildes y mayúsculas.
`station_code`	string	Opcional. Devuelve solo la estación con ese código, p. ej. `520`.

curl https://api.croma.run/co/siata-geoportal/rainfall/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "latitude": 6.2442, "longitude": -75.5812, "radius_km": 5 }'

Campo	Notas
`stations[].is_raining`	Si el pluviómetro registra lluvia en este momento. `extreme_rain` y `extreme_category` traen la marca y la categoría de lluvia extrema de la fuente cuando la activa.
`stations[].accumulated_mm`	Lluvia acumulada en cada ventana: `last_5m`, `last_30m`, `last_1h`, `last_3h`, `last_24h`, `last_72h`, `last_30d`. `null` cuando el pluviómetro no ha reportado.
`stations[].monthly`	Una entrada por mes del año en curso con datos, como `month` (`YYYY-MM`), `total_mm` y `data_availability_pct` (porcentaje del mes en que el pluviómetro reportó).
`stations[].sub_basin`	La subcuenca del río o quebrada donde está la estación. `village` y `district` son la vereda y el corregimiento cuando la estación está fuera del área urbana.
`advisories`	Avisos operativos que la fuente muestra actualmente para esta capa, en texto plano.

Las marcas de lluvia se actualizan en la fuente cada cinco minutos y los acumulados cada 15. La respuesta se guarda en caché durante un minuto.

Calidad del aire

POST /co/siata-geoportal/air-quality/v1

Campo	Tipo	Notas
`latitude`	number	Opcional. -90 a 90. Debe enviarse junto con `longitude`.
`longitude`	number	Opcional. -180 a 180. Debe enviarse junto con `latitude`.
`radius_km`	number	Opcional. Radio en km alrededor del punto, 0-100. Por defecto `10`.
`municipality`	string	Opcional. Conserva solo las estaciones de ese municipio, p. ej. `Medellín`, `Itagüí`. Se ignoran tildes y mayúsculas.
`station_code`	string	Opcional. Devuelve solo la estación con ese código, p. ej. `520`.

curl https://api.croma.run/co/siata-geoportal/air-quality/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "municipality": "Medellín" }'

Campo	Notas
`stations[].pm25`, `pm10`	Lecturas de material particulado de 24 horas como `{ concentration, unit, index, category, window_start, window_end }`, `unit` = `ug/m3`.
`stations[].o3_8h`, `no2_1h`, `so2_1h`, `co_8h`	Lecturas de gases en la ventana que indica el nombre del campo, `unit` = `ppb`.
`...index`, `...category`	El índice de calidad del aire de Colombia (ICA) de la lectura y su categoría: `Buena` (0-50), `Moderada` (51-100), `Dañina a la salud de grupos sensibles` (101-150), `Dañina a la salud` (151-200), `Muy dañina a la salud` (201-300), `Peligrosa` (301+).
`stations[].dominant_pollutant`, `dominant_index`	El contaminante con el índice más alto en la estación (`PM2.5`, `PM10`, `O3`, `NO2`, `SO2` o `CO`) y ese índice.
`stations[].station_short`	El identificador corto de la estación en la fuente, p. ej. `BAR-TORR`.

Un contaminante que la estación no mide es null. Las lecturas se actualizan en la fuente cada hora. La respuesta se guarda en caché durante un minuto.

Sensores ciudadanos de aire

POST /co/siata-geoportal/citizen-sensors/v1

Campo	Tipo	Notas
`latitude`	number	Opcional. -90 a 90. Debe enviarse junto con `longitude`.
`longitude`	number	Opcional. -180 a 180. Debe enviarse junto con `latitude`.
`radius_km`	number	Opcional. Radio en km alrededor del punto, 0-100. Por defecto `10`.
`municipality`	string	Opcional. Conserva solo las estaciones de ese municipio, p. ej. `Medellín`, `Itagüí`. Se ignoran tildes y mayúsculas.
`station_code`	string	Opcional. Devuelve solo la estación con ese código, p. ej. `520`.

curl https://api.croma.run/co/siata-geoportal/citizen-sensors/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "latitude": 6.2442, "longitude": -75.5812, "radius_km": 3 }'

Campo	Notas
`sensors[].pm25_1h`	PM2.5 de la última hora, en ug/m3.
`sensors[].index_daily`, `category`	El índice diario de calidad del aire (ICA) para PM2.5 y su categoría.
`sensors[].available`	Si el sensor está reportando actualmente. `data_recovery_24h_pct` y `data_recovery_15d_pct` indican qué tan completo es su registro reciente.

Son sensores de bajo costo operados por voluntarios; tómalos como indicativos y usa air-quality para la red de referencia. Las lecturas se actualizan en la fuente cada hora. La respuesta se guarda en caché durante un minuto.

Pronóstico

POST /co/siata-geoportal/forecast/v1

Campo	Tipo	Notas
`municipality`	string	Opcional. Uno de los municipios del valle, p. ej. `Medellín`, `Bello`, `Itagüí`, o una de las zonas de Medellín (`Centro`, `Occidente`, `Oriente`, `Palmitas`). Se ignoran tildes y mayúsculas.

curl https://api.croma.run/co/siata-geoportal/forecast/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "municipality": "Medellín" }'

Sin municipality la respuesta trae todas las zonas que pronostica la fuente: los diez municipios del valle, con Medellín dividido en Centro, Occidente, Oriente y Palmitas (zone).

Campo	Notas
`zones[].issued_at`	Marca de tiempo ISO de la corrida del pronóstico.
`zones[].days[]`	Hoy y mañana: `date`, `temperature_max_c`, `temperature_min_c` y `rain`, la probabilidad de lluvia por franja del día (`early_morning`, `morning`, `afternoon`, `night`) tal como la expresa la fuente: `BAJA`, `MEDIA` o `ALTA`.

La fuente emite el pronóstico una vez al día, hacia las 09:30 hora local. La respuesta se guarda en caché durante un minuto.

Alertas

POST /co/siata-geoportal/alerts/v1

Campo	Tipo	Notas
`include_past`	boolean	Opcional. Con `true`, devuelve también los avisos pasados, no solo los activos. Por defecto `false`.

curl https://api.croma.run/co/siata-geoportal/alerts/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "include_past": true }'

Campo	Notas
`alerts[]`	Avisos oficiales del sistema de alerta temprana, del más reciente al más antiguo: `id`, `title`, `description` (texto plano), `start_date`, `end_date`, `is_active` y `audience` (a quién lo dirige la fuente, p. ej. `citizen`). Vacío cuando no hay ninguno activo.

La respuesta se guarda en caché durante un minuto.

Sismos

POST /co/siata-geoportal/seismic-events/v1

Campo	Tipo	Notas
`latitude`	number	Opcional. -90 a 90. Debe enviarse junto con `longitude`.
`longitude`	number	Opcional. -180 a 180. Debe enviarse junto con `latitude`.
`radius_km`	number	Opcional. Radio en km alrededor del punto, 0-100. Por defecto `10`.
`municipality`	string	Opcional. Conserva solo las estaciones de ese municipio, p. ej. `Medellín`, `Itagüí`. Se ignoran tildes y mayúsculas.
`station_code`	string	Opcional. Devuelve solo la estación con ese código, p. ej. `520`.

curl https://api.croma.run/co/siata-geoportal/seismic-events/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Campo	Notas
`stations[].kind`	`accelerograph` o `seismograph`, con el `sensor` y la `technology` de la estación.
`stations[].events[]`	Los últimos eventos registrados por la estación, del más reciente al más antiguo: `occurred_at`, `magnitude`, `epicenter`, `depth_km`, la `latitude` y `longitude` del epicentro, y lo que midió la estación: `peak_acceleration_cm_s2` e `intensity_mmi` (Mercalli modificada, p. ej. `IV`) en los acelerógrafos, `peak_velocity_cm_s` en los sismógrafos.

La fuente lo actualiza cuando se registra un evento. La respuesta se guarda en caché durante un minuto.

Cámaras

POST /co/siata-geoportal/cameras/v1

Campo	Tipo	Notas
`latitude`	number	Opcional. -90 a 90. Debe enviarse junto con `longitude`.
`longitude`	number	Opcional. -180 a 180. Debe enviarse junto con `latitude`.
`radius_km`	number	Opcional. Radio en km alrededor del punto, 0-100. Por defecto `10`.
`type`	string	Opcional. `nivel`, `cielo`, `deprimido` o `capa_limite`.

curl https://api.croma.run/co/siata-geoportal/cameras/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "type": "nivel",
        "latitude": 6.2442,
        "longitude": -75.5812,
        "radius_km": 5
      }'

Todos los campos son opcionales. latitude + longitude (con radius_km) devuelven las cámaras cercanas, de la más cercana a la más lejana, con distance_km; type conserva un solo tipo.

Campo	Notas
`cameras[].type`	`nivel` (apunta a un sensor de río), `cielo`, `deprimido` (paso deprimido) o `capa_limite` (capa límite), con la etiqueta de la fuente en `type_label`.
`cameras[].snapshot_url`	La última imagen de la cámara. La fuente la renueva aproximadamente cada minuto; descárgala cuando la necesites en lugar de guardar el contenido de la URL.

La respuesta se guarda en caché durante un minuto.

La cobertura es únicamente el área metropolitana de Medellín (Valle de Aburrá). Los puntos fuera del valle devuelven arreglos vacíos, no un error.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.

Primeros pasos

Países

Clima

Serie de una estación meteorológica

Niveles de ríos y quebradas

Lluvia

Calidad del aire

Sensores ciudadanos de aire

Pronóstico

Alertas

Sismos

Cámaras

Referencia completa

​Clima

​Serie de una estación meteorológica

​Niveles de ríos y quebradas

​Lluvia

​Calidad del aire

​Sensores ciudadanos de aire

​Pronóstico

​Alertas

​Sismos

​Cámaras

Referencia completa

Clima

Serie de una estación meteorológica

Niveles de ríos y quebradas

Lluvia

Calidad del aire

Sensores ciudadanos de aire

Pronóstico

Alertas

Sismos

Cámaras