图表功能清单

chdlp - [可选] 图例的位置和图例条目的顺序。您可以指定 <position> 和/或 <label_order>。如果同时指定，请使用竖条字符分隔。如果您希望在图例中跳过 chdl 中的空图例条目，则可以向任何值添加一个“s”。示例：chdlp=bv、chdlp=r、chdlp=bv|r、chdlp=bvs|r

<opt_position>

[可选] 指定图例在图表上的位置。如需指定图例与图表区域或图片边框之间的额外内边距，请使用 chma 参数。从下列值中选择一个：

• b - 图例位于图表底部，横向显示图例条目。
• bv - 图例位于图表底部，纵向显示图例条目。
• t - 图例位于图表顶部，横向显示图例条目。
• tv - 图例位于图表顶部，纵向显示图例条目。
• r - [默认] 图例位于图表右侧，纵向列显示图例条目。
• l - 图例位于图表左侧，纵向显示图例条目。

<opt_label_order>

[可选] 标签在图例中的显示顺序。从下列值中选择一个：

• l - [垂直图例的默认选项] 按指定给 chdl 的顺序显示标签。
• r - 按照为 chdl 指定的反向顺序显示标签。在堆叠条形图中，这有助于按照条形的显示顺序
  显示图例。
• a - [水平图例的默认选项] 自动排序：大致表示按长度排序，由短到短首先以 10 像素块为单位。当两个元素的长度相同（分成 10 个像素的块）时，首先列出的元素会最先显示。
• 0,1,2... - 自定义标签顺序。这是 chdl 中从零开始的标签索引的列表，以英文逗号分隔。

chdls - [可选] 指定图例文本的颜色和字体大小。

<color>

图例文字颜色，采用 RRGGBB 十六进制格式。

<size>

图例文字的点大小。

示例

返回页首

图表边距 chma [所有图表]

您可以指定图表边距的大小（以像素为单位）。从指定的图表尺寸 (chs) 向内计算外边距；增加外边距不会增加总图表尺寸，而是会根据需要缩小图表区域。

默认情况下，边距为计算图表大小后剩余的外边距。此默认值因图表类型而异。您指定的外边距是一个最小值；如果图表区域为外边距留出了空间，则外边距大小将为剩余大小；您不能挤压小于任何图例和标签所要求的外边距。下图显示了图表的基本组成部分：

图表外边距包括轴标签和图例区域。除非您使用 chma 指定较大的宽度，否则图例区域会自动调整大小以精确适应文本，在这种情况下，它会将边距尺寸扩展得更宽，将图表区域压缩得更小。您无法通过指定过小的大小来剪裁图例，但您可以让图例占据的空间超过实际需求。 提示：在条形图中，如果条形具有固定大小（默认设置），则图表区域宽度无法缩小。您必须使用 chbh 指定更小或可调整大小的条形。

语法

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>

<left_margin>、<right_margin>、<top_margin>、<bottom_margin>

图表区域周围的最小外边距尺寸（以像素为单位）。请提高此值以添加一些内边距，以防止轴标签触碰图表的边界。

<opt_legend_width>、<opt_legend_height>

[可选] 图例周围的外边距宽度（以像素为单位）。使用此方法可避免图例触碰到图表区域或图片边缘。

示例

返回页首

轴样式和标签 [线条、条形图、Google-o-meter、雷达、散点图]

您可以指定要在图表上显示的轴，并为它们提供自定义标签以及位置、范围和样式。

默认情况下，并非所有图表都会显示轴线。您可以使用 chxt 参数精确指定图表应显示哪些轴。默认轴线不显示数字；您必须在 chxt 参数中指定轴才能显示数字。

您可以选择让轴显示反映数据值的数字，也可以指定自定义轴。 默认设置是显示数值，其值会调整为 0—100 之间的值。 不过，您可以使用 chxr 更改该范围以显示任何范围，还可以使用 chxs 设置值的样式（例如，显示货币符号或小数位）。

如果您选择使用自定义值（例如“周一,周二,周三”），则可以使用 chxl 参数。如需将这些标签放置在轴上的特定位置，请使用 chxp 参数。

最后，您可以使用 chxs 和 chxtc 参数指定自定义轴标签和数字轴标签的颜色、尺寸、对齐方式和其他属性。

关于字符串值的说明：标签字符串中仅允许使用安全的网址字符。为安全起见，如果字符串中包含不在字符集 0-9a-zA-Z 中的字符，您应对此类字符串进行网址编码。 您可以在 Google 可视化文档中找到网址编码器。

本部分包含以下主题：

• 可见轴 (chxt) - 要显示哪些轴。
• 轴范围 (chxr) - 每条轴的值范围。
• 自定义轴标签 (chxl) - 要在轴上显示的自定义参数。
• 轴标签位置 (chxp) - 沿每个轴的自定义标签的位置。
• 轴标签样式 (chxs) - 轴标签的颜色、大小、对齐方式和格式。
• 轴刻度线样式 (chxtc) - 特定轴的刻度线长度。

可见轴 chxt

条形图、折线图、雷达图和散点图默认显示一条或两条轴线，但这些轴线不包含值。 如需在轴线上显示值或更改显示的轴，您必须使用 chxt 参数。 默认情况下，轴值的范围是 0-100，除非您使用 chxr 属性明确进行缩放。若要隐藏折线图中的所有轴线，请在 cht 参数中的图表类型值之后指定 :nda（例如：cht=lc:nda）。

默认情况下，顶部轴和底部轴不会在值旁边显示刻度线，而左侧和右侧轴则会显示刻度线。您可以使用 chxs 参数更改此行为。

语法

chxt=
  <axis_1>
    ,...,
  <axis_n>

<axis>

要在图表中显示的轴。可用的轴包括：

• x - 底部 x 轴
• t - 顶部 x 轴 [Google-o-Meter 不支持]
• y - 左侧 y 轴
• r - 右侧 y 轴 [Google-o-Meter 不支持]

您可以指定多个相同类型的轴，例如 cht=x,x,y。此操作会沿着图表底部堆叠两组 x 轴。这在沿显示数值的轴添加自定义标签时非常有用（请参见下面的示例）。轴是从内向外绘制的，因此，如果您设置了 x,x，则第一个 x 是指最内层的副本，下一个 x 是指下一个向外的副本，依此类推。

示例

说明	示例
此示例展示了一个带有 x 轴、y 轴、顶部轴 (t) 和右侧轴 (r) 的折线图。 由于未指定标签，因此图表的所有轴的范围都默认为 0 到 100。 请注意，默认情况下，顶部轴和底部轴不会显示标签旁的刻度线。	chxt=x,y,r,t
您可以通过多次添加同一值来为每个轴添加多组标签。本示例显示了两组 x 轴和两组 y 轴。如此处所示，这在仅使用默认轴标签时并不特别有用。不过，您可以使用 chxl 参数为每个轴指定自定义标签。	<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x1" />x1"}
此示例展示了一个水平条形图，包含一条 x 轴、一条 y 轴、一条顶部 t 轴和一条右侧 r 轴。 由于省略了轴标签，因此 Chart API 为 x 轴和 t 轴显示了 0 到 100 的范围。 y 轴和 r 轴的范围取决于条形的数量。本例中有五个条形，因此 Chart API 显示了 0 到 4 的范围。第一个标签位于第一个条形底部的中心，第二个标签位于第二个条形底部的中心，以此类推。	chxt=x,y,r,t
您可以通过在图表类型后面指定 :nda 来禁止折线图中的默认轴。	cht=lc:nda

返回页首

轴范围 chxr

您可以使用 chxr 参数分别指定显示在每条轴上的值的范围。请注意，这不会更改图表元素的缩放比例，而只会更改轴标签的缩放比例。 如果您希望轴上的数字描述实际的数据值，请将 <start_val> 和 <end_val> 分别设置为数据格式范围的下限值和上限值。如需了解详情，请参阅轴缩放。

如果您想指定轴的范围，则必须使用 chxt 参数将其设为可见。

若要指定自定义轴值，请使用 chxl 参数。

语法

请使用竖线字符 ( |) 分隔多个轴标签范围。

chxr=
  <axis_index>,<start_val>,<end_val>,<opt_step>
    |...|
  <axis_index>,<start_val>,<end_val>,<opt_step>

<axis_index>

要应用标签的轴。这是 chxt 指定的轴数组中的从零开始的索引。例如，在 chxt=x,r,y 中，r 轴为 1。

<start_val>

一个数字，用于定义此轴的最低值。

<end_val>

一个数字，用于定义此轴的最大值。

<opt_step>

[可选] 轴上刻度之间的计数步骤。没有默认的步长值；计算步长以尝试显示一组间隔合理的标签。

示例

返回页首

自定义轴标签 chxl

您可以使用 chxl 参数在任意轴上指定自定义字符串轴标签。您可以根据需要指定任意数量的标签。如果您（使用 chxt 参数）显示一条轴，但未指定自定义标签，则将应用标准的数字标签。若要指定自定义数字范围，请改用 chxr 参数。

如需为标签设置轴的具体位置，请使用 chxp 参数。

语法

请为您想要加标签的每个轴指定一个参数集。请使用竖线字符 (|) 分隔多组标签。

chxl=
  <axis_index>:|<label_1>|...|<label_n>
    |...|
  <axis_index>:|<label_1>|...|<label_n>

<axis_index>

要应用标签的轴。这是 chxt 参数数组的索引。例如，如果您有 chxt=x,x,y,y，则索引 0 为第一个 x 轴，1 为第二个 x 轴。

<label_1>| ... |<label_n>

要沿此轴放置的一个或多个标签。这些标记可以是字符串或数值；字符串不需要用引号括起来。label_1 显示在轴的最低位置，而 label_n 显示在最高位置。其他标签则以相等的间距排列在这两个标签之间。使用 + 号表示空格。无法在标签中指定换行符。请使用竖线字符分隔标签。注意 ：请勿在 chxl 参数中的最后一个标签之后放置竖线。

示例

说明	示例
此图表展示了如何向两条轴添加自定义标签。请注意这些值是如何均匀分布的，以及最后一个 chxl 值如何不以竖线结尾。	chxt=x,y chxl= 0:|Jan|Feb|March|April|May| 1:|Min|Mid|Max
此示例包含左右 y 轴的轴标签（y 和 r），并且还包含两组 x 轴值 (x)。您可以考虑使用 chxs 在 y 轴上添加刻度线。	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 1:|0|50|100| 2:|A|B|C| 3:|2005|2006|2007
此示例包含左侧和右侧 y 轴上的轴标签（y 和 r）。它还包含两组 x 轴值 (x)。请注意，较低 x 轴集合的空标签，用于将值隔开。 此例左侧 y 轴上的轴标签采用了默认值。	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 2:|A|B|C| 3:|2005||2006||2007
如果您想添加一个通用标签来描述整个轴（例如，将一条轴标记为“费用”，另一条轴标记为“学生”），请使用 chxt 属性在每条边上再添加一个轴，然后使用 chxl 向每边添加一个自定义标签，并使用 chxp 将其设在轴的中间位置。	chxt=x,x,y,y chxl=1:|Martinis|3:|Score chxp=1,50|3,50

返回页首

轴标签位置 chxp

您可以指定要显示的轴标签，无论是使用默认标签，还是使用通过 chxl 指定的自定义标签。如果您没有使用此参数指定确切位置，则标签将沿轴等距离以默认步长值均匀分布。如果未指定 chxl，则刻度线标签将采用默认值（通常是数据值，或条形图中的条形数字）。

语法

请使用竖线字符 (|) 分隔多个定位集。

chxp=
  <axis_1_index>,<label_1_position>,...,<label_n_position>
    |...|
  <axis_m_index>,<label_1_position>,...,<label_n_position>

<axis_index>

您要为其指定位置的轴。这是 chxt 参数数组中的索引。例如，如果您有 chxt=x,x,y,y，则索引 0 为第一条 x 轴，1 为第二条 x 轴，以此类推。

<label_1_position>,...,<label_n_position>

：标签沿轴的位置。这是以英文逗号分隔的数值列表，其中每个值用于设置 chxl 数组中相应标签的位置：第一个条目适用于第一个标签，依此类推。位置是该轴范围内的值。请注意，除非您使用 chxr 指定了自定义范围，否则此值将始终为 0—100。位置的数量必须与该轴的标签数量相同。

示例

说明	示例
此例在图表的指定位置添加了 r 轴标签。标签文本使用 chxl 参数指定。 指定位置为 0 的标签位于 y 轴或 r 轴的底部，或者位于 x 轴或 t 轴的左侧。 指定位置为 100 的标签位于 y 轴或 r 轴的顶部，或者位于 x 轴或 t 轴的右侧。	chxt=x,y,r chxl=2:|min|average|max chxp=2,10,35,75
此示例演示了如何仅在指定位置显示默认标签值。 chxp=1,10,35,75 - y 轴应仅显示三个标签：10、35 和 75。由于未指定自定义标签文本，因此会显示这些轴值。请注意，在使用 chxp 时，您不需要以均匀的方式间隔标签。如果此处未指定 chxp，则 y 轴上的默认标签值距离为每 20 个单位，如第二张图表所示。	chxt=x,y chxp=1,10,35,75 chxt=x,y 未指定 chxp

返回页首

轴标签样式 chxs

您可以为轴标签（自定义标签和默认标签值）指定字体大小、颜色和对齐方式。同一条轴上的所有标签格式相同。如果一条轴有多个副本，则可以为每个副本设置不同的格式。您还可以指定标签字符串的格式，例如显示货币符号或尾随零。

默认情况下，顶部轴和底部轴不会在值旁边显示刻度线，而左侧和右侧轴则会显示刻度线。

语法

应使用竖线字符 (|) 分隔多个轴的值。

chxs=
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
   |...|
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>

<axis_index>axis_index

此属性适用的轴。这是 chxt 参数中的从零开始的索引。

<opt_format_string>opt_format_string

[可选] 这是一个可选的格式字符串，如果使用，紧跟在轴索引编号后面，中间不加英文逗号。它以字母 N 开头，后面都是可选值： 格式字符串语法如下：
       N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
每个元素的含义如下：

• <preceding_text> - 每个值前面的字面量文本。
• *...* - 用星号括起来的可选块，您可以在该块中指定数字的格式详细信息。以下值均受支持且均为可选：
  • <number_type> - 数值的数字格式。选择以下任一选项：
    • f - [默认] 浮点格式。 也可以考虑使用 <小数位数> 值指定精度。decimal_places
    • p - 百分比格式。系统会自动附加 % 符号。注意：使用此格式时，从 0.0 到 1.0 的数据值会映射到 0 到 100%（例如，0.43 将显示为 43%）。
    • e - 科学记数法格式。
    • c<CUR> - 使用相应的货币标记将数字设置为指定的货币格式。将 <CUR> 替换为由三个字母组成的货币代码。示例：cEUR 表示欧元。 您可以在 ISO 网站上找到一系列代码，不过并非所有符号都受支持。
  • <decimal_places> - 一个整数，用于指定要显示的小数位数。该值会四舍五入（非截断）到此长度。默认值为 2。
  • z - 显示尾随零。默认值为“否”。
  • s - 显示组分隔符。默认值为“否”。
  • x 或 y - 按指定方式显示 x 坐标或 y 坐标中的数据。x 数据的含义因图表类型而异：请使用您的图表进行实验以确定其含义。默认值为 'y'。
• <following_text> - 每个值后面的字面量文本。

<opt_label_color>

应用于轴文本（但不是轴线）的颜色，采用 RRGGBB 十六进制格式。轴线颜色是使用 opt_axis_color 单独指定的。默认值为灰色。

<opt_font_size>

[可选] 指定字体大小（以像素为单位）。此参数是可选的。

<opt_alignment>

[可选] 标签对齐方式。对于顶部轴或底部轴，这说明标签如何与其上方或下方的刻度线对齐；对于左侧轴或右侧轴，这说明标签如何在其边界框内（与轴接触）对齐。指定以下某个数字：

• -1 - 顶部或底部：标签位于刻度线的右侧；左侧或右侧：标签在其区域中左对齐。r 轴标签的默认值。
• 0 - 顶部或底部：标签位于刻度线的中心；左侧或右侧：标签在其区域内居中。x 轴和 t 轴标签的默认值。
• 1 - 顶部或底部：标签位于刻度线的左侧；左侧或右侧：标签在其区域中右对齐。y 轴标签的默认值。

<opt_axis_or_tick>

[可选；Google-o-meter 不支持] 是否显示此轴的刻度线和/或轴线。刻度线和轴线仅适用于最内层的轴（例如，不支持两个 x 轴最外侧的轴）。请使用以下某个值：

• l（小写“L”）- 仅绘制轴线。
• t - 仅绘制刻度线。刻度线是轴标签旁边的小线条。
• lt - [默认] 同时绘制轴线和所有标签的刻度线。
• _ -（下划线）既不绘制轴线，也不绘制刻度线。 如果您要隐藏轴线，请使用此值。

<tick_color>tick_color

[可选；Google-o-meter 不支持] 刻度线颜色，采用 RRGGBB 十六进制格式。默认值为灰色。

<opt_axis_color>opt_axis_color

[可选] 此轴线的颜色，采用 RRGGBB 十六进制格式。默认值为灰色。

示例

说明	示例
为第二条 x 轴（1 月、2 月、3 月）指定了字体大小和颜色。	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,0,t
为右侧 y 轴指定了字体大小、颜色和对齐方式。已绘制刻度线，但未绘制轴线。	chxt=x,y,r,x chxl=3:|Jan|Feb|Mar|      2:|min|average|max chxp=2,10,35,95 chxs=2,0000DD,13,-1,t,FF0000
此图表包含三个数据集，并显示了三组轴标签，每个系列一个。每组标签都使用自定义格式字符串设置格式，如下所述： 0N*e,000000| 0 表示第一个数据系列 N 表示格式字符串 * 表示格式说明符的开头 e 表示科学记数法 * 表示格式说明符的结尾 000000 表示黑色文本。 1N*cUSD*Mil,FF0000| 1 表示第二个系列 N 表示格式字符串 * 表示格式说明符的开头 c 表示货币标记 USD 指定美元作为要使用的货币标记 * 表示格式说明符的结尾 Mil 是跟在字符串后面的字面量 FF0000 表示红色文本。 2N*sz2*,0000FF 2 表示第三个系列 N 表示格式字符串 * 表示格式说明符的开头 s 表示显示分组说明符（在美国英语语言区域，即每三个零一个英文逗号） z2 表示显示两个尾随零 0000FF 表示蓝色文本。 轴标签范围是使用 chxr 参数（axis_index、start、end、step）设置的。 如果未设置，则此值的默认值为 0—100。	chd=s:   984sttvuvkQIBLKNCAIi,   DEJPgq0uov17zwopQODS,   AFLPTXaflptx159gsDrn chxr=   0,0,1000000,250000|   1,0,60|   2,0,5000 chxs=   0N*e,000000|   1N*cUSD*Mil,FF0000|   2N*sz2*,0000FF

返回页首

轴刻度线样式 chxtc

您可以为特定轴指定长刻度线。通常，这用于在图表的整个长度上扩展刻度线。使用 chxs 参数可更改刻度线颜色。

应使用竖线字符 (|) 分隔多个轴的值。一系列的值应以英文逗号分隔。

语法

chxtc=
  <axis_index_1>,<tick_length_1>,...,<tick_length_n>
    |...|
  <axis_index_m>,<tick_length_1>,...,<tick_length_n>

<axis_index>axis_index

此属性适用的轴。这是 chxt 参数中的从零开始的索引。请使用竖线分隔符分隔不同轴的值。

<tick_length_1>,...,<tick_length_n>

相应轴上的刻度线长度，以像素为单位。如果指定了单个值，则该值将应用于所有值；如果指定了多个值，轴刻度线将循环显示该轴的值列表。正值绘制在图表区域外部，并会被图表边界裁剪。最大正值为 25。负值会在图表区域内部绘制，并会被图表区域边界裁剪。

示例

说明	示例
使用 chxtc 创建红色长刻度线的示例。此处的刻度线长度超过了图表区域宽度，但系统为了适应图表而剪裁了刻度线。 chxt=x,y,r,x - 显示一条左轴、一条右轴和两条底部轴。 chxl=2:|min|average|max|3:|Jan|Feb|Mar - 分配给“r”（右侧）和外侧 x 轴的标签文本。 chxp=2,10,35,95 - 三个标签沿 r 轴（索引=2）的自定义标签位置。 chxs=2,0000dd,13,-1,t,FF0000 - r 轴的轴标签样式：文本颜色、文本大小、左对齐、带红色刻度线。 chxtc=1,10|2,-180 - y 轴和 r 轴的轴刻度线长度。 第一个值指定轴外侧长度为 10 像素的刻度线。第二个值指定了轴内长 180 像素的刻度线；负数表示刻度线位于轴内侧，并且系统会对刻度线进行剪裁以适应图表。	chxt=x,y,r,x chxl=   2:|min|average|max|   3:|Jan|Feb|Mar chxp=2,10,35,95 chxs=   2,0000dd,13,-1,t,FF0000 chxtc=1,10|2,-180
此图表展示了交替的刻度线长度。chxtc 为 y 轴指定了两个刻度线长度值（5 和 15），图表上绘制的刻度线会在这两个值之间切换。	chxt=x,y chxtc=   1,5,15

返回页首

背景填充 chf [所有图表]

您可以为图表数据区域和/或整个图表背景指定填充颜色和样式。填充类型包括纯色填充、条纹填充和渐变。 您可以为不同区域（例如整个图表区域，或仅数据区域）指定不同的填充。图表区域填充会覆盖背景填充。所有填充均使用 chf 参数指定，您可以在同一图表中混合使用不同的填充类型（纯色、条纹、渐变），只需用竖线字符 ( | ) 分隔值即可。图表区域填充会覆盖图表背景填充。

纯色填充 chf [所有图表]

您可以为背景和/或图表区域指定纯色填充，或者为整个图表指定透明度值。您可以使用竖线字符 (|) 指定多种填充。（地图：仅限背景）。

语法

chf=<fill_type>,s,<color>|...

<fill_type>fill_type

要填充的图表部分。指定以下某个值：

• bg - 背景填充
• c - 图表区域填充。不支持地图图表。
• a - 将整个图表（包括背景）设为透明。 <color> 的前六位数会被忽略，只有最后两位数（透明度值）会应用到整个图表和所有填充。
• b<index> - 条形纯色填充（仅限条形图）。 将 <index> 替换为条形的系列索引，即可以纯色填充条形。其效果类似于在条形图中指定 chco。有关示例，请参阅条形图系列颜色。

秒

表示纯色或透明填充。

<color>

填充颜色，采用 RRGGBB 十六进制格式。对于透明度，前六位数会被忽略，但无论如何都必须将其包含在内。

示例

返回页首

渐变填充 chf [线条、柱形、Google-o-meter、雷达、散点、维恩]

您可以对图表区域或背景应用一种或多种渐变填充。渐变填充是从一种颜色淡出到另一种颜色。（饼图、Google-O-Me 图表：仅限背景。）

每个渐变填充都指定一个角度，然后指定两种或更多颜色锚定到指定位置。颜色会随着从一个锚点移动到另一个锚点而变化。您必须至少具有两种具有不同 <color_centerpoint> 值的颜色，以便一种可以淡入另一种。每个额外的渐变均由 <color>,<color_centerpoint> 对指定。

语法

chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1>
    ,...,
  <color_n>,<color_centerpoint_n>

<fill_type>fill_type

要填充的图表区域。以下其中一列：

• bg - 背景填充
• c - 图表区域填充。
• b<index> - 条形渐变填充（仅限条形图）。 将 <index> 替换为条形的系列索引，以便用渐变色进行填充。有关示例，请参阅条形图系列颜色。

lg

指定渐变填充。

<angle>

一个数字，用于指定从 0（横向）到 90（纵向）的渐变角度。

<color>

填充的颜色，采用 RRGGBB 十六进制格式。

<color_centerpoint>

指定颜色的定位点。当该锚点接近另一个锚点时，颜色将从该点开始淡出。值范围是从 0.0（底部或左侧边缘）到 1.0（顶部或右侧边缘），按 <angle> 指定的角度倾斜。

示例

返回页首

条纹填充 chf [线条、条形图、Google-o-meter、雷达、散点图、维恩]

您可以为图表区域或整个图表指定条纹背景填充。（饼图、Google-O-Meter 图表：仅限背景。）

语法

chf=
  <fill_type>,ls,<angle>,<color_1>,<width_1>
    ,...,
  <color_n>,<width_n>

<fill_type>fill_type

要填充的图表区域。以下其中一列：

• bg - 背景填充
• c - 图表区域填充
• b<index> - 条形条纹填充（仅限条形图）。 将 <index> 替换为条形的系列索引，以便用条纹填充。有关示例，请参阅条形图系列颜色。

ls

指定线性条纹填充。

<angle>

所有条纹相对于 y 轴的角度。对竖条纹使用 0，或针对横向条纹使用 90。

<color>

此条纹的颜色，采用 RRGGBB 十六进制格式。再为每一个其他条纹重复 <color> 和 <width>。您必须至少有两种条纹。条纹会交替显示，直到图表填满。

<width>

此条纹的宽度，介于 0 到 1 之间，其中 1 为图表的全宽。系统会重复使用条纹，直到将图表填满。 再为每一个其他条纹重复 <color> 和 <width>。您必须至少有两种条纹。条纹会交替显示，直到图表填满。

示例

说明	示例
bg,ls,0 - 背景条纹填充与 y 轴（平行于 y 轴）夹角为零度的条纹。条纹填充了图表背景以及图表区域。 CCCCCC,0.15 - 第一种条纹为深灰色，宽度为图表的 15%。 FFFFFF,0.1 - 第二条条纹是白色的，宽度为图表的 10%。	chf=   bg,ls,0,   CCCCCC,0.15,   FFFFFF,0.1
c,ls,90 - 带有与 y 轴成九十度角的水平条纹的图表区域。条纹填充了图表区域，但图表背景被忽略。 999999,0.25 - 第一种条纹为深灰色，宽度为图表的 25%。 CCCCCC,0.25 - 与第一种条纹相同，但为浅灰色。 FFFFFF,0.25 - 与第一种条纹相同，但为白色。	chf=   c,ls,90,   999999,0.25,   CCCCCC,0.25,   FFFFFF,0.25

返回页首

网格线 chg [线条、条形图、雷达图、散点图]

您可以使用 chg 参数在图表上指定实线或虚线网格线。

此参数不能用于指定线条的粗细或颜色。如需了解在图表上绘制线条的更多方法，请参阅形状标记（chm 类型 h、H、v 或 V）、范围标记 (chm) 和轴刻度线 (chxtc)。

语法

chg=
  <x_axis_step_size>,<y_axis_step_size>,<opt_dash_length>,<opt_space_length>,<opt_x_offset>,<opt_y_offset>

<x_axis_step_size>、<y_axis_step_size>

用于计算要在图表上显示的 x 或 y 网格线的数量。100 / step_size = 图表上的网格线数量。因此：20,25 表示 5 条垂直网格线和 4 条水平网格线。

<opt_dash_length>、<opt_space_length>

[可选] 用于定义虚线网格线。第一个参数是每条短划线的长度（以像素为单位）。 第二个参数是短划线之间的间距（以像素为单位）。将 <opt_space_length> 指定为 0 可表示实线。默认值为 4,1。

<opt_x_offset>,<opt_y_offset>

[可选] 分别偏移 x 和 y 网格线的单位数（根据图表比例）。 正值或负值。如果您指定此值，则还必须指定前面的所有值。默认值为 0,0。

示例

说明	示例
这些示例仅使用 <x_axis_step_size> 和 <y_axis_step_size> 参数。默认情况下，Chart API 会显示虚线网格。	chg=20,50 chg=20,50
此示例使用较大的空间来显示较浅的网格线 (1,5)。	chg=20,50,1,5
如需显示实线网格线，请为 <opt_space_length> 参数指定零 (0)。 此图表还指定了 10 的 x 轴偏移。	chg=20,50,1,0,10
此图表展示了 10 的 x 轴偏移和 20 的 y 轴偏移。	chg=20,50,3,3,10,20

返回页首

线条样式 chls [线条、雷达]

您可以使用 chls 参数指定线条粗细和实线/虚线样式。此参数只能用于设置折线图或雷达图表中的线条的样式；除非复合图表的基本类型为折线图，否则无法用于设置复合图表中的线条的样式。

语法

请使用竖线字符 ( |) 分隔多个线条样式；第一种样式会应用于第一行，第二种样式会应用于下一行，以此类推。如果样式少于线条数量，系统会将默认样式应用于所有未指定的线条。

chls=
  <line_1_thickness>,<opt_dash_length>,<opt_space_length>
    |...|
  <line_n_thickness>,<opt_dash_length>,<opt_space_length>

<line_1_thicknessline_1_thickness>

线条粗细（以像素为单位）。

<opt_dash_length>、<opt_space_length>

[可选] 用于定义虚线网格线。第一个参数是每条短划线的长度（以像素为单位）。 第二个参数是短划线之间的间距（以像素为单位）。如需实线，请勿指定这两个值。如果仅指定 <opt_dash_length>，则 <opt_space_length> 将设置为 <opt_dash_length>。默认值为 1,0（实线）。

示例

说明	示例
此处的虚线由 3,6,3 指定，较粗的实线由 5 指定。	chls=3,6,3|5

返回页首

动态图标标记 chem [条形图、线条、雷达、散点图]

创建图表，然后将一个或多个动态图标指定为 chem 值。chem 的语法如下所示。所有以英文分号分隔的紫色项都是可选的，可以在网址中完全省略其中任何一项。您可以添加多个标记，方法是加入多个以 | 字符分隔的语法字符串。您可以在“动态图标”页面上详细了解动态图标。

您还可以将某个图表作为动态图标嵌入另一个图表中。请参阅下文的嵌入式图表子部分。

chem=
  y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
   |...|
  y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>

s=<icon_string_Constant>icon_string_constant

来自动态图标页面的动态图标的字符串标记常量。此常量与独立图标的 chst 参数几乎相同。但是，独立图标字符串以“d_”开头的地方，您应移除该前缀，以获取等效的动态图标标记。示例：独立式图标：d_bubble_icon_text_small；等效的动态图标标记：bubble_icon_text_small。

d=<marker_data_string>marker_data_string

这种特定标记类型所需的数据。此字符串包含将在 chld 参数中用于等效独立图标的字符串，但所有 | 分隔符都应替换为英文逗号（请注意，对于多行文本，应使用英文逗号，而不是竖线标记！）。 请注意，在数据字符串中，您还必须使用 @ 符号转义以下字符：竖线 ( | ) , at ( @ ) , 等于 ( = )、英文逗号 ( , )、分号 ( ; )。示例：hello@,+world、5@@10+cents+each。

ds=<哪个系列>which_series

[可选] 此标记所属数据系列中从零开始的索引。默认值为 0。

dp=<what_points>which_points

[可选] 指定用于绘制标记的数据点。默认值为 0（序列中的第一个点）。使用以下任一格式：

• n.d - 要在哪个数据点上绘制标记，其中 n.d 是数据系列中从零开始的索引。n.d如果您指定的是非整数值，则小数点表示计算出的中间点。例如，3.5 表示点 3 和点 4 之间的一半。
• range,<start>,<end>,<step> - 在起始和结束之间（包括起始值和结束值）的每个步骤数据点上绘制标记。start 和 end 是索引值，并且可以是浮点数以表示中间值。所有值均为可选；默认值为：start=0、end=last 项、step=1。如果您跳过某个值，仍必须包含所有中间英文逗号，但不必在结尾处添加英文逗号。示例：dp=range,0,4 会在元素 0 到 4 上绘制标记；dp=range,5,10,2 会在元素 5、7 和 9 上绘制标记；dp=range,2 会在第三个点及之后的点上绘制点；dp=range,3,,1.5 会在从第四项到最后一项时每 1.5 个数据点上绘制标记。
• all - 在每个元素上绘制标记。效果等同于 range,0,end_index。示例：dp=all
• every,n - 每第 n 个标记绘制一个标记。示例：dp=every,2 会在项 0、2 和 4 上绘制标记。

py=<z_order>

[可选] 表示要在哪个图层上绘制标记（与其他标记和所有其他图表元素相比）。这是一个从 -1.0 到 1.0（包括 -1.0 和 1.0）的浮点数，其中 -1.0 表示底部，1.0 表示顶部。图表元素（折线和条形）正好在零以下。如果两个标记具有相同的值，则系统会按照网址指定的顺序绘制它们。默认值为 0.0（正好位于图表元素的上方）。

po=<x,y>

[可选] 图表中绘制标记的绝对位置。x 和 y 是两个浮点数，其中 0.0,0.0 表示左下角，1.0,1.0 表示右上角。

of=<x_offset,y_offset>

[可选] 图标从其正常位置偏移的像素数。x_offset 和 y_offset 为正整数或负整数。务必在嵌入式动态图标中指定此值，因为标记将在该点上垂直和水平居中，这意味着该点可能不会与数据标记对齐。对于直立的图钉，合适的偏移为 of=0,22；对于倾斜的图钉，合适的偏移为 of=-12,20 或 of=12,20，具体取决于倾斜的方向，但您可能需要尝试一下。默认值为 0,0。

示例

说明	示例
下面的示例展示了以独立图片形式创建并用作折线图中的标记的动态图标。 图表 1：https://chart.googleapis.com/chart?chs=300x140&cht=lc&chco=FF9900,224499& chd=t:75,74,66,30,10,5,3,1&chls=1|1& chem=y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0&chm=v,ccccFF,0,::.2,2 图表 2：https://chart.googleapis.com/chart?chst=d_bubble_icon_text_small&chld=ski|bb|Wheeee!|FFFFFF|000000	chem=   y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0 chst=   d_bubble_icon_text_small chld=   ski|bb|Wheeee!|FFFFFF|000000
请注意，动态图标标记将在水平和垂直方向上居中放置。因此，如果您使用带尾部的动态图标，则尾部不会显示在图表点上，而是标记中心。 第一个图表将标记的中心放在数据点 3 上，这实际上会使尾部略微靠近线条上的标记右侧。 第二个图表使用 of 值将标记的尾部移到所需数据点上。对于倾斜的图钉，合适的偏移为 -12,20。	chem=y;   s=map_xpin_letter;   d=pin_sleft,A,FF0000;   dp=3;   ds=1 chem=y;   s=map_xpin_letter;   d=pin_sleft,A,FF0000;   dp=3;   ds=1;   of=-12,0
如需添加多个动态图标，请重复该语法字符串，并以 | 字符分隔。 此例展示了一系列范围标记以及两个单独的标记。 请注意，垂直图钉的偏移值为 0,22 时，倾斜的图钉的偏移为 12,20，以使图钉点与其描述的系列对齐。	chem=   y;s=map_xpin_letter;d=pin_sright,A,FF0000;dp=4;ds=0;py=1;of=12,20|   y;s=map_pin_icon;d=baby,FF5555;ds=1;dp=6;of=0,22|   y;s=map_pin_icon;d=camping,DEF763;ds=2;dp=range,2,5
此示例展示了一个多行文本标记。添加文本后必须偏移标记，因为气泡会调整大小以适应文本，导致其在图表上重新居中。请注意，文本中的换行符在 d 数据字符串中以英文逗号表示。	chem=y;   s=bubble_texts_big;   d=bbbr,FFC6A5,000000,Outlier,Forgot+to+feed;   ds=0;   dp=13;   of=-120,2

嵌入式图表

您可以使用动态图标语法将一个图表嵌入另一个图表中。

嵌入式图表标记有两种样式：气泡中的嵌入式图表和无气泡的嵌入式图表。这两者的示例如下：

带气泡的图表	无气泡的图表

对于非气泡式图表和气泡式嵌入式图表，以下是 s=<icon_string_constant>;d=<marker_data_string> 参数的具体信息（此处不再描述上面介绍的参数）：

语法

Non-bubble:
  chem=y;s=ec;d=<alignment_string>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>

Bubble:
  chem=y;s=ecb;d=<frame_type>,<padding>,<frame_color>,<fill_color>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>

alignment_string

[仅限非气泡] 无气泡的嵌入式图表的哪个部分固定在数据点。选择下图中的两个字母字符串常量之一：

chart_data

嵌入式图表的数据。这是要嵌入的图表的网址中 https://chart.googleapis.com/chart? 之后的所有内容。使用下面的工具，或遵循工具下方列出的规则。

frame_type

[仅限气泡] 动态图标帧样式常量之一。

内边距

[仅限气泡] 气泡内的内边距（以像素为单位）。

frame_color

[仅气泡] 帧的颜色，表示为不带 # 标记的 6 位 HTML 颜色字符串。示例：FF00FF。

fill_color

[仅限气泡] 气泡填充颜色，表示为六位数的 HTML 颜色字符串，不带 # 标记。示例：FF00FF。

嵌入式图表数据

使用以下转换工具帮助您生成图表字符串，或者按照该工具后给定的规则手动生成图表字符串。

手动转化规则

1. 首先，请按所示顺序将参数和值对中的以下所有字符替换为以下值：

2. 然后将 parameter1=value1&parameter2=value2... 对中的所有 & 和 = 值替换为英文逗号。

返回页首

线条填充 chm [线条、雷达]

您可以使用单色填充数据折线下方的区域。

您可以将线条填充与任何其他 chm 参数结合使用，并使用竖线字符 ( |) 来分隔 chm 参数。

语法

chm=
  <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
    |...|
  <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>

<b_or_B>b_or_B

是填充到图表底部，还是仅填充到下一条折线。

• B - 从 <start_line_index> 填充到图表底部。<end_line_index> 支持一种特殊语法，可让您填充图表的某一部分。如果您的图表中只包含一条您想要填充的线条，这是最简单的方法。
• b - 在多折线图的两条折线之间填充。起始线和结束线由 <start_line_index> 和 <end_line_index> 指示。

<color>

填充颜色的 RRGGBB 格式的十六进制数字。

<start_line_index>start_line_index

填充开始处的行的索引。chd 中指定的第一个数据系列的索引为零 (0)，第二个数据系列的索引为 1，依此类推。

<end_line_index>

• 填充类型“b”- 停止填充的线条。此行必须位于当前行下方。
• 填充类型“B”- 以下选项之一：
  • any value - 此参数中的任何单个数字都将被忽略，并且填充将从指定的线条延伸到图表的底部
  • start:end - 要填充图表下方的纵向切片，请指定 start:end，其中这些数据点索引用于描述填充开始和结束的位置。这两个值都是可选的，默认值为 first_point:last_point。（请参见下方示例）。

<0>

预留 - 必须为零。

示例

说明	示例
对于单个系列，使用 chm=B 最为简单。 这会填充折线下的整个区域。 这是雷达图表唯一可用的填充区域类型。chm=b 不适用于雷达图表。	chm=B,76A4FB,0,0,0
此图表包含两条折线和两种填充。填充底部线以下和顶线上方的区域需要一种特殊方法，详见下文。	chd=s: cefhjkqwrlgYcfgc, QSSVXXdkfZUMRTUQ, HJJMOOUbVPKDHKLH, chm= b,224499,0,1,0|（蓝色） b,FF0000,1,2,0|（红色）
在多折线图表中，如需从图表顶部填充到第一行，请添加一个数据系列，其中包含该数据格式的最高数据值的两个副本。例如，“....”表示扩展编码，“100,100”表示基本文本格式，依此类推。系统会从此数据系列填充到最顶端的折线。 如需从最后一条线填充到图表底部，请添加一个数据系列，其中包含该数据格式最低数据值的两份副本。例如，扩展编码为 AAAA，基本文本格式为 0,0，以此类推。 线条本身使用 chco 以黑色绘制。	chd=e:   ....,（最高值）   cefhjkqwrlgYcfgc,   QSSVXXdkfZUMRTUQ,   HJJMOOUbVPKDHKLH,   AAAA（零值） chm=   b,76A4FB,0,1,0|（浅蓝色）   b,224499,1,2,0|（蓝色）   b,FF0000,2,3,0|（红色）   b,80C65A,3,4,0（绿色） chco=000000
此折线图包含纵向填充切片。使用线条填充类型“B”为 <end_line_index> 指定 start:end 对，即可实现此目的。 B,76A4FB,0,0:3,0 - 线 0 下的蓝色垂直填充，以数据点 0—3 为边界。 B,990000,0,7:10,0 - 线条 0 下的红色垂直填充，以数据点 7-10 为边界。 B,DEDC06,0,12:,0 - 线条 0 下的黄色纵向填充，范围为从数据点 12 到数据系列末尾。	chm=   B,76A4FB,0,0:3,0|   B,990000,0,7:10,0|   B,DEDC06,0,12:,0
此例展示了如何在雷达图表中使用折线填充。	chm=   B,FF000080,0,1.0,5.0|   B,FF990080,1,1.0,5.0

返回页首

形状标记 chm [条形图、折线图、雷达图、散点图]

您可以为图表上的所有或单个数据点指定图形标记。如果两个或多个标记占据同一点，则会按照标记在 chm 参数中的显示顺序绘制这些标记。您还可以在数据点上创建文本标记，数据点标记中对此进行了介绍。

您可以将形状标记与任何其他 chm 参数结合使用，并使用竖线字符 ( |) 来分隔 chm 参数。

语法

为要标记的每个系列指定以下一组参数。如需标记多个系列，请创建额外的参数集，并以竖线字符分隔。您无需标记所有系列。如果您不为数据系列分配标记，则该数据系列将不会收到任何标记。

在散点图中，形状标记的行为方式略有不同。如需了解详情，请参阅该文档。

chm=
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
    |...|
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>