Localização

Weather

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.

Quando possível, opte por utilizar o método de busca por WOEID, que é mais rápido e eficiente.

GEThttps://api.hgbrasil.com/weather?city_name=Curitiba,PR&key=suachave

curl -X GET "https://api.hgbrasil.com/weather?city_name=Curitiba%2CPR&key=suachave"

const url = new URL("/weather", "https://api.hgbrasil.com")

url.searchParams.set("city_name", "Curitiba,PR")
url.searchParams.set("key", "suachave")

const response = await fetch(url.href)
const data = await response.json()

$url = 'https://api.hgbrasil.com/weather';

$queryString = http_build_query([
    'city_name' => 'Curitiba,PR',
    'key' => 'suachave'
]);

$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);

import requests

url = 'https://api.hgbrasil.com/weather'

params = {
    'city_name': 'Curitiba,PR',
    'key': 'suachave'
}

response = requests.get(url, params=params)
data = response.json()

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.hgbrasil.com/weather')

uri.query = URI.encode_www_form({
  city_name: 'Curitiba,PR',
  key: 'suachave'
})

response = Net::HTTP.get(uri)
data = JSON.parse(response, symbolize_names: true)

import java.net.URI;
import java.net.http.*;

var url = "https://api.hgbrasil.com/weather?city_name=Curitiba%2CPR&key=suachave";

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .GET()
    .build();

var response = client.send(request, HttpResponse.BodyHandlers.ofString());
var data = response.body();

using System.Net.Http;
using System.Text.Json;
using System.Web;

var client = new HttpClient();
var baseUrl = "https://api.hgbrasil.com/weather";

var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["city_name"] = "Curitiba,PR";
queryParams["key"] = "suachave";

var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);

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.

GEThttps://api.hgbrasil.com/weather?woeid=455827&key=suachave

curl -X GET "https://api.hgbrasil.com/weather?woeid=455827&key=suachave"

const url = new URL("/weather", "https://api.hgbrasil.com")

url.searchParams.set("woeid", "455827")
url.searchParams.set("key", "suachave")

const response = await fetch(url.href)
const data = await response.json()

$url = 'https://api.hgbrasil.com/weather';

$queryString = http_build_query([
    'woeid' => '455827',
    'key' => 'suachave'
]);

$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);

import requests

url = 'https://api.hgbrasil.com/weather'

params = {
    'woeid': '455827',
    'key': 'suachave'
}

response = requests.get(url, params=params)
data = response.json()

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.hgbrasil.com/weather')

uri.query = URI.encode_www_form({
  woeid: '455827',
  key: 'suachave'
})

response = Net::HTTP.get(uri)
data = JSON.parse(response, symbolize_names: true)

import java.net.URI;
import java.net.http.*;

var url = "https://api.hgbrasil.com/weather?woeid=455827&key=suachave";

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .GET()
    .build();

var response = client.send(request, HttpResponse.BodyHandlers.ofString());
var data = response.body();

using System.Net.Http;
using System.Text.Json;
using System.Web;

var client = new HttpClient();
var baseUrl = "https://api.hgbrasil.com/weather";

var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["woeid"] = "455827";
queryParams["key"] = "suachave";

var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);

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.

GEThttps://api.hgbrasil.com/weather?lat=-23.5505&lon=-46.6333&key=suachave

curl -X GET "https://api.hgbrasil.com/weather?lat=-23.5505&lon=-46.6333&key=suachave"

const url = new URL("/weather", "https://api.hgbrasil.com")

url.searchParams.set("lat", "-23.5505")
url.searchParams.set("lon", "-46.6333")
url.searchParams.set("key", "suachave")

const response = await fetch(url.href)
const data = await response.json()

$url = 'https://api.hgbrasil.com/weather';

$queryString = http_build_query([
    'lat' => '-23.5505',
    'lon' => '-46.6333',
    'key' => 'suachave'
]);

$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);

import requests

url = 'https://api.hgbrasil.com/weather'

params = {
    'lat': '-23.5505',
    'lon': '-46.6333',
    'key': 'suachave'
}

response = requests.get(url, params=params)
data = response.json()

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.hgbrasil.com/weather')

uri.query = URI.encode_www_form({
  lat: '-23.5505',
  lon: '-46.6333',
  key: 'suachave'
})

response = Net::HTTP.get(uri)
data = JSON.parse(response, symbolize_names: true)

import java.net.URI;
import java.net.http.*;

var url = "https://api.hgbrasil.com/weather?lat=-23.5505&lon=-46.6333&key=suachave";

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .GET()
    .build();

var response = client.send(request, HttpResponse.BodyHandlers.ofString());
var data = response.body();

using System.Net.Http;
using System.Text.Json;
using System.Web;

var client = new HttpClient();
var baseUrl = "https://api.hgbrasil.com/weather";

var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["lat"] = "-23.5505";
queryParams["lon"] = "-46.6333";
queryParams["key"] = "suachave";

var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);

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.

GEThttps://api.hgbrasil.com/weather?user_ip=remote&key=suachave

curl -X GET "https://api.hgbrasil.com/weather?user_ip=remote&key=suachave"

const url = new URL("/weather", "https://api.hgbrasil.com")

url.searchParams.set("user_ip", "remote")
url.searchParams.set("key", "suachave")

const response = await fetch(url.href)
const data = await response.json()

$url = 'https://api.hgbrasil.com/weather';

$queryString = http_build_query([
    'user_ip' => 'remote',
    'key' => 'suachave'
]);

$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);

import requests

url = 'https://api.hgbrasil.com/weather'

params = {
    'user_ip': 'remote',
    'key': 'suachave'
}

response = requests.get(url, params=params)
data = response.json()

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.hgbrasil.com/weather')

uri.query = URI.encode_www_form({
  user_ip: 'remote',
  key: 'suachave'
})

response = Net::HTTP.get(uri)
data = JSON.parse(response, symbolize_names: true)

import java.net.URI;
import java.net.http.*;

var url = "https://api.hgbrasil.com/weather?user_ip=remote&key=suachave";

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .GET()
    .build();

var response = client.send(request, HttpResponse.BodyHandlers.ofString());
var data = response.body();

using System.Net.Http;
using System.Text.Json;
using System.Web;

var client = new HttpClient();
var baseUrl = "https://api.hgbrasil.com/weather";

var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["user_ip"] = "remote";
queryParams["key"] = "suachave";

var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);