# Localização

> Obtenha dados de previsão do tempo para uma cidade ou região específica.

## Obter pelo nome da cidade

Você pode obter dados de previsão do tempo para uma cidade ou região específica utilizando o parâmetro `city_name` e com o nome da cidade desejada, por exemplo `city_name=Curitiba,PR`.

<warning>

Quando possível, opte por utilizar o [método de busca por WOEID](#obter-pelo-c%C3%B3digo-woeid-da-cidade), que é mais rápido e eficiente.

</warning>

<endpoint endpoint="/weather?city_name=Curitiba,PR">



</endpoint>

<request-example endpoint="/weather?city_name=Curitiba,PR">



</request-example>

## Obter pelo código WOEID da cidade

O **WOEID** (Where On Earth IDentifier) é um identificador único atribuído a cada localidade. Você pode obter dados de previsão do tempo para uma cidade ou região específica utilizando o parâmetro `woeid`.

<endpoint endpoint="/weather?woeid=455827">



</endpoint>

<request-example endpoint="/weather?woeid=455827">



</request-example>

## Obter por coordenadas de latitude e longitude

Através dos parâmetros `lat` e `lon`, você pode obter dados de previsão do tempo para uma cidade ou região específica utilizando as coordenadas de latitude e longitude. Por exemplo, para São Paulo - SP, você pode utilizar `lat=-23.5505&lon=-46.6333`.

<endpoint endpoint="/weather?lat=-23.5505&lon=-46.6333">



</endpoint>

<request-example endpoint="/weather?lat=-23.5505&lon=-46.6333">



</request-example>

## Obter por geolocalização IP

Alterativamente, você pode obter dados de previsão do tempo utilizando o parâmetro `user_ip`, onde é possível informar um endereço IP no formato `0.0.0.0` ou `remote` para que o sistema busque automaticamente a localização aproximada do usuário através do IP de quem está acessando a API.

<endpoint endpoint="/weather?user_ip=remote">



</endpoint>

<request-example endpoint="/weather?user_ip=remote">



</request-example>