Até hoje, a API respondia pelo SIATA com um único endpoint: clima, chuva e PM2.5 de cada estação do Vale de Aburrá. A partir de hoje, a fonte siata-geoportal cobre tudo o que o sistema de alerta precoce de Medellín publica, em dez endpoints sob /co/siata-geoportal.
| Endpoint | O que devolve |
|---|---|
/co/siata-geoportal/weather/v1 | Temperatura, umidade, vento e pressão por estação, com série horária de 12 horas e índice UV |
/co/siata-geoportal/weather-series/v1 | Uma estação minuto a minuto: temperatura, umidade, vento e pressão na última hora, ou a cada cinco minutos nas últimas seis |
/co/siata-geoportal/river-levels/v1 | Nível de rios, córregos e galerias pluviais com limites de inundação, estado, semáforo de alerta, janelas e morfologia da bacia |
/co/siata-geoportal/rainfall/v1 | Chuva acumulada em sete janelas (5 minutos a 30 dias), totais mensais e se está chovendo agora |
/co/siata-geoportal/air-quality/v1 | PM2.5, PM10, ozônio, NO2, SO2 e CO por estação, cada um com concentração, índice ICA numérico e categoria |
/co/siata-geoportal/citizen-sensors/v1 | A rede cidadã de sensores de PM2.5, cerca de 230 sensores de baixo custo |
/co/siata-geoportal/forecast/v1 | Previsão para dois dias por município: temperaturas máxima e mínima e probabilidade de chuva por período do dia |
/co/siata-geoportal/alerts/v1 | Avisos oficiais do sistema de alerta precoce |
/co/siata-geoportal/seismic-events/v1 | Últimos sismos registrados por acelerógrafos e sismógrafos, com magnitude, epicentro e o que cada estação mediu |
/co/siata-geoportal/cameras/v1 | Cerca de 90 câmeras com a URL da última imagem de cada uma |
Todos os endpoints de estações aceitam os mesmos filtros opcionais: latitude e longitude com radius_km para as estações próximas, ordenadas da mais próxima para a mais distante, e municipality ou station_code para restringir. Um body vazio devolve o vale inteiro.
Nível dos rios com limites#
Cada estação de nível agora traz os limites de inundação da fonte e um status derivado deles, então não é preciso interpretar o nível na mão.
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"
}'A resposta inclui level_m, thresholds (safe_m, caution_m, minor_flood_m, major_flood_m), status (normal, elevated, caution, minor_flood, major_flood), o nível máximo e médio das últimas três horas e, com include_series: true, uma leitura por minuto dessas três horas.
Qualidade do ar com índice ICA#
air-quality passa de um poluente para seis, e cada leitura traz a concentração, o índice ICA numérico e sua categoria (Buena, Moderada, Dañina a la salud de grupos sensibles, ...), além do poluente que domina o índice da estação.
O que muda para quem usa o endpoint anterior#
POST /co/siata/v1 está obsoleto desde 27 de agosto de 2026 e deixará de responder em 1º de dezembro de 2026. Até lá, ele continua funcionando igual, e cada resposta traz os cabeçalhos Deprecation e Sunset e um Link com rel="successor-version", como descreve a política de versionamento.
Para migrar:
- Clima (
meteorology):POST /co/siata-geoportal/weather/v1, os mesmos campos por estação mais a série de 12 horas. - Chuva (
rain):POST /co/siata-geoportal/rainfall/v1.accumulated_mmagora é um objeto com sete janelas;intensity_mm_hnão tem equivalente. - Qualidade do ar (
air_quality):POST /co/siata-geoportal/air-quality/v1.pm25eair_quality_indexpassam a serpm25.concentrationepm25.index.
As respostas desta fonte ficam em cache por um minuto. O guia completo está em SIATA Geoportal e a página da fonte, em SIATA.