> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SIATA Geoportal
> Clima, niveles de ríos con umbrales de inundación, lluvia, calidad del aire, pronósticos, alertas, sismos y cámaras del Valle de Aburrá (Medellín).
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](/es/colombia/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`. |
```bash theme={"dark"}
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`. |
```bash theme={"dark"}
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`. |
```bash theme={"dark"}
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 }'
```
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. `include_series` agrega `series_3h` a cada estación.
| 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`. |
```bash theme={"dark"}
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 }'
```
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[].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`. |
```bash theme={"dark"}
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" }'
```
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[].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`. |
```bash theme={"dark"}
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 }'
```
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 |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `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. |
```bash theme={"dark"}
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`. |
```bash theme={"dark"}
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`. |
```bash theme={"dark"}
curl https://api.croma.run/co/siata-geoportal/seismic-events/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
```
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[].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`. |
```bash theme={"dark"}
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.
Esquemas, todos los campos de respuesta y un playground interactivo.