Mostrando a Previsão do Tempo com PHP

 
 
Atenção: Este artigo/tutorial foi escrito em setembro de 2009 e seu conteúdo pode estar desatualizado. Se possível, procure artigos mais recentes.
Hoje vou mostrar pra vocês como é incrivelmente simples mostrar uma previsão do tempo no seu site usando a API de Previsão do Tempo do Google (Google Weather API).
Diferente da API de previsão do tempo do Yahoo, na do Google você identifica a cidade pelo o seu nome, não por um código alfa-numérico, o que deixa o serviço bem mais fácil e customizável… Você pode, por exemplo, mostrar a previsão do tempo da cidade que o visitante informou na hora do cadastro, é muito bom.
Outra diferença primordial entre as duas APIs é que a do Yahoo retorna apenas a previsão do tempo do dia, e a do Google retorna a previsão do tempo do dia e dos próximos três dias.
A resposta do Google vem em formato XML e vamos usar a classe SimpleXML (PHP 5) para manipular esses dados.

A URL da API

O script todo funciona de uma forma bem simples: você chama a URL da API informando a cidade, estado e o idioma de retorno e ele te responde com os dados no formato XML. A URL que iremos usar de exemplo é essa:

http://www.google.com/ig/api?weather=Rio de Janeiro,Rio de Janeiro,Brazil&hl=pt-br

Repare que passamos dois parâmetros na URL, o “weather” que é onde informaos a cidade, estado e país (Rio de Janeiro, Rio de Janeiro, Brazil)… Antes que você me chame de burro, Brasil lá fora se escreve com Z e não com S… E temos o segundo parâmetro é o “hl” que é o idioma no qual queremos a resposta (pt-br).

O Script

Primeiro nós definimos algumas variáveis que serão usadas pelo script:

01<?php
02
03// Localização
04$cidade = 'Rio de Janeiro'; // Cidade
05$estado = 'Rio de Janeiro'; // Estado (sem abreviação!)
06$pais = 'Brazil'; // País (em inglês)
07$idioma = 'pt-br'; // Idioma de resposta (pt-br)
08
09// URL principal da API
10$googleWeather = 'http://www.google.com/ig/api';
11
12?>

Depois montamos a URL que será usada para chamar as informações:

12// Montamos a URL que será chamada
13// Usamos a função urlencode() para substituir caracteres especiais
14$apiUrl = $googleWeather . '?weather=' . urlencode($cidade) . ',' . urlencode($estado) . ',' . urlencode($pais) . '&hl=' . $idioma;

Agora nós iremos pegar o resultado da API e passá-lo (em codificação UFT-8) para o SimpleXML:

16// Pegamos o resultado da API
17$resultado = file_get_contents($apiUrl);
18
19// Usamos o SimpleXML para pegar a resposta
20// O SimpleXML precisa receber valores em UTF-8, então usamos o uft8_encode()
21$xml = simplexml_load_string(utf8_encode($resultado));

Agora nós já temos todas as informações, vamos separá-las usando o método xpath() do SimpleXML:

23// Separamos as informações encontradas
24$info = $xml->xpath('/xml_api_reply/weather/forecast_information');
25$atual = $xml->xpath('/xml_api_reply/weather/current_conditions');
26$proximos = $xml->xpath('/xml_api_reply/weather/forecast_conditions');

E por fim, exibimos as informações em formato HTML:

28<h2>Previsão do Tempo - <?php echo date('d/m/Y', strtotime($info[0]->forecast_date['data'])); ?></h2>
29<p>Cidade: <?php echo $info[0]->city['data']; ?></p>
30
31<h3>Previsão Atual</h3>
32<table>
33    <tr>
34        <td><img src="http://www.google.com<?php echo $atual[0]->icon['data']; ?>" alt="weather" /></td>
35        <td><?php echo $atual[0]->temp_c['data']; ?>&deg; C<br /><?php echo $atual[0]->condition['data']; ?></td>
36    </tr>
37</table>
38
39<h3>Próximos dias</h3>
40<table>
41    <?php foreach ($proximos AS $item) { ?>
42    <tr>
43        <td><?php echo $item->day_of_week['data'];?></td>
44        <td><img src="http://www.google.com<?php echo $item->icon['data']; ?>" alt="weather" /></td>
45        <td><?php echo $item->low['data']; ?>/<?php echo $item->high['data']; ?>&deg; C<br /><?php echo $item->condition['data']; ?></td>
46    </tr>
47    <?php } ?>
48</table>

O resultado

previsao
 

O Script Completo

Faça o download do script completo aqui: http://blog.thiagobelem.net/arquivos/2009/09/gwa.txt

Considerações finais

Claro que se você fizer seu PHP buscar os dados na API todas as vezes que for exibir a previsão do tempo o seu site ficará lento… É altamente recomendável que você salve esses dados em um banco de dados ou até um arquivo XML dentro do site e use essa fonte de dados (interna) para o site.
Espero que tenham gostado! :)
Abraços!