Extrator de Estações

Introdução

Módulo Python para coleta e armazenamento de dados de estações fluviométricas da Agência Nacional de Águas (ANA), com foco nas bacias da Amazônia Legal.

índicie

1. Visão Geral
2. Confirguração
3. Extrator de Estações
4. Obter estações
5. Buscar dados de estações
6. Inserir estações
7. Extrair estações
8. Encontrar estações novas

Visão Geral

Esse módulo realiza:

• Autenticação na API ANA
• Busca de estações fluviométricas
• Armazenamento em banco de dados
• Detecção de novas estações

Fluxo principal:

Configuração

Variáveis de filtragem no código:

codigos_bacias_interesse = [1, 2]  # Códigos Hidroweb  
estados_interesse = ["MA", "MT"] # UF da Amazônia Legal   

Extrator de Estacoes

Classe responsável pela extração e processamento de dados de estações pluviométricas da ANA.

Atributos: url (str): Endpoint da API de inventários de estações da ANA

Métodos principais: extrair_estacoes, encontrar_estacoes_novas.

Obter estações

Função que obtém estações filtrando por bacias e estados de interesse.

Parâmetros: tentativas(int): número atual de tentativas de conexão (máximo 3).

Retorna: list: lista de dicionários contendo dados das estações formatados

Buscar dados de estações

Função que consulta a API usando um critério de filtro e parâmetro específicos.

Parâmetros: filtro(str): tipo de filtro (código da Bacia ou Unidade Federativa). parametro(str ou int): valor do filtro (código numérico ou sigla UF).

Retorna: list: lista de estações fluviométricas formatadas.

Inserir estações

Função que insere as estações obtidas na base de dados.

Parâmetros: estacoes(list): lista com dados das estações.

Extrair estações

Função que realiza a busca e armazenamento das estações.

Encontrar estações novas

Função que identifica e insere estações não cadastradas na base de dados.

Retorna: list: lista de novas estações encontradas.