O Google Charts API é uma ferramenta muito útil e interessante para quem desenvolve aplicações web e quer gerar gráficos de uma forma dinâmica. Esta API caracteriza-se pela facilidade de utilização e implementação, não sendo necessária a instalação de qualquer software ou frameworks. Para a sua utilização, basta o URL da API no qual serão referenciados os dados e características necessários para gerar o gráfico pretendido. Para começar inserimos o seguinte URL no browser:

http://chart.apis.google.com/chart?cht=p3&chd=t:60,40,30&chs=260×110&chl=Ligeiros|Motas|Pesados

Podemos ver no exemplo que foi gerado um gráfico tipo “queijo” com a percentagem de Mulheres e Homens.

Como resposta ao URL e parâmetros nele inseridos, a API gerou uma imagem PNG. Podem ser gerados outros tipos de gráficos, com diversas cores e outros atributos, é isso que iremos ver a seguir.

Formato do URL

Os parâmetros estão separados por “&”. Podem ser especificados quantos parâmetros se desejarem e pretenderem.

http://chart.apis.google.com/chart? ? Localização da Chart API
cht=p3 ? Tipo de gráfico
chd=t: 60,40,30 ? Valores do gráfico
chs=260x110 ? Dimensões do gráfico (em pixels)
chl= Ligeiros|Motas|Pesados ? Referências do gráfico (r

Claro que a utilização deste API não se resume à aplicação em URLs. Uma vez que é gerada uma imagem, é essa mesma imagem que será utilizada no layout de uma aplicação ou site. Para isso deveremos inserir a URL pretendida numa tag de imagem, como se fosse um arquivo *.jpg, *.gif ou *.png.

Seguindo o exemplo anterior, deveremos colocar a URL da seguinte forma:

<img src="http://chart.apis.google.com/chart?
chs=260x110
&amp;chd=t: 60,40,30
&amp;cht=p3
&amp;chl= Ligeiros|Motas|Pesados " 
alt="Sample chart" />

Em alguns casos (repare no exemplo) será necessária a utilização da referência &amp no lugar de “&” quando inserido na tag <img>.

Utilização de valores de bases de dados

Para aplicar um pouco mais de dinamismo aos gráficos e mais precisamente aos dados que ele representa, o Google Charts pode ser utilizado com valores de uma tabela de base de dados.

Suponhamos que tem uma tabela com entradas no site:

SELECT count(*) FROM entradas WHERE entradas.mes=\'3\'

Então os valores ficariam na forma:

&amp;chd=t: <?php echo $row_rsVAL1[\'count(*)\']; ?>, <?php echo $row_rsVAL2[\'count(*)\']; ?>, <?php echo $row_rsVAL3[\'count(*)\']; ?>