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

> Leituras ao vivo de clima, chuva e qualidade do ar das estações do Valle de Aburrá (Medellín).

Consulta o SIATA (Sistema de Alerta Temprana de Medellín y el Valle de Aburrá)
para obter as leituras atuais de cada estação de monitoramento do Valle de
Aburrá: clima (temperatura, umidade, vento, pressão), chuva (acumulado e
intensidade) e qualidade do ar (PM2.5 e índice ICA, médias de 24 horas).

`POST /co/siata/v1`

| Campo       | Tipo   | Notas                                                           |
| ----------- | ------ | --------------------------------------------------------------- |
| `latitude`  | number | Opcional. -90 a 90. Deve ser enviado junto com `longitude`.     |
| `longitude` | number | Opcional. -180 a 180. Deve ser enviado junto com `latitude`.    |
| `radius_km` | number | Opcional. Raio em km ao redor do ponto, 0-100. Por padrão `10`. |

Todos os campos são opcionais. Um body vazio retorna todas as estações
do vale; `latitude` + `longitude` limita a resposta às estações
próximas, **ordenadas da mais próxima à mais distante** e com `distance_km`
em cada estação.

```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 }'
```

A resposta agrupa as estações 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
      }
    ]
  }
}
```

As leituras individuais são `null` quando a estação não as reportou.
Os valores de qualidade do ar são médias de 24 horas; `updated_at` marca
o fim dessa janela. Sem filtro de localização, `distance_km` é `null` em
todas as estações.

<Note>
  A cobertura é apenas a área metropolitana de Medellín (Valle de
  Aburrá). Um ponto fora do vale retorna arrays vazios, não um erro.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>