API de clima como caminho de dados paralelo

Busque a previsão e as condições externas junto com o JSON das sondas para dar contexto na página inicial ou combinar em arquivos CSV.

Pessoa em frio extremo segurando um termômetro externo que marca muito abaixo de zero
Ondas de frio regionais podem ser mais severas do que os apps de clima sugerem para uma garagem anexa, oficina ou porão raso. Foto: Bureau of Land Management: public domain

As sondas da garagem dizem o que aconteceu lá dentro. Um caminho paralelo por uma API de clima diz o que a atmosfera entregou: útil para relacionar a infiltração por vento, as mínimas previstas e as junções de planilha em gráficos em planilhas. Esse caminho não pode bloquear o SSR das sondas se o fornecedor de clima estiver lento.

Setas de busca em paralelo do servidor para o JSON das sondas e para a API de clima, se juntando no SSR
O servidor busca os feeds das sondas e a API de clima ao mesmo tempo, para que previsões lentas não bloqueiem as temperaturas ao vivo.

Estratégia de busca

Use Promise.allSettled ou algo equivalente: uma falha na busca das sondas ainda deve retornar a página com status 200 e um cartão de erro; uma falha do clima apenas omite a previsão na barra lateral. Os timeouts seguem os padrões da busca das sondas na página inicial.

Uso dos dados

  • Só exibição: contexto de temperatura/umidade externa no dashboard.
  • Enriquecimento do CSV: junção por blocos de hora durante a análise da exportação.
  • Não para controle: não dispare alertas de congelamento só com base na previsão.

Segredos e cache

As chaves da API de clima ficam nos secrets da Cloudflare. Mantenha as respostas em cache por mais tempo que o TTL das sondas: o documento de cache dos feeds compara as necessidades de atualização.