Google Chart API — prosty sposób umieszczania wykresów na stronach WWW

2. Adresy URL

Analizując adres użyty w pierwszym przykładzie możemy wyodrębnić następujące fragmenty:

http://chart.apis.google.com/chart?
    chs=400x200&
    cht=p3&
    chd=t:1,5&
    chl=Węże|Żółwie

Bazowym adresem usługi Chart API jest więc:

http://chart.apis.google.com/chart

Po nim umieszczamy znak zapytania i serię parametrów oddzielonych znakiem & (ich kolejność może być dowolna). Pierwszy z użytych parametrów ustala wymiary wykresu. Pisząc:

chs=400x200

otrzymamy wykres, który jest obrazem PNG o szerokości 400 i wysokości 200 pikseli.

Wykresy generowane przez Google Chart API zawsze są w formacie PNG. Wymiary obrazów podlegają dwóm ograniczeniom:

maksymalna wysokość to 1000 pikseli,
obraz może mieć co najwyżej 300 tysięcy pikseli.

Największymi dopuszczalnymi wymiarami są więc: 1000x300, 300x1000, 600x500, 500x600, 800x375 i 375x800.

Drugi parametr cht o wartości p3 ustala typ wykresu. Wykres oznaczany symbolem p3 jest trójwymiarowym wykresem kołowym (ang. pie chart). Kolejny parametr chd definiuje dane wykresu. Zapis:

chd=t:1,5

powoduje, że pierwszy wycinek koła zajmie 1/6 część całości, a drugi — 5/6. Wreszcie ostatni z parametrów:

chl=Węże|Żółwie

zawiera etykiety wycinków koła. Polskie znaki kodujemy w standardzie utf-8.

Jeśli chcesz, by adres:

...chart?chs=400x200&cht=p3&chd=t:1,5&chl=Węże|Żółwie

nie powodował ostrzeżeń podczas walidacji kodu rozszerzeniem HTML Validator przeglądarki Firefox, jako separatora użyj encji & zaś polskie znaki kodowane w UTF-8 zapisz wykorzystując notację %HH:

...chart?chs=400x200&amp;chl=W%C4%99%C5%BCe%7C%C5%BB%C3%B3%C5%82wie

Polskie napisy możesz zakodować wykorzystując w PHP funkcję urlencode():

<?php
echo urlencode('Węże|Żółwie');
?>

lub w JavaScript funkcję escape():

<script type="text/javascript">
  alert(escape('Węże|Żółwie'));    
</script>