Modo Kiosque

HG BrasilWeather
Dashboard meteorológico para exibição em TVs, painéis e monitores.

O Modo Kiosque da HG Weather é uma página de dashboard pública para exibição contínua em TVs, monitores corporativos e painéis. Ela exibe temperatura atual, condição climática, mínima e máxima do dia, detalhes meteorológicos e previsão dos próximos dias em um layout visual otimizado para leitura à distância, com atualização automática e relógio ao vivo.

O Modo Kiosque é uma página do site, não um endpoint de API. Configure-a diretamente pela URL.

Acesso

https://hgbrasil.com/weather/kiosk

Parâmetros

key
string required
Chave de API HG Brasil. Informada diretamente na URL — utilize uma chave com permissões de leitura.
cities
string
Lista de cidades separadas por vírgula. Padrão: São Paulo.
refresh
integer
Intervalo de atualização automática em segundos. Padrão: 3600 (1 hora).

Exemplo

https://hgbrasil.com/weather/kiosk?key=API_KEY&cities=São Paulo,Ribeirão Preto,Curitiba&refresh=3600

Formato das cidades

Utilize o parâmetro cities para informar uma ou mais cidades. Para múltiplas cidades, separe os nomes por vírgula. Exemplos:

ExibiçãoValor
Uma cidadeSão Paulo
Duas cidadesSão Paulo,Curitiba
Três cidadesSão Paulo,Ribeirão Preto,Curitiba

Tanto o nome acentuado quanto a versão sem acento são aceitos. São Paulo e Sao Paulo funcionam da mesma forma.

Com uma única cidade, o layout exibe a previsão em tela cheia com temperatura em destaque. Com duas ou mais cidades, o layout se organiza em grade responsiva, com cada cidade em um card independente.

Atualização automática

A página atualiza os dados automaticamente conforme o intervalo definido em refresh. O padrão é de 1 hora (3600 segundos).

Os dados meteorológicos são atualizados em intervalos de até 1 hora. Definir um refresh inferior a esse valor não traz dados mais recentes — apenas consome requisições desnecessariamente.

Recomendações para TVs

Abra a URL no modo tela cheia do navegador (F11 no Chrome/Edge) para eliminar a barra de endereços e as abas.
Para TVs em orientação horizontal, recomendamos até 3 cidades. Em orientação vertical, até 2 cidades, para manter boa legibilidade à distância.
Configure o navegador ou o sistema operacional para recarregar a aba periodicamente (a cada 12 a 24 horas) como prevenção a eventuais travamentos de longa duração.
Utilize uma chave com permissões mínimas necessárias. Evite compartilhar a mesma chave de projetos em produção, pois a key fica visível na barra de endereços.