O Access Hidro API (AHAPI) é um software em Python 3 para requisição de dados da API Hidro Webservice da Agência Nacional de Águas (ANA). Ele permite registrar credenciais, gerenciar estações e realizar o download de dados hidrometeorológicos de forma prática.
O programa foi desenvolvido em Python 3. Para executar:
# Clone o repositório
git clone https://github.com/seu-usuario/AHAPI.git
cd AHAPI
# (Opcional) Crie um ambiente virtual
python -m venv venv
source venv/bin/activate # Linux/Mac
venv\Scripts\activate # Windows
# Instale as dependências
pip install -r requirements.txt
# Execute
python main.pyTambém há disponível uma versão compilada para Windows 11. Observações:
- Pode não funcionar corretamente em outros sistemas operacionais.
- Não possui assinatura digital, então seu antivírus pode sinalizar como potencial ameaça.
As credenciais são concedidas pela ANA via e-mail. Siga as instruções disponíveis no Hidroweb: Solicitar credenciais no Hidroweb para adquiri-lás.
Antes de solicitar dados:
- Selecione Atualizar Credenciais.
- Insira os dados fornecidos pela ANA nos campos de Login e Senha.
- Selecione Confirmar
- Clique em Atualizar estações.
- Selecione Adicionar estações.
- Insira os códigos das estações (um por linha).
- Clique em Atualizar.
Opções adicionais:
- Sobreescrever estações → apaga registros anteriores e substitui pelas novas.
- Adicionar estações → mantém registros anteriores e adiciona novas.
- Visualizar estações → abre a lista atual de estações. É possível remover selecionadas.
Edite ou substitua o arquivo estacoes.txt manualmente.
- O arquivo deve conter apenas códigos de estações
- Cada código deve estar em uma linha separada.
Os tipos de dados disponíveis:
- Telemétricas Adotadas
- Telemétricas Detalhadas
- Convencionais de Chuva
- Convencionais de Cota
- Convencionais de Sedimentos
- Clique em Baixar Estações.
- Selecione o período de datas.
- Clique em Baixar estações.
O tempo de download depende da disponibilidade da API da ANA e da velocidade de internet. Uma barra de progresso indica o andamento da operação.
Os arquivos baixados ficam organizados em resultados/, separados por tipo de estação:
resultados/
├── Adotadas/
├── Detalhadas/
├── Chuvas/
├── Cotas/
└── Sedimentos/
Cada arquivo segue o padrão:
códigoEstação-tipoEstação-dataInicial-dataFinal.txt
- Erros de uso são exibidos em popups para o usuário.
- Logs detalhados ficam registrados em
logs/.
Para mais informações sobre o projeto, sugestões ou reportar erros:
- Miguel Brondani - Desenvolvedor: brondani.miguel@gmail.com
- Daniel Allasia - Professor Orientador: dallasia@gmail.com
- Ecotecnologias - Grupo de Pesquisa: eco@ecotecnologias.org
- https://github.com/mBrond/AccessHidroAPI