Dados IMGW-PIB - como baixá-los e usá-los no monitoramento das águas
Muitas das suas medições ganham sentido apenas no contexto do clima e da hidrologia - e na Polônia esses dados são acessíveis ao público, gratuitamente, graças ao IMGW-PIB (o Instituto de Meteorologia e Gestão das Águas - Instituto Nacional de Pesquisa). Vale a pena saber o que você vai encontrar ali e como usá-lo.
O que o IMGW-PIB fornece
- Dados meteorológicos - entre outros a temperatura do ar, as precipitações, o vento, a pressão, a umidade.
- Dados hidrológicos - entre outros os níveis de água e as vazões nas estações fluviométricas.
- Alertas e informações sobre a situação hidrometeorológica.
Como baixá-los - um exemplo resolvido
O serviço polonês IMGW-PIB serve aqui de estudo de caso: o padrão se repete na maioria dos serviços hidrometeorológicos nacionais (no Brasil, a rede da ANA e do INMET), então vale a pena aprender o mecanismo e não uma lista de endereços. Tudo começa em danepubliczne.imgw.pl, que tem duas partes: um arquivo de ficheiros e uma API com dados correntes.
| Endereço | O que devolve | Atualização |
|---|---|---|
danepubliczne.imgw.pl/api/data/synop | estações sinóticas: temperatura do ar, chuva, vento, pressão, umidade | horária |
danepubliczne.imgw.pl/api/data/hydro | níveis, vazões e temperatura da água em estações fluviométricas | horária |
danepubliczne.imgw.pl/api/data/hydro2 | conjunto hidrológico ampliado (níveis diários) | diária |
danepubliczne.imgw.pl/api/data/meteo | estações climatológicas (inclusive temperatura do solo) | horária |
Dois parâmetros resolvem quase tudo: uma estação em vez de todas -
…/api/data/hydro/id/152210040 (acrescenta-se /id/<código>), e outro formato -
…/api/data/synop/format/csv (JSON por padrão; há também html e xml).
A resposta é um array de objetos planos: um por estação, sem aninhamento; com /id/<código> é um array com um único objeto. Um trecho de resposta real para a estação do Vístula em Varsóvia-Nadwilanówka:
[{
"id_stacji": "152210040",
"stacja": "Warszawa - Nadwilanówka",
"rzeka": "Wisła",
"rzedna_zerawodowskazu": "76.805",
"stan_alarmowy": "800",
"stan_ostrzegawczy": "750",
"stan_wody": "44",
"stan_wody_data_pomiaru": "2026-08-12 16:50:00",
"temperatura_wody": null,
"przeplyw": "181",
"przeplyw_data": "2026-08-12 16:50:00"
}]
Quatro tropeços fáceis - que você encontrará na maioria das APIs públicas:
- Os valores chegam como texto, não como números (
"stan_wody": "44"): converta antes de qualquer conta. nullé normal. A temperatura da água costuma vir vazia quando um sensor falha: é uma medição ausente, não um erro de download. Pule esses registros; nunca os substitua por zero.- Cada campo tem o seu próprio carimbo de tempo (
stan_wody_data_pomiaru,przeplyw_data): um registro pode trazer medições de horas diferentes. - Os carimbos de tempo estão em UTC, não na hora polonesa, embora a API não o declare:
16:50:00no registro são 18:50 no horário de verão (17:50 no inverno). Ao combiná-los com as suas medições, converta o fuso horário; o conector do LimnoLog faz isso sozinho (fuso da fonte: UTC).
O registro hidrológico contém também os níveis de alerta e de alarme da estação e a cota do zero da régua (rzedna_zerawodowskazu, em metros acima do nível do mar). Os níveis estão em centímetros acima do zero dessa régua - não acima do fundo nem do zero da sua própria régua. Uma leitura da mesma régua você pode comparar diretamente com eles. Um sensor próprio tem o seu próprio zero; por isso, converta primeiro as duas leituras em cota (m acima do nível do mar) e confirme que ambas estão no mesmo sistema de referência vertical (a API do IMGW informa a cota do zero no sistema EVRF2007, como se depreende do comunicado sobre a mudança do zero de Bulwary; um nivelamento próprio pode estar no sistema antigo Kronstadt 86) - e só para o mesmo ponto do rio, pois alguns quilômetros adiante a altura da água já é outra. O zero e os níveis às vezes são alterados juntos: Warszawa-Bulwary, 1.11.2025 - zero rebaixado em 100 cm e níveis convencionais elevados em 100 cm (alerta de 600 para 700 cm, alarme de 650 para 750 cm; aviso à navegação IMGW-PIB/Wody Polskie). Registre a data do limiar com que você compara e use os limiares do registro atual, não do arquivo.
Dados de arquivo
A API ao vivo devolve apenas a última medição. As séries históricas (diárias e mensais, de décadas) estão no arquivo de ficheiros: danepubliczne.imgw.pl/datastore - diretórios com arquivos CSV/ZIP de dados meteorológicos e hidrológicos.
Condições de uso
Os dados são gratuitos, mas as condições exigem citar a fonte: publicações baseadas neles devem indicar que os dados vêm do IMGW-PIB e, se houve processamento, acrescentar nota sobre isso. Texto completo: condições de fornecimento. Verifique a regra equivalente do serviço do seu país - gratuito quase nunca significa “sem condições”.
Para que empregá-los
Os dados do IMGW são um contexto pronto para as suas medições:
- as precipitações explicam as mudanças de nível de água e de turbidez (escoamento depois da chuva),
- a temperatura ajuda a compreender as flutuações do oxigênio, o risco de florações de cianobactérias, e até mesmo a revoada dos besouros-da-casca,
- os níveis e as vazões a montante ajudam a interpretar o que acontece no seu ponto.
Na prática
📊 Veja um exemplo funcionando: Vístula - Varsóvia (Nadwilanówka) - um painel público alimentado por exatamente esta API, o endereço
…/api/data/hydro/id/152210040do exemplo acima. Nível e vazão puxados automaticamente a cada hora, sem login e sem colar arquivos à mão. (Fonte dos dados: Instituto de Meteorologia e Gestão das Águas - Instituto Nacional de Pesquisa.)
A sua própria estação se conecta do mesmo jeito: no LimnoLog os conectores consultam APIs públicas no ritmo escolhido e gravam os resultados ao lado das suas medições, numa linha do tempo comum. Mais sobre combinar dados em Como combinar as suas medições com dados públicos.
Ver no aplicativo LimnoLog
Conhecer os recursos do LimnoLog