开发人员指南

Google 图表 API 使您可以动态生成图表。要查看图表 API 的运行情况，请打开浏览器窗口，并将以下网址复制到其中：

http://chart.apis.google.com/chart?cht=p3&chd=t:60,40&chs=250x100&chl=Hello|World

按下 Enter 键或回车键，即刻您就会看到以下图片：

目录

受众 使用政策 简介 网址格式 必选参数和可选参数 图表大小 图表数据 文本编码 带有数据换算的文本编码 简单编码 扩展编码 用 JavaScript 对数据进行编码 粒度指导原则 图表类型 折线图 Sparkline 图 条形图 饼图 维恩图 散点图 雷达图 地图 Google 指数 QR 代码 新增！

颜色 图表颜色 实体填充 线性渐变 线性条纹 填充区域 标签 图表标题 图表图例 扩展！ 饼图和 Google 指数标签 多个轴标签 样式 条宽和间距 条形图基准线 折线样式 网格线 形状标记和范围标记 字符映射 简单编码字符值 扩展编码字符值 美国州代码 ISO 3166 国家代码

返回页首

受众

本文档适用于想要将 Google 图表 API 图片包含在网页中的编程人员。本文档介绍了如何使用 API，并提供了有关可用参数的参考资料。

使用政策

您每天调用 Google 图表 API 的次数没有限制。但是，我们保留禁止任何我们视为滥用行为（例如，明显拒绝服务尝试的行为）的权利。如果您认为您的服务每天会进行 250,000 次以上的 API 调用，请通过电子邮件将估计的次数发送至 chart-api-notifications@google.com 来告知我们。

简介

Google 图表 API 会返回一幅 PNG 格式的图片来响应一个网址。可以生成多种类型的图片，包括折线图、条形图和饼图。您可以为每种图片类型指定属性，例如大小、颜色和标签。

通过将网址嵌入 <img> 标签内，您可以将图表 API 图片包括在网页中。当网页在浏览器中显示时，图表 API 会呈现该网页中的这幅图片。

本文档中的所有图片均是使用图表 API 生成的。要查看图片的网址，请执行以下操作：

• 如果您使用的是 Firefox，请单击鼠标右键，然后选择“View image”或“Properties”。
• 如果您使用的是 Internet Explorer，请单击鼠标右键，然后选择“Properties”。

本文档说明了所需的图表 API 网址格式和可用参数。

返回页首

网址格式

Google 图表 API 网址必须为以下格式：

http://chart.apis.google.com/chart?<parameter 1>&<parameter 2>&<parameter n>

注意：每个网址必须完全在一行中。

使用和号 (&) 字符对参数加以分隔。您可以按任意顺序指定任意数量的参数。例如，图表 API 会返回以下图表来响应下面的网址：

http://chart.apis.google.com/chart?
chs=250x100
&chd=t:60,40
&cht=p3
&chl=Hello|World

其中：

• http://chart.apis.google.com/chart? 是图表 API 的位置。
• & 用于分隔参数。
• chs=250x100 是图表的大小（以像素为单位）。
• chd=t:60,40 是图表的数据。
• cht=p3 是图表的类型。
• chl=Hello|World 是图表的标签。

通过将网址嵌入 <img> 标签内，您可以将图表 API 图片包括在 HTML 文档中。例如，以下 <img> 标签会生成与上文相同的图片：

<img src="http://chart.apis.google.com/chart?
chs=250x100
&amp;chd=t:60,40
&amp;cht=p3
&amp;chl=Hello|World"
alt="Sample chart" />

注意：您在 HTML <img> 标签中嵌入网址时，请注意要使用字符实体参考 & 来代替和号 (&)。

返回页首

必选参数和可选参数

您必须至少提供以下参数：

• 图表大小
• 图表数据
• 图表类型
  

其他所有参数均为可选参数。可选参数按图表类型列在下表中。请注意，QR 代码被省略，因为它们没有可选参数。

参数	条形图	折线图和 Sparkline 图	雷达图	散点图	维恩图	饼图	Google 指数	地图
图表颜色	是	是	是	是	是	是	是	是
实体填充	是	是	是	是	是	是	仅填充背景	仅填充背景
数据换算	是	是	是	是	是	是	是
线性渐变	是	是	是	是	是	仅填充背景
线性条纹	是	是	是	是	是	仅填充背景
图表标题	是	是	是	是	是	是
图表图例	是	是	是	是	是
多个轴标签	是	是	是	是
网格线	是	是	是	是
形状标记	是	是	是	是
水平范围标记	是	是	是	是
垂直范围标记	是	是	是	是
折线样式	是	是	是
填充区域	是	是	是
条宽和间距	是
条形图基准线	是
饼图和 Google 指数标签						是	是

返回页首

图表大小

使用 chs=<width in pixels>x<height in pixels> 指定图表大小

例如，chs=300x200 会生成宽为 300 像素、高为 200 像素的图表。

除地图外，所有图表的最大可能区域是 300,000 像素。最大高度或宽度为 1000 像素时，最大大小的实例包括 1000x300、300x1000、600x500、500x600、800x375 和 375x800。

对于地图，最大大小为宽 440 像素、高 220 像素。

如果指定的大小太小，则会剪裁饼图（仅部分可见）。饼图的常规大小指导方针为：

• 二维图表的宽度需要大约是其高度的两倍。
• 三维图表的宽度需要大约是其高度的二点五倍。

返回页首

图表数据

必须先将数据编码为图表 API 可以识别的形式，才能创建图表。使用以下格式之一：

• 文本编码使用从零到一百的正浮点数字符串。
  带有数据换算的文本编码结合使用任意正或负浮点数与换算参数。请注意，这对于地图来说不可用。
  整数（1.0、2.0 等等）允许每个数据点占据 5 个像素，适用于最大约为 500 像素的折线图和条形图。如果您需要更高的解析度，则可以包括一位小数（例如 35.7）。无论图表大小如何，文本编码适用于所有类型的图表。请注意，该编码类型通常会导致对给定数据集使用最长网址。
• 简单编码使用字母数字字符（A 到 Z，a 到 z，以及 0 到 9），其中 A 代表 0，B 代表 1，以此类推，直到代表 61 的 9，从而解析 62 个不同值。
  每个数据点占据 5 个像素，适用于最大约为 300 像素的折线图和条形图。该编码类型会导致对给定数据集使用最短网址。
• 扩展编码使用字母数字字符对（以及要稍后讨论的一些其他字符），其中 AA 代表 0，AB 代表 1，以此类推，直到代表 4095 的两个句号 (..)，从而解析 4,096 个不同值。
  扩展编码最适用于具有较大数据范围的大型图表。该编码类型会导致对给定数据集使用长度为简单编码产生的网址长度两倍的网址。

注意：对于简单编码和扩展编码，您可能最希望能通过编程对数据进行编码。请参阅用于对数据进行编码的 JavaScript 代码段。另外，有几个图表组成员已提供了 API 库 - 可以在网上论坛查找，也可以访问帖子 API 库的有用链接。

返回页首

文本编码

以如下方式指定文本编码

chd=t:<chart data string>

其中，<chart data string> 包含从零 (0.0) 到一百 (100.0) 的正浮点数、负一 (-1) 和管道符 (|) 作为分隔符。

注意：

• 您可以用负一 (-1) 指定缺少的值。
• 如果有多组数据，请使用管道符 (|) 来分隔每组数据。

例如： chd=t:10.0,58.0,95.0|30.0,8.0,63.0

注意：对于文本编码，通过将数据转换为数据集中最大值的百分比来换算数据。

返回页首

带有数据换算的文本编码

通过两个参数来指定带有数据换算的文本编码

chd=t:<chart data string>
chds=<data set 1 minimum value>,<data set 1 maximum value>,<data set n minimum value>,<data set n maximum value>

其中：

• <chart data string> 包含任意正或负浮点数
• <data set 1 minimum value> 是要应用于第一个数据集上的最小数
• <data set 1 maximum value> 是要应用于第一个数据集上的最大数，忽略并指定为 100
• <data set n minimum value> 是要应用于第 n 个数据集上的最小数
• <data set n maximum value> 是要应用于第 n 个数据集上的最大数，忽略并指定为 100

如果您提供的数据换算参数比现有的数据集要少，则最后一个换算参数会应用于剩余的数据集。仅提供一对换算参数以将单一范围应用于图表。

注意：

• 这对于地图来说不可用。
• 您可以用范围外的数指定缺少的值。
• 如果有多组数据，请使用管道符 (|) 来分隔每组数据。

例如：chd=t:30,-60,50,120,80&chds=-80,140

返回页首

简单编码

以如下方式指定简单编码

chd=s:<chart data string>

其中，<chart data string> 包含字符：A 到 Z、a 到 z、0 到 9、下划线 (_) 以及逗号 (,) 作为分隔符。

注意：

• 大写字母 A = 0、B = 1，以此类推，直到Z = 25。
• 小写字母 a = 26、b = 27，以此类推，直到z = 51。
• 零 (0) = 52，以此类推，直到 9 = 61。
• 您可以用下划线 (_) 指定缺少的值。
• 如果有多组数据，请使用逗号 (,) 来分隔每组数据。

例如，有两组数据：chd=s:ATb19,Mn5tz。其中，在第一组数据中，A 代表 0、T 代表 19、b 代表 27、1 代表 53、9 代表 61。

注意：请参阅简单编码字符值以获取完整列表。

返回页首

扩展编码

以如下方式指定扩展编码

chd=e:<chart data string>

其中，<chart data string> 可以包含以下成对字符：A 到 Z、a 到 z、0 到 9、连字符 (-)、句点 (.)、下划线 (_) 和逗号 (,) 作为分隔符。

注意：

• AA = 0、AZ = 25、Aa = 26、Az = 51、A0 = 52、A9 = 61、A- = 62、A. = 63
  BA = 64、BZ = 89、Ba = 90、Bz = 115、B0 = 116、B9 = 125、B- = 126、B. = 127
  .A = 4032、.Z = 4057、.a = 4058、.z = 4083、.0 = 4084、.9 = 4093、.- = 4094、.. = 4095。
• 您可以用两个下划线 (__) 字符指定缺少的值。
• 如果有多组数据，请使用逗号 (,) 来分隔每组数据。

注意：请参阅扩展编码字符值以获取有关如何生成完整列表的说明。

返回页首

用 JavaScript 对数据进行编码

您很可能会发现通过编程将实际数据转换为图表 API 数据比手动进行转换要简便。

以下 JavaScript 代码段用于将一个数据集编码为简单编码。该数据集必须以正数数组的形式提供。数据集中的非正数值将作为缺少的值用下划线字符 (_) 进行编码。

var simpleEncoding = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
 
function simpleEncode(valueArray,maxValue) {

var chartData = ['s:'];
  for (var i = 0; i < valueArray.length; i++) {
    var currentValue = valueArray[i];
    if (!isNaN(currentValue) && currentValue >= 0) {
    chartData.push(simpleEncoding.charAt(Math.round((simpleEncoding.length-1) * currentValue / maxValue)));
    }
      else {
      chartData.push('_');
      }
  }
return chartData.join('');
}

调用 simpleEncode 函数，使该函数在该数组 (valueArray) 和该数组内的最大值 (maxValue) 间循环。在以下实例中，maxValue 设置为大于该数组内最大数字的值，以在最大值和图表的顶部之间留出一定的间距：

var valueArray = new Array(0,1,4,4,6,11,14,17,23,28,33,36,43,59,65);
var maxValue = 70; 
simpleEncode(valueArray,maxValue);

返回页首

粒度指导方针

请注意，不要过多估计图表所需的数据点数。例如，要表明布兰妮·斯皮尔斯 (Britney Spears) 在过去十年中的受欢迎程度，每天的搜索查询次数共计超过 3,600 个值。这些数据太多了，无法在网址中传达出来，而且以此粒度打印图形毫无意义：在 1024 像素宽的屏幕上，一个数据点在屏幕上约占四分之一像素。以下实例说明了这一点。

200x100 的图表中具有 20 个数据点（每个数据点 10 像素）：

40 个数据点（每个数据点 5 像素）：

80 个数据点（每个数据点只有 2.5 像素）：

返回页首

图表类型

可以使用以下图表类型：

• 折线图
• Sparkline 图
• 条形图
• 饼图
• 维恩图
• 散点图
• 雷达图
• 地图
• Google 指数

折线图

以如下方式指定折线图

cht=<line chart type>

其中，<line chart type> 为 lc 或 lxy，如下表所述。

• 对于类型为 lc 的图表，将多个数据集绘制成多条线。
• 对于类型为 lxy 的图表，每条线需要两个数据集。
• 有关如何指定多个数据集的信息，请参阅图表数据。
• 有关可用参数的信息，请参阅可选参数（按图表类型）。

参数	说明	实例
cht=lc	一种折线图，数据点沿 x 轴均匀分布。	cht=lc
cht=lxy	为您要绘制的每条线提供一对数据集，则每对数据集的第一个数据集用于指定 x- 轴坐标，第二个数据集用于指定 y- 轴坐标。如果您传递奇数个数据集，则最后一个集会被忽略。 提供一个未定义的值用于沿 x 轴均匀分隔数据点。实例图表使用文本编码，因此使用 -1 来代表未定义的值。如果使用简单编码，则使用一个下划线 (_) 来代表未定义或缺少的值；如果使用扩展编码，则使用两个下划线 (__) 来代表未定义或缺少的值。 按照形状标记中所述，使用 chm 参数指定数据点形状标记。 按照颜色中所述，指定线颜色。	cht=lxy chd=t:0,30,60,70,90,95,100| 20,30,40,50,60,70,80| 10,30,40,45,52| 100,90,40,20,10| -1| 5,33,50,55,7

Sparkline 图

以如下方式指定 Sparkline 图

cht=ls

Sparkline 图的参数与折线图的参数完全相同。唯一的区别就是轴线并非为 Sparkline 图默认绘制的。如果愿意，您可以添加轴标签，有关详细信息，请参阅多个轴标签。

返回页首

条形图

以如下方式指定条形图

cht=<bar chart type>

其中，<bar chart type> 为 bhs、bhg、bvs 或 bvg，如下表所述。

• 根据条形图类型，将多个数据集绘制成堆叠式或分组式条。
• 有关如何指定多个数据集的信息，请参阅图表数据。
• 有关可用参数的信息，请参阅可选参数（按图表类型）。

参数	说明	实例
cht=bhs cht=bvs	分别为水平和垂直条形图。 第一个实例（所有条均为深蓝色）有一个数据集。 第二个实例（有深蓝色条和浅蓝色条）有两个数据集。 正如您所看到的，多个数据集堆叠，所以您必须为每个数据集指定一种颜色。您还可以为一个数据集中的每个数据点指定一种颜色。请参阅颜色以获取详细信息。 第二个实例不使用数据换算，所以组合值大于 100 的数据点无法换算。 第三个实例使用数据换算，所以条能正确换算。	cht=bhs chco=4d89f9 cht=bvs chco=4d89f9,c6d9fd chd=t:10,50,60,80,40| 50,60,100,40,20 cht=bvs chco=4d89f9,c6d9fd chd=t:10,50,60,80,40| 50,60,100,40,20 chds=0,160
cht=bhg cht=bvg	分别为带有指定颜色的水平和垂直条形图；将多个数据集进行分组。	cht=bhg chco=4d89f9,c6d9fd cht=bvg chco=4d89f9,c6d9fd
chbh	条形图大小的处理方式与其他图表类型不同。 对于类型为 bhs 和 bhg 的水平条形图，以及类型为bvs 和 bvg 的垂直条形图，图表大小由 chs 参数确定。如果指定（用 chs）的大小太小，则会剪裁图表（仅部分可见）。 因此，您可能想要指定条宽和间距，形式如下 chbh= <bar width in pixels>, <optional space between bars in a group>, <optional space between groups> 注意：如果未提供第三个参数（组间间距），则该参数值默认为组间间距值的一半。	chbh 已省略 cht=bhs chbh=10 cht=bhs

返回页首

饼图

以如下方式指定饼图

cht=<pie chart type>

其中，<pie chart type> 为 p 或 p3，如下表所述。

• 仅支持一个数据集；后续数据集将被忽略。
• 有关可用参数的信息，请参阅可选参数（按图表类型）。

注意：Google 图表 API 根据图表大小参数 (chs) 指定的宽度和高度的最小值来计算圆的半径。如果指定的大小过小，则会剪裁图表。如果要包含标签，则可能需要将宽度指定为高度的两倍。

参数	说明	实例
cht=p	二维饼图。 除非另行指定，否则饼块的颜色呈深橙色到浅黄色渐变。按照颜色中所述，指定其他颜色。 按照饼图标签中所述，使用 chl 指定标签。	cht=p chs=200x100
cht=p3	三维饼图。 按照饼图标签中所述，使用 chl 指定标签。	cht=p3 chs=250x100

返回页首

维恩图

以如下方式指定维恩图

cht=v

提供一个数据集，其中：

• 前三个值指定三个圆 A、B 和 C 的相对大小
• 第四个值指定 A 与 B 相交的面积
• 第五个值指定 A 与 C 相交的面积
• 第六个值指定 B 与 C 相交的面积
• 第七个值指定 A、B、C 三者相交的面积

参数	说明	实例
cht=v	在该实例中，为第一个圆、第二个圆和第三个圆指定的面积依次为 100、80 和 60。这三个圆两两相交部分的面积均为 30。 有关维恩图的可用参数的信息，请参阅可选参数（按图表类型）。	cht=v chd=t:100,80,60,30,30,30,10

返回页首

散点图

以如下方式指定散点图

cht=s

• 散点图使用与其他图表类型不同的多个数据集。一个散点图中只能显示一个数据集。然而您使用三个数据集来指定每个点的 x 轴位置、y 轴位置和可选大小。有关如何指定多个数据集的信息，请参阅图表数据。
• 有关可用参数的信息，请参阅可选参数（按图表类型）。

参数	说明	实例
cht=s	提供两个数据集：第一个数据集指定 x 坐标，第二个数据集指定 y 坐标。 数据点的默认形状为一个圆。按照形状标记中所述，使用 chm 参数指定其他数据点形状。 数据点的颜色默认为蓝色。按照颜色中所述，指定其他颜色。 在该实例中，您将注意到数据点大小的变化。要实现这一点，请指定第三个数据集。任何使用 chm 参数指定的大小确定了任何数据点的最大大小。由可选的第三个数据集来确定每个数据点绘制的大小。因此，例如，用 chm 以及您在第三个数据集中使用的编码类型的最大可能值（9、100.0 或 ..）指定 20 像素的大小会生成 20 像素的数据点。	cht=s

返回页首

雷达图

以如下方式指定雷达图

cht=r 或 cht=rs

对于 r 类型的图表，点与直线相连。

对于 rs 类型的图表，点与样条线相连以形成曲线。

• 多个数据集绘制为多条线。
• 有关如何指定多个数据集的信息，请参阅图表数据。
• 有关可用参数的信息，请参阅可选参数（按图表类型）。

参数	说明	实例
cht=r	在雷达图中，在图表中心与周界之间绘制数据点。零值点（0、A 或 AA，视编码类型而定）在中心绘制，而编码所用的最大值（100、9 或 ..）在周界处绘制。中间值分布在两者之间。 数据集中代表第一个值和最后一个值的点在图表中心和图表顶部之间绘制。其余点绕图表沿顺时针方向均匀分布，并且在这种类型的雷达图中，在每一对点之间都会绘制直线。 该实例显示了具有一个数据集的简单雷达图。	cht=r chd=t:10,20,30,40,50,60,70,80,90
	您可以通过添加颜色、折线样式和轴标签来添加更多信息以使之更清楚。 该实例是一个具有两个数据集的更复杂的雷达图。按照图表颜色中所述，使用 chco 指定每个数据集的颜色。 按照折线样式中所述，使用 chls 指定折线样式。 最后使用 chxt、chxl 和 chxr 指定轴标签 - 有关详细信息，请参阅多个轴标签。对于雷达图，x 轴在圆中绘制，而 y 轴和 r 轴从图表中心向顶部绘制。忽略 t 轴。 注意：包含标签时，将通过标签数或数据点数减去一（取两者中较大的一个）来确定围绕图表的数据点的间距。	chco=FF0000,FF9900 chls=2.0,4.0,0.0|2.0,4.0,0.0 chxt=x chxl=0:|0|45|90|135|180|225|270|315 chxr=0,0.0,360.0
	该实例与上一实例使用相同的参数，但是为两个数据集指定了填充区域。 另外还添加了网格。有关详细信息，请参阅网格线。	chg=25.0,25.0,4.0,4.0 chm= B,FF000080,0,1.0,5.0| B,FF990080,1,1.0,5.0
	最后的实例在上一实例的基础上添加了形状标记。请注意，水平线形状标记（用 chm=h 指定）在雷达表中生成圆，而垂直线（chm=v 和 chm=V）从图表中心向周界绘制。 用 chm=h,0000FF,... 指定外围蓝色圆 用 chm=h,3366CC80,... 指定内部的部分透明的蓝色圆 用 chm=V,00FF0080,... 指定部分透明的绿色线（1 点和 2 点之间） 用 chm=V,008000,... 指定深绿色线（在 8 点方向上） 用 chm=v,00A000,... 指定绿色线（在 10 点方向上） 请参阅形状标记和颜色以获取信息。 您还可以指定范围标记，请参阅范围标以获取详细信息。	chm= h,0000FF,0,1.0,4.0| h,3366CC80,0,0.5,5.0| V,00FF0080,0,1.0,5.0| V,008000,0,5.5,5.0| v,00A000,0,6.5,4

返回页首

地图

以如下方式指定地图

cht=t 和 chtm=<geographical area>

其中，<geographical area> 为以下类型之一：

• africa
• asia
• europe
• middle_east
• south_america
• usa
• world

例如：

chs=440x220
chd=s:_
cht=t
chtm=world

注意：带有数据换算的文本编码对于地图来说不可用。而是使用文本编码、简单编码或扩展编码。

以下是默认的世界地图。实例中使用的大小（440 x 220 像素）是所有地图可用的最大值。还请注意，数据集仅包含一个字符，即下划线 (_)。这可在简单编码中指定缺少的值，并为我们提供尽可能最简单的地图。您可以为地图上的一个或多个国家/地区设置颜色，使地图比上述实例更加生动、信息更加丰富。

联合使用三个参数在地图上指定颜色，以及如何将这些颜色应用于地图中的每个国家/地区或州：

chco=<default color><colors for gradient>
chld=<list of codes for each country or state to be colored>
chd=<list of values for each country or state to be colored>

其中：

• <default color>、<colors for gradient> 是 RRGGBB 格式的十六进制数字。默认颜色应用于未在 chld 参数中列出的国家/地区或州。其他颜色指定用于为在 chld 参数中列出的所有国家/地区着色的颜色渐变的极限。应用的颜色视 chd 参数中的国家/地区值而定。
• <list of codes for each country or state to be colored> 为以下任一内容的列表：
  • 按 ISO3166 定义的国家/地区的 ISO 3166-1-alpha-2 代码，请参阅 ISO 3166 国家/地区代码。
  • 美国州代码中列出的美国州代码。
• <list of values for each country or state to be colored> 是简单编码、文本编码或扩展编码的值。第一个值用于 chld 参数中列出的第一个国家/地区，第二个值用于第二个国家/地区，以此类推。最低的数据值 A、0 或 AA（取决于使用的编码类型）以 chco 中的 <color for start of gradient> 指定的颜色绘制。最高的数据值 9、100 或 .. 以 <color for end of gradient> 指定的颜色绘制。中间值给出中间颜色。

例如：

chtm=africa
chco=ffffff,edf0d4,13390a
chld=MGKETN
chd=s:Af9
chf=bg,s,EAF7FE

在此实例中：

• 第一种颜色（ffffff，指定白色）用于 chld 参数中未列出的所有国家/地区
• 第二种和第三种颜色指定从浅绿 (edf0d4) 到深绿 (13390a) 的颜色渐变
  
• 要着色的国家是马达加斯加 (MG)、肯尼亚 (KE) 和突尼斯 (TN)
• 马达加斯加的值为 A，这是简单编码中最小的可能值，等于零。
  因此，马达加斯加以浅绿色 (edf0d4) 绘制
• 肯尼亚的值为 f，等于 31。因此，肯尼亚以浅绿和深绿之间的中间色来绘制
• 突尼斯的值为 9，这是简单编码中的最大可能值，等于 61。
  因此，突尼斯以深绿色 (13390a) 绘制
• 水域以浅蓝色 (EAF7FE) 着色，被视为地图的背景色。请参阅图表区域和背景填充中所述的 chf 参数。

以下是一个色彩更丰富的实例：

chco=
f5f5f5,
edf0d4,
6c9642,
13390a

该地图中的默认颜色是 f5f5f5。使用 edf0d4、6c9642 和 13390a 来指定颜色渐变。使用文本编码来解释如何应用颜色是最简单的：

• 零值以最浅的绿色 (edf0d4) 来绘制
• 值 50 以中等深度的绿色 (6c9642) 来绘制
• 值 100 以最深的绿色 (13390a) 来绘制
• 这些数字之间的值位于最接近的颜色之间。所以，例如，值 75 处于中等深度的绿色 (6c9642) 和最深的绿色 (13390a) 中间。

返回页首

Google 指数

以如下方式指定 Google 指数

cht=gom

有关可用参数的信息，请参阅可选参数（按图表类型）。

参数	说明	实例
cht=gom	该实例为使用默认颜色（左边的红色经橙色和黄色渐变到右边的绿色）的 Google 指数。请参阅图表颜色以获取有关指定其他颜色的信息。 请参阅饼图和 Google 指数标签以获取有关指定箭头末尾显示的文本的信息。	cht=gom chd=t:70

返回页首

QR 代码

QR 代码是一种常见的二维条码，也称为硬链接或现实世界超链接。QR 代码存储文本，这些文本可以是超链接、联系信息、电话号码甚至诗歌！

在人眼看来，QR 代码像象形文字，但是任何安装了相应软件的设备都可以读取它们。这类设备从专用阅读器到移动电话，都可以。所以具有适当移动设备的人员可以扫描比如杂志上的 QR 代码，这会导致手机的浏览器根据 QR 代码中的网址启动。

使用以下项指定 QR 代码

cht=qr
chl=<text to encode>
choe=<output encoding>

其中：

• <text to encode> 是 QR 代码的文本。它必须通过 UTF8 进行网址编码。请注意，hello 和 world 之间的空格在以下实例中被写为 %20。
• <output encoding> 可以指定如何对输出进行编码（可选）。如果没有指定，则使用默认设置 UTF-8。可用选项有：Shift_JIS、UTF-8 或 ISO-8859-1。

例如：

cht=qr
chl=hello%20world
choe=UTF-8

上面 21 行 x 21 列处的实例 QR 代码是最简单的可能的代码，被称为第 1 版：

• 第 1 版有 21 行、21 列，最多可以编码 25 个字母数字字符
• 第 2 版有 25 行、25 列，最多可以编码 47 个字母数字字符
• 第 3 版有 29 行、29 列，最多可以编码 77 个字母数字字符
• ...
• 第 40 版有 177 行、177 列，最多可以编码 4,296 个字母数字字符

图表 API 根据您提供的字符数生成相应的 QR 代码版本。例如，如果您提供 55 个字母数字字符，图表 API 会生成第 3 版 QR 代码。这根据您选择使用的错误纠正 (EC) 级别进行修改，有关 EC 级别的详细信息请参阅下节。

注意：此处很容易将行数和列数与 QR 代码大小混淆。您提供的字符数决定行数和列数。图表的像素大小照常由 chs 决定（请参阅图表大小）。

错误纠正和边界

有四个可用的 EC 级别。默认级别 (L) 允许在错读、缺少或不明的 QR 代码不超过 7% 的情况下读取 QR 代码。其他级别提供更高的 EC 级别。可以编码的字符数随着 EC 级别的提高而减少。请参阅版本、错误纠正和最大字符数以获取详细信息。

默认边界为 4 个模块。这意味着在 QR 代码周围划出了一个相当于顶部四行、底部四行以及左边四列和右边四列的空白区域。这是 QR 阅读器的最低要求。

或者，可以使用以下项指定 EC 级别和边界

chld=<EC level>|<margin>

其中：

• <EC level> 是以下级别之一
  - L 允许恢复 7% 的 QR 代码
  - M 允许恢复 15% 的 QR 代码
  - Q 允许恢复 25% 的 QR 代码
  - H 允许恢复 30% 的 QR 代码
  （或其相应的小写 l、m、q 或 h）。
• <margin> 定义 QR 代码周围的边界（或空白区域）。默认图片的边界相当于图表 4 行/列。
  

版本、错误纠正和最大字符数

在生成 QR 代码之前，请考虑将使用什么设备来读取您的代码。最好的 QR 代码阅读器能够读取第 40 版代码，移动设备最多只能读取第 4 版。

建议您保持第 4 版，这一版相当于默认 EC 级别的约 100 个字母数字字符。

有关每个版本和 EC 级别的最大字符数的信息，请参阅下表。

版本	行 x 列	EC 级别	EC 级别和字符类型允许的最大字符数
			数字：0 到 9	字母数字： 0 到 9，A 到 Z， 空格，$ % * + - . / :	二进制	汉字
1	21x21	L	41	25	17	10
		M	34	20	14	8
		Q	27	16	11	7
		H	17	10	7	4
2	25x25	L	77	47	32	20
		M	63	38	26	16
		Q	48	29	20	12
		H	34	20	14	8
3	29x29	L	127	77	53	32
		M	101	61	42	26
		Q	77	47	32	20
		H	58	35	24	15
4	33x33	L	187	114	78	48
		M	149	90	62	38
		Q	111	67	46	28
		H	82	50	34	21
10	57x57	L	652	395	271	167
		M	513	311	213	131
		Q	364	221	151	93
		H	288	174	119	74
40	177x177	L	7,089	4,296	2,953	1,817
		M	5,596	3,391	2,331	1,435
		Q	3,993	2,420	1,663	1,024
		H	3,057	1,852	1,273	784

更多信息和标准

QR 代码是 Denso Wave, inc. 的商标。正如您所期望的一样，Denso Wave 网站包括大量有关 QR 代码的有用信息。

QR 代码被批准作为以下标准：

• AIM 国际（国际自动识别设备制造商协会）标准（ISS - QR 代码），1997 年 10 月。
• JEIDA（日本电子行业发展协会）标准 (JEIDA-55)，1998 年 3 月。
• JIS（日本行业标准）标准 (JIS X 0510)，1999 年 1 月。
• ISO 国际标准 (ISO/IEC18004)，2000 年 6 月。

QR 代码阅读器软件可从许多渠道获得。Google 免费提供 QR 代码阅读器库 Zebra Crossing (ZXing)。有关详细信息，请参阅 http://code.google.com/p/zxing/。

有关条码中的信息的标准编码的初略指南，请参阅条码内容。

返回页首

颜色

使用至少 6 个字母的十六进制值字符串以 RRGGBB 格式来指定颜色。例如：

• FF0000 = 红色
• 00FF00 = 绿色
• 0000FF = 蓝色
• 000000 = 黑色
• FFFFFF = 白色

通过附加介于 00 和 FF 之间的十六进制值，您可以随意指定透明度，其中 00 代表完全透明，FF 代表完全不透明。例如：

• 0000FFFF = 不透明蓝色
• 0000FF00 = 透明蓝色
  

有以下颜色选项可供使用：

• 图表颜色
• 实体填充 扩展！
• 线性渐变
• 线性条纹
• 填充区域

返回页首

图表颜色

以如下方式指定折线图、条形图、维恩图、Google 指数和饼块的颜色

chco=
<color1>,
...
<colorn>

其中，<color1> 及所有后续颜色值均为 RRGGBB 格式的十六进制数字。

参数	说明	实例
chco	该实例包含了三个数据集，并指定了三种颜色。	chco=ff0000,00ff00,0000ff
	该实例也包含了三个数据集，但仅指定了两种颜色。因此，最后两条线均绘制为最后一种颜色（红色 ff0000）。	chco=ff0000,0000ff
	对于条形图，如果指定的颜色数少于数据集的数目，则颜色会交替显示。在以下图表中，第三个数据集 Bar 以第一种颜色绘制。如果仅指定了一种颜色，则所有数据集都将被绘制为该颜色。	chco=ff0000,00ff00 chd=s:FOE,THE,Bar
	这是指定了三种颜色的同一图表。	chco=ff0000,00ff00,0000ff chd=s:FOE,THE,Bar
	通过使用管道符 (|) 来分隔 chco 颜色参数，在单个数据集中为每个数据点指定颜色。	chco=ff0000|00ff00|0000ff chd=s:elo
	对于饼图，如果指定的颜色数少于饼块的数目，则颜色会进行渐变。	chco=0000ff
	对于维恩图，如果指定的颜色数少于圆的数目，则重复使用指定的最后一种颜色。	chco=00ff00,0000ff
	对于 Google 指数，指定至少两种颜色，如果您要在二者之间指定渐变，则可指定更多颜色。	chco=ffffff,ffaaaa,ff0000

返回页首

填充区域

以如下方式指定填充区域

chm=
b,<color>,<start line index>,<end line index>,<any value>|
...
b,<color>,<start line index>,<end line index>,<any value>

其中：

• <color> 是 RRGGBB 格式的十六进制数字。
• <start line index> 是从其开始填充的线的索引。该参数取决于使用 chd 指定数据集的顺序。指定的第一个数据集的索引为零 (0)，第二个数据集的索引为 1，以此类推。
• <end line index> 是从其结束填充的线的索引。该参数取决于使用 chd 指定数据集的顺序。指定的第一个数据集的索引为零 (0)，第二个数据集的索引为 1，以此类推。
• <any value> 被忽略。

使用管道符 (|) 来分隔多个填充区域。

参数	说明	实例
chm=b	在指定包含第一批最大值的数据集时，请谨慎： 如要填充从图表的顶部到第一条线的区域，则包括一个只含有最大的数据值（9、100.0 或 ..，取决于使用的编码类型）的数据集。 如要填充从最后一条线到图表的底部的区域，则包括一个只含有最小的数据值（A、0 或 AA，取决于使用的编码类型）的数据集。 按照颜色中所述，使用 chco 将这些线本身绘制为黑色。	chd=s: 99, cefhjkqwrlgYcfgc, QSSVXXdkfZUMRTUQ, HJJMOOUbVPKDHKLH, AA chm= b,76A4FB,0,1,0|（浅蓝色） b,224499,1,2,0|（蓝色） b,FF0000,2,3,0|（红色） b,80C65A,3,4,0（绿色） chco=000000,000000,000000, 000000,000000
	为形成对比，已删除该图表的第一个和最后一个数据集（99 和 AA）。 另外，忽略了 chco，这样线颜色会根据图表类型参数进行绘制。在该实例中，参数为 cht=lc，因此使用了默认的线颜色（黄色）。	chd=s: cefhjkqwrlgYcfgc, QSSVXXdkfZUMRTUQ, HJJMOOUbVPKDHKLH, chm= b,224499,0,1,0|（蓝色） b,FF0000,1,2,0|（红色） b,80C65A,2,3,0（绿色）
chm=B	对于一个数据集，使用 chm=B 更为简便。在该实例中，线以下的区域均被填充。请注意，chm=b 在雷达图上不起作用，但是您可以使用 chm=B。	chm=B,76A4FB,0,0,0 chd=s:ATSTaVd21981uocA

返回页首

实体填充

以如下方式指定实体填充

chf=
<bg or c or a>,s,<color>|
<bg or c or a>,s,<color>

其中：

• <bg or c or a> 为：
  - bg，用于背景填充
  - c，用于图表区域填充
  - a，对整个图表应用透明度。
• <s> 表示实体填充。
• <color> 是 RRGGBB 格式的十六进制数字。
• 管道符 (|) 用于分隔填充定义。在第二个定义后不需要使用管道符。

您可以指定：

• 用于折线图、Sparkline 图和散点图的背景填充、图表区域填充和透明度。
• 用于条形图、饼图和维恩图的背景填充和透明度。
• 用于地图和雷达图的背景填充。

参数	说明	实例
chf	该实例将图片背景填充为浅灰色 (efefef)。	chf=bg,s,efefef
	该实例将背景填充为浅灰色 (efefef)，并将图表区域填充为黑色 (000000)。	chf=bg,s,efefef| c,s,000000
	请注意使用十六进制值 20 和 80 分别为背景和图表区域指定透明度的效果。	chf=bg,s,efefef20| c,s,00000080
	该实例对整个图表应用透明度。	chf=a,s,efefeff0

返回页首

线性渐变

以如下方式指定折线图、Sparkline 图、条形图、维恩图、雷达图和散点图的线性渐变

chf=<bg or c>,lg,<angle>,<color 1>,<offset 1>,<color n>,<offset n>

其中：

• <bg or c> 中的 bg 为背景填充，c 为图表区域填充。
• lg 指定线性渐变。
• <angle> 指定渐变的角度，角度值介于 0（水平）和 90（垂直）之间。
• <color x> 是 RRGGBB 格式的十六进制数字。
• <offset x> 指定颜色为纯色的点，其中：0 指定最右侧的图表位置而 1 指定最左侧的位置。

参数	说明	实例
chf	图表区域使用的是水平（从左到右）线性渐变，指定的角度为零度 (0)。 指定的第一种颜色为蓝色 (76A4FB)。该颜色在图表最右侧是纯色。 指定的第二种颜色为白色 (ffffff)。该颜色在图表最左侧是纯色。 图表背景绘制为灰色 (EFEFEF)。	chf= c,lg,0,76A4FB,1,ffffff,0| bg,s,EFEFEF
	图表区域使用的是对角线（从左下角到右上角）线性渐变，指定的角度为四十五度 (45)。 指定的第一种颜色为白色 (ffffff)。该颜色在图表的左下角是纯色。 指定的第二种颜色为蓝色 (6A4FB)。该颜色在图表的右上角是纯色。 图表背景还是绘制为灰色 (EFEFEF)。	chf= c,lg,45,ffffff,0,76A4FB,0.75| bg,s,EFEFEF
	图表区域使用的是垂直（从上到下）线性渐变，指定的角度为九十度 (90)。 指定的第一种颜色为蓝色 (76A4FB)。该颜色在图表的顶部是纯色。 指定的第二种颜色为白色 (ffffff)。该颜色在图表的底部是纯色。 图表背景还是绘制为灰色 (EFEFEF)。	chf= c,lg,90,76A4FB,0.5,ffffff,0| bg,s,EFEFEF

返回页首

线性条纹

以如下方式指定折线图、Sparkline 图、条形图、维恩图、雷达图和散点图的线性条纹

chf=<bg or c>,ls,<angle>,<color 1>,<width 1>,<color n>,<width n>

其中：

• <bg or c> 中的 bg 为背景填充，c 为图表区域填充。
• ls 指定线性条纹。
• <angle> 指定渐变的角度，角度值介于 0（垂直）和 90（水平）之间。
• <color> 是 RRGGBB 格式的十六进制数字。
• <width> 必须介于 0 和 1 之间，其中 1 是图表的全宽度。条纹重复出现，直到填满图表。

参数	说明	实例
chf	包含角度指定为零度 (0) 的垂直条纹的图表区域。 指定的第一种颜色（深灰色 CCCCCC）是以图表宽度的 20% 绘制的第一个条纹。 指定的第二种颜色（白色 ffffff）也是以图表宽度的 20% 绘制的。 条纹交替出现，直到填满图表。 图表背景被忽略。	chf=c,ls,0,CCCCCC,0.2, FFFFFF,0.2
	包含角度指定为九十度 (90) 的水平条纹的图表区域。 指定的第一种颜色（灰黑色 999999）是以图表宽度的 25% 绘制的第一个条纹。 指定的第二种和第三种颜色（深灰色 CCCCCC 和白色 FFFFFF）也是以图表宽度的 25% 绘制的。 条纹交替出现，直到填满图表。 图表背景被忽略。	chf= c,ls,90, 999999,0.25, CCCCCC,0.25, FFFFFF,0.25

返回页首

标签

有以下标签类型可供使用：

• 图表标题
• 图表图例
• 饼图标签
• 多个轴标签

图表标题

以如下方式指定图表标题

chtt=<chart title>

参数	说明	实例
chtt	使用加号 (+) 指定一个空格。 使用管道符 (|) 进行强制换行。	chtt=Site+visitors+by+month| January+to+July
	根据需要，您还可以使用如下方式设置标题的颜色和大小 chts=<color>,<fontsize> 如果指定（用 chs）的大小太小，则会剪裁图表（仅部分可见）。	chtt=Site+visitors chts=FF0000,20

返回页首

图例

以如下方式指定图例

chdl=<first data set label>|<n data set label>

参数	说明	实例
chdl	按照颜色中所述，配合使用 chdl 和线颜色。 在这些实例中，第一个、第二个和第三个数据集分别被绘制为红色、绿色和蓝色。	chdl=NASDAQ|FTSE100|DOW chco=ff0000,00ff00,0000ff
		chdl=First|Second|Third chco=ff0000,00ff00,0000ff
chdl 和 chdlp	将 chdl 与 chdlp 参数配合使用来如下指定图例的位置： chdlp=b 将图例放在底部 chdlp=t 将图例放在顶部 chdlp=r 将图例放在右边 chdlp=l 将图例放在左边	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=l

返回页首

饼图和 Google 指数标签

对于饼图，以如下方式指定标签

chl=
<label 1 value>|
...
<label n value>

您可以使用两个连续的管道符 (||) 指定缺少的值。

注意：若要显示标签：
- 二维图表的宽度需要大约是其高度的两倍。
- 三维图表的宽度需要大约是其高度的二点五倍。

对于 Google 指数，以如下方式指定显示在箭头上方的文本

chl=<label>

参数	说明	实例
chl	三维饼图的标签。	chl=May|Jun|Jul|Aug|Sep|Oct chs=220x100
	对于要使饼图包含标签需要多大的宽度，上面提供了良好的缩略图规则 - 但是请记住，您仍需要考虑您的标签有多长！此处，由于图表不够宽，因此仅显示了部分标签。	chl=May|June|July|August| September|October chs=220x100
	此图表的宽度需要为 280 像素才可以显示完整的标签。	chl=May|June|July|August| September|October chs=280x100
	该实例为带有标签的 Google 指数。	chl=Hello

返回页首

多个轴标签

多个轴标签可用于折线图、条形图、雷达图和散点图：

• 轴类型
• 轴标签
• 轴标签位置
• 轴范围
• 轴样式

轴类型

以如下方式指定多个轴

chxt=
<axis 1>,
...
<axis n>

可用的轴有：

• x = 底部 x 轴
• t = 顶部 x 轴
• y = 左侧 y 轴
• r = 右侧 y 轴

轴由它们在 chxt 参数规范中拥有的索引来指定。第一个轴的索引为 0，第二个轴的索引为 1，以此类推。可以通过多次包含 x、t、y 或 r 来指定多个轴。

要创建多个轴，至少需要使用 chxt 参数。如果缺少其他参数，则图表 API 会使用下文所述的默认值。

参数	说明	实例
chxt	这些实例显示了两个底部 x 轴（包含了 x 两次）、左侧和右侧 y 轴（y 和 r）及一个顶部轴 (t)。 由于轴标签被省略，因此图表 API 假设以下范围 对于折线图中的所有轴，为 0 到 100。 对于垂直条形图上的 y 轴和 r 轴，为 0 到 100，但将每个条下方的 x 轴和 t 轴标签居中并用 0 到 4 给它们加标签。 对于水平条形图上的 x 轴和 t 轴，为 0 到 100，但将每个条旁边的 y 轴和 r 轴标签居中，并用轴索引（0 到 4）给它们加标签。此外，需要降低水平图的高度，否则会剪裁图表。 请注意：为了暂时垂直而不是水平，条形图在本节的其余部分讨论。水平条形图中 y 轴和 r 轴的行为与垂直条形图中 x 轴和 t 轴的行为相同。	chxt=x,y,r,x,t

返回页首

轴标签

以如下方式指定标签

chxl=
<axis index>:|<label 1>|<label n>|
...
<axis index>:|<label 1>|<label n>

index 参数用于指定应用标签的轴的索引。
所有标签均通过管道符 (|) 分隔。

注意：必须按顺序指定轴标签（0，然后是 1、2，以此类推）。

第一个标签放置在开头，最后一个标签放置在末尾，其他标签均匀地分布在这两者之间。

参数	说明	实例
chxt 和 chxl	这些实例显示了左侧和右侧 y 轴（y 和 r）及 x 轴 (x) 的两组值。 请注意：条形图 x 轴标签在每个条下面居中。因此，与折线图不同，对条形图中的每个条都指定年份。	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 1:|0|100| 2:|A|B|C| 3:|2005|2006|2007 折线图如上，除了： 3:|2005|2005|2006|2006|2007
	如上，除了未指定 y- 轴标签（索引 1）	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| （y 轴被省略） 2:|A|B|C| 3:|2005|2006|2007 折线图如上，除了： 3:|2005|2005|2006|2006|2007

返回页首

轴标签位置

以如下方式指定标签位置

chxp=
<axis index>,<label 1 position>,<label n position>|

...
<axis index>,<label 1 position>,<label n position>

对于位置值，请使用浮点数。使用管道符 (|) 来分隔不同轴的数据。如果标签 (chxl) 被忽略，则标签文本采用位置值。

参数	说明	实例
chxp	该实例显示了左侧和右侧 y 轴（y 和 r）及一个 x 轴 (x)。 x 轴（索引 0）既无位置也无标签，因此图表 API 假定范围为 0 到 100，并均匀排列这些值。 左侧 y 轴（索引 1）既有标签（max、average 和 min），又有位置 (10,35,75)。 r 轴（索引 2）只有位置 (0,1,2,4)，因此图表 API 使用位置作为标签。为该轴指定了范围 chxr=2,0,4，有关详细信息，请参阅下节。	chxt=x,y,r chxl=1:|min|average|max chxp=1,10,35,75|2,0,1,2,4 chxr=2,0,4
	该实例显示了左侧和右侧 y 轴（y 和 r）及两个 x 轴 (x)。 与上述实例类似，除了指定了两个 x 轴的标签位置。这说明您可以通过使用 chxp 覆盖图表 API 的条形图的标签位置。	chxt=x,y,r,x chxr=2,0,4|3,0,4 chxl=1:|min|average|max chxp=0,10,35,75     |1,10,35,75     |2,0,1,2,4     |3,0,1,2,4

返回页首

轴范围

以如下方式指定范围

chxr=
<axis index>,<start of range>,<end of range>|
...
<axis index>,<start of range>,<end of range>

使用管道符 (|) 来分隔多个轴范围。

参数	说明	实例
chxr	该实例显示了左侧和右侧 y 轴（y 和 r）及一个 x 轴 (x)。 每个轴都定义了一个范围。由于未指定标签或位置，因此值将均匀分布并采用指定的范围。在条形图中，请再次注意，x 轴的处理方式不同，每个条都给定了标签。 注意：由于 r 轴（索引2）的第一个值 (1000) 大于最后一个值 (0)，因此轴方向将反向。	chxt=x,y,r chxr=0,100,500| 1,0,200| 2,1000,0
	在该实例中，仅定义了 x 轴 (x)。该轴有范围、标签和位置，因此使用了所有三组值。	chxt=x chxr=0,100,500 chxl=0:|200|300|400 chxp=0,200,300,400

返回页首

轴样式

以如下方式指定轴标签的字体大小、颜色和对齐方式

chxs=
<axis index>,<color>,<font size>,<alignment>|
...
<axis index>,<color>,<font size>,<alignment>

其中：

• <axis index> 是在 chxt 中指定的轴索引。
• <color> 是 RRGGBB 格式的十六进制数字。
• <font size> 可选。如果使用该参数，请以像素为单位指定大小。
• <alignment> 可选。默认情况下：x 轴标签居中对齐，左侧 y 轴标签右对齐，右侧 y 轴标签左对齐。要指定对齐方式，请使用 0 表示居中对齐，-1 表示左对齐，1 表示右对齐。

使用管道符 (|) 来分隔多个值。

参数	说明	实例
chxs	为第二个 x 轴指定了字体大小、颜色和对齐方式。	chxt=x,y,r,x chxr=2,0,4 chxl=3:|Jan|Feb|Mar|1:|min|average|max chxp=1,10,35,75 chxs=3,0000dd,13
	为两个 x 轴都指定了字体大小、颜色和对齐方式。	chxt=x,y,r,x chxl=3:|Jan|Feb|Mar||      0:|1st|15th|1st|15th|1st chxs=0,0000dd,10|3,0000dd,12,1

返回页首

样式

有以下样式可供使用：

• 条宽和间距
• 条形图基准线
• 折线样式
• 网格线
• 形状标记
• 水平范围标记
• 垂直范围标记

条宽和间距

对于条形图，以如下方式指定条宽和间距
chbh=
<bar width in pixels>,
<optional space between bars in a group>,
<optional space between groups>

参数	说明	实例
chbh	在第一个实例中，条宽设置为 10 像素，条间间距默认为 4 像素且组间间距默认为 8 像素。 在第二个实例中，条宽设置为 10 像素，条间间距为 5 像素且组间间距为 15 像素。 在您仅提供两个值时，请注意以下情况。在第三个实例中，条间间距设置为 8 像素。由于该值是组间间距的默认值，因此从视觉上根本无法区分哪几条是一组。但是，指定大于 8 的值甚至会更糟糕，因为不是一组的条会显示为一组。	cht=bhg chbh=10 cht=bvg chbh=10,5,15 cht=bhg chbh=10,8 cht=bhg chbh=10,15

返回页首

条形图基准线

对于条形图，以如下方式指定基准线

chp=
<value between 0 and 1 for dataset 1>,
<value between 0 and 1 for dataset n>

仅提供一个值以将相同的基准线应用于所有数据集。

参数	说明	实例
chp	在该实例中，chp 值 .5 将基准线放置在图表中间。该图表使用文本编码，所以不同值的数据点位置如下： 值 0 到 49 的数据点绘制在基准线以下 值 50 的数据点绘制在基准线上（基准线不可见，请参见本实例中的第三个数据点） 值 51 到 100 的数据点绘制在基准线以上	chp=.5 chd=t:20,35,50,10,95
chds	设置基准线的另一种方法是配合使用换算参数 (chds) 和文本编码。 实例的数据集的范围从 -60 到 120、换算范围从 -80 到 140，从而在条的上方和下方留出空间。 有关详细信息，请参阅带有数据换算的文本编码。	chd=t:30,-60,50,120,80 chds=-80,140

返回页首

折线样式

您可以为以下图表指定折线样式：

• 折线图和 Sparkline 图：指定宽度和虚线样式（颜色采用数据集颜色）
• 折线图、Sparkline 图和条形图：指定宽度、颜色和优先级

折线图和 Sparkline 图样式

以如下方式指定折线图和 Sparkline 图样式

chls=
<data set 1 line thickness>,<length of line segment>,<length of blank segment>|
...
<data set n line thickness>,<length of line segment>,<length of blank segment>


参数值为浮点数，使用管道符 (|) 来分隔多个折线样式。第一个折线样式应用于第一个数据集，第二个折线样式应用于第二个数据集，以此类推。

参数	说明	实例
chls	在该实例中，使用 3,6,3 来指定粗虚线，使用 1,1,0 来指定细实线。 请参阅图表颜色以获取有关指定折线图颜色的信息。	chls=3,6,3|1,1,0

返回页首

折线图、Sparkline 图和条形图的折线样式

以如下方式指定折线图和条形图的折线样式

chm=D,<color>,<data set index>,<data point>,<size>,<priority>

其中：

• <color> 是 RRGGBB 格式的十六进制数字。
• <data set index> 是在其上绘制折线的数据集的索引。第一个数据集的索引为 0，第二个数据集的索引为 1，以此类推。
• <data point> 为零。
• <size> 是标记的大小，单位为像素。
• <priority> 决定绘制条、折线、标记和填充的顺序：
  1 指定在条和标记之上绘制折线。
  0 为默认值，指定在条之上和标记之下绘制折线。
  -1 指定在条和标记之下绘制折线。

参数	说明	实例
chm=D	该实例为条形图上的数据折线。优先级设置为 1，所以折线在条之前绘制。	chm= D,4D89F9,0,0,5,-1
	该实例为 Sparkline 图。Sparkline 图与折线图一致，除了没有默认的轴外，功能与折线图完全相同。	chm= D,C6D9FD,1,0,8| D,4D89F9,0,0,4

返回页首

网格线

以如下方式指定网格

chg=
<x axis step size>,
<y axis step size>,
<length of line segment>,
<length of blank segment>

参数值可以是整数，也可以包括一位小数，例如 10.0 或 10.5。

参数	说明	实例
chg	该实例仅定义了步长大小 (20,50)，因此图表 API 默认使用虚网格线。	chg=20,50
	在该实例中定义了步长大小 (20,50)、线段 (1) 和空白段 (5)。	chg=20,50,1,5
	将空白段指定为零 (0)，可以得到实网格。	chg=20,50,1,0

返回页首

形状标记和范围标记

对于折线图、雷达图、条形图和散点图，使用 chm 指定形状标记和范围标记。范围标记可以水平也可以垂直。

• 形状标记
• 范围标记

形状标记

以如下方式指定形状标记

chm=
<marker type>,<color>,<data set index>,<data point>,<size>,<priority>|
...
<marker type>,<color>,<data set index>,<data point>,<size>,<priority>

其中：

• <marker type> 是以下字符之一：
  a 代表箭头。
  c 代表叉号。
  d 代表菱形。
  o 代表圆形。
  s 代表正方形。
  t 代表文本。
  v 代表从 x 轴到数据点的垂线。
  V 代表延伸到图表顶部的垂线。
  h 代表贯穿图表的水平线。
  x 代表 x 形。
  
  
• <color> 是 RRGGBB 格式的十六进制数字。
• <data set index> 是要绘制标记的线的索引。第一个数据集的索引为 0，第二个数据集的索引为 1，以此类推。
• <data point> 对于除水平线外的所有标记来说是指定绘制标记所在的数据点的浮点值。这可能是：0（对于第一个数据点），1（对于第二个数据点等）或 -1（对于所有数据点）。指定一个分数以在两个数据点之间插入一个标记。对于水平线，请参见下表中第一个实例。
• <size> 是标记的大小，单位为像素。
• <priority> 决定绘制条、折线、标记和填充的顺序：
  -1 指定在图表的所有其他部分之前绘制标记。这意味着如果在同一位置绘制其他图表元素，则该标记将隐藏。
  0 为默认值，指定在条或折线之上、其他标记之下绘制标记。
  1 指定在图表所有其他部分之上绘制标记。这意味着如果在同一位置绘制该标记，则其他图表元素将隐藏。
  

使用管道符 (|) 来分隔多个标记。

参数	说明	实例
chm	该实例为完整的形状标记和折线标记集。 列表中的最后一个标记 h 是与垂直线 v 和 V 相交的水平线。对于这种类型的标记，不指定数据点。而是使用 0.0 来将线放在图表底部，使用 1.0 来将线放在图表顶部，使用二者之间的值来插入。该实例中有一个值为 0.3，所以在图表上部约三分之一处绘制折线。	chm= c,FF0000,0,1.0,20.0| d,80C65A,0,2.0,20.0| a,990066,0,3.0,9.0| o,FF9900,0,4.0,20.0| s,3399CC,0,5.0,10.0| v,BBCCED,0,6.0,1.0| V,3399CC,0,7.0,1.0| x,FFCC33,0,8.0,20.0| h,000000,0,0.30,0.5
	该实例为散点图上的标记类型 s。 请参阅散点图部分，以获取有关设置每个数据点大小的详细信息。	chm= s,FF0000,1,1.0,10.0
	该实例为两个数据集使用的是菱形和圆形。 如果两个数据点占用同一位置（通过具有相同的 x 和 y 值），则绘制指定的第一个点。在该实例中，圆形的优先级比菱形高。 注意使用 -1 将一个数据集中的所有数据点设置为相同的形状。	chm= o,ff9900,0,-1,10.0| d,ff9900,1,-1,10.0
	这是将文本作为标记的条形图。按照与数据相同的顺序指定文本标记。 可选的第五个值决定优先级： 0 为默认值，此时在条之上和其他标记之下绘制文本。这是您在实例图表从上到下的第二个条 (April desktop hits) 中看到的。 1 表示在条和其他标记之上绘制文本。 -1 表示在条和其他标记之下绘制文本。这是您在实例图表从上到下的第三个条 (May mobile hits) 中看到的。	chm= tApril+mobile+hits,000000,0,0,13| tMay+mobile+hits,000000,0,1,13,-1| tApril+desktop+hits,000000,1,0,13| tMay+desktop+hits,000000,1,1,13

返回页首

范围标记

对于折线图、雷达图、条形图和散点图，以如下方式指定水平范围标记和垂直范围标记

chm=
<r or R>,<color>,<any value>,<start point>,<end point>|
...
<r or R>,<color>,<any value>,<start point>,<end point>

其中：

• <r or R> 中，r 代表水平范围，R 代表垂直范围。
• <color> 是 RRGGBB 格式的十六进制数字。
• <any value> 被忽略。
• <start point>：
  - 对于水平范围标记来说是范围在 y 轴上的起始位置，其中 0.00 是下端点，1.00 是上端点。
  - 对于垂直范围标记来说是范围在 x 轴上的起始位置，其中 0.00 左端点，1.00 是右端点。
• <end point>：
  - 对于水平范围标记来说是范围在 y 轴上的终止位置，其中 0.00 是下端点，1.00 是上端点。
  - 对于垂直范围标记来说是范围在 x 上的终止位置，其中 0.00 是左端点，1.00 是右端点。

使用管道符 (|) 来分隔多个范围标记。

参数	说明	实例
chm=r	范围标记可以是一条线，也可以是一条颜色带。在该实例中，第一个标记是一条浅蓝色 (E5ECF9) 的颜色带，而第二个标记是一条黑色 (000000) 线。	chm= r,E5ECF9,0,0.75,0.25| r,000000,0,0.1,0.11
chm=R	该实例是针对垂直范围标记的相同实例。在该实例中，第一个标记是一条红色 (ff0000) 线，而第二个标记是一条浅蓝色 (A0BAE9) 带。	chm= R,ff0000,0,0.1,0.11| R,A0BAE9,0,0.75,0.25
chm= R...|r...	您可以混合使用水平范围标记和垂直范围标记。请注意，如果指定的标记重叠，则最后一个标记的优先级比前边标记的优先级高。在该实例中，最后指定的是水平标记，因此水平标记会绘制在垂直标记上面。	chm= R,ff0000,0,0.1,0.11| R,A0BAE9,0,0.75,0.25| r,E5ECF9,0,0.75,0.25| r,000000,0,0.1,0.11
chm=r	该 Sparkline 图将淡水平线和右边 y 轴上的图表标签结合在一起。	chm= r,000000,0,0.499,0.501| r,000000,0,0.998,1.0| r,000000,0,0.0,0.002

返回页首

字符映射

简单编码字符值

简单编码映射关系提供如下：

字符	值
A	0
B	1
C	2
D	3
E	4
F	5
G	6
H	7
I	8
J	9
K	10
L	11
M	12
N	13
O	14
P	15
Q	16
R	17
S	18
T	19
U	20
V	21
W	22
X	23
Y	24
Z	25
a	26
b	27
c	28
d	29
e	30
f	31
g	32
h	33
i	34
j	35
k	36
l	37
m	38
n	39
o	40
p	41
q	42
r	43
s	44
t	45
u	46
v	47
w	48
x	49
y	50
z	51
0	52
1	53
2	54
3	55
4	56
5	57
6	58
7	59
8	60
9	61

返回页首

扩展编码字符值

需要使用一个 63x63 的网格来映射扩展编码的全部 4096 个值。这样一个网格在类似于本页面的 HTML 页面中可能不易于阅读。因此，建议您使用电子表格来建立自己的网格。下文提供了所需网格的一小部分。

要为扩展编码映射关系建立电子表格，请执行以下操作：

1. 创建电子表格，其中一行中依次包含大写字母 (A-Z)、小写字母 (a-z)、0 到 9（包括 0 和 9）、连字符 (-) 和句点 (.)。
2. 在左侧创建包含相同值的一列。
3. 在“列 A 行 A”中键入零 (0)，在“列 A 行 B”中键入一 (1)，以此类推，直到“列 A 行句点 (.)”为 63。参阅下文，以获取所需列的一部分。
4. 使“列 B 行 A”等于“列 A 行 A”加 64。将该单元格复制到列 B 中其余的单元格中。
5. 将列 B 复制到其他所有列中。
6. 表中的最后一个值：列句点 (.):行句点 (.) 的值应为 4095。

要阅读该表，请先查找列，然后查找行。例如：

• 7 = AH
• 133 = CF
• 3975 = -H
• 4037 = .F

	A	B	C	->	9	连字符 (-)	句点 (.)
A	0	64	128	...	3904	3968	4032
B	1	65	129	...	3905	3969	4033
C	2	66	130	...	3906	3970	4034
D	3	67	131	...	3907	3971	4035
E	4	68	132	...	3908	3972	4036
F	5	69	133	...	3909	3973	4037
G	6	70	134	...	3910	3974	4038
H	7	71	135	...	3911	3975	4039
I	8	72	136	...	3912	3976	4040
J	9	73	137	...	3913	3977	4041
K	10	74	138	...	3914	3978	4042
L	11	75	139	...	3915	3979	4043
M	12	76	140	...	3916	3980	4044
N	13	77	141	...	3917	3981	4045
O	14	78	142	...	3918	3982	4046
P	15	79	143	...	3919	3983	4047
Q	16	80	144	...	3920	3984	4048
R	17	81	145	...	3921	3985	4049
S	18	82	146	...	3922	3986	4050
T	19	83	147	...	3923	3987	4051
U	20	84	148	...	3924	3988	4052
V	21	85	149	...	3925	3989	4053
W	22	86	150	...	3926	3990	4054
X	23	87	151	...	3927	3991	4055
Y	24	88	152	...	3928	3992	4056
Z	25	89	153	...	3929	3993	4057
a	26	90	154	...	3930	3994	4058
b	27	91	155	...	3931	3995	4059
c	28	92	156	...	3932	3996	4060
d	29	93	157	...	3933	3997	4061
e	30	94	158	...	3934	3998	4062
f	31	95	159	...	3935	3999	4063
g	32	96	160	...	3936	4000	4064
h	33	97	161	...	3937	4001	4065
i	34	98	162	...	3938	4002	4066
j	35	99	163	...	3939	4003	4067
k	36	100	164	...	3940	4004	4068
l	37	101	165	...	3941	4005	4069
m	38	102	166	...	3942	4006	4070
n	39	103	167	...	3943	4007	4071
o	40	104	168	...	3944	4008	4072
p	41	105	169	...	3945	4009	4073
q	42	106	170	...	3946	4010	4074
r	43	107	171	...	3947	4011	4075
s	44	108	172	...	3948	4012	4076
t	45	109	173	...	3949	4013	4077
u	46	110	174	...	3950	4014	4078
v	47	111	175	...	3951	4015	4079
w	48	112	176	...	3952	4016	4080
x	49	113	177	...	3953	4017	4081
y	50	114	178	...	3954	4018	4082
z	51	115	179	...	3955	4019	4083
0	52	116	180	...	3956	4020	4084
1	53	117	181	...	3957	4021	4085
2	54	118	182	...	3958	4022	4086
3	55	119	183	...	3959	4023	4087
4	56	120	184	...	3960	4024	4088
5	57	121	185	...	3961	4025	4089
6	58	122	186	...	3962	4026	4090
7	59	123	187	...	3963	4027	4091
8	60	124	188	...	3964	4028	4092
9	61	125	189	...	3965	4029	4093
连字符	62	126	190	...	3966	4030	4094
句点	63	127	191	...	3967	4031	4095

返回页首

ISO 3166 国家/地区代码

下表按字母顺序列出了 ISO 3166-1 中给出的 246 个国家名称（简体中文官方简称）以及对应的 ISO 3166-1-alpha-2 代码元素。

绘制地理区域类型为 africa、asia、europe、middle_east、south_america 和 world 的地图时将使用这些代码。有关详细信息，请参阅本文档中的地图。

国家名称	ISO 3166-1-alpha-2 代码
A
阿富汗	AF
奥兰群岛	AX
阿尔巴尼亚	AL
阿尔及利亚	DZ
美属萨摩亚	AS
安道尔	AD
安哥拉	AO
安圭拉	AI
南极洲	AQ
安提瓜和巴布达	AG
阿根廷	AR
亚美尼亚	AM
阿鲁巴	AW
澳大利亚	AU
奥地利	AT
阿塞拜疆	AZ
B
巴哈马	BS
巴林	BH
孟加拉	BD
巴巴多斯	BB
白俄罗斯	BY
比利时	BE
伯利兹	BZ
贝宁	BJ
百慕大	BM
不丹	BT
玻利维亚	BO
波斯尼亚和黑塞哥维那	BA
博茨瓦纳	BW
布韦岛	BV
巴西	BR
英属印度洋领地	IO
文莱达鲁萨兰国	BN
保加利亚	BG
布基纳法索	BF
布隆迪	BI
C
柬埔寨	KH
喀麦隆	CM
加拿大	CA
佛得角	CV
开曼群岛	KY
中非共和国	CF
乍得	TD
智利	CL
中国	CN
圣诞岛	CX
科科斯（基林）群岛	CC
哥伦比亚	CO
科摩罗	KM
刚果	CG
刚果民主共和国	CD
库克群岛	CK
哥斯达黎加	CR
科特迪瓦	CI
克罗地亚	HR
古巴	CU
塞浦路斯	CY
捷克共和国	CZ
D
丹麦	DK
吉布提	DJ
多米尼克	DM
多米尼加共和国	DO
E
厄瓜多尔	EC
埃及	EG
萨尔瓦多	SV
赤道几内亚	GQ
厄立特里亚	ER
爱沙尼亚	EE
埃塞俄比亚	ET
F
福克兰群岛（马尔维纳斯）	FK
法罗群岛	FO
斐济	FJ
芬兰	FI
法国	FR
法属圭亚那	GF
法属波利尼西亚	PF
法属南部领地	TF
G
加蓬	GA
冈比亚	GM
格鲁吉亚	GE
德国	DE
加纳	GH
直布罗陀	GI
希腊	GR
格陵兰岛	GL
格林纳达	GD
瓜德罗普	GP
关岛	GU
危地马拉	GT
格恩西岛	GG
几内亚	GN
几内亚比绍	GW
圭亚那	GY
H
海地	HT
赫德岛和麦克唐纳岛	HM
罗马教廷（梵蒂冈城国）	VA
洪都拉斯	HN
中国香港特别行政区	HK
匈牙利	HU
I
冰岛	IS
印度	IN
印度尼西亚	ID
伊朗伊斯兰共和国	IR
伊拉克	IQ
爱尔兰	IE
曼岛	IM
以色列	IL
意大利	IT
J
牙买加	JM
日本	JP
泽西岛	JE
约旦	JO
K
哈萨克斯坦	KZ
肯尼亚	KE
基里巴斯	KI
朝鲜民主主义人民共和国	KP
韩国	KR
科威特	KW
吉尔吉斯斯坦	KG
L
老挝人民民主共和国	LA
拉脱维亚	LV
黎巴嫩	LB
莱索托	LS
利比里亚	LR
阿拉伯利比亚民众国	LY
列支敦士登	LI
立陶宛	LT
卢森堡	LU
M
中国澳门特别行政区	MO
前南斯拉夫马其顿共和国	MK
马达加斯加	MG
马拉维	MW
马来西亚	MY
马尔代夫	MV
马里	ML
马耳他	MT
马绍尔群岛	MH
马提尼克	MQ
毛里塔尼亚	MR
毛里求斯	MU
马约特	YT
墨西哥	MX
密克罗尼西亚联邦	FM
摩尔多瓦共和国	MD
摩纳哥	MC
蒙古	MN
黑山	ME
蒙塞拉特岛	MS
摩洛哥	MA
莫桑比克	MZ
缅甸	MM
N
纳米比亚	NA
瑙鲁	NR
尼泊尔	NP
荷兰	NL
荷属安的列斯	AN
新喀里多尼亚	NC
新西兰	NZ
尼加拉瓜	NI
尼日尔	NE
尼日利亚	NG
纽埃	NU
诺福克岛	NF
北马里亚纳群岛	MP
挪威	NO
O
阿曼	OM
P
巴基斯坦	PK
帕劳	PW
巴勒斯坦被占领土	PS
巴拿马	PA
巴布亚新几内亚	PG
巴拉圭	PY
秘鲁	PE
菲律宾	PH
皮特凯恩	PN
波兰	PL
葡萄牙	PT
波多黎各	PR
Q
卡塔尔	QA
R
留尼旺	RE
罗马尼亚	RO
俄罗斯联邦	RU
卢旺达	RW
S
圣巴泰勒米	BL
圣赫勒拿	SH
圣基茨和尼维斯	KN
圣卢西亚	LC
圣马丁岛	MF
圣皮埃尔和密克隆	PM
圣文森特和格林纳丁斯	VC
萨摩亚	WS
圣马力诺	SM
圣多美和普林西比	ST
沙特阿拉伯	SA
塞内加尔	SN
塞尔维亚	RS
塞舌尔	SC
塞拉利昂	SL
新加坡	SG
斯洛伐克	SK
斯洛文尼亚	SI
所罗门群岛	SB
索马里	SO
南非	ZA
南乔治亚和南桑德威奇群岛	GS
西班牙	ES
斯里兰卡	LK
苏丹	SD
苏里南	SR
斯瓦尔巴和扬马延	SJ
斯威士兰	SZ
瑞典	SE
瑞士	CH
阿拉伯叙利亚共和国	SY
T
中国台湾省	TW
塔吉克斯坦	TJ
坦桑尼亚联合共和国	TZ
泰国	TH
东帝汶	TL
多哥	TG
托克劳	TK
汤加	TO
特立尼达和多巴哥	TT
突尼斯	TN
土耳其	TR
土库曼斯坦	TM
特克斯和凯科斯群岛	TC
图瓦卢	TV
U
乌干达	UG
乌克兰	UA
阿拉伯联合酋长国	AE
英国	GB
美国	US
美国本土外小岛屿	UM
乌拉圭	UY
乌兹别克斯坦	UZ
V
瓦努阿图	VU
梵蒂冈城国	参阅罗马教廷
委内瑞拉	VE
越南	VN
英属维尔京群岛	VG
美属维尔京群岛	VI
W
瓦利斯和富图纳	WF
西撒哈拉	EH
Y
也门	YE
Z
赞比亚	ZM
津巴布韦	ZW

返回页首

美国州代码

下表列出了美国境内各个州的代码。绘制地理区域类型为 usa 的地图时将使用这些代码。有关详细信息，请参阅本文档中的地图。

AL Alabama	LA Louisiana	OH Ohio
AK Alaska	ME Maine	OK Oklahoma
AZ Arizona	MD Maryland	OR Oregon
AR Arkansas	MA Massachusetts	PA Pennsylvania
CA California	MI Michigan	RI Rhode Island
CO Colorado	MN Minnesota	SC S Carolina
CT Connecticut	MS Mississippi	SD S Dakota
DE Delaware	MO Missouri	TN Tennessee
FL Florida	MT Montana	TX Texas
GA Georgia	NE Nebraska	UT Utah
HI Hawaii	NV Nevada	VT Vermont
ID Idaho	NH New Hampshire	VA Virginia
IL Illinois	NJ New Jersey	WA Washington
IN Indiana	NM New Mexico	WV W Virginia
IA Iowa	NY New York	WI Wisconsin
KS Kansas	NC N Carolina	WY Wyoming
KY Kentucky	ND N Dakota

返回页首