# Previsão do Tempo

> Dados meteorológicos atualizados e precisos.

O **HG Weather** é uma API que fornece dados de previsão do tempo e condições climáticas atuais para uma cidade. É possível obter a cidade desejada de várias formas diferentes, como geolocalização, IP do usuário, busca por nome ou código.

<callout color="neutral" icon="tabler:key" to="/docs/guide/key">

Para acessar os dados da API é necessário utilizar uma chave de integração.

</callout>

<note icon="tabler:clock">

Os dados meteorológicos são atualizados em intervalos de até 1 hora.

</note>

<tip>

É possível indicar o idioma de retorno da API através do parâmetro `locale`. Estão disponíveis: `pt` (português, por padrão) e `en` (inglês).

</tip>

## Requisição

Todas as requisições tem como base o seguinte endpoint:

<endpoint endpoint="/weather">



</endpoint>

<request-example endpoint="/weather">



</request-example>

Veja como é fácil obter dados de previsão do tempo para uma cidade ou região específica. Você pode fazer isso de várias maneiras, como:

- [Obter pelo nome da cidade](/docs/weather/finding#obter-pelo-nome-da-cidade);
- [Obter pelo código WOEID da cidade](/docs/weather/finding#obter-pelo-c%C3%B3digo-woeid-da-cidade);
- [Obter por coordenadas de latitude e longitude](/docs/weather/finding#obter-por-coordenadas-de-latitude-e-longitude);
- [Obter por geolocalização IP](/docs/weather/finding#obter-por-geolocaliza%C3%A7%C3%A3o-ip).

## Resposta

Exemplo de resposta no formato `JSON`.

<response-json endpoint="/weather">



</response-json>

### Campos

Os dados referentes à consulta chegam no parâmetro `results`, você também pode conferir a autenticação de sua chave no parâmetro de retorno `valid_key`.