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!
-
Operando normamente
Aplicação API: OK
Website: OK
HG Console: OK
Rotinas: OK
Fontes de dados: OK
HG Weather: OK
- Latência: 38.12 ms
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.
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;
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;
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.
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:
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 ºCdate
- data da consulta, em fuso horário do localtime
- hora da consulta, em fuso horário do localcondition_code
- código da condição de tempo atual veja a listadescription
- descrição da condição de tempo atual no idioma escolhidocurrently
- retorna se está de dia ou de noite no idioma escolhidocid
- antigo identificador da cidade, pode não estar presente em alguns casoscity
- nome da cidade seguido por uma vírgula (mantido para as libs antigas)humidity
- umidade atual em percentualcloudiness
- nebulosidade em percentual, de 0 a 100NOVO
rain
- volume de chuva em mm na última horaNOVO
wind_speedy
- velocidade do vento em km/hwind_direction
- direção do vento em grauNOVO
wind_cardinal
- direção do vento em ponto cardealNOVO
sunrise
- nascer do Sol em horário local da cidadesunset
- pôr do Sol em horário local da cidademoon_phase
- fase da Lua veja a listaNOVO
condition_slug
- slug da condição de tempo atual veja a listacity_name
- nome da cidadetimezone
- fuso horário da cidade-
forecast
- array com a previsão do tempo para outros diasdate
- data da previsão dd/mmweekday
- dia da semana abreviadomax
- temperatura máxima em ºCmin
- temperatura mínima em ºChumidity
- umidade prevista em percentualcloudiness
- nebulosidade em percentual, de 0 a 100NOVO
rain
- volume de chuva esperadoNOVO
rain_probability
- probabilidade de chuva em percentual, de 0 a 100NOVO
wind_speedy
- velocidade do vento em km/hNOVO
sunrise
- nascer do Sol em horário local da cidadesunset
- pôr do Sol em horário local da cidademoon_phase
- fase da Lua veja a listaNOVO
description
- descrição da previsãocondition
- slug da condição veja a lista
Você pode personalizar o resultado da consulta omitindo alguns dados veja como.
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
Basta você substituir o retorno do condition_slug no nome da imagem.
Exemplo:
Fases da Lua
Basta você substituir o retorno do moon_phase no nome da imagem.
Exemplo:
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ódigocity_name
- string com o nome da cidadelat
/lon
- float com a latitude e longitude da cidadeuser_ip
- IP de seu usuário exemplo000.000.000.000
ou envieremote
para o sistema obter o IP com base no cliente
Os dados históricos são obtidos a partir de uma data passada.
Você pode escolher a data por 3 tipos de filtros diferentes:
Por intervalo de datas:
start_date
- data de inicio, stringyyyy-mm-dd
end_date
- data de término, stringyyyy-mm-dd
Por data única:
date
- data de inicio, stringyyyy-mm-dd
ouyesterday
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.
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 exemplo000.000.000.000
ou envieremote
para o sistema obter o IP com base no cliente.
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.
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.
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.
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.
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.
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.