Widget de previsão do tempo para TYPO3

Site de turismo que não mostra o tempo agora desperdiça uma informação muito procurada

Quem pesquisa no Google “previsão do tempo Gramado”, “Fernando de Noronha agora” ou “tempo no Algarve” espera encontrar o tempo no site do destino. Se a informação não está lá, o visitante sai da página e abre um aplicativo de previsão do tempo. É uma oportunidade perdida, porque o visitante já estava no site certo. O weather2 integra dados meteorológicos atuais ao TYPO3: temperatura, condições do tempo, chuva, vento, umidade e previsão para vários dias. Os dados vêm do OpenWeatherMap ou de APIs equivalentes e são atualizados num intervalo configurável. Para sites de turismo, portais de eventos ao ar livre e portais regionais de notícias, é uma função padrão, que o visitante espera encontrar.

Portal de destino, camping e estação de esqui: onde o tempo decide a visita

O cenário mais comum é o portal de turismo de uma região. A secretaria de turismo de uma cidade do litoral catarinense mostra na página inicial o tempo agora: 22 graus, sol, água a 19 graus. Ao lado, a previsão para cinco dias. Quem planeja um passeio de um dia recebe na hora a informação que importa e fica na página para reservar atividades. A temperatura da água vem de um endpoint de API separado ou é mantida manualmente.

O segundo cenário são campings e pousadas. Um camping na Serra da Mantiqueira mostra na página de reservas a previsão da semana seguinte. Quem está em dúvida entre duas semanas de viagem pode usar a previsão para decidir. Para quem administra o camping, é um argumento de conversão: “Vai fazer sol, reserve agora.”

Terceiro cenário: estações de esqui e eventos ao ar livre. Uma estação de esqui (em Portugal, a da Serra da Estrela) mostra a temperatura no alto e no vale, a altura da neve (de uma fonte de dados separada) e a velocidade do vento. No Brasil, a mesma lógica serve a uma escola de surfe: vento pelo weather2, ondulação de uma fonte de dados separada. Um festival ao ar livre mostra a previsão para o fim de semana do evento. Em todos esses casos, a informação do tempo traz um valor concreto que mantém o visitante no site.

A API é consultada no servidor, e os dados ficam em cache local

A extensão weather2 se comunica com a API do OpenWeatherMap (ou, como alternativa, com provedores como WeatherAPI, Visual Crossing e Meteostat). A configuração no backend do TYPO3 define a chave de API, o local (coordenadas ou nome da cidade), as unidades (métricas ou imperiais), o idioma e o intervalo de atualização. O intervalo padrão é de 30 minutos: a cada 30 minutos, uma requisição vai ao OpenWeatherMap, e a resposta fica em cache no banco de dados do TYPO3.

O plugin de frontend renderiza os dados por templates Fluid: temperatura atual, ícone do tempo (sol, nuvens, chuva), descrição em texto, vento e umidade. A previsão para vários dias mostra a mínima e a máxima de cada dia, para três a sete dias. Os ícones são entregues em SVG, e não como URLs de imagens externas, para que nenhuma requisição extra vá a servidores de terceiros.

Quanto à chave de API, o OpenWeatherMap oferece um plano gratuito com 1.000 chamadas por dia, o que sobra para um intervalo de 30 minutos (48 chamadas por dia). Sites com vários locais (por exemplo, uma secretaria de turismo com 10 cidades) precisam de 480 chamadas por dia, ainda dentro do plano gratuito. Os planos pagos (a partir de 40 dólares por mês) oferecem atualizações de hora em hora e dados ampliados, como índice UV e concentração de pólen.

Limite da API, cache e dados velhos são as armadilhas mais comuns

O problema mais comum é estourar o limite da API. Se o cache do TYPO3 não está configurado corretamente e cada acesso à página dispara uma chamada à API, o limite de 1.000 chamadas do plano gratuito se esgota em poucas horas. A extensão deixa então de mostrar dados ou mostra um erro. A solução: garantir que os dados do tempo fiquem no cache do TYPO3 e não sejam buscados de novo a cada requisição do frontend. Esse cache precisa funcionar independentemente do cache de página (tarefa do Scheduler ou entrada de cache própria).

Segundo problema: dados do tempo desatualizados. Se a tarefa do Scheduler não roda (cron desativado, migração de servidor), o site mostra dados de dias ou semanas atrás. Isso é pior do que não mostrar nada. A solução: incluir no template Fluid uma verificação que confira se os dados em cache têm mais de duas horas e, nesse caso, esconda o widget em vez de exibir dados errados.

Terceiro ponto: proteção de dados. Se o navegador busca os dados do tempo direto na API via JavaScript, ele transmite o IP do visitante ao provedor da API. É uma transferência de dados a terceiros, relevante para a LGPD (PT: RGPD). A solução do lado do servidor (o servidor TYPO3 consulta a API, não o navegador) evita o problema.

O TYPO3 v12 é suportado, e a integração com a API se mantém estável entre versões

O weather2 usa a biblioteca de cliente HTTP do TYPO3 para as requisições à API e templates Fluid para a renderização. As duas são estáveis no core do TYPO3. No v12, a extensão roda sem problemas. Para o v13, bastam ajustes mínimos (registro da tarefa do Scheduler, configuração do plugin). Como a lógica central (requisição HTTP, parsing de JSON, gravação no banco de dados) é padronizada, a extensão exige pouca manutenção nos upgrades do TYPO3. A Gosign configura widgets de previsão do tempo como parte de projetos de sites de turismo e garante que o cache da API, a verificação de dados antigos e a proteção de dados estejam implementados corretamente.