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!

Sua aplicação fica muito mais completa com nossas APIs

A HG Brasil sempre prezou pela qualidade das APIs, neste ano de 2019, comemoramos 10 anos no ar!

Nossas APIs foram feitas de desenvolvedor para desenvolvedor, documentações completas e objetivas, sem enrolação.
Em poucos minutos e com uma única chave de acesso, você tem acesso à todos os nossos dados na sua aplicação.

Seja o dólar, uma ação, o bitcoin, um índice, como está o tempo, como vai estar o tempo, a geolocalização por IP e muito mais...
Comece agora! Os principais dados possuem acesso gratuito!

Documentação completa Bibliotecas Criar chave gratuita
Status
  • Operando normamente
    Aplicação API: OK
    Website: OK
    HG Console: OK
    Rotinas: OK
    Fontes de dados: OK
    HG Weather: OK
  • Requisições hoje: 38.676
  • Latência: 31.55 ms
Download da biblioteca em PHP Download da biblioteca em JS Gem para integração Ruby

Cidades que consultaram nas últimas 24 horas

Histórico de temperatura em Ribeirão Preto


Radar de chuvas SP

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:

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
  • time - hora da consulta
  • 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
  • wind_speedy - velocidade do vento em km/h
  • sunrise - nascer do sol em horário local da cidade
  • sunset - pôr do sol em horário local da cidade
  • condition_slug - slug da condição de tempo atual veja a lista
  • city_name - nome 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
    • 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":17,"date":"08/10/2019","time":"04:30","condition_code":"28","description":"Tempo nublado","currently":"noite","cid":"","city":"Sao Paulo,","img_id":"28n","humidity":82,"wind_speedy":"3.1 km/h","sunrise":"05:40 am","sunset":"06:07 pm","condition_slug":"cloudly_night","city_name":"Sao Paulo","forecast":[{"date":"09/10","weekday":"Qua","max":24,"min":16,"description":"Chuvas esparsas","condition":"rain"},{"date":"10/10","weekday":"Qui","max":28,"min":15,"description":"Tempo nublado","condition":"cloudly_day"},{"date":"11/10","weekday":"Sex","max":31,"min":17,"description":"Tempo nublado","condition":"cloudly_day"},{"date":"12/10","weekday":"Sáb","max":31,"min":19,"description":"Chuvas esparsas","condition":"rain"},{"date":"13/10","weekday":"Dom","max":22,"min":21,"description":"Parcialmente nublado","condition":"cloud"}],"latitude":-23.5489,"longitude":-46.6388},"execution_time":0.0,"from_cache":true}

Obter cidade por código WOEID ou CID

Com este método, informamos os dados de tempo no código WOEID (Where On Earth IDentifier, identificador onde na terra em inglês) de cidade. CID ainda funciona porém foi descontinuado.

Parâmetro de consulta: woeid
Requer chave: não



Você pode buscar o código de sua cidade nas ferramentas do HG Weather.

Buscar cidade

 

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

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.