SIATA Geoportal

Consulta o geoportal do SIATA (Sistema de Alerta Temprana de Medellín y el Valle de Aburrá) para tudo o que suas redes de estações publicam: clima com série de 12 horas e índice UV, níveis de rios, córregos e redes pluviais com limiares de inundação e o semáforo de alerta da fonte, chuva acumulada em sete janelas mais os totais mensais, qualidade do ar por poluente com o índice ICA numérico, a rede cidadã de sensores de PM2.5, a previsão de dois dias por município, os avisos oficiais, os últimos sismos e as últimas imagens da rede de câmeras. Esta fonte substitui o SIATA, que está obsoleto.

Clima

POST /co/siata-geoportal/weather/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`.
`municipality`	string	Opcional. Mantém apenas as estações desse município, p. ex. `Medellín`, `Itagüí`. Acentos e maiúsculas são ignorados.
`station_code`	string	Opcional. Devolve apenas a estação com esse código, p. ex. `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 os campos são opcionais. Um body vazio devolve todas as estações; latitude + longitude limita a resposta às estações próximas, ordenadas da mais próxima para a mais distante e com distance_km em cada uma; municipality e station_code limitam ainda mais. Sem filtro de localização, distance_km é null em todas as estações.

Campo	Notas
`stations[].temperature_c`, `humidity_pct`, `wind_speed_ms`, `wind_direction_deg`, `wind_direction_cardinal`, `pressure_hpa`	As últimas leituras da estação. `null` quando a estação não reportou.
`stations[].series_12h`	Temperatura e umidade por hora nas últimas 12 horas, da mais antiga para a mais recente, cada uma com seu timestamp ISO `at`.
`stations[].updated_at`	Timestamp ISO da última atualização da estação na fonte.
`uv`	A leitura UV do vale: `index`, a `category` da fonte (`Bajo`, `Moderado`, `Alto`, …), `temperature_c`, `measured_at` e a `series` horária de hoje. `null` quando o sensor não reportou.

As leituras são atualizadas na fonte a cada cinco minutos. A resposta fica em cache por um minuto.

Série de uma estação meteorológica

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

Campo	Tipo	Notas
`station_code`	string	Obrigatório. Código da estação, p. ex. `202`. Os códigos vêm do endpoint `weather`.
`window`	enum	`1h` para a última hora com resolução de um minuto, `6h` para as últimas seis horas com resolução de cinco minutos. Por padrão `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` quando a fonte não tem uma estação com esse código. Nesse caso nada mais é retornado.
`points[]`	Leituras na janela, da mais antiga para a mais recente: `at` (timestamp ISO), `temperature_c`, `humidity_pct`, `wind_speed_ms`, `pressure_hpa`. Um ponto por minuto com `1h`, um a cada cinco minutos com `6h` (`resolution_minutes`). Uma variável que a estação não mede é `null`.
`mean`, `mean_3h`	A média de cada variável segundo a fonte em toda a janela, e nas últimas três horas (apenas com `6h`).
`temperature_percentiles`	Os percentis de temperatura da estação (`p10` a `p90`) como a fonte os reporta, como contexto.

Os códigos de estação vêm do endpoint weather. A resposta fica em cache por um minuto.

Níveis de rios e córregos

POST /co/siata-geoportal/river-levels/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`.
`municipality`	string	Opcional. Mantém apenas as estações desse município, p. ex. `Medellín`, `Itagüí`. Acentos e maiúsculas são ignorados.
`station_code`	string	Opcional. Devolve apenas a estação com esse código, p. ex. `520`.
`include_series`	boolean	Opcional. Com `true`, cada estação traz `series_3h`, uma leitura por minuto das últimas três horas. Por padrão `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 um sensor de rio ou córrego, `sewer` para um sensor de rede pluvial.
`stations[].level_m`, `measured_at`	Último nível da água em metros e seu timestamp ISO. `null` quando a estação não reportou.
`stations[].thresholds`	Limiares de inundação da estação em metros: `safe_m`, `caution_m`, `minor_flood_m`, `major_flood_m`. `null` nos sensores de rede pluvial.
`stations[].status`	Onde o último nível está em relação a esses limiares: `normal`, `elevated`, `caution`, `minor_flood` ou `major_flood`. `null` quando falta algum.
`stations[].max_level_3h_m`, `mean_level_3h_m`	Nível máximo e médio das últimas três horas.
`stations[].series_3h`	Uma leitura por minuto das últimas três horas, da mais antiga para a mais recente. Apenas com `include_series`; `null` caso contrário.
`stations[].alert_color`, `alert_level`	O semáforo da fonte (`green`, `yellow`, `orange`, `red`) e seu nível de alerta, de `0` (normal) a `3`. `null` quando não avaliado.
`stations[].windows`	O nível representativo em cada janela (`last_30m`, `last_1h`, `last_3h`, `last_24h`, `last_72h`, `last_30d`), cada uma com seu `level_m`, `measured_at` e `alert_color`.
`stations[].basin`, `land_cover_pct`	Morfologia da bacia drenada pela estação (área, perímetro, comprimento do canal, elevações, declividades, densidade de drenagem, tempo de concentração, percentual urbanizado) e sua cobertura do solo em percentual. `null` quando a fonte não as tem para a estação.
`advisories`	Avisos operacionais que a fonte exibe atualmente para essas camadas, em texto simples. Vazio quando não há nenhum.

Níveis e limiares são atualizados na fonte a cada cinco minutos; semáforos, janelas e sensores de rede pluvial entre 15 minutos e uma hora. A resposta fica em cache por um minuto.

Chuva

POST /co/siata-geoportal/rainfall/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`.
`municipality`	string	Opcional. Mantém apenas as estações desse município, p. ex. `Medellín`, `Itagüí`. Acentos e maiúsculas são ignorados.
`station_code`	string	Opcional. Devolve apenas a estação com esse código, p. ex. `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`	Se o pluviômetro registra chuva neste momento. `extreme_rain` e `extreme_category` trazem a marca e a categoria de chuva extrema da fonte quando ela a ativa.
`stations[].accumulated_mm`	Chuva acumulada em cada janela: `last_5m`, `last_30m`, `last_1h`, `last_3h`, `last_24h`, `last_72h`, `last_30d`. `null` quando o pluviômetro não reportou.
`stations[].monthly`	Uma entrada por mês do ano corrente com dados, como `month` (`YYYY-MM`), `total_mm` e `data_availability_pct` (percentual do mês em que o pluviômetro reportou).
`stations[].sub_basin`	A sub-bacia do rio ou córrego onde está a estação. `village` e `district` são a vereda e o corregimiento quando a estação está fora da área urbana.
`advisories`	Avisos operacionais que a fonte exibe atualmente para essa camada, em texto simples.

As marcas de chuva são atualizadas na fonte a cada cinco minutos e os acumulados a cada 15. A resposta fica em cache por um minuto.

Qualidade do ar

POST /co/siata-geoportal/air-quality/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`.
`municipality`	string	Opcional. Mantém apenas as estações desse município, p. ex. `Medellín`, `Itagüí`. Acentos e maiúsculas são ignorados.
`station_code`	string	Opcional. Devolve apenas a estação com esse código, p. ex. `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`	Leituras 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`	Leituras de gases na janela indicada pelo nome do campo, `unit` = `ppb`.
`...index`, `...category`	O índice de qualidade do ar da Colômbia (ICA) da leitura e sua categoria: `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`	O poluente com o índice mais alto na estação (`PM2.5`, `PM10`, `O3`, `NO2`, `SO2` ou `CO`) e esse índice.
`stations[].station_short`	O identificador curto da estação na fonte, p. ex. `BAR-TORR`.

Um poluente que a estação não mede é null. As leituras são atualizadas na fonte a cada hora. A resposta fica em cache por um minuto.

Sensores cidadãos de ar

POST /co/siata-geoportal/citizen-sensors/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`.
`municipality`	string	Opcional. Mantém apenas as estações desse município, p. ex. `Medellín`, `Itagüí`. Acentos e maiúsculas são ignorados.
`station_code`	string	Opcional. Devolve apenas a estação com esse código, p. ex. `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 da última hora, em ug/m3.
`sensors[].index_daily`, `category`	O índice diário de qualidade do ar (ICA) para PM2.5 e sua categoria.
`sensors[].available`	Se o sensor está reportando atualmente. `data_recovery_24h_pct` e `data_recovery_15d_pct` indicam quão completo é seu registro recente.

São sensores de baixo custo operados por voluntários; trate-os como indicativos e use air-quality para a rede de referência. As leituras são atualizadas na fonte a cada hora. A resposta fica em cache por um minuto.

Previsão

POST /co/siata-geoportal/forecast/v1

Campo	Tipo	Notas
`municipality`	string	Opcional. Um dos municípios do vale, p. ex. `Medellín`, `Bello`, `Itagüí`, ou uma das zonas de Medellín (`Centro`, `Occidente`, `Oriente`, `Palmitas`). Acentos e maiúsculas são ignorados.

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

Sem municipality a resposta traz todas as zonas que a fonte prevê: os dez municípios do vale, com Medellín dividida em Centro, Occidente, Oriente e Palmitas (zone).

Campo	Notas
`zones[].issued_at`	Timestamp ISO da rodada da previsão.
`zones[].days[]`	Hoje e amanhã: `date`, `temperature_max_c`, `temperature_min_c` e `rain`, a probabilidade de chuva por período do dia (`early_morning`, `morning`, `afternoon`, `night`) como a fonte a expressa: `BAJA`, `MEDIA` ou `ALTA`.

A fonte emite a previsão uma vez ao dia, por volta das 09:30 no horário local. A resposta fica em cache por um minuto.

Alertas

POST /co/siata-geoportal/alerts/v1

Campo	Tipo	Notas
`include_past`	boolean	Opcional. Com `true`, devolve também os avisos passados, não apenas os ativos. Por padrão `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 oficiais do sistema de alerta antecipado, do mais recente para o mais antigo: `id`, `title`, `description` (texto simples), `start_date`, `end_date`, `is_active` e `audience` (a quem a fonte o dirige, p. ex. `citizen`). Vazio quando não há nenhum ativo.

A resposta fica em cache por um minuto.

Sismos

POST /co/siata-geoportal/seismic-events/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`.
`municipality`	string	Opcional. Mantém apenas as estações desse município, p. ex. `Medellín`, `Itagüí`. Acentos e maiúsculas são ignorados.
`station_code`	string	Opcional. Devolve apenas a estação com esse código, p. ex. `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` ou `seismograph`, com o `sensor` e a `technology` da estação.
`stations[].events[]`	Os últimos eventos registrados pela estação, do mais recente para o mais antigo: `occurred_at`, `magnitude`, `epicenter`, `depth_km`, a `latitude` e `longitude` do epicentro, e o que a estação mediu: `peak_acceleration_cm_s2` e `intensity_mmi` (Mercalli modificada, p. ex. `IV`) nos acelerógrafos, `peak_velocity_cm_s` nos sismógrafos.

A fonte atualiza isso quando um evento é registrado. A resposta fica em cache por um minuto.

Câmeras

POST /co/siata-geoportal/cameras/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`.
`type`	string	Opcional. `nivel`, `cielo`, `deprimido` ou `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 os campos são opcionais. latitude + longitude (com radius_km) devolvem as câmeras próximas, da mais próxima para a mais distante, com distance_km; type mantém um só tipo.

Campo	Notas
`cameras[].type`	`nivel` (aponta para um sensor de rio), `cielo` (céu), `deprimido` (passagem rebaixada) ou `capa_limite` (camada limite), com o rótulo da fonte em `type_label`.
`cameras[].snapshot_url`	A última imagem da câmera. A fonte a renova aproximadamente a cada minuto; baixe-a quando precisar em vez de guardar o conteúdo da URL.

A resposta fica em cache por um minuto.

A cobertura é apenas a área metropolitana de Medellín (Valle de Aburrá). Pontos fora do vale devolvem arrays vazios, não um erro.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Países

Clima

Série de uma estação meteorológica

Níveis de rios e córregos

Chuva

Qualidade do ar

Sensores cidadãos de ar

Previsão

Alertas

Sismos

Câmeras

Referência completa

​Clima

​Série de uma estação meteorológica

​Níveis de rios e córregos

​Chuva

​Qualidade do ar

​Sensores cidadãos de ar

​Previsão

​Alertas

​Sismos

​Câmeras

Referência completa

Clima

Série de uma estação meteorológica

Níveis de rios e córregos

Chuva

Qualidade do ar

Sensores cidadãos de ar

Previsão

Alertas

Sismos

Câmeras