此页面由 Cloud Translation API 翻译。

常见问题解答

开始使用
使用 API
问题排查
Google Visualization API 政策
在社区中保持活跃

开始提交

什么是 Google 可视化 API？: 借助 Google Visualization API，您可以针对结构化数据创建图表和报告应用，并协助将这些应用直接集成到您的网站中。
我可以使用可视化 API 执行哪些操作？: 借助 Google Visualization API，您可以访问在浏览器中本地创建的结构化数据，或者以简单的表格格式从受支持的数据源检索到的结构化数据。您还可以将自己的数据源实现为可视化 API 数据源，并启用任何符合可视化条件的可视化和/或应用访问您的数据。该格式适合报告、分析或图表应用使用。因此，您可以直观呈现数据和/或为应用添加新功能，例如 Google 电子表格。
在哪里可以找到可视化 API 的文档？: 您可以在 https://developers.google.com/chart/interactive/docs 上找到开发者指南和所有其他相关文档。
如何创建新图表？: 最好的入门方法是阅读简介和快速入门部分。
什么是数据源网址？: 数据源网址是可视化 API 数据源的唯一网址标识符。数据源网址可能还包含图表查询语言参数。在这种情况下，系统会在提取数据之前对数据源执行查询（例如排序、分组等）。
在哪里可以找到使用可视化 API 的图表应用程序的示例代码？: 您可以在可视化 API 示例代码文档中找到示例代码。
Flash 应用程序能否访问可视化 API？: 当然可以。但是可视化 API 使用的是 JavaScript API，但有一些库使 Flash 应用能够连接 JavaScript 代码。您可以在 http://code.google.com/p/swfobject 中找到可能对您有用的此类库。有关影响 Flash 的一些开发问题，请参见下文。
如何实现数据源？: 请阅读使用和创建图表的部分，了解图表的工作原理，然后阅读实现数据源，了解如何创建数据源。如果使用 Java，您也可以利用 Google 图表数据源 Java 库快速上手。
我能否从 Java 应用访问图表？: 可以。借助适用于 Google Web Toolkit (GWT) 的 Google 可视化库，您可以通过使用 GWT 编译器编译的 Java 代码访问与 API 兼容的可视化效果，并使用 GWT 编译器在 Java 中编写与可视化 API 兼容的可视化效果。候选版本库还支持可视化 API 事件模型。
我能否从使用 Google Web Toolkit (GWT) 编译器编写的应用中访问图表？: 可以。借助适用于 Google Web Toolkit (GWT) 的 Google 可视化库，您可以通过使用 GWT 编译器编译的 Java 代码访问与 API 兼容的可视化效果，并使用 GWT 编译器在 Java 中编写与可视化 API 兼容的可视化效果。候选版本库还支持可视化 API 事件模型。
我还有其他问题/疑问，应该与谁联系以获取更多信息？: 请将您的问题发布到 Google Visualization API 论坛中，以获取可视化开发者社区的帮助。Google 可视化团队也会参与该小组解答问题。

使用 API

Google 图表 API 和 Google 可视化 API 之间有什么区别？

Chart API 提供了一种创建各种图片图表的简单方法，只需将包含数据和图表配置选项的格式化网址发送到 Google 服务器，即可完成上述操作。Chart API 包含一组封闭的图表，其中包含各种选项。Chart API 数据集不得超过网址的大小（约为 2K）。

可视化 API 提供了一种通过网络连接图表和数据源并发布它们的方法：

可视化 API 提供了一个用于访问图表的 JavaScript API。
它的图表库包含 Google 创建的图表，同时也可供任何第三方创建他们自己的与可视化 API 兼容的可视化。
可视化 API 图表可以是浏览器能够呈现的任何内容。这包括图片、JavaScript、矢量图形、Flash 等。
大量的 Chart API 图表都可以通过可视化 API 进行访问，但它们的某些配置选项可能无法使用。
该 API 还提供了一个有备案的传输协议，可供任何人向任何 API 可视化工具公开其数据源。
该 API 有一个定义的事件模型，允许图表抛出和接收事件，从而与其托管网页和/或网页上的其他图表进行通信。

可以使用可视化 API 访问哪些数据源？

使用 Visualization API，您可以通过创建该 API 的标准 DataTable 格式，从浏览器本地访问数据，或者访问任何支持该 API 的数据源。知名应用已经支持该 API，包括 Google 电子表格和其 Force.com 开发者平台上的 Salesforce.com。您也可以将自己的数据作为图表数据源来实现。

我的应用要求接收的数据采用特定格式。如何处理异常？

您可以使用 google.visualization.DataTable 类的 getNumberOfColumns() 和 getColumnType() 方法测试获取的数据是否与预期相符，并在出现不匹配时发出错误消息。

在我的网站中嵌入图表是否安全？

直接在您的网站上运行第三方代码会带来固有风险。 Google 对应用性能、质量、安全性或内容不作任何承诺或保证。不符合 Google Visualization API 服务条款的图表应用可能会从模板库中移除。

我可以离线使用图表吗？

用户的计算机必须能够访问 https://www.gstatic.com/charts/loader.js，才能使用 Google 图表的互动功能。这是因为，在您使用页面所需的可视化库之前，系统会动态加载这些库。用于加载相应库的代码是所含脚本的一部分，会在您调用 google.charts.load() 方法时调用。我们的服务条款不允许您下载 google.charts.load 或 google.visualization 代码以供离线使用。

我可以在本地或内网上下载并托管图表代码吗？

抱歉，我们的服务条款不允许您下载、保存或托管 google.charts.load 或 google.visualization 代码。但是，如果您不需要 Google 图表的交互性，可以对图表进行截图，然后根据需要使用它们。

问题排查

为什么我的图表没有显示？

首先，检查您的 JavaScript 控制台。在 Chrome 中，您可以通过以下方式访问 JavaScript 控制台：Chrome -> 查看 -> 开发者 -> JavaScript 控制台，或 Chrome -> 工具 -> JavaScript 控制台。所有现代浏览器都有 JavaScript 控制台；您可能需要在包含“高级”或“开发者工具”等名称的菜单上四处移动，查找它们。

希望控制台能立即帮助您解决问题。不过，有时很难将控制台消息转化为根本原因。以下是一些常见的误区：

您可能未正确使用 Google 加载器。

仅加载 Chars/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>

每个图表都应具有唯一的元素 ID（例如，chart1、chart2）。
查找拼写错误。切记 JavaScript 是一种区分大小写的语言。

如果问题依然存在，请搜索 Google Visualization API 论坛，看看是否有人遇到过类似问题。如果您找不到可以解答您问题的帖子，请将您的问题发布到群组，并附上演示问题的网页的链接。如果可能，请包含 jsfiddle。

为什么我的月份和天数是相差一日的？

Google 图表使用的 JavaScript 使用从零开始编制索引。一个月的第一天是 0，月份的范围从 0（1 月）到 11（12 月）。如果您的代码假定索引编号为 1，请将数据减 1，然后再将数据放入 JavaScript 日期对象中。

为什么我的图表在某些浏览器（而非全部浏览器）中都能正常工作？

建议您访问 caniuse.com 查看关于浏览器不兼容性的大量信息。使用 Google 图表时，Internet Explorer 8 及更低版本有时会出现问题，原因有两个：

IE8 不支持 SVG，因此图表会切换到 VML，而 VML 的限制较为有限。

IE8 的 JavaScript 不允许在列表中以逗号结尾。

为什么基于 Flash 的图表在测试时不显示？

由于 Flash 安全设置的限制，当从浏览器的文件位置（如 file:///c:/webhost/myhost/myviz.html）而不是网络服务器网址（如 http://www.myhost.com/myviz.html）访问时，基于 Flash 的图表可能无法正常运行。这通常只是测试问题；当您从 http:// 地址访问图表时，不会出现此问题。您可以按照 Macromedia 网站上的说明来解决此问题。一般来说，我们建议尽可能避免开发 Flash。

Google 可视化计划政策

什么是 Google 可视化计划政策？

根据服务条款的规定，我们可能会拒绝包含和显示违反我们计划政策的内容，具体做法是显示或链接到以下内容：

非法内容。
侵犯个人隐私。
色情或淫秽内容。
干扰或危害用户的计算机或托管网页的功能的内容（如恶意代码）。
宣扬仇恨或宣扬暴力。
侵犯版权。有关详情，请参阅我们的数字千年版权法案 (DMCA) 政策。
侵犯商标权。
冒充第三方。

如果开发者会创建用于收集数据的图表，则同意维护并链接到符合法律规范的隐私权政策。此外，我们要求开发者确保其图表是安全的，并且只要应用位于图表目录中，他们就可以对其进行维护。

这些政策可能会不时修订，恕不另行通知。

Google 可视化 API 是否可以用于商业用途？

可以。如需查看细则，请参阅 Google Visualization API 服务条款。

我可以使用 Google Visualization API 创建客户端软件吗？

目前，我们不允许开发者使用 Visualization API 来创建客户端软件。您只能通过提供的接口使用 Visualization API。如需查看细则，请参阅 Google Visualization API 服务条款。

Google 是否会记录我所有的图表数据？

HTTP 请求中包含的图表数据会在临时日志中保存最多两周，用于内部测试和调试。当然，您应该了解，如果您的图表出现在公共网页上的图片标记中，则该图表可能会被抓取。

违反计划政策。

违反这些计划政策可能会导致您的图表被停用或移除、被列入禁止上传后续图表的黑名单、您的 Google 账号被终止和/或删除您的所有图表。

在社区中保持活跃

如何与他人共享图表应用程序？: 首先，将您的图表放置在图表库中。您可以根据需要提供指向您网站的链接，并提供您的源代码。加入我们的讨论小组以获取社区的反馈。
什么是图表库？: 图表库列出了使用可视化 API 的应用。它为可视化开发者社区提供了一个共享图表应用程序的中心位置。如需向数据库提交图表应用，请在线申请。
如何宣传我的图表数据源？: 将您的实现发布到可视化图表组。如果我们喜欢它，我们甚至可能会亲自提及它。

常见问题解答 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。