> ## 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

> Lecturas en vivo de clima, lluvia y calidad del aire de las estaciones del Valle de Aburrá (Medellín).

Consulta SIATA (Sistema de Alerta Temprana de Medellín y el Valle de Aburrá)
para obtener las lecturas actuales de cada estación de monitoreo del Valle de
Aburrá: clima (temperatura, humedad, viento, presión), lluvia (acumulado e
intensidad) y calidad del aire (PM2.5 e índice ICA, promedios de 24 horas).

`POST /co/siata/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`. |

Todos los campos son opcionales. Un body vacío devuelve todas las estaciones
del valle; `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 estación.

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

La respuesta agrupa las estaciones por tipo:

```json theme={"dark"}
{
  "data": {
    "meteorology": [
      {
        "station": "AMVA",
        "station_code": "44",
        "latitude": 6.24248,
        "longitude": -75.5735,
        "temperature_c": 22.5,
        "humidity_pct": 74.1,
        "wind_speed_ms": 5.2,
        "wind_direction_deg": 201.6,
        "wind_direction_cardinal": "SSW",
        "pressure_hpa": 825.9,
        "updated_at": "2026-07-12T22:53:02.000Z",
        "distance_km": 0.822
      }
    ],
    "rain": [
      {
        "station": "Instituto Jorge Robledo",
        "station_code": "23",
        "latitude": 6.258272,
        "longitude": -75.581128,
        "accumulated_mm": 0,
        "intensity_mm_h": 0,
        "updated_at": "2026-07-12T22:52:00.000Z",
        "distance_km": 1.564
      }
    ],
    "air_quality": [
      {
        "station": "Torre Social",
        "station_code": "81",
        "municipality": "Barbosa",
        "latitude": 6.43696,
        "longitude": -75.330452,
        "pm25": 10,
        "air_quality_index": 42,
        "updated_at": "2026-07-12T22:00:00.000Z",
        "distance_km": 4.1
      }
    ]
  }
}
```

Las lecturas individuales son `null` cuando la estación no las ha reportado.
Los valores de calidad del aire son promedios de 24 horas; `updated_at` marca
el fin de esa ventana. Sin filtro de ubicación, `distance_km` es `null` en
todas las estaciones.

<Note>
  La cobertura es únicamente el área metropolitana de Medellín (Valle de
  Aburrá). Un punto fuera del valle devuelve arreglos vacíos, no un error.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>