Skip to main content

Extrator Cotas PCD

Introdução​

Módulo Python para coleta e armazenamento de dados de cotas de estações tele métricas PCD (Plataforma de Coleta de Dados) da Agência Nacional de Águas (ANA).

Índice​

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

Visão Geral ​

Este módulo realiza:

  • Autenticação na API ANA
  • Busca de medições horárias de cotas
  • Adequação de dados brutos
  • Armazenamento em banco de dados

Fluxo principal:​

Configuração ​

Parâmetros fixos na classe

url = "https://www.ana.gov.br/.../HidroinfoanaSerieTelemetricaAdotada/v1"  # Endpoint PCD

Extrator de Cotas PCD ​

Classe responsável pela extração e processamento de dados de cotas em tempo real.

Atributos: url (str): Endpoint da API de telemetria PCD

Métodos principais: obtem_dados_estacao, armazenar_cotas: fluxo completo de coleta. armazenar_cotas: persistência dos dados.

Obter Dados da Estação ​

Obtém os dados da estação para o período informado.

Parâmetros: token (str): Token de autenticação da ANA. codigo_estacao (int): Código da estação data_busca (str): Data de início no formato yyyy-MM-dd range_busca (str): Periocidade da busca (HORA_X, MINUTO_X)

Retorno: True para dados válidos processados. False para falhas ou dados ausentes.

Tratar Resposta ​

Trata a resposta da requisição.

Parâmetros: resultado (object): Resposta da requisição. codigo_estacao (int): Código da estação. data_busca (str): Data de busc

Preencher Cota ​

Retorna uma cota padrão com valores nulos.

Parâmetros: codigo_estacao (int): Código da estação.

Retorno: dict: Cota preenchida.

Armazenar Cotas ​

Insere os dados na base de dados.

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