Clima
de Piracicaba: Estação da ESALQ/USP.

Motivação

O portal já usa a estação da ESALQ para mostrar o tempo em Piracicaba, mas só guarda o último valor. O DataX guarda a série observada e, a cada 6 horas, a previsão oficial do INMET com a hora em que foi emitida, para comparar previsto e observado.

Composição

Unidade

Leitura de 15 min; dia fechado; emissão de previsão.

Campos de 15 min

t (hora local), temp, umidade, vento_kmh, dir_vento, radiacao_wm2, chuva_mm, pressao_kpa.

Campos do dia

dia, temp_med, temp_max e hora, temp_min e hora, ur_max, ur_min, vento_med_kmh, vento_max_kmh e hora, dir_vento, radiacao_med_wm2, radiacao_total_mjm2, chuva_mm, pressao_kpa.

Previsão

emitida_em, fonte, ibge e dias[]: data, dia_semana, temp_min, temp_max, umidade_min, umidade_max, nascer, ocaso, tendência da máxima e da mínima. Os primeiros dias trazem periodos (manha, tarde, noite) com resumo, vento e temperaturas; os demais trazem um resumo único e a origem (previsor ou modelo). Os ícones da resposta não são guardados.

Cobertura: ESALQ: resumo diário desde 23/08/2025 (início do arquivo diário publicado) e leituras de 15 min desde a primeira coleta do DataX (carga do arquivo inteiro na madrugada). Previsão: cada emissão a partir da primeira coleta; o INMET devolve o dia da emissão e mais alguns (5 dias em 28/10/2026).

Como é coletado

Fonte oficial

ESALQ/USP: http://143.107.212.10/dados/COLETA15.DAT (15 min) e COLETADI.DAT (diário), arquivos Campbell TOA5. Previsão: INMET, API pública sem chave, https://apiprevmet3.inmet.gov.br/previsao/3538709 (3538709 = Piracicaba no IBGE); cada resposta vira uma emissão com a hora da coleta e os ícones em base64 são descartados.

Método

Parser copiado do hub do portal (campos Tar_AVG, UR_inst, Vvento_ms_AVG x 3,6, Dvento_G, Qg_AVG, Chuva_mm, Patm_kPa_AVG; faixas físicas; NAN vira vazio). Leitura de 15 min via Range (cauda do arquivo); dia fechado do COLETADI. Leitura já gravada é fixa.

Cadência

ESALQ 15 min: a cada 15 min; diário: uma vez ao dia (06h30); previsão do INMET: a cada 6 horas (00h, 06h, 12h, 18h). Mesmas cadências do portal para a ESALQ.

Orçamento de requisições

Por dia: 96 (ESALQ 15 min) + 1 (diário) + 1 (cabeçalho, se faltar) + 4 (previsão do INMET) = cerca de 102. Carga histórica: 1 requisição de ~5 MB.

Túnel

Não há.

Pré-processamento e limpeza

• No arquivo diário o carimbo é o fim do período (a linha de 27/10 00:00 fecha o dia 26/10): o campo dia é o carimbo menos 1 dia. Conferido contra o arquivo de 15 min: chuva 60,2 mm e temperatura média 21,6 °C em 25/10 nas duas pontas.
• A previsão guarda a resposta do INMET sem os ícones, com a hora de emissão. O INMET traz números como inteiros e textos de resumo prontos; nada é recalculado.
• Valores fora da faixa física (temperatura -5 a 45 °C, umidade 0 a 100%, vento 0 a 150 km/h, chuva 0 a 400 mm, pressão 90 a 100 kPa) viram vazio; umidade é arredondada ao inteiro e vento a 1 casa, como no portal.

Checks de qualidade aplicados

• Esquema: carimbo válido; arquivo diário não vazio.
• Unicidade e futuro: carimbos em ordem e nenhuma leitura no futuro.
• Faixa: mais de 5% dos valores do lote fora da faixa física retém o lote.
• Salto: mudança de mais de 8 °C entre duas leituras de 15 min retém o lote. Coerência: mínima maior que a máxima reprova o dia.
• Fluxo de qualidade: o dado coletado é conferido antes de ficar público; se reprovar, fica retido e a API segue entregando a última versão boa. Recheque noturno: 5 leituras de 15 min das últimas 24 h e 5 dias fechados, conferidos no arquivo da ESALQ.

Licença e usos

Licença

ESALQ/USP: dados da Estação Meteorológica publicados abertamente, sem licença declarada (atribuição: "Fonte: Estação Meteorológica da ESALQ/USP, processamento PIRANOT"). Previsão: INMET, dado público federal; cite "Fonte: INMET".

Usos

Histórico de clima de Piracicaba, comparação previsto x observado, pautas e relatórios. Não é alerta: avisos oficiais vêm do INMET e da Defesa Civil.

Limitações conhecidas

• A previsão do INMET cobre poucos dias (5 em 28/10/2026), não 7; os dias de resumo único vêm de previsor ou de modelo, como o INMET informa. O recheque noturno não confere previsões: uma emissão é um retrato datado, não um fato que se possa conferir depois.
• O arquivo diário da ESALQ publicado traz só desde 08/2025: recordes valem para essa janela, não para os 100 anos da estação.
• A estação pode ter falhas de sensor ou de envio; valores implausíveis ficam vazios.

Distribuição

Metadados (DCAT / schema.org Dataset)

dct:identifier

clima-piracicaba

dct:publisher

PIRANOT

dct:source

ESALQ/USP; INMET

dct:license

ESALQ sem licença declarada; INMET dado público federal

dct:temporal

2025-08 ao presente

dct:spatial

Piracicaba/SP

dct:accrualPeriodicity

15 minutos

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.