# Modo Kiosque

> 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.

<callout color="neutral" icon="tabler:device-tv">

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

</callout>

## Acesso

```text
https://hgbrasil.com/weather/kiosk
```

## Parâmetros

<field-group>
<field name="key" type="string" :required="true">

Chave de API HG Brasil. Informada diretamente na URL — utilize uma chave com permissões de leitura.

</field>

<field name="cities" type="string">

Lista de cidades separadas por vírgula. Padrão: `São Paulo`.

</field>

<field name="refresh" type="integer">

Intervalo de atualização automática em segundos. Padrão: `3600` (1 hora).

</field>
</field-group>

## Exemplo

```text
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:

<table>
<thead>
  <tr>
    <th>
      Exibição
    </th>
    
    <th>
      Valor
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Uma cidade
    </td>
    
    <td>
      <code>
        São Paulo
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Duas cidades
    </td>
    
    <td>
      <code>
        São Paulo,Curitiba
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Três cidades
    </td>
    
    <td>
      <code>
        São Paulo,Ribeirão Preto,Curitiba
      </code>
    </td>
  </tr>
</tbody>
</table>

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

<note icon="tabler:layout-grid">

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.

</note>

## 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).

<note icon="tabler:clock">

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.

</note>

## Recomendações para TVs

<tip>

Abra a URL no modo tela cheia do navegador (`F11` no Chrome/Edge) para eliminar a barra de endereços e as abas.

</tip>

<tip>

Para TVs em orientação horizontal, recomendamos até 3 cidades. Em orientação vertical, até 2 cidades, para manter boa legibilidade à distância.

</tip>

<tip>

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.

</tip>

<warning>

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.

</warning>