Download the PHP package adinan-cenci/climatempo-api without Composer
On this page you can find all versions of the php package adinan-cenci/climatempo-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download adinan-cenci/climatempo-api
More information about adinan-cenci/climatempo-api
Files in adinan-cenci/climatempo-api
Package climatempo-api
Short Description Uma api para previsão de tempo escrita em PHP.
License MIT
Informations about the package climatempo-api
Climatempo API
*Read this in other languages: English
Climatempo é um serviço de previsão do tempo para cidades brasileiras. Eles oferece uma API do tipo REST para desenvolvedores e o objetivo desta biblioteca é fazer simples a requisição de previsão de tempo via dita API.
Aonde consigo o token de acesso?
Acesse advisor.climatempo.com.br e crie uma conta.
Registrando cidades ao seu token
Antes de requisitar previsões para uma cidade em específico, você precisa registrar o id daquela cidade ao seu token:
Como usar
Digamos que nós queremos a previsão para São Paulo - SP.
Nós vamos precisar do id para essa cidade:
Vai resultar em:
Cidade: São Paulo (2017-12-06):
Temp. mínima: 21 °C
Temp. máxima: 32 °C
Probab. de precipitação: %
Precipitação: mm
Frase: Sol com algumas nuvens
Cidade: São Paulo (2017-12-07):
Temp. mínima: 18 °C
Temp. máxima: 24 °C
Probab. de precipitação: 75 %
Precipitação: 2 mm
Frase: Sol e Chuva
Cidade: São Paulo (2017-12-08):
Temp. mínima: 16 °C
Temp. máxima: 20 °C
Probab. de precipitação: 75 %
Precipitação: 3 mm
Frase: Sol e Chuva
Inundação
É possivel recuperar dados sobre risco de inundação através da latitude e longitude.
Vai resultar em:
-23.18400435255711 -46.28138759172782
Valor agora: 0
Agora: 26 / Dec / 2019, 16:00:00
Valor próxima hora: 0
Próxima hora: 26 / Dec / 2019, 17:00:00
Como ter a previsão de uma cidade sem saber o ID?
Infelizmente o climatempo usa seu próprio sistema, cada cidade brasileira tem seu próprio ID. Mas você pode facilmente usar a classe Search para encontrar a cidade que procura.
Digamos que nós queremos a previsão para Rio de Janeiro - RJ:
Então você pode acessar a previsão através dos seguintes metodos:
Pesquisando
Falando em pesquisa, a classe Search nos permite a restringir a busca à estados.
O exemplo abaixo vai pesquisar por todas as cidades com "rio" no nome no estado do Rio de Janeiro.
Veja outros exemplos na pasta "examples".
Como instalar
Use composer
Licença
Licença MIT