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

Начиная

Что такое API визуализации Google?
API визуализации Google позволяет создавать диаграммы и приложения для составления отчетов на основе структурированных данных и помогает интегрировать их непосредственно на ваш веб-сайт.
Что я могу делать с API визуализации?
С помощью API визуализации Google вы можете получить доступ к структурированным данным, созданным локально в вашем браузере или полученным из поддерживаемых источников данных в простом табличном формате. Вы также можете реализовать свой собственный источник данных в качестве источника данных API визуализации и предоставить любой визуализации и/или приложению, совместимому с визуализацией, доступ к вашим данным. Этот формат можно использовать в приложениях для создания отчетов, анализа или диаграмм. Таким образом, вы можете визуализировать данные и/или добавить новые функции в приложения, такие как таблицы Google.
Где я могу найти документацию по API визуализации?
Руководство для разработчиков и всю другую соответствующую документацию можно найти по адресу https://developers.google.com/chart/interactive/docs .
Как создать новую диаграмму?
Лучший способ начать — прочитать раздел «Введение» и «Краткий старт» .
Что такое URL-адрес источника данных?
URL-адрес источника данных — это уникальный идентификатор URL-адреса источника данных API визуализации. URL-адрес источника данных также может включать параметры языка запросов диаграмм. В этом случае запрос (например, сортировка, группировка и т. д.) выполняется к источнику данных перед получением данных.
Где я могу найти пример кода приложений Chart, использующих API визуализации?
Пример кода можно найти в документации примера кода 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. Библиотека-кандидат на выпуск также поддерживает модель событий API визуализации.
Могу ли я получить доступ к диаграмме из приложения, написанного с помощью компилятора Google Web Toolkit (GWT)?
Да. Библиотека визуализации Google для Google Web Toolkit (GWT) позволяет получать доступ к визуализациям, совместимым с API, из кода Java, скомпилированному с помощью компилятора GWT, и писать визуализации, совместимые с API визуализации, на Java с помощью компилятора GWT. Библиотека-кандидат на выпуск также поддерживает модель событий API визуализации.
У меня другой вопрос/проблема. К кому мне обратиться, чтобы получить дополнительную информацию?
Задайте свой вопрос в группе обсуждения API визуализации Google , чтобы получить помощь от сообщества разработчиков визуализации. Команда Google Visualization также участвует в этой группе и отвечает на вопросы.

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

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

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

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

  • API визуализации предоставляет API Javascript для доступа к диаграммам.
  • Его галерея диаграмм включает в себя диаграммы, созданные Google, но также открыта для любой третьей стороны для создания собственных визуализаций, совместимых с API визуализации.
  • Диаграммы и диаграммы API визуализации могут представлять собой все, что может отображаться в браузере. Сюда входят изображения, Javascript, векторная графика, Flash и т. д.
  • Значительное количество диаграмм Chart API доступно через API визуализации, хотя некоторые параметры их конфигурации могут быть недоступны.
  • API также предоставляет документированный проводной протокол и возможность любому пользователю предоставить свои источники данных любой визуализации API.
  • API имеет определенную модель событий, которая позволяет диаграммам генерировать и получать события и, таким образом, взаимодействовать со своей главной страницей и/или другими диаграммами на странице.
К каким источникам данных я могу получить доступ с помощью 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->Просмотр->Разработчик->Консоль JavaScript или Chrome->Инструменты->Консоль JavaScript. Все современные браузеры имеют консоль JavaScript; вам может понадобиться покопаться в меню с такими названиями, как «Дополнительно» или «Инструменты разработчика», чтобы найти его.

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

  • Возможно, вы неправильно используете Google Loader .
    • Загружайтеcharts/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 для коммерческого использования?
    Да. Подробности, напечатанные мелким шрифтом, см. в Условиях использования API визуализации Google.
    Могу ли я использовать API визуализации Google для создания клиентского программного обеспечения?
    В настоящее время мы не разрешаем разработчикам использовать API визуализации для создания клиентского программного обеспечения. Вы можете использовать API визуализации только через предоставленный интерфейс. Подробности, напечатанные мелким шрифтом, см. в Условиях использования API визуализации Google .
    Google записывает все мои данные диаграммы?
    Данные диаграммы, включенные в HTTP-запрос, сохраняются во временных журналах не более двух недель для целей внутреннего тестирования и отладки. Конечно, вы должны понимать, что если ваша диаграмма появится в теге изображения на общедоступной веб-странице, ее можно будет просканировать.
    Нарушения правил программы.
    Нарушения настоящих Правил программы могут привести к отключению или удалению вашей диаграммы, попаданию в черный список с возможностью загрузки будущих диаграмм, прекращению действия ваших учетных записей Google и/или удалению всех ваших диаграмм.

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

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