Подключить необходимую библиотеку можно двумя способами. Первый — тривиальный, с помощью HTML-элемента script.

<script src="http://ajax.googleapis.com/
    ajax/libs/prototype/1.6.0.2/prototype.js"></script>

Как не сложно догадаться, вместо prototype/1.6.0.2 можно указать название любого другого фреймворка и его версии.

Второй способ более гибок. С помощью специального JS-метода google.load() можно задавать версию библиотеки не точно, а по первым цифрам.

<script src="http://www.google.com/jsapi"></script>
<script>
google.load("prototype", "1.6");
// …
</script>

Заданное в примере значение «1.6» означает то, что будет автоматически выбрана самая свежая версия prototype в ветке 1.6. Таким образом, AJAX Libraries API может обеспечить автообновление JS-библиотек без каких-либо изменений в вызывающем скрипте (естветсственно, такое обновление ограничивается пределами нужной ветки).

К основным плюсам использования AL API можно отнести следующие:

• Хранение скриптов на Google в некоторой степени снижает нагрузку на собственный веб-сервер.
• Скорость загрузки страниц увеличивается, благодаря переносу части запросов на другой хост и поддержке gz-сжатия.
• При массовом использовании централизованно-хранимых фреймворков, кэш браузеров используется эффективнее. Файл, загруженный для одного веб-приложения, может быть повторно использован при работе с другим, использующим тот же фреймворк. Пока это лишь потенциальный бенефит сервиса, но, тем не менее, приятный.
• Кроме того, благодаря Google можно облегчать дистрибутивы веб-приложений, использующих JS-фреймворки.

Ссылки по теме

• Официальный анонс AJAX Search API.
• Подробное описание метода google.load().
• Developer’s Guide, содержащий список поддерживаемых фреймворков с номерами версий.
• Announcing AJAX Libraries API: Speed up your Ajax apps with Google’s infrastructure @ ajaxian.com

Проще говоря, теперь любой желающий сможет в своих проектах пользоваться распределенной базой данных Google, системой авторизации Google Accounts и другими элементами их инфраструктуры. Работающие на базе App Engine приложения смогут без труда выдерживать такую нагрузку, которую вне Google возможно было бы получить только за довольно немалые деньги. А именно, по усредненной оценке, выделенных ресурсов должно быть достаточно на 5 миллионов загрузок страниц в месяц (ограничение дискового пространства — 500 Мб, а трафика — 10 Gb в сутки).

App Engine находится еще на стадии разработки и то, что доступно сечас, — это демонстрационная версия. На официальном сайте можно скачать SDK и зарегистрировать себе аккаунт для публикации в сети своих приложений.

SDK представляет собой работающий локально веб-сервер, на котором эмулируется среда App Engine (кстати, все написано на Python). Приложения, разработанные и отлаженные в этой среде, можно без каких-либо изменений переносить на «настоящие» сервера Google. Кстати, дистрибутив SDK занимает всего 2.5 Мб. Правда, в комплект поставки обязательно должен входить Python 2.5, который весит еще 12.

Стоит отметить, что по заявлению разработчиков, GAE не будет жестко связан с конкретным языком программирования. Первым поддерживаемым языком стал Python (2.5, естесственно). Выбор следующего языка будет основан на мнении потенциальных пользователей. Мне самому кажется, что следующим будет либо Java, либо Ruby.

В докладе на Campfire несколько раз подчеркнули, что поддержка Python — полная, включающая все сторонние библиотеки и любые фреймворки. Можно использовать Django, CherryPy, Pylons и web.py. Любимый многими Django даже включен в комплект SDK и используется в демонстрационном примере, при создании гостевой книги.

Особый интерес представляет собой административная панель Apps Engine.
С ее помощью можно мониторить работу приложений и управлять версиями. Панель демонстрировали в том же докладе, но попробовать вживую пока не получилось (как я уже говорил, аккаунт мне еще не открыли).

В заключении, еще одна деталь: к проектам, работающим на Apps Engine, можно будет привязывать собственные доменные имена, либо беплатно размещать их на субдоменах appspot.com.

Анонс Google App Engine на Campfire (7/04/2008)

Ссылки по теме

• Официальный сайт Google Apps Engine.
• Страница загрузки SDK.
• Описание установки и пример использования основных средств SDK для написания простого приложения.
• Python — страница скачивания.

Тем не менее, для того чтобы все правильно настроить, потребуется совершить определенные телодвижения, связанные с корректированием MX записей в DNS. И если отсутствует опыт или понимание сути выполняемых операций, становится довольно легко что-нибудь сломать, сделав почтовые сервера временно недоступными (и соответственно, потерять пришедшую за это время почту).

Совсем недавно, возможно даже сегодня, в контрольной панели Dreamhost появилась возможность очень просто включить сервисы Google для любого из своих доменов, избежав тем самым рутинной настройки и избавив себя от риска поломать DNS.

Gmail и Google Apps могут быть включены отдельно — для того и другого нужно просто поставить соответствующую галку в настройках домена. При этом автоматически создадуться субдомены mail.yourdomain.com, calendar.yourdomain.com, docs.yourdomain.com, sites.yourdomain.com и start.yourdomain.com. Ну а если вдруг вам нравится делать сайты Page Creator-ом, можно полностью отвести домен под сервисы Google:

Помимо всего прочего, на Dreamhost есть довольно щедрая партнерская программа. Каждому клиенту, который «приведет друга» они кладут на счет 97$, при этом ограниченную часть этих денег (до 50$) можно потратить в пользу нового клиента. Например, можно сделать ему скидку или увеличить доступное место на диске.

Я не расцениваю эту программу как средство какого-то значимого заработка, но все равно зарегистрировал там свой код — возможно, кому-то пригодится. Итак, все желающие получить максимальную на сегодняшний день скидку — 50$, а так же дополнительный к стандартному домен бесплатно, указывайте при регистрации в поле Promo Code — DREIKANTER.

Вчера проверял — все работает. Цена первого года хостинга с моей скидкой уменьшается с положенных 119$ до 69$. Я бы мог еще увеличить размер дискового пространства, но зачем кому-то на shared хостинге может понадобится больше стандартных 500 Gb — непонятно. Тем более, что этот лимит там инкрементальный и сам бесплатно увеличивается на 40 Gb в месяц.

Update: Со времени написания этого поста, скидки на Dreamhost изменились. Я сделал новый промокод с максимальной скидкой — теперь уже 97$. Т. е. первый год хостинга будет стоить 14$. Код: PARADIGM.

Программный интерфейс у сервиса достаточно прост: все параметры отрисовки диаграммы и данные для визуализации передаются на сервер Google в виде GET запроса (проще говоря, специального URL), а сервер в ответ отдает PNG с нарисованным графиком. По скорости процесс сравним с загрузкой статических файлов, кроме того правила его использования не накладывают никаких жестких ограничений на количество обращений с одного хоста. Все это позволяет очень легко интегрировать Chart в свои системы, да еще и бесплатно снять с собственного сервера дополнительную нагрузку по генерации графики.

Гибкость возможностей Chart API послужила причиной разростания количества параметров URL. Ниже будут приведены несколько примеров того, как с помощью серверных скриптов облегчить задачу по формированию запросов к сервису.

Упаковка данных

В Chart API предлагается три варианта представления данных, на основе которых будут строиться диаграммы. Самый простой из них — перечисление значений через запятую. Но для большей компактности URL, так же можно кодировать числа одним из двух способов, в результате чего объем передаваемых данных сократится.

Самым эффективным способом кодирования, который мы и будем использовать, является т.н. «extended encoding». Метод сводится к последовательной записи двузначных чисел в шестидесятичетырехразрядной (прости меня, русский язык) системе счисления. Динамический диапазон таких значений находится в интервале от 0 до 4095 (64² — 1). Для их представления в кодированном виде, согласно предписанию документации, необходимо использовать строчные и прописные английские буквы, цифровые символы, а так же тире и точку (всего набирается как раз 64 символа). В том случае, если значение не задано, оно будет обозначаться последовательностью из двух «_».

Следующая функция, написанная на PHP, выполняет преобразование десятичных чисел в extended encoding для Google Chart:

function google_ext_encode($dec) {
	if($dec === false) return '__';

	$e = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'.
		'abcdefghijklmnopqrstuvwxyz0123456789-.';
	$m = strlen($e); // == 63
	$res = '';

	do {
		$r = $dec % $m;
		$dec = (int)($dec / $m);
		$res = $e[$r].$res;
	} while($dec > 0);

	$res = sprintf("%'A2s", $res);
	return $res;
}

Тест:

$test = array(0, 25, 26, 51, 4093, 4094, 4095);
echo '<pre>';
printr_r(array_map("google_ext_encode", $test));
echo '</pre>';

Программа выдаст несколько закодированных чисел, с аналогичными приведенным в документации значениями: AA, AZ, Aa, Az, .9, .-, ...

Поддержка русского языка

Еще до начала первых экспериментов с Google Chart, у меня было подозрение на тему того, что в нем может не оказаться поддержки русского алфавита (и вообще любых языков кроме английского). Как выяснилось, подозрения были напрасны: API прекрасно поддерживает UTF-8.

HTML код для вставки графика в веб страницу удобно генерировать с помощью специальной функции, пример реализации которой приведен далее. Внутри нее выполняется корректное преобразование текста для надписей:

function chart_html($type, $width,
	$height, $data, $labels = false, $colors = false, $alt = '') {

	$edata = implode('', (array_map("google_ext_encode", $data)));
	$url = 'http://chart.apis.google.com/chart?cht='.$type.
		'&chd=e:'.$edata.'&chs='.$width.'x'.$height;

	if(is_array($colors) && count($colors))
		$url .= '&chco='.implode(',', $colors);

	if(is_array($labels) && count($labels))
		$url .= '&chl='.implode('|', (array_map("urlencode", $labels)));

	return '<img src="'.$url.'" width="'.$width.'" height="'.$height.
		'" alt="'.$alt.'" />';
}

Стоит обратить внимание на две детали:

1. Функция не задействует все параметры, доступные в Charts API, а работает только с наиболее актуальными. Она была написана для генерации круговых диаграмм под конкретную задачу. Для иных типов графиков логичным шагом будет корректировка набора аргументов.
2. Файл с кодом сохранен в кодировке UTF-8. При хранении исходников и данных в 8-битной кодировке, понадобится дополнительное преобразование текста в UTF, чтобы не-английские буквы не отображались на диаграммах как вопросительные знаки.

Функция chart_html() будет выдавать XHTML теги img, в соответствии с заданными параметрами:

• $type — условное обозначение типа диаграммы. Используемое в тестах значение p3, например, соответствует трехмерной круговой диаграмме. Описание других вариантов можно найти в официальной документации API.
• $width, $height — соответственно, ширина и высота генерируемого графического изображения в пикселях. Максимальное значение для каждой величины — 1000. При выборе размера, следует помнить о необходимости свободного пространства вокруг графика, т.к. при его недостатке надписи могут быть обрезаны границей картинки. Оптимальную величину для выбранного сочетания размера и типа диаграммы, проще всего подбирать методом «научного тыка».
• $data — массив с данными для визуализации на диаграмме.
• $labels — (необязательный параметр) массив с надписями для отображения на графике.
• $colors — (необязательный параметр) массив со значениями цветов, которые будут использованы для отрисовки элементов изображения (например, секторов круговой диаграммы). Если количество цветов в массиве будет меньше количества элементов, дополнительные, схожие по тональности цвета будут добавлены автоматически.
• $alt — (необязательный параметр) значение атрибута alt тега img. Если этот аргумент не задать, атрибуту alt будет задано пустое значение.

Тест:

$width = 300;
$height = 100;
$data = array(100, 128, 200, 38);
$labels = array('Одно', 'Другое', 'Третье', 'Четвертое');

echo chart_html('p3', 500, 150, $data, $labels, false,
	'Google Chart Test').'<br />';

shuffle($data);

// задано значение альфа-канала
$colors = array('33dd66cc');
echo chart_html('p3', 500, 150, $data, $labels, $colors,
	'Демография Хабрахабра').'<br />';

Функция chart_html() будет генерировать ссылки примерно такого вида:

http://chart.apis.google.com/chart? cht=p3 &chd=e:BkCADIAm &chs=500x150 &chl=%D0%9E%D0%B4%D0%BD%D0%BE |%D0%94%D1%80%D1%83%D0%B3%D0%BE%D0%B5 |%D0%A2%D1%80%D0%B5%D1%82%D1%8C%D0%B5 |%D0%A7%D0%B5%D1%82%D0%B2%D0
%B5%D1%80%D1%82%D0%BE%D0%B5

В результате получаем две диаграммы:

Демография Хабрахабра:

(благодаря заданному значению альфа-канала, диаграмма получилась полупрозрачной)