Atualização e timestamps
Com que frequência as previsões de qualidade do ar atualizam?
Não existe uma única resposta “atualiza a cada X minutos”. O modelo tem ciclo, o provedor publica e o aplicativo pode armazenar a resposta. O horário mostrado deve identificar a previsão, não apenas o carregamento da página.
Quatro relógios
Rodada, hora válida, consulta e visualização são relógios diferentes
A rodada é o ciclo de produção do modelo. A hora válida é o período representado por um valor. A consulta é quando a AirAgora pediu o dado. A visualização é quando o usuário abriu a página. Misturar os quatro cria falsa atualização.
A AirAgora armazena timestamps de fonte e consulta separadamente e formata horas válidas no fuso do local. Atualizar o navegador não transforma um timestamp antigo em dado novo.
A cadência pertence ao provedor
A OpenWeather expõe condições atuais de poluição do ar e quatro dias de previsão horária. A disponibilidade de uma nova atualização pertence ao provedor; a AirAgora não promete minuto inventado.
O resultado ao vivo informa o timestamp recebido. A documentação da fonte, não o marketing, controla afirmações de atualização.
Por que a AirAgora usa cache
Cache reduz latência, carga e solicitações duplicadas. Respostas têm período fresco limitado, e pedidos simultâneos da mesma localização podem ser coalescidos. A chave de cache remove credenciais e usa fatos normalizados.
Geocodificação e previsão têm janelas diferentes. A busca estática das 2.500 cidades fica fora do D1 e do caminho do provedor.
Dado antigo após erro não pode fingir frescor
Quando a atualização falha, uma previsão recente em cache pode ser mais útil que tela vazia, mas apenas com idade limitada e divulgação. A AirAgora retém o dado por uma janela curta, mantendo horário original e rótulo de desatualizado.
Depois do limite, ou sem entrada válida, mostra indisponibilidade. Ela nunca preenche horas ausentes nem troca para fixture em produção.
Como comparar horários de atualização
Procure o horário da fonte, não um “atualizado agora” ligado à renderização. Alinhe o fuso e descubra se o timestamp pertence a rodada, hora válida, observação ou consulta de cache.
Uma página mais nova pode mostrar modelo antigo. Uma rodada anterior pode conter horas futuras válidas. O produto transparente identifica o tipo de dado e preserva o relógio relevante.
- Fonte: quando o dado foi emitido ou marcado.
- Validade: hora representada pelo valor.
- Consulta: quando o aplicativo pediu o provedor.
- Idade do cache: tempo de reutilização.
- Visualização: quando o navegador exibiu.
Alertas usam idempotência além de atualização
Uma execução agendada não envia toda vez que vê a mesma previsão. O estado registra cruzamento, recuperação, cooldown e data local da manhã. Chaves de entrega evitam repetição.
Falhas do provedor alimentam o disjuntor do cron. Após três falhas consecutivas, o lote para em vez de criar mensagens falsas. Atualização sem controle de entrega seria ruído.
Respostas diretas
Perguntas frequentes
A AirAgora consulta o provedor em toda visualização?
Não. Ela usa cache limitado e coalescência para reduzir chamadas duplicadas, preservando timestamps.
O que significa “horário da previsão”?
É um timestamp da fonte associado ao dado modelado, diferente do horário da página e da hora local válida.
Por quanto tempo o dado é fresco?
O cache da AirAgora considera 20 minutos como fresco. Após erro, pode usar retenção antiga de até duas horas, com rótulo explícito.
Atualizar a página torna o dado mais novo?
Não necessariamente. A página pode reutilizar o mesmo cache ou rodada. O timestamp da fonte é a evidência.
O que acontece quando o provedor falha?
Um cache recente pode aparecer como antigo. Caso contrário, a AirAgora mostra indisponibilidade e nunca substitui fixture, scraping ou outro provedor.
Alertas repetem a cada execução?
Não deveriam. Idempotência, cruzamento, recuperação, cooldown e data local evitam duplicatas.
Registro de evidências
Fontes e leitura adicional
Os links abaixo identificam as referências primárias usadas nesta página. A seleção, o resumo e a apresentação são modificações da AirAgora.
Continue explorando
A AirAgora oferece orientação informativa para planejamento, não aconselhamento médico. As condições locais podem diferir das previsões modeladas; siga as orientações oficiais em eventos graves.