Tem um tempinho livre e quer aprender a desenvolver rapidamente uma app? Então vamos a isso! A proposta que temos para hoje consiste no desenvolvimento de uma pequena app de meteorologia usando para isso Node.js e a API OpenWeatherMap.
A nossa aplicação terá apenas 16 linhas de código! Não acreditam? Então vamos a isso!
Como referido, para este tutorial vamos necessitar essencialmente de duas coisas:
- Node.js – É um interpretador de código JavaScript que funciona do lado do servidor. Esta plataforma permite aos programadores o desenvolvimento de aplicações em rede, em tempo real e de alta escalabilidade, de uma forma simples e rápida. O Node.js é baseado no interpretador V8 da Google
- OpenWeatherMap – É um serviço que permite consultar informações climáticas. Este serviço tem disponível uma API público que nos permite aceder à informação climatérica de uma determinada cidade. A API irá devolver informação sobre a temperatura mínima, máxima, humidade e outras variáveis.
Para criar então uma simples App de meteorologia usando Node.js e a API OpenWeatherMap devem seguir os seguintes passos:
Passo 1 – Criar conta no site OpenWeatherMap
Para começar acedemos ao site OpenWeatherMap aqui e criamos uma conta de acesso.
Em seguida selecionamos o separador API Keys e vamos criar uma chave. Para tal, basta inserir no campo Name um nome que ficará associado à chave que for gerada.
O resultado será idêntico ao apresentado na imagem seguinte.
Uma vez criada a chave de acesso à API, vamos ao desenvolvimento da app que vai invocar a API do site OpenWeatherMap.
Passo 2 – Desenvolvimento da app
Uma vez que vamos desenvolver em NodeJS, é necessário ter o interpretador instalado no nosso sistema. Podem ver os tutoriais de instalação para Windows, Linux e macOS.
Para começar vamos criar então um diretório com o nome nodejs-weather e iniciamos o nosso projeto com o comando npm init. O resultado será algo semelhante ao apresentado na seguinte imagem.
O próximo passo é criar o ficheiro index.js. Agora que temos as “peças” todas, vamos juntá-las de forma a obter o output que pretendemos.
Invocar a API OpenWeatherMap
Vamos agora invocar a API OpenWeatherMap. Para tal podemos usar o popular módulo npm request. Para instalar este módulo basta executar o comando:
npm install request --save
Usar este módulo é relativamente simples. Para tal basta que o utilizador passe, como parâmetro, o URL e o modulo invoca o método na API e devolve o resultado.
Abram agora o ficheiro index.js e insiram o seguinte código:
let request = require('request');
let apiKey = '*****************************';
let cidade = 'Guarda';
let url = `http://api.openweathermap.org/data/2.5/weather?q=${cidade}&appid=${apiKey}&units=metric`
request(url, function (err, response, body) {
if(err){
console.log('error:', error);
} else {
console.log('body:', body);
}
});
Breves Explicações
- apiKey – Insiram a chave criada no OpenWeatherMap
- cidade – Insiram o nome da Cidade para a qual pretendem obter informação climatérica
- url: Invocação da API, onde passamos como parâmetros a cidade e a chave.
Depois de todos os passos anteriores realizados, vamos executar a aplicação e observar o resultado.
E está feito! Obviamente agora é necessário fazer um “parser” dos resultados. Esse tutorial será apresentado em breve! Caso tenham alguma dúvida ou questão relativamente a este tutorial, deixem as vossas questões em comentário.