- Начиная
- Что такое API визуализации Google?
- Что я могу делать с API визуализации?
- Где я могу найти документацию по Visualization API?
- Как создать новую диаграмму?
- Что такое URL-адрес источника данных?
- Где я могу найти пример кода приложений Chart, использующих Visualization API?
- Может ли приложение Flash получить доступ к API визуализации?
- Могу ли я получить доступ к диаграмме из приложения Java?
- Могу ли я получить доступ к диаграмме из приложения, написанного с помощью компилятора Google Web Toolkit (GWT)?
- У меня другой вопрос/проблема, к кому мне обратиться, чтобы получить дополнительную информацию?
- Использование API
- В чем разница между Google Chart API и Google Visualization API?
- К каким источникам данных я могу получить доступ с помощью Visualization 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 и/или удалению всех ваших диаграмм.
Стать активным в сообществе
- Начните с размещения диаграммы в галерее диаграмм . Вы можете сделать ссылку на свой сайт и предоставить исходный код, если хотите. Примите участие в нашей дискуссионной группе , чтобы получить отзывы сообщества.
- Что такое Галерея диаграмм?
- Галерея диаграмм — это список приложений, использующих Visualization API. Он предоставляет сообществу разработчиков визуализаций центральное место для обмена приложениями Chart. Чтобы подать заявку на создание диаграммы в галерею, подайте заявку онлайн .
- Как я могу продвигать свой источник данных Chart?
- Опубликуйте свою реализацию в группе визуализации. Если нам это нравится, мы можем даже упомянуть об этом сами.