Эта страница переведена с помощью Cloud Translation API.

Часто задаваемые вопросы

Начиная
Использование API
Исправление проблем
Политика API визуализации Google
Стать активным в сообществе

Начиная

Что такое API визуализации Google?: Google Visualization API позволяет создавать диаграммы и приложения для создания отчетов на основе структурированных данных и помогает интегрировать их непосредственно на ваш веб-сайт.
Что я могу делать с API визуализации?: С помощью Google Visualization API вы можете получить доступ к структурированным данным, созданным локально в вашем браузере или извлеченным из поддерживаемых источников данных в простом табличном формате. Вы также можете реализовать свой собственный источник данных в качестве источника данных API визуализации и разрешить любой визуализации и/или приложению, совместимым с визуализацией, получать доступ к вашим данным. Формат подходит для использования в отчетах, анализе или графических приложениях. Таким образом, вы можете визуализировать данные и/или добавлять новые функции в приложения, такие как таблицы Google.
Где я могу найти документацию по Visualization API?: Вы можете найти руководство для разработчиков и всю другую сопутствующую документацию по адресу https://developers.google.com/chart/interactive/docs .
Как создать новую диаграмму?: Лучший способ начать работу — прочитать Введение и раздел « Быстрый старт ».
Что такое URL-адрес источника данных?: URL-адрес источника данных — это уникальный идентификатор URL-адреса источника данных API визуализации. URL-адрес источника данных может также включать параметры языка запросов диаграммы. В этом случае запрос (такой как сортировка, группировка и т. д.) выполняется в источнике данных до выборки данных.
Где я могу найти пример кода приложений Chart, использующих Visualization API?: Вы можете найти пример кода в документации по примерам кода Visualization API.
Может ли приложение Flash получить доступ к API визуализации?: Абсолютно. API визуализации использует API JavaScript, но существуют библиотеки, которые позволяют приложениям Flash подключаться к коду Javascript. Одна из таких библиотек, которая может оказаться полезной, находится по адресу http://code.google.com/p/swfobject . Ниже приведены некоторые проблемы разработки, влияющие на Flash.
Как реализовать источник данных?: Прочтите раздел об использовании и создании диаграммы, чтобы узнать, как работают диаграммы, а затем прочитайте Реализация источника данных , чтобы узнать, как создать источник данных. Вы также можете использовать библиотеку Java для источника данных Google Chart , чтобы быстро приступить к работе, если вы используете Java.
Могу ли я получить доступ к диаграмме из приложения Java?: Да. Библиотека визуализации Google для Google Web Toolkit (GWT) позволяет получать доступ к визуализациям, совместимым с API, из кода Java, скомпилированного с помощью компилятора GWT, и создавать визуализации, совместимые с API визуализации, на Java с помощью компилятора GWT. Библиотека-кандидат на выпуск также поддерживает модель событий Visualization API.
Могу ли я получить доступ к диаграмме из приложения, написанного с помощью компилятора Google Web Toolkit (GWT)?: Да. Библиотека визуализации Google для Google Web Toolkit (GWT) позволяет получать доступ к визуализациям, совместимым с API, из кода Java, скомпилированного с помощью компилятора GWT, и создавать визуализации, совместимые с API визуализации, на Java с помощью компилятора GWT. Библиотека-кандидат на выпуск также поддерживает модель событий Visualization API.
У меня другой вопрос/проблема, к кому мне обратиться, чтобы получить дополнительную информацию?: Опубликуйте свой вопрос в группе обсуждения Google Visualization API, чтобы получить помощь от сообщества разработчиков визуализации. Команда Google Visualization также участвует в этой группе, чтобы отвечать на вопросы.

Использование API

В чем разница между Google Chart API и Google Visualization API?

Chart API предоставляет простой способ создания диаграмм изображений различных типов путем отправки форматированного URL-адреса, который включает в себя как данные, так и параметры конфигурации диаграммы, на сервер Google. Chart API включает в себя закрытый набор диаграмм с различными параметрами. Наборы данных Chart API ограничены размером URL-адреса (примерно 2 КБ).

Visualization API позволяет подключать диаграммы и источники данных через Интернет и публиковать их:

API визуализации предоставляет API Javascript для доступа к диаграммам.
Его галерея диаграмм включает диаграммы, созданные Google, но также открыта для любой третьей стороны для создания собственных визуализаций, совместимых с Visualization API.
Диаграммы API визуализации и диаграммы могут быть чем угодно, что может быть отображено браузером. Сюда входят изображения, Javascript, векторная графика, Flash и т. д.
Значительное количество диаграмм Chart API доступно через Visualization API, хотя некоторые параметры их конфигурации могут быть недоступны.
API также предоставляет задокументированный проводной протокол и способ, с помощью которого любой может предоставить свои источники данных для любой визуализации API.
API имеет определенную модель событий, которая позволяет диаграммам создавать и получать события и, таким образом, связываться со своей главной страницей и/или другими диаграммами на странице.

К каким источникам данных я могу получить доступ с помощью Visualization API?

С API визуализации вы можете получить доступ к данным локально из своего браузера, создав стандартный формат DataTable для API, или получить доступ к любому источнику данных, который поддерживает API. Хорошо известными приложениями, которые уже поддерживают API, являются Google Spreadsheets и Salesforce.com на их платформе для разработчиков Force.com . Вы также можете реализовать свои собственные данные в качестве источника данных диаграммы.

Мое приложение ожидает, что данные, которые оно получает, будут в определенном формате. Как обрабатывать исключения?

Вы можете использовать getNumberOfColumns() и getColumnType() класса google.visualization.DataTable , чтобы проверить, соответствуют ли полученные данные ожидаемым, и выдать сообщение об ошибке в случае несоответствия.

Безопасно ли вставлять диаграмму на мой веб-сайт?

Запуск стороннего кода непосредственно на вашем веб-сайте сопряжен с неотъемлемыми рисками. Google не дает никаких обещаний и заявлений о производительности, качестве, безопасности или содержании приложений. Приложения для работы с диаграммами, которые не соответствуют Условиям использования Google Visualization API, могут быть удалены из галерей.

Могу ли я использовать диаграммы в автономном режиме?

Компьютеры ваших пользователей должны иметь доступ к https://www.gstatic.com/charts/loader.js, чтобы использовать интерактивные функции Google Charts. Это связано с тем, что библиотеки визуализации, необходимые для вашей страницы, загружаются динамически перед тем, как вы их используете. Код для загрузки соответствующей библиотеки является частью включенного скрипта и вызывается при вызове метода google.charts.load() . Наши условия обслуживания не позволяют загружать код google.charts.load или google.visualization для использования в автономном режиме.

Могу ли я загрузить и разместить код диаграммы локально или во внутренней сети?

Извиняюсь; наши условия обслуживания не позволяют вам загружать и сохранять или размещать код google.charts.load или google.visualization . Однако, если вам не нужна интерактивность Google Charts, вы можете делать скриншоты диаграмм и использовать их по своему усмотрению.

Исправление проблем

Почему не отображается моя диаграмма?

Сначала проверьте свою консоль JavaScript. В Chrome вы можете получить доступ к консоли JavaScript через Chrome->View->Developer->JavaScript Console или Chrome->Tools->JavaScript Console. Все современные браузеры имеют консоль JavaScript; вам может понадобиться покопаться в меню с такими названиями, как «Дополнительно» или «Инструменты разработчика», чтобы найти его.

Надеюсь, консоль сразу приведет вас к проблеме. Однако иногда будет сложно перевести консольное сообщение в основную причину. Вот некоторые распространенные ловушки:

Возможно, вы неправильно используете Google Loader .

Загружайте диаграммы/loader.js только один раз . Независимо от того, сколько диаграмм у вас есть на вашей веб-странице, у вас должен быть один и только один такой вызов:
```
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
```
Это может быть в заголовке или в теле вашей веб-страницы, в зависимости от того, когда вы хотите, чтобы произошла загрузка.

В идеале вызовите google.charts.load только один раз со всеми пакетами, которые вам понадобятся для вашей веб-страницы.

<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
<script>
  google.charts.load("current", {packages: ["corechart", "timeline"]});

  google.charts.setOnLoadCallback(drawBarChart1);
  function drawBarChart1() {
    ...
    var barChart1 = new google.visualization.BarChart(document.getElementById('chart1'));
    ...
  }

  google.charts.setOnLoadCallback(drawBarChart2);
  function drawBarChart2() {
    ...
    var barChart2 = new google.visualization.BarChart(document.getElementById('chart2'));
    ...
  }

  google.charts.setOnLoadCallback(drawTimeline);
  function drawTimeline() {
    ...
    var timeline = new google.visualization.Timeline(document.getElementById('chart3'));
    ...
  }

</script>
<div id="chart1"></div>
...
<div id="chart2"></div>
...
<div id="chart3"></div>

Каждая диаграмма должна иметь уникальный идентификатор элемента (например, chart1 , chart2 в приведенном выше примере).
Ищите опечатки. Помните, что JavaScript — это язык, чувствительный к регистру.

Если вы все еще в замешательстве, поищите в группе обсуждения Google Visualization API, чтобы узнать, не сталкивался ли кто-нибудь с подобной проблемой. Если вы не можете найти сообщение, отвечающее на ваш вопрос, опубликуйте свой вопрос в группе вместе со ссылкой на веб-страницу, демонстрирующую проблему. Если возможно, включите jsfiddle .

Почему мои месяцы и дни выпадают на один?

Google Charts использует JavaScript, который использует индексацию с отсчетом от нуля. Первый день месяца равен 0, а месяцы варьируются от 0 (январь) до 11 (декабрь). Если ваш код предполагает индексирование на основе единицы, вычтите единицу перед помещением ваших данных в объект даты JavaScript.

Почему мои графики работают в некоторых браузерах, но не во всех?

Мы рекомендуем caniuse.com для поиска информации о несовместимости браузеров. С Google Charts иногда возникают проблемы в Internet Explorer 8 и более ранних версиях по двум причинам:

IE8 не поддерживает SVG, поэтому Charts переключается на VML, который более ограничен.

JavaScript IE8 не допускает запятых в списках.

Почему моя диаграмма на основе Flash не отображается, когда я ее тестирую?

Из-за настроек безопасности Flash диаграммы на основе Flash могут работать неправильно при доступе из местоположения файла в браузере (например, file:///c:/webhost/myhost/myviz.html), а не из URL-адреса веб-сервера ( например, http://www.myhost.com/myviz.html). Обычно это проблема только тестирования; проблема не возникает при доступе к диаграмме с адреса http://. Вы можете решить эту проблему, как описано на веб-сайте Macromedia . В общем, мы рекомендуем по возможности избегать Flash-разработки.

Политика программы визуализации Google

Какова политика программы визуализации Google?

Как описано в Условиях предоставления услуг , мы можем отказаться включать и отображать контент, который нарушает политику нашей программы, путем отображения или ссылки на:

Незаконный контент.
Вторжения в личную жизнь.
Порнография или непристойность.
Содержимое, такое как вредоносный код, который мешает или наносит вред компьютеру пользователя или функционированию главной веб-страницы.
Пропаганда ненависти или подстрекательство к насилию.
Нарушения авторских прав. Пожалуйста, ознакомьтесь с нашей политикой DMCA для получения дополнительной информации.
Нарушения товарного знака.
Олицетворение третьих лиц.

Разработчики, которые создают диаграммы для сбора данных, соглашаются поддерживать и ссылаться на юридически адекватную политику конфиденциальности. Кроме того, мы требуем, чтобы разработчики обеспечивали безопасность своих диаграмм и поддерживали свои приложения, пока они находятся в каталоге диаграмм.

Эти политики могут время от времени пересматриваться без предварительного уведомления.

Доступен ли API визуализации Google для коммерческого использования?

Да. Мелкий шрифт см. в Условиях использования Google Visualization API .

Могу ли я использовать Google Visualization API для создания клиентского программного обеспечения?

В настоящее время мы не разрешаем разработчикам использовать Visualization API для создания клиентского программного обеспечения. Вы можете использовать API визуализации только через предоставленный интерфейс. Мелкий шрифт см. в Условиях использования Google Visualization API .

Регистрирует ли Google все данные моей диаграммы?

Данные диаграммы, включенные в HTTP-запрос, сохраняются во временных журналах не более двух недель для целей внутреннего тестирования и отладки. Конечно, вы должны понимать, что если ваша диаграмма появляется в теге изображения на общедоступной веб-странице, она может быть просканирована.

Нарушения правил программы.

Нарушение этих Правил программы может привести к отключению или удалению вашей диаграммы, внесению в черный список для загрузки будущих диаграмм, прекращению действия ваших учетных записей Google и/или удалению всех ваших диаграмм.

Стать активным в сообществе

Как я могу поделиться своим приложением Chart с другими?: Начните с размещения диаграммы в галерее диаграмм . Вы можете сделать ссылку на свой сайт и предоставить исходный код, если хотите. Примите участие в нашей дискуссионной группе , чтобы получить отзывы сообщества.
Что такое Галерея диаграмм?: Галерея диаграмм — это список приложений, использующих Visualization API. Он предоставляет сообществу разработчиков визуализаций центральное место для обмена приложениями Chart. Чтобы подать заявку на создание диаграммы в галерею, подайте заявку онлайн .
Как я могу продвигать свой источник данных Chart?: Опубликуйте свою реализацию в группе визуализации. Если нам это нравится, мы можем даже упомянуть об этом сами.