Pular para o conteúdo

Guia de timestamps da previsão

Hora válida vs hora de atualização da previsão de qualidade do ar

Hora válida vs hora de atualização da previsão de qualidade do ar começa por uma regra: identifique o significado real de cada timestamp. Hora válida é a data e a hora descritas por um ponto da previsão. “Hora de atualização” pode significar rodada do modelo, publicação do provedor, consulta do aplicativo, idade do cache ou recarregamento da página; por isso, o rótulo precisa nomear o relógio. A API de Poluição do Ar da OpenWeather documenta dt para cada ponto atual ou futuro, mas não um timestamp separado da rodada desse feed. A AirAgora preserva os horários dos pontos, registra consulta e cache na procedência técnica e mostra um rótulo explícito quando o dado está desatualizado, sem inventar horário de publicação. Recarregar a página não cria uma nova rodada, e nenhum desses horários transforma a previsão modelada em observação de rua.

Camadas atmosféricas abstratas em tons quentes e frios encontrando-se sobre colinas azul-esverdeadas
Ilustração editorial de camadas atmosféricas distintas para relógios com papéis distintos; não mostra relógio literal nem painel de dados.

Definição curta: período representado versus relógio de frescor identificado

A hora válida responde “quando estas condições modeladas devem se aplicar?”. Um horário de atualização ou frescor só responde outra pergunta depois que a interface define seu significado: pode ser rodada do modelo, publicação do provedor, consulta do aplicativo, criação do cache ou exibição da página. Esses relógios não são equivalentes, e um “atualizado” genérico não deve ser lido como hora da rodada sem documentação.

Use a hora válida para alinhar o ponto com uma atividade, limite de alerta ou observação posterior. Os horários de consulta e cache da AirAgora pertencem à procedência técnica; o planejador atual mostra o horário do ponto do provedor e eventual aviso de dado desatualizado, não um campo exato de idade da consulta. Use horário de rodada ou publicação apenas quando o provedor realmente fornecer e definir esse campo. Nenhum desses timestamps mede exposição pessoal nem garante a condição exata do local.

Fontes[1][3][4]

Os pontos da OpenWeather usam tempo Unix em UTC

A OpenWeather documenta o campo dt como data e hora em Unix UTC. Esse valor identifica o ponto representado. A AirAgora converte o instante absoluto para o fuso IANA da localização. A conversão muda o rótulo do relógio e, às vezes, a data local, mas não muda qual instante o ponto previsto representa.

A diferença importa perto da meia-noite e em mudanças de horário de verão. Dois lugares podem exibir relógios locais diferentes para o mesmo instante absoluto. Uma hora repetida pode corresponder a dois instantes, enquanto uma hora pulada não deve ser inventada. Guarde timestamp absoluto e fuso quando uma comparação futura exata for importante.

Fontes[1][2][3]

A OpenWeather não documenta uma rodada separada para este feed

A documentação da API de Poluição do Ar define dt para cada ponto atual ou previsto. Ela não define no retorno um timestamp separado de rodada, emissão ou publicação do modelo. Portanto, um ponto válido para amanhã não deve receber uma “hora da rodada” inventada apenas porque o aplicativo consultou a resposta hoje.

A AirAgora também não promete com que frequência a OpenWeather publica um conjunto novo. Uma resposta recém-consultada pode trazer pontos alterados ou os mesmos pontos, mas o horário da consulta não comprova nova rodada do provedor. A evidência pública honesta é o horário documentado do ponto e eventual aviso de dado desatualizado; a procedência técnica registra separadamente consulta e cache.

Horário da consulta e da visualização pertencem ao aplicativo

O horário da consulta registra quando a AirAgora pediu o provedor ou leu uma entrada válida do cache. O horário da visualização indica quando o navegador mostrou a página. Esses relógios ajudam a entender operação e reutilização, mas não redefinem a hora ambiental. Eles pertencem à procedência técnica, não a um campo exato de idade da consulta no planejador atual. A pessoa pode abrir às 10h05, receber cache consultado às 9h55 e olhar um ponto válido às 14h locais.

O exemplo não precisa de um valor inventado de poluição: só os horários já mostram os papéis. O ponto das 14h deve ser comparado com outros valores válidos às 14h. A consulta das 9h55 ajuda a entender a idade do cache. Sem um horário de rodada documentado pelo provedor, nem a consulta nem a visualização das 10h05 identificam quando o ciclo do modelo foi produzido.

Fontes[2][3][4]

Dado desatualizado preserva os pontos e o contexto da consulta original

Na AirAgora, uma resposta da previsão pode ser reutilizada como fresca por até 20 minutos, enquanto a consulta do ponto atual usa uma janela de 10 minutos. Se a renovação falhar, uma entrada ainda válida pode aparecer como desatualizada por no máximo duas horas. Os horários dos pontos e o contexto da consulta original permanecem; a falha não vira horário da rodada nem observação atual.

Depois do limite, ou sem cache válido, a AirAgora informa indisponibilidade. Ela não reescreve timestamps antigos, preenche lacunas, usa scraping nem troca silenciosamente de provedor. O contrato de horário também é um contrato de honestidade: evidência antiga continua antiga mesmo quando é temporariamente a única disponível.

Fontes[3][4]

Use o horário certo para cada pergunta

No planejamento comum, alinhe a atividade às horas válidas locais e use o horário exibido do ponto do provedor com eventual aviso de dado desatualizado. Numa comparação operacional com acesso à procedência técnica, alinhe a mesma hora válida e guarde timestamps de consulta e cache de cada resposta. A hora da visualização pode registrar quando alguém viu a página. Nenhum desses relógios do aplicativo é rodada do provedor sem documentação.

Ao comparar outra tela, alinhe também localização, poluente, unidade, média, escala do provedor e procedência modelada ou observada. Horários iguais não tornam dois valores automaticamente equivalentes. O objetivo aqui é explicar os relógios, não declarar que uma fonte é mais precisa que outra.

Fontes[1][3][4]

Checklist compacto de timestamps

Antes de agir, pergunte: qual hora local o valor representa? Qual timestamp absoluto e fuso produziram esse rótulo? O provedor documenta uma rodada separada ou apenas o horário do ponto? O planejador está marcado como desatualizado? Quando eu o vi? Se a procedência técnica estiver disponível, quando a AirAgora consultou ou reutilizou a resposta? Essas respostas evitam chamar previsão futura de medição atual e evitam confundir recarregamento com nova rodada.

Depois aplique os limites normais. O valor continua modelado para uma grade, a escala OpenWeather 1–5 continua separada de IQAs regulatórios e um timestamp compatível não prova exposição na rua nem segurança universal. Em situações urgentes, a orientação oficial local permanece prioritária.

Respostas diretas

Perguntas frequentes

O que é hora válida em uma previsão de qualidade do ar?

É a data e a hora representadas pelo valor previsto. A AirAgora formata o timestamp absoluto no fuso da localização para que o período possa ser ligado a um plano real.

A OpenWeather publica uma hora separada de atualização ou rodada?

Não no retorno documentado da API de Poluição do Ar. A OpenWeather define dt para cada ponto, e a AirAgora registra consulta e cache na procedência técnica e mostra eventual aviso de dado desatualizado sem inventar uma rodada do provedor.

O que o “horário da previsão” da AirAgora representa?

É o timestamp ligado ao ponto modelado atual do provedor, exibido separadamente das horas válidas futuras e ao lado de eventual aviso de dado desatualizado. A AirAgora não o apresenta como horário exato de publicação do modelo.

Recarregar a página cria uma nova hora de atualização?

Não. A solicitação pode reutilizar cache válido ou receber uma resposta com os mesmos horários dos pontos. Visualização e consulta não comprovam que o provedor publicou nova rodada.

Qual horário permanece no dado desatualizado?

Os horários originais dos pontos permanecem visíveis, o contexto técnico da consulta continua associado à resposta e um aviso explícito identifica o dado desatualizado. A tentativa que falhou não torna a previsão atual nem recém-observada.

Quais horários devo guardar para verificar depois?

Guarde hora válida, timestamp absoluto, fuso, horário exibido do ponto do provedor, eventual aviso de dado desatualizado, lugar, poluente, unidade, escala e os valores vistos. Se houver procedência técnica, guarde também os timestamps de consulta e cache. Só guarde horário de rodada se o provedor realmente fornecer esse campo.

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.

  1. 1.Documentação da API de Poluição do Ar da OpenWeather
  2. 2.Perguntas frequentes da OpenWeather
  3. 3.Metodologia da AirAgora — regra airagora-1.1.0
  4. 4.Fontes, atribuição e 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.