Rios:
nível, vazão e chuva (ANA) e o rio Piracicaba.

Motivação

A ANA publica a telemetria por um web service sem cadastro, estação a estação, em XML, e o rio Piracicaba em Piracicaba (SAISP/DAEE) chega pela coleta que o portal PIRANOT já faz (coleta uma vez, serve sempre). Quem acompanha cheia, estiagem e chuva (defesa civil, imprensa, agronegócio, pesquisa) precisa da série guardada, por hora, em formato estável e com a fonte.

Composição

Unidade

Estação em uma hora (hora local de Brasília); no rio Piracicaba, uma leitura coletada pelo portal.

Campos ANA

hora, nivel_cm (média das leituras da hora), vazao_m3s (média), chuva_mm (soma), leituras (quantas entraram na hora).

Campos SAISP

t (instante da coleta pelo portal), nivel_m (régua), cota_m (quando existe), fonte (wp-hist: coleta do portal; saisp: leitura direta antiga).

Inventário

cod, nome, rio, municipio, uf, lat, lon, alt, bacia, subbacia, operadora, origens, status.

Cobertura: Inventário nacional (ListaEstacoesTelemetricas, uma linha por estação, origens agrupadas). Série: estações da bacia do rio Piracicaba (rios Piracicaba, Atibaia, Jaguari e Corumbataí, sub-bacia 62) com os últimos 30 dias; as demais estações do Brasil entram pela carga histórica noturna (7 dias) e depois pela coleta diária incremental. Rio Piracicaba em Piracicaba: tudo o que o portal coletou (option pn_pira_rio_hist), acrescido a cada rodada.

Como é coletado

Fonte oficial

ANA: telemetriaws1.ana.gov.br/ServiceANA.asmx, métodos ListaEstacoesTelemetricas e DadosHidrometeorologicos (codEstacao, dataInicio, dataFim em AAAA-MM-DD). Rio Piracicaba: SAISP/DAEE, via coleta do portal PIRANOT (option pn_pira_rio_hist do WordPress, lida em modo somente leitura). O DataX não acessa o saisp.br e não promete outros postos do SAISP.

Método

Coletor próprio do DataX, User-Agent "PIRANOT-DataX/1.0". ANA: a hora é a média do nível e da vazão e a soma da chuva das leituras daquela hora; nada além disso. Rio Piracicaba: a cada rodada entram na série só os pontos com instante novo; ponto já guardado não é regravado. Incremental: pede do dia da última hora gravada em diante.

Cadência

Rio Piracicaba: a cada 15 min o DataX lê o que o portal já coletou (a cadência é a do portal). ANA: uma vez ao dia (06h30), só as estações que já têm dados e as novas da bacia. Carga histórica de todas as estações: uma vez, de madrugada, retomável.

Orçamento de requisições

Rio Piracicaba: nenhuma requisição externa (leitura local do portal). ANA diário: 1 (inventário) + 1 por estação com dados (uma estação, uma requisição, 1 por segundo). Carga histórica: 1 por estação (~5.100), cerca de 1h30 a 1 req/s.

Túnel

Não há.

Pré-processamento e limpeza

• Estação repetida no inventário (uma linha por origem) vira uma só, com a lista de origens; coordenada 0,0 vira vazio.
• Valores fora da faixa física (nível -1.000 a 150.000 cm, vazão 0 a 400.000 m³/s, chuva 0 a 300 mm/h) viram vazio e entram na contagem do check de faixa.
• Nenhum valor é interpolado nem preenchido; hora sem leitura simplesmente não existe na série.

Checks de qualidade aplicados

• Esquema: hora válida e contagem de leituras positiva; SAISP com instante e nível numéricos.
• Unicidade e futuro: horas sem repetição e em ordem; nenhuma leitura depois do instante da coleta.
• Faixa: mais de 5% dos valores do lote fora da faixa física retém o lote; SAISP: nível 0 a 20 m e cota 400 a 800 m.
• Salto (SAISP): mudança de mais de 2 m entre duas leituras retém o ponto para conferência. Inventário: não pode encolher mais de 20% de uma coleta para outra.
• Previsão: esquema (dias com mínima, máxima e resumo), datas em sequência e o primeiro dia a até 1 dia de hoje, temperatura de -10 a 50 °C e umidade de 0 a 100%, mínima não maior que a máxima; reprovar retém a emissão.
• Fluxo de qualidade: o dado coletado é conferido antes de ficar público; se reprovar, fica retido para conferência e a API segue entregando a última versão boa. Recheque noturno: 5 horas de estações sorteadas, conferidas na ANA.

Licença e usos

Licença

Dados públicos da ANA (Telemetria, web service sem cadastro) e do SAISP/DAEE (rio Piracicaba, via coleta do portal PIRANOT). Atribuição: "Fonte: Agência Nacional de Águas e Saneamento Básico (ANA), processamento PIRANOT" e, para o rio Piracicaba, "Fonte: SAISP/DAEE, via coleta do portal PIRANOT". As fontes não publicam licença explícita; vale a Lei de Acesso à Informação.

Usos

Acompanhar o nível e a vazão de rios, chuva por estação, apoio a pautas e relatórios. Não é sistema de alerta oficial: em risco, a referência é a Defesa Civil.

Limitações conhecidas

• Telemetria é dado bruto, sem consistência hidrológica; níveis de estações diferentes não são comparáveis (cada régua tem seu zero).
• Muitas estações do inventário não têm telemetria publicada no período ("sem dados"); elas aparecem no inventário e não na série.
• O SAISP não publica vazão nem chuva para o posto de Piracicaba; elas vêm da estação da ANA no mesmo trecho (PCH Luiz Queiroz, jusante).
• A série do rio Piracicaba começa onde a coleta do portal começou; não há leituras de antes disso.

Distribuição

Metadados (DCAT / schema.org Dataset)

dct:identifier

rios

dct:publisher

PIRANOT

dct:source

Agência Nacional de Águas e Saneamento Básico; SAISP/DAEE

dct:license

Dados públicos (LAI), atribuição à fonte

dct:temporal

últimos 30 dias na bacia do Piracicaba; 7 dias nacionais na carga inicial, crescendo diariamente

dct:spatial

Brasil

dct:accrualPeriodicity

horária

dcat:distribution

JSON via API v1

Histórico de versões

Reportar erro

POST /api/v1/qualidade/reportar com dataset, chave_registro, valor_visto, valor_esperado e fonte_esperada (detalhes em /docs/qualidade). Correções confirmadas aparecem em /erratas. Sem chave, escreva para [email protected].

Aviso. O DataX PIRANOT organiza dados de fontes oficiais e pode conter erros ou atrasos. Confira na fonte oficial, indicada em cada dado, antes de qualquer decisão importante. Respostas geradas por IA podem errar.DataX PIRANOT organises data from official sources and may contain errors or delays. Check the official source, linked with each dataset, before any important decision. AI-generated answers can be wrong.