Método AirAgora · regra airagora-1.1.0
Como a AirAgora escolhe um horário prático para sair
A AirAgora responde a uma pergunta limitada: qual janela prática completa de duas horas tem a menor gravidade determinística na previsão disponível? Ela não calcula um horário universalmente seguro nem substitui orientação oficial.
Exemplo ilustrativo · não são dados ao vivo
Janela completa · regra 70/30
Média + pior hora, empate estável
As entradas passam por um adaptador protegido
A produção aceita somente HTTPS em api.openweathermap.org com OPENWEATHER_API_KEY no servidor. Ela solicita concentrações atuais e previstas, o valor oficial da OpenWeather de 1 a 5 e timestamps. A chave nunca entra no navegador.
Sem chave, com host inesperado, modo fixture/avaliação ou payload inválido, a produção falha fechada. Respostas de previsão ficam frescas por 20 minutos e respostas do ponto atual por 10 minutos; após erro do provedor, uma entrada válida pode permanecer disponível com rótulo explícito de dado desatualizado por no máximo duas horas. Esse caminho preserva o timestamp original do ponto do provedor.
A escala do provedor fica separada da gravidade interna
Todo resultado preserva o valor e a categoria oficiais da OpenWeather de 1 a 5. A AirAgora nunca chama esse valor de IQA dos EUA, IQA europeu ou índice regulatório local.
Para ranquear, cada concentração é mapeada continuamente nas faixas documentadas do poluente. A gravidade 0–1 é somente interna e não aparece como índice oficial.
Janelas candidatas são completas e respeitam o horário local
O mecanismo considera períodos consecutivos de duas horas iniciados entre 06:00 e 22:00 no horário local. As duas horas precisam de gravidade válida derivada das concentrações. Lacunas não são interpoladas, duplicadas nem tratadas como ar limpo.
Os timestamps permanecem absolutos até a formatação no fuso IANA. Assim, transições de horário de verão são determinísticas: relógios repetidos continuam instantes distintos e horários inexistentes não são inventados.
A pontuação 70/30 mantém a pior hora visível
Para cada janela, a AirAgora calcula 70 por cento da gravidade média normalizada mais 30 por cento da pior hora. Só a média esconderia uma piora forte; só o máximo ignoraria o restante. A combinação fixa é fácil de inspecionar e explicar.
Menor é preferível. Diferenças até 0,02 são empate material, com vitória da janela mais cedo. A ordem estável impede saltos entre períodos praticamente iguais.
| Regra | Valor | Objetivo |
|---|---|---|
| Duração | 2 horas completas | Período útil |
| Inícios | 06:00–22:00 local | Evitar vencedores impráticos |
| Pontuação | 70% média + 30% pior hora | Equilibrar período e pico |
| Empate | 0,02 | Preferir o mais cedo |
| Mudança relevante | 0,08 | Evitar falsa precisão |
A melhor janela precisa diferir de forma relevante
A melhor pontuação é comparada à mediana. Se a melhoria for menor que 0,08, a AirAgora informa condições parecidas em vez de promover um vencedor preciso. A heurística fica registrada com a versão da regra.
Quando todas as janelas atingem a faixa interna ruim derivada dos limites do provedor, o resultado é “janela disponível menos poluída”. Nunca vira boa ou segura apenas por ocupar o primeiro lugar.
Poluentes, atividades e contexto registrado
O principal poluente vem da gravidade contínua derivada separadamente pelas faixas documentadas de cada poluente, com desempate estável. Concentrações permanecem visíveis com unidade. Atividade e sensibilidade mudam cuidado, não ranqueamento.
Cada recomendação registra versão airagora-1.1.0, escala do provedor, contexto derivado, timestamps, completude, pontuações, janela, principal poluente, cuidado e códigos de motivo.
- Sem interpolar horas ausentes.
- Sem fallback para fixture, scraping ou outro provedor.
- Sem conversão direta entre IQAs.
- Sem promessa universal de segurança.
- Sem ranqueamento oculto por atividade.
Respostas diretas
Perguntas frequentes
Por que a AirAgora usa janelas de duas horas?
Duas horas são a unidade fixa de planejamento. Ambas precisam estar completas, evitando que um único ponto atraente vire toda a recomendação.
Por que 70% média e 30% pior hora?
A combinação enfatiza o período típico e mantém uma piora forte visível. É regra transparente do produto, não fórmula oficial de agência.
O que acontece em um empate?
Se a diferença for até 0,02, vence a janela local mais cedo. Isso estabiliza o resultado sem fingir uma diferença relevante.
E se o dia inteiro estiver ruim?
A AirAgora indica a janela disponível menos poluída e mantém o cuidado. Ela não chama o período de bom ou seguro.
Selecionar corrida muda a melhor janela?
Não. A atividade muda o texto e o limite de cuidado, mas não o ranqueamento determinístico.
Como a AirAgora trata horário de verão?
Ela avalia timestamps absolutos e os formata no fuso IANA, tratando horas repetidas e puladas sem aritmética de texto.
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.