HG Weather

Tenha Previsão do Tempo no seu site de uma maneira simples e funcional.
Veja como é fácil implementar, comece agora, serviço gratuito!

O HG Weather está há mais de 15 anos no ar

A mais completa API de dados meteorológicos, simples e prático de implementar!

Status
  • Operando normamente
    Aplicação API: OK
    Website: OK
    HG Console: OK
    Rotinas: OK
    Fontes de dados: OK
    HG Weather: OK
  • Latência: 31.4 ms
Download da biblioteca em PHP Download da biblioteca em JS Gem para integração Ruby
Planos e Preços Obter suporte

Cidades que consultaram nas últimas 24 horas

Veja exemplos de dados reais e como implementar

A melhor e mais completa API de meteorologia do Brasil, incluindo dados históricos

Simplicidade para implementar

Documentação objetiva, com qualidade nos retornos e segurança.

Serviço 100% brasileiro

Foco no mercado nacional, com cobrança em real sem surpresas e atendimento em português.

Desde 2009 no mercado

Confiança e qualidade de quem já está há anos no mercado de fornecimento de dados.

Chamada para API

Simples e prático

Todos os dados que você precisa, no menor número de requisições possível.

Condição climática atual de qualquer cidade do país;

Previsão diária para até 10 dias;

Probabilidade de chuva para próximos dias;

Direção e velocidade do vento;

Temos novidade!
Níveis de nebulosidade e volume de chuvas;
Dados históricos de meteorologia via API;

Busque a cidade por nome, geolocalização, IP ou código;

Veja a documentação completa

Desenvolvido de programador para programador

API sem complicações.
Nada de autenticações e métodos complexos.

Documentação completa e direto ao ponto, sem enrolação.

Autenticação simples via parâmetro GET;

Respostas completas em uma única requisição;

Liberado para no navegador (CORS);

Exemplos de respostas;

Bibliotecas para download;

Crie sua chave agora mesmo
Segunda chamada para API

São Paulo - SP

Histórico de temperatura em São Paulo


Introdução

O HG Weather é uma API que fornece dados de previsão do tempo e condições climáticas atuais para uma cidade.
API fácil de implementar, com respostas e parâmetros objetivos, com bibliotecas em PHP, Ruby e JavaScript.

Você pode obter a cidade desejada de várias formas diferentes, como geolocalização, IP do usuário, busca por nome ou código.
Recomendamos que sempre use sua chave em todas as requisições.

Criar nova chave

O idioma de resposta da API pode ser configurado através do parâmetro locale.
Estão disponíveis: pt, en. (pt é o padrão)

Mesmo que sua aplicação não seja com essas linguagens, abaixo você pode conferir como integrar a API.
Todos esses dados de uma cidade são retornados na mesma requisição de uma só vez, sendo esses dados:

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

https://api.hgbrasil.com/weather

Estrutura de dados

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.

  • temp - temperatura atual em ºC
  • date - data da consulta, em fuso horário do local
  • time - hora da consulta, em fuso horário do local
  • condition_code - código da condição de tempo atual veja a lista
  • description - descrição da condição de tempo atual no idioma escolhido
  • currently - retorna se está de dia ou de noite no idioma escolhido
  • cid - antigo identificador da cidade, pode não estar presente em alguns casos
  • city - nome da cidade seguido por uma vírgula (mantido para as libs antigas)
  • humidity - umidade atual em percentual
  • cloudiness - nebulosidade em percentual, de 0 a 100 NOVO
  • rain - volume de chuva em mm na última hora NOVO
  • wind_speedy - velocidade do vento em km/h
  • wind_direction - direção do vento em grau NOVO
  • wind_cardinal - direção do vento em ponto cardeal NOVO
  • sunrise - nascer do Sol em horário local da cidade
  • sunset - pôr do Sol em horário local da cidade
  • moon_phase - fase da Lua veja a lista NOVO
  • condition_slug - slug da condição de tempo atual veja a lista
  • city_name - nome da cidade
  • timezone - fuso horário da cidade
  • forecast - array com a previsão do tempo para outros dias
    • date - data da previsão dd/mm
    • weekday - dia da semana abreviado
    • cloudiness - nebulosidade em percentual, de 0 a 100 NOVO
    • rain - volume de chuva esperado NOVO
    • rain_probability - probabilidade de chuva em percentual, de 0 a 100 NOVO
    • wind_speedy - velocidade do vento em km/h NOVO
    • max - temperatura máxima em ºC
    • min - temperatura mínima em ºC
    • description - descrição da previsão
    • condition - slug da condição veja a lista

Você pode personalizar o resultado da consulta omitindo alguns dados veja como.

Exemplo de resposta JSON
{"by":"woeid","valid_key":true,"results":{"temp":22,"date":"24/04/2024","time":"21:08","condition_code":"27","description":"Tempo limpo","currently":"noite","cid":"","city":"São Paulo, SP","img_id":"27n","humidity":76,"cloudiness":0.0,"rain":0.0,"wind_speedy":"5.66 km/h","wind_direction":180,"wind_cardinal":"S","sunrise":"06:23 am","sunset":"05:44 pm","moon_phase":"full","condition_slug":"clear_night","city_name":"São Paulo","timezone":"-03:00","forecast":[{"date":"24/04","weekday":"Qua","max":29,"min":19,"cloudiness":29.0,"rain":0.0,"rain_probability":0,"wind_speedy":"4.49 km/h","description":"Parcialmente nublado","condition":"cloud"},{"date":"25/04","weekday":"Qui","max":26,"min":20,"cloudiness":69.0,"rain":0.1,"rain_probability":26,"wind_speedy":"5.61 km/h","description":"Chuvas esparsas","condition":"rain"},{"date":"26/04","weekday":"Sex","max":28,"min":19,"cloudiness":7.0,"rain":0.0,"rain_probability":0,"wind_speedy":"3.79 km/h","description":"Tempo limpo","condition":"clear_day"},{"date":"27/04","weekday":"Sáb","max":30,"min":20,"cloudiness":6.0,"rain":0.0,"rain_probability":0,"wind_speedy":"5.34 km/h","description":"Tempo limpo","condition":"clear_day"},{"date":"28/04","weekday":"Dom","max":31,"min":21,"cloudiness":2.0,"rain":0.0,"rain_probability":0,"wind_speedy":"5.29 km/h","description":"Tempo limpo","condition":"clear_day"},{"date":"29/04","weekday":"Seg","max":32,"min":22,"cloudiness":0.0,"rain":0.0,"rain_probability":0,"wind_speedy":"3.61 km/h","description":"Tempo limpo","condition":"clear_day"},{"date":"30/04","weekday":"Ter","max":31,"min":22,"cloudiness":0.0,"rain":0.0,"rain_probability":0,"wind_speedy":"3.67 km/h","description":"Tempo limpo","condition":"clear_day"},{"date":"01/05","weekday":"Qua","max":32,"min":21,"cloudiness":2.0,"rain":0.0,"rain_probability":0,"wind_speedy":"5.3 km/h","description":"Tempo limpo","condition":"clear_day"},{"date":"02/05","weekday":"Qui","max":31,"min":21,"cloudiness":0.0,"rain":0.0,"rain_probability":0,"wind_speedy":"6.43 km/h","description":"Tempo limpo","condition":"clear_day"},{"date":"03/05","weekday":"Sex","max":32,"min":21,"cloudiness":0.0,"rain":0.0,"rain_probability":0,"wind_speedy":"7.59 km/h","description":"Tempo limpo","condition":"clear_day"}],"latitude":-23.5329,"longitude":-46.6395},"execution_time":0.0,"from_cache":true}

Galeria de Imagens

Fornecemos imagens que podem ser utilizadas para representar os dados que são retornados na API.

Ícones de Condição Climática

tempestade neve granizo chuva neblina dia limpo noite limpa nublado nublado de dia nublado de noite

Basta você substituir o retorno do condition_slug no nome da imagem.
Exemplo:

https://assets.hgbrasil.com/weather/icons/conditions/rain.svg
  ou   Fazer download das imagens

Fases da Lua

Lua nova Lua crescente Quarto crescente Gibosa crescente Lua cheia Gibosa minguante Quarto minguante Lua minguante

Basta você substituir o retorno do moon_phase no nome da imagem.
Exemplo:

https://assets.hgbrasil.com/weather/icons/moon/full.png
  ou   Fazer download das imagens

Obtendo histórico de dados meteorológicos

Novidade!

Este endpoint acabou de sair do forno!

Com este método, você pode acessar dados históricos registrados pela API.
Esse método necessita da contratação de um plano que tenha suporte à dados históricos HG Weather.

Conheça nossos planos

Requer chave: sim
Cidades disponíveis: somente cidades brasileiras
Requer plano: sim (com suporte à dados históricos HG Weather)

Para buscar por uma cidade, você pode utilizar as mesmas formas de busca para cidades da API de dados atuais:

Somente um é necessário.

  • woeid - código da cidade, encontrar código
  • city_name - string com o nome da cidade
  • lat / lon - float com a latitude e longitude da cidade
  • user_ip - IP de seu usuário exemplo 000.000.000.000 ou envie remote para o sistema obter o IP com base no cliente

Os dados históricos são obtidos a partir de uma data passada.

https://api.hgbrasil.com/weather/historical?key=SUA-CHAVE&woeid=455903&days_ago=3&mode=all


Você pode escolher a data por 3 tipos de filtros diferentes:
Por intervalo de datas:
  • start_date - data de inicio, string yyyy-mm-dd
  • end_date - data de término, string yyyy-mm-dd

Por data única:
  • date - data de inicio, string yyyy-mm-dd ou yesterday para obter o dia anterior

Por número de dias atrás:
  • days_ago - número de dias atrás, inteiro

Somente um filtro desses 3 acima pode ser escolhido.
Lembre-se que a data consultada deve estar dentro dos limites de dados históricos de weather para seu plano.

Juntamente com uma das datas acima, você pode:

Obter todos os dados, ou somente um usando o filtro mode:
  • mode - string
    - all: retorna todos os dados históricos
    - hourly: retorna somente os registros por hora
    - summary: retorna somente o resumo

Somente um filtro acima pode ser utilizado.

Exemplo de resposta
{"by":"days_ago","mode":"all","valid_key":true,"city_woeid":455827,"results":{"2024-04-21":{"city":"São Paulo, SP","sunrise":"06:22 am","sunset":"05:47 pm","temp":{"max":28.0,"min":16.0,"avg":20.5},"humidity":{"max":93.0,"min":39.0,"avg":75.6},"cloudiness":{"max":100.0,"min":0.0,"avg":24.1},"rain":{"max":0.0,"min":0.0,"avg":0.0},"wind_speedy":{"max":4.1,"min":1.0,"avg":2.7},"hourly":{"00:18":{"temp":17,"humidity":88,"cloudiness":0.0,"rain":0.0,"wind_speedy":"3.09 km/h","wind_direction":160,"condition_code":"27","condition_slug":"clear_night"},"01:08":{"temp":17,"humidity":91,"cloudiness":20.0,"rain":0.0,"wind_speedy":"2.57 km/h","wind_direction":150,"condition_code":"29","condition_slug":"cloudly_night"},"02:07":{"temp":16,"humidity":91,"cloudiness":20.0,"rain":0.0,"wind_speedy":"2.57 km/h","wind_direction":150,"condition_code":"29","condition_slug":"cloudly_night"},"03:08":{"temp":16,"humidity":93,"cloudiness":0.0,"rain":0.0,"wind_speedy":"2.06 km/h","wind_direction":150,"condition_code":"27","condition_slug":"clear_night"},"04:07":{"temp":16,"humidity":92,"cloudiness":74.0,"rain":0.0,"wind_speedy":"1.03 km/h","wind_direction":0,"condition_code":"28","condition_slug":"cloudly_night"},"05:07":{"temp":17,"humidity":89,"cloudiness":100.0,"rain":0.0,"wind_speedy":"4.12 km/h","wind_direction":50,"condition_code":"28","condition_slug":"cloudly_night"},"06:07":{"temp":17,"humidity":90,"cloudiness":100.0,"rain":0.0,"wind_speedy":"4.12 km/h","wind_direction":50,"condition_code":"28","condition_slug":"cloudly_night"},"07:07":{"temp":17,"humidity":89,"cloudiness":75.0,"rain":0.0,"wind_speedy":"3.6 km/h","wind_direction":50,"condition_code":"20","condition_slug":"fog"},"08:08":{"temp":17,"humidity":90,"cloudiness":75.0,"rain":0.0,"wind_speedy":"2.06 km/h","wind_direction":70,"condition_code":"20","condition_slug":"fog"},"09:13":{"temp":18,"humidity":83,"cloudiness":75.0,"rain":0.0,"wind_speedy":"2.57 km/h","wind_direction":50,"condition_code":"28","condition_slug":"cloudly_day"},"10:11":{"temp":19,"humidity":85,"cloudiness":40.0,"rain":0.0,"wind_speedy":"2.06 km/h","wind_direction":50,"condition_code":"29","condition_slug":"cloud"},"11:13":{"temp":23,"humidity":68,"cloudiness":0.0,"rain":0.0,"wind_speedy":"2.06 km/h","wind_direction":350,"condition_code":"27","condition_slug":"clear_day"},"12:16":{"temp":25,"humidity":61,"cloudiness":0.0,"rain":0.0,"wind_speedy":"3.6 km/h","wind_direction":330,"condition_code":"27","condition_slug":"clear_day"},"13:18":{"temp":26,"humidity":55,"cloudiness":0.0,"rain":0.0,"wind_speedy":"2.06 km/h","wind_direction":0,"condition_code":"27","condition_slug":"clear_day"},"14:23":{"temp":27,"humidity":46,"cloudiness":0.0,"rain":0.0,"wind_speedy":"3.09 km/h","wind_direction":280,"condition_code":"27","condition_slug":"clear_day"},"15:25":{"temp":28,"humidity":39,"cloudiness":0.0,"rain":0.0,"wind_speedy":"3.09 km/h","wind_direction":310,"condition_code":"27","condition_slug":"clear_day"},"16:33":{"temp":27,"humidity":47,"cloudiness":0.0,"rain":0.0,"wind_speedy":"2.57 km/h","wind_direction":300,"condition_code":"27","condition_slug":"clear_day"},"17:43":{"temp":25,"humidity":57,"cloudiness":0.0,"rain":0.0,"wind_speedy":"4.12 km/h","wind_direction":170,"condition_code":"27","condition_slug":"clear_day"},"18:47":{"temp":22,"humidity":73,"cloudiness":0.0,"rain":0.0,"wind_speedy":"3.6 km/h","wind_direction":150,"condition_code":"27","condition_slug":"clear_night"},"19:39":{"temp":21,"humidity":75,"cloudiness":0.0,"rain":0.0,"wind_speedy":"3.09 km/h","wind_direction":150,"condition_code":"27","condition_slug":"clear_night"},"20:42":{"temp":21,"humidity":76,"cloudiness":0.0,"rain":0.0,"wind_speedy":"1.54 km/h","wind_direction":90,"condition_code":"27","condition_slug":"clear_night"},"21:37":{"temp":20,"humidity":79,"cloudiness":0.0,"rain":0.0,"wind_speedy":"1.54 km/h","wind_direction":150,"condition_code":"27","condition_slug":"clear_night"},"22:24":{"temp":20,"humidity":80,"cloudiness":0.0,"rain":0.0,"wind_speedy":"2.06 km/h","wind_direction":60,"condition_code":"27","condition_slug":"clear_night"},"23:12":{"temp":20,"humidity":77,"cloudiness":0.0,"rain":0.0,"wind_speedy":"2.06 km/h","wind_direction":60,"condition_code":"27","condition_slug":"clear_night"}}}},"execution_time":0.81,"from_cache":false}

O sistema obtem os dados e faz o cálculo diário para cada retorno, a fim de obter o máxima, média e mínima para cada dado.

Obtenha a cidade pelo IP

Com muita facilidade, obtenha os dados climáticos de seu usuário através de geolocalização por IP!
Sem custo adicional, veja como é simples abaixo:

Obter cidade por localicação de IP

Com este método, informamos os dados de tempo baseado na localização por IP, o sistema busca uma localização aproximada do seu usuário pelo endereço IP.

Caso o mesmo IP tenha feito uma consulta via geolocalização, o sistema utilizará esse dado salvo anteriormente.
A busca pode não ser exata, podendo variar de acordo com a região.

Requer chave: sim

Parâmetros
  • user_ip - IP de seu usuário exemplo 000.000.000.000 ou envie remote para o sistema obter o IP com base no cliente.
https://api.hgbrasil.com/weather?key=SUA-CHAVE&user_ip=remote

 

Veja nossa documentação completa!

Nossa documentação é simples e intuitiva, veja como é simples integrar sua aplicação às APIs HG Brasil!
Clara, simples e objetiva, feita de desenvolvedor para desenvolvedor.

Ver documentação
Chamada para a documentação

Exoneração de responsabilidade

API para fins informativos. Não garantimos a precisão dos dados fornecidos pela API ou contidos nesta página, uma vez que devem ser utilizados apenas para efeitos informativos. Trabalhamos pela estabilidade e precisão dos dados, porém, os dados podem estar atrasados ou errados "no estado em que se encontram", confirme todos os dados antes de efetuar qualquer ação que possa ser afetada por estes valores, assim como demais endpoints da API.

Qualquer dúvida verifique nossos termos de uso ou entre em contato.

Estamos aqui para tirar suas dúvidas

Colocamos aqui algumas dúvidas frequentes que recebemos. Para mais
informações, por favor entre em contato conosco.

Contato por e-mail Abrir um chamado de suporte
Q.

Funciona na minha liguagem de programação?

Sim! Nossa API pode ser implementada em qualquer linguagem de programação. Utilizamos padrão de mercado, com documentação completa e objetiva.

Q.

O que acontece quando utilizo todo o meu limite?

Quando seu limite é excedido, novas consultas não serão mais permitidas dentro do período. Mas não se preocupe, caso venha a ocorrer, você receberá um e-mail notificando.

Q.

Como funciona o plano gratuito?

Quase todos os retornos estão presentes no plano gratuito, salvo algumas exceções. O que muda é o volume de consultas que você pode fazer. Saiba mais em nossos planos.

Q.

Existe período de testes?

Não, mas caso venha a contratar um de nossos planos, e o serviço não lhe atenda, dentro dos 7 primeiros dias fazemos o reembolso integral do valor pago.