Skip to main content

Extrator Cotas Horárias

Introdução​

Módulo para extração e armazenamento de dados de cotas fluviométricas da Agência Nacional de Águas (ANA).

Índice​

  1. Visão Geral
  2. Configuração
  3. Extrator de Cotas
  4. Obter Dados da Estação
  5. Tratar Resposta
  6. Combinar Cotas
  7. Armazenar Cotas

Visão Geral ​

Este módulo realiza:

  • Autenticação na API ANA
  • Extração de séries históricas de cotas
  • Processamento de dados brutos
  • Armazenamento em banco de dados

Fluxo principal:​

Configuração ​

Parâmetros fixos na classe:

url = "https://www.ana.gov.br/.../HidroSerieCotas/v1"  # Endpoint da API

Extrator de Cotas ​

Classe responsável pela extração e processamento de dados de cotas da ANA. Atributos: url (str): Endpoint da API de séries históricas.

Métodos principais: obtem_dados_estacao, armazenar_cotas.

Obter Dados da Estação ​

Estrutura a requisição para obter os dados de cotas de uma estação.

Parâmetros: token (str): o token de autenticação da API.

codigo_estacao (int): Código ANA da estação.

data_inicial (str): Data inicial (yyyy-MM-dd).

data_final (str): Data final (yyyy-MM-dd)

tipo_filtro_data (str): Tipo de filtro temporal

Retorno: True se dados foram processados com sucesso False em caso de falha ou dados ausentes

Tratar Resposta ​

Combina as cotas brutas e analisadas em uma única lista

Parâmetros: codigo_estacao (int): o código da estação de interesse. nivel_consistencia (int): o nível de consistência das cotas. data_inicio (str): a data de início de interesse no formato yyyy-MM-dd. data_fim (str): a data final de interesse no formato yyyy-MM-dd.

Combinar Cotas ​

Parâmetros: cota_analisada (list): Lista de dicionários com as cotas analisadas. cota_bruta (list): Lista de dicionários com as cotas brutas.

Armazenar Cotas ​

Insere os dados na base de dados.

Parâmetros: dados (list): Lista de dicionários com as cotas a serem inseridos.