本文档介绍了您可以使用 Chart API 创建的各种类型的折线图。
目录
图表专用功能 |
标准功能 |
图表类型 (cht
)
您可以创建多种折线图。请使用以下语法指定折线图:
语法
cht=<chart_type>
其中,<chart_type>
是以下类型之一:
参数 | 说明 | 示例 |
---|---|---|
|
一个折线图,其中数据点沿 x 轴以相等的间距排列。x默认情况下会显示轴线。如需显示轴线上的值,您必须指定 |
|
|
与 |
|
|
可让您为每个点同时指定 x 坐标和 y 坐标,而不仅仅是 y 值。 要为 chd=t:<line_1_x1>,<line_1_x2>,...|<line_1_y1>,<line_1_y2>,...| <line_2_x1>,<line_2_x2>,...|<line_2_y1>,<line_2_y2>,... 要使数据点仅沿 x 轴以相等的间距排列x,请为该系列的 x 集提供一个未定义的值。x在此示例中,红色的“独角兽”线沿 x 轴以相等的间距排列数据点。如需详细了解未定义的值,请参阅数据格式。 在此示例中,“小马”线为所有点指定确切的 x 值和 y 值,“独角兽”线沿 x 轴以相等的间距排列值。 注意:如果您要创建复合 |
cht=lxy |
数据粒度
请注意,不要高估折线图所需的数据点数量。例如,要显示巧克力冰淇淋在过去十年中的受欢迎程度,汇总每天的搜索查询会产生超过 3,600 个值。以这样的粒度绘制图表毫无意义。在宽度为 1024 像素的图表上,一个数据点大约为四分之一像素。(此外,由于数据量过大,无法传入网址)。以下示例说明了这一点。
200 像素宽的图表中包含了 40 个数据点(每个数据点占 5 个像素):
80 个数据点(每个数据点仅占 2.5 个像素):
150 个数据点(每个数据点仅占 1.3 个像素):
300 个数据点(每个数据点所占的像素不足 1):
系列颜色 chco
您可以使用 chco
参数指定特定系列或所有系列的颜色。
语法
chco= <color_1>, ... <color_n>
- <color>
- 一个 RRGGBB 格式的十六进制数字。指定单个值可将同一颜色应用于所有系列。通过添加颜色值(以英文逗号分隔),为不同的系列指定不同的颜色。如果您拥有的颜色数少于系列数,则未指定的系列将从头开始循环使用指定的颜色。
示例
说明 | 示例 |
---|---|
如果您为每个系列指定一种颜色,则系统会为每个系列指定颜色。此示例有三个数据系列并指定了三种颜色。 |
|
此示例还包含三个数据系列,但仅指定了两种颜色。由于未指定第三个数据系列的颜色,因此第三行使用第一种颜色(红色)绘制。 |
|
复合图表
您可以向折线图添加折线、K 线和形状标记,以创建复合图表。如需了解详情,请参阅复合图表。
标准功能
此网页上的其他功能均为标准图表功能。
图表标题 chtt
、chts
[所有图表]
您可以为图表标题指定文字、颜色和字体大小。
语法
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
- 指定图表标题。
- <chart_title>chart_title
- 要为图表显示的标题。您无法指定标题的显示位置,但可以选择指定字体大小和颜色。使用 + 号表示空格,使用竖线字符 (
|
) 表示换行符。
chts
[可选] - chtt
参数的颜色和字体大小。
- <color>
- 标题颜色,采用 RRGGBB 十六进制格式。默认颜色为黑色。
- <font_size>
- 标题的字体大小(以点为单位)。
- <opt_alignment>
- [可选] 标题的对齐方式。选择以下某个区分大小写的字符串值:“l”(左)、“c”(居中)、“r”(右)。默认值为“c”。
示例
说明 | 示例 |
---|---|
标题使用默认颜色和字体大小的图表。 请使用加号 ( 使用竖线字符 ( 此处未指定 |
chtt=Site+visitors+by+month| |
一个图表,带有蓝色右对齐的 20 点标题。 |
chtt=Site+visitors |
图表图例文本和样式 chdl
、chdlp
、chdls
[所有图表]
图例是图表的侧边部分,用于为每个系列提供简短的文字说明。您可以指定与此图例中的每个系列相关联的文本,并指定这些文本在图表上的显示位置。
如需了解如何设置图例周围的外边距,另请参阅 chma
。
有关字符串值的注意事项:标签字符串中只允许使用安全网址字符。为了安全起见,如果字符串中包含不属于字符集 0-9a-zA-Z
的字符,您应该对其进行网址编码。
您可以在 Google 可视化文档中找到网址编码器。
语法
chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>
chdl
- 要在图例中显示的每个系列的文字。
- <data_series_label>data_series_label
- 图例条目的文本。每个标签都适用于
chd
数组中的相应系列。使用“+”号表示空格。如果您未指定此参数,图表将不会获得图例。您无法在标签中指定换行符。图例通常会扩大以容纳图例文本,而图表区域会缩小以适应图例。
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>
- 图例文本的点大小。
示例
说明 | 示例 |
---|---|
两个图例示例。请按与数据系列相同的顺序指定图例文本。 |
chdl=NASDAQ|FTSE100|DOW
chdl=First|Second|Third |
第一个图表展示了横向图例条目( |
|
此示例演示了如何更改字体大小。 |
|
图表边距 chma
[所有图表]
您可以指定图表边距的大小(以像素为单位)。边距从指定的图表尺寸 (chs
) 向内计算;增加边距尺寸不会增加图表的总大小,但会在必要时缩小图表区域。
默认情况下,外边距为计算图表尺寸后剩下的部分。此默认值因图表类型而异。您指定的外边距是最小值;如果图表区域为外边距留出了空间,则外边距大小就是剩下的空间大小;不能将外边距压成小于任何图例和标签所要求的大小。下图显示了图表的基本组成部分:
图表外边距包括轴标签和图例区域。除非您使用 提示:在条形图中,如果条形具有固定大小(默认设置),则无法缩小图表区域宽度。您必须使用 |
语法
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>
- [可选] 图例周围的外边距宽度(以像素为单位)。 使用此选项可避免图例触碰图表区域或图片边缘。
示例
说明 | 示例 |
---|---|
在此示例中,图表每边的最小外边距为 30 像素。由于图表图例的宽度超过 30 像素,因此右侧的边距会设置为图表图例的宽度,并且与其他边距不同。 轴标签在图表区域之外,因此在外边距空间内绘制。 |
|
若要在图例周围添加外边距,请设置 在此例中,图例的宽度约为 60 像素。如果您将 |
|
轴样式和标签 [折线图、条形图表、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。 请注意,默认情况下,顶部和底部的轴不会在标签旁边显示刻度线。 |
|
您可以多次添加相同的值,从而为每条轴添加多组标签。以下示例显示了两组 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&chls=2.0&chls=200x" <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chls=200 |
此示例展示了一个水平条形图,其中包含一条 x 轴、一条 y 轴、一条顶部 t 轴和一条右侧 r 轴。 由于省略了轴标签,因此 Chart API 会为 x 轴和 t 轴显示 0 到 100 的范围。 y 轴和 r 轴的范围取决于条形的数量。在本示例中,有五个条形,因此 Chart API 显示的是 0 到 4 的范围。第一个标签在第一个条形的底部居中,第二个标签位于第二个条形底部的中心,以此类推。 |
|
您可以通过在图表类型后指定 :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
指定的轴数组中从零开始的索引。例如,r 轴在chxt=x,r,y
中为 1。 - <start_val>
- 定义此轴的下限值的数字。
- <end_val>
- 定义此轴的最高值的数字。
- <opt_step>
- [可选] 轴上刻度线之间的计数步长。没有默认的步长值;计算该步长是为了尝试显示一组间距适当的标签。
示例
说明 | 示例 |
---|---|
此示例显示了左右 y 轴( 每个轴都有一个定义的范围。由于未指定标签或位置,因此系统会从给定范围中获取值,并在该范围内以相等的间距排列各个值。在该折线图表中,这些值以相等的间距沿 x 轴排列。 r 轴的轴方向反转(索引 |
|
此例已为 x 轴指定了值。 轴标签沿轴均匀分布。<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
参数的最后一个标签后面添加竖线。
示例
说明 | 示例 |
---|---|
此图表展示了如何为两条轴添加自定义标签。请注意如何以相等的间距排列各值,以及最后的 |
chxt=x,y |
此示例包括左侧和右侧 y 轴上的轴标签( |
|
此示例包括左侧和右侧 y 轴上的轴标签( 此例左侧 y 轴上的轴标签采用了默认值。 |
|
如果要添加一个通用标签来描述整个轴(例如,将一个轴标记为“费用”,将另一个轴标记为“学生”),请使用 |
chxt=x,x,y,y |
轴标签位置 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 轴标签。标签文本使用 指定位置为 指定位置为 |
|
此示例演示了如何显示默认标签值,但仅在指定位置显示。
|
chxt=x,y
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_stringopt_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
- 显示尾随零。默认为 no。s
- 显示组分隔符。默认为 no。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_coloropt_axis_color>
- [可选] 此轴线的颜色,采用 RRGGBB 十六进制格式。默认为灰色。
示例
说明 | 示例 |
---|---|
为第二条 x 轴(1 月、2 月、3 月)指定字体大小和颜色。 |
|
为右侧 y 轴指定了字体大小、颜色和对齐方式。已绘制刻度线,但未绘制轴线。 |
|
此图表包含三个数据集,并显示三组轴标签,每个标签系列对应一个。每组标签都使用自定义格式字符串设置格式,如下所示:
轴标签范围使用 |
chd=s: |
轴刻度线样式 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 为 y 轴指定了两个刻度线值(5 和 15),并且图表上绘制的刻度线会交替显示这两个值。 |
chxt=x,y |
背景填充 chf
[所有图表]
您可以为图表数据区域和/或整个图表背景指定填充颜色和样式。填充类型包括单色填充、条纹填充和渐变填充。您可以为不同区域(例如整个图表区域或仅数据区域)指定不同的填充。图表区域填充会覆盖背景填充。所有填充均使用 chf
参数指定,您可以通过使用竖线字符 ( | ) 分隔各个值,在同一图表中混合使用不同的填充类型(单色、条纹、渐变)。图表区域填充会覆盖图表背景填充。
实心填充 chf
[所有图表]
您可以为背景和/或图表区域指定纯色填充,也可以为整个图表指定透明度值。您可以使用竖线字符 (|
) 指定多种填充。(Maps:仅限背景)。
语法
chf=<fill_type>,s,<color>|...
- <fill_typefill_type>
- 要填充的图表部分。指定以下某个值:
bg
- 背景填充c
- 图表区域填充。不支持地图图表。a
- 将整个图表(包括背景)设为透明。 系统会忽略<color>
的前六位数,而仅后两位数(透明度值)会应用于整个图表和所有填充。b<index>
- 条形纯色填充(仅限条形图)。 将 <index> 替换为条形的数据系列索引,以纯色填充条形。此效果类似于在条形图中指定chco
。有关示例,请参阅条形图系列颜色。
- 秒
- 表示单色或透明填充。
- <color>
- 填充颜色,采用 RRGGBB 十六进制格式。对于透明度,系统会忽略前 6 位数字,但无论如何都必须将其包含在内。
示例
说明 | 示例 |
---|---|
此示例用浅灰色 ( |
|
此示例用浅灰色 ( |
|
此示例将 50% 的透明度应用于整个图表(80 在十六进制中为 128,即约为 50% 的透明度)。请注意,表格单元格背景透过图表显示出来。 |
|
渐变填充 chf
[线条、条形图、Google-O-Meter、雷达、散点、维恩]
您可以对图表区域或背景应用一种或多种渐变填充。渐变填充是指从一种颜色淡化为另一种颜色。(饼图、Google-O-Meter 图表:仅限背景。)
每个渐变填充都会指定一个角度,以及锚定到指定位置的两种或更多颜色。颜色会随着锚点从一个锚点移动到另一个锚点而发生变化。您必须至少有两种颜色,它们的 <color_centerpoint> 值不同,这样才能让一种颜色淡入另一种。每个额外的渐变均由 <color>,<color_centerpoint> 对指定。
语法
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- <fill_typefill_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_typefill_type>
- 要填充的图表区域。以下其中一列:
bg
- 背景填充c
- 图表区域填充b<index>
- 条形条纹填充(仅限条形图)。 将 <index> 替换为条形的数据系列索引,即可用条纹填充条形。有关示例,请参阅条形图系列颜色。
- ls
- 指定线性条纹填充。
- <angle>
- 所有条纹相对于 y 轴的角度。对于垂直条纹,请使用
0
;对于水平条纹,请使用90
。 - <color>
- 条纹的颜色,采用 RRGGBB 十六进制格式。对其他每个条纹重复 <color> 和 <width>。你必须至少有两条条纹。条纹会交替显示,直到将图表填满。
- <width>
- 此条带的宽度,从
0
到1
,其中1
是图表的全宽。系统会重复使用条纹,直到将图表填满。 对其他每个条纹重复 <color> 和 <width>。你必须至少有两条条纹。条纹会交替显示,直到将图表填满。
示例
说明 | 示例 |
---|---|
|
chf= |
|
chf= |
网格线 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_axis_step_sizex_axis_step_size
- 用于计算要在图表上显示的 x 或 y 网格线的数量。100 / step_size = 图表上的网格线数量。因此:20,25 表示 5 条垂直网格线和 4 条水平网格线。
- <opt_dash_length>、<opt_space_lengthopt_dash_lengthopt_dash_length
- [可选] 用于定义虚线网格。第一个参数是每条短划线的长度(以像素为单位)。 第二个参数是短划线的间距(以像素为单位)。将 <opt_space_length> 指定为 0opt_space_length> 即可得到实线。默认值为 4,1。
- <opt_x_offset>,<opt_y_offset>
- [可选] 分别用于偏移 x 和 y 网格线的单元数(根据图表刻度)。 可以是正值或负值。如果您指定此值,则还必须指定前面的所有值。默认值为 0,0。
示例
说明 | 示例 |
---|---|
这些示例仅使用 |
chg=20,50 chg=20,50 |
此示例使用较大的空间来显示较浅的网格线 ( |
|
如需显示实线网格,请为 此图表还指定了 10 的 x 轴偏移。 |
chg=20,50,1,0,10 |
此图表所示的 x 轴偏移量为 10,y 轴偏移量为 20。 |
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_thickness>line_1_thickness
- 线条粗细(以像素为单位)。
- <opt_dash_length>、<opt_space_lengthopt_dash_lengthopt_dash_length
- [可选] 用于定义虚线网格。第一个参数是每条短划线的长度(以像素为单位)。 第二个参数是短划线的间距(以像素为单位)。对于实线,请勿指定以上任何值。如果您仅指定 <opt_dash_length>,则 <opt_space_length> 将设为 <opt_dash_length>。默认值为 1,0(实线)。opt_dash_lengthopt_dash_lengthopt_dash_lengthopt_dash_length
示例
说明 | 示例 |
---|---|
此处的虚线由 |
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_stringmarker_data_string>
- 这种特定标记类型所需的数据。此字符串包含用于等效独立图标的
chld
参数中的相同字符串,但 所有 | 分隔符都应替换为英文逗号(请注意,对于多行文本,请务必使用英文逗号,而不是竖线标记!)。请注意,在数据字符串中,您还必须使用 @ 标记对以下字符进行转义:竖线 ( | ) , at ( @ ) , 等于 ( = )、英文逗号 ( , )、分号 ( ; )。例如:hello@,+world
、5@@10+cents+each
。 - ds=<which_series>
- [可选] 此标记所属数据系列的索引(从零开始)。默认值为 0。
- dp=< which_points>which_points
- [可选] 指定用于绘制标记的数据点。默认值为 0(数据系列中的第一个点)。请使用以下格式之一:
n.d
- 要在哪个数据点上绘制标记,其中 n.d 是数据系列中从零开始的索引。如果您指定的是非整数值,则分数表示计算出的中间点。例如,3.5 表示点 3 和点 4 的中间。range,<start>,<end>,<step>
- 在 start 到 end 范围内(含边界值)的每个 step 数据点上绘制标记。start 和 end 是索引值,可以是浮点数,用于表示中间值。所有值均为可选;默认值为:start=0、end=最后一项、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 表示顶部。图表元素(折线和条形)正好位于零下方。如果两个标记的值相同,则将按照网址指定的顺序绘制。默认值为 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: 图表 2: |
|
请注意,动态图标标记将水平和垂直居中于相应点。因此,如果您使用带有结尾标志的动态图标,则它的尾部不会位于图表点上,而是标记中心。 第一个图表将标记的中心置于数据点 3 的中心,这实际上使尾部稍微靠近了线条上标记的右侧。 第二个图表使用 |
chem=y;
chem=y; |
要添加多个动态图标,请重复语法字符串,并以 | 字符分隔。 此例展示了一系列范围标记以及两个单独的标记。 请注意,垂直图钉的偏移量为 0,22,倾斜的图钉的偏移量为 12,20,以使图钉点与它们描述的系列对齐。 |
chem= |
此例展示了一个多行文本标记。添加文本后,该标记必须偏移,因为气泡会根据文本的大小自行调整大小,使其在图表上重新居中。请注意,d 数据字符串中的文本中的换行符由逗号表示。 |
chem=y; |
嵌入式图表
您可以使用动态图标语法将一个图表嵌入另一个图表中。
嵌入式图表标记有两种样式:以气泡形式嵌入的图表和不含气泡的嵌入式图表。这两者的示例如下:
带有气泡的图表 |
无气泡的图表 |
下面介绍了无气泡和包含气泡的嵌入式图表的 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
- [[仅限气泡]] 气泡的填充颜色,采用不带 # 标记的 6 位 HTML 颜色字符串。示例:
FF00FF
。
嵌入式图表数据
请使用以下转换工具来帮助生成图表字符串,或按照该工具后给出的规则手动生成图表字符串。
手动转化规则
1. 首先,按所示顺序将参数和值对中的所有以下字符替换为下面的值:
替换 | 目标值 |
---|---|
%7C 或 %7c |
| |
@ |
@@ |
% |
%25 |
, |
@, |
| |
@| |
; |
@; |
& |
%26 |
= |
%3D |
2. 然后,用英文逗号分隔 parameter1=value1¶meter2=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 - 从
<start_line_index>
填充到图表底部。<end_line_index>
支持一种特殊语法,可让您填充图表的一部分。如果您的图表中只有一条要填充的线条,那么这是最简单的方法。 - b - 在多折线图的两条折线之间填充。起点和终点线由
<start_line_index>
和<end_line_index>
表示。
- B - 从
- <color>
- 填充颜色的 RRGGBB 格式的十六进制数字。
- <start_line_index>start_line_index
- 填充开始处的线条的索引。在
chd
中指定的第一个数据系列的索引为零 (0
),第二个数据系列的索引为1
,依此类推。 - <end_line_index>end_line_index
-
- 填充类型“b”- 填充停止处的线条。此线条必须位于当前线条的下方。
- 填充类型“B”- 以下选项之一:
- 任意值 - 此参数中的任何单个数字都会被忽略,并且填充会从指定的折线到图表的底部
- start:end - 要填充图表下方的垂直切片,请指定 start:end,其中这些是描述填充开始和停止位置的数据点索引。这两个值都是可选的,默认值为 first_point:last_point。 (请参见下方示例)。
- <0>
- 预留 - 必须为零。
示例
说明 | 示例 |
---|---|
对于单个系列,使用 这是雷达图唯一可用的填充区域类型。 |
|
此例的图表有两条折线和两种填充。填充底部折线下方和顶部折线上方的区域需要一种特殊方法,下文将进行介绍。 |
|
在多折线图中,要从图表顶部填充到第一条折线,请添加一个数据系列,其中包含两份相应数据格式的最高数据值。例如,“ 要从最后一条折线填充到图表底部,请添加一个数据系列,其中包含两份相应数据格式的最低数据值。 例如,扩展编码为 AAAA,基本文本格式为 0,0,依此类推。 线条本身使用 |
chd=e: (最高值) (零值)chm= (浅蓝色) b,224499,1,2,0| (蓝色) b,FF0000,2,3,0| (红色) b,80C65A,3,4,0 (绿色)chco=000000 |
此例的折线图包含纵向填充切片。可通过使用线条填充类型“B”为 <end_line_index> 指定 start:end 对来实现。
|
chm= |
此例展示了如何在雷达图表中使用折线填充。 |
chm= |
形状标记 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>
- @
- [可选] 如果您在标记类型前面添加了可选的 @ 字符,则 <opt_while_points> 应使用 x:y 格式。
- <marker_type>
- 要使用的标记类型。指定以下任一类型:
a
- 箭头c
- 十字C
- 矩形。如果是矩形标记,则必须至少有两个数据系列,其中数据系列 0 指定下边缘,数据系列 1 指定上边缘。<size> 指定矩形的宽度(以像素为单位)。d
- 钻石级E
- 错误栏标记 ( ) 需要两个数据系列才能创建此标记,一个值表示底部,第二个系列中的对应点表示顶部。此外,它还公开了扩展的 <size> 语法:line_thickness[:top_and_bottom_width],其中 top_and_bottom_width 是可选的。请参阅下面的示例。h
- 在指定高度穿过图表的横线。 (<opt_which_points> 参数的唯一有效格式是 opt_which_points.)H
- 穿过指定数据标记的水平线。这支持扩展的 <size> 语法,该语法可让您指定确切的线条长度:line_thickness[:length],其中 :length 是可选的,默认值为图表区域的完整宽度。o
- 圆形s
- 方形v
- 从 x 轴到数据点的竖线V
- 长度可调整的竖线。这支持扩展的 <size> 值语法,该语法可让您指定确切的线条长度:line_thickness[:length],其中 :length 是可选的,默认值为图表区域的完整高度。该标记会居中于相关数据点上。x
- X
- <color>
- :此系列中的标记的颜色,采用 RRGGBB 十六进制格式。
- <series_index>series_index
- :要在其上绘制标记的数据系列(从零开始的索引)。对于
h
标记和按 x/y 位置指定位置的标记(以 @ 字符开头),会被忽略。您可以使用隐藏的数据系列作为标记的来源;如需了解详情,请参阅复合图表。分组垂直条形图支持特殊的扩展语法,用于将标记与特定条形对齐。 - <opt_when_points>opt_which_points
- [可选] 要在哪个(些)点上绘制标记。默认为所有标记。请使用以下某个值:
n.d
- 绘制标记的位置。其含义取决于标记类型:- 除 h 以外的所有类型 - 要在哪个数据点上绘制标记,其中 n.d 是数据系列中从零开始的索引。如果您指定的是非整数值,则分数表示计算出的中间点。例如,3.5 表示点 3 和点 4 的中间。
h
- 介于 0.0 到 1.0 之间的数字,其中 0.0 表示图表底部,1.0 表示图表顶部。
-1
- 在所有数据点上绘制标记。您也可以将此参数留空,以便在所有数据点上绘制图表。-n
- 在每 n 个数据点上绘制一个标记。n浮点值;如果 n 小于 1,则图表将为您计算其他中间点。例如,-0.5 将放置的标记数量是数据点数量的两倍。start:end:n
- 在某个范围(从 n 到 n 索引值(含)之间)的每个数据点上绘制一个标记。n所有参数都是可选的(可能不存在),因此 3::1 表示从第四个元素到最后一个元素(即第 1 步),如果完全省略此参数,则默认为 first:last:1。所有值都可以是浮点数。start 和 end 可以为负数,以便从最后一个值向后计数。如果 start 和 end 均为负数,请确保它们的值是递增的(例如 -6:-1:1)。 如果 n 步进值小于 1,它将通过插值给定数据值来计算其他数据点。默认值为 first:last:1x:y
- 在图表上的特定 x/y 点绘制标记。 此点不必位于线上。若要使用此选项,请在标记类型前添加 @ 字符。以浮点值指定坐标,其中0:0
表示图表的左下角,1:1
表示图表的右上角。例如,要向图表中心添加 15 像素的红色菱形,请使用@d,FF0000,0,0.5:0.5,15
。
- <size>
- :标记的尺寸(以像素为单位)。大多数标记都接受此参数的单个数字值;V、H 和 S 标记支持语法 <size>[:width],其中可选的第二部分指定了线条或标记的长度。
- <opt_z_order>
- [可选] 要在其上绘制标记的图层(与其他标记和所有其他图表元素相比)。这是一个介于 -1.0 到 1.0(含)之间的浮点数,其中 -1.0 表示底部,1.0 表示顶部。图表元素(折线和条形)正好位于零的下方。如果两个标记的值相同,则它们将按照网址指定的顺序绘制。默认值为 0.0(就在图表元素的上方)。
- <opt_offset>
- [可选] 可让您指定距指定位置的水平偏移量和垂直偏移量。以下是使用 : 分隔符的语法:
reserved:<horizontal_offset>:<vertical_offset>
。如果指定,则可以在chm
参数字符串中为 <opt_z_order> 添加一个空值。示例:o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
- reserve - 留空。
<horizontal_offset>
- 指定水平偏移量(以像素为单位)的正数或负数。可选;如果未使用,请留空。<vertical_offset>
- 指定垂直偏移量(以像素为单位)的正数或负数。可选;如果未使用,请留空。
示例
说明 | 示例 |
---|---|
以下示例展示了几个形状和线条标记。
|
chm= |
以下示例对一个数据系列使用菱形,针对另一个数据系列使用圆形。 如果两个或多个标记占据同一个点,则系统将按照它们在 |
chm= |
此折线图的每两个数据点上带有一个标记(-2 表示每隔一个点)。 |
chd=t: |
此折线图的标记数量是数据点数量的两倍(-0.5 表示每半个点)。 | chd=t: |
此示例展示了如何使用 h 和 v 标记创建具有自定义颜色和粗细的网格线。将 Z 轴顺序值(最后一个值)设置为 -1,以便在数据线下方绘制网格线。 |
chm= |
此例向折线图表添加了纵向填充线:
|
chm= |
下例使用精确坐标向图表添加了箭头和文本标记。第一个标记 D 是条形下的跟踪线。第二个标记是箭头,第三个标记是箭头文本。 | chm= |
固定在特定数据点的水平线 (H ) 可用于显示相对值或突出图表上数据值的高度。 |
chm=H,FF0000,0,18,1 |
此图展示了可在 <size> 参数中指定线条粗细和长度的标记。
|
title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:5chm= |
文本和数据值标记 chm
[条形图、折线图、雷达图表、散点图表]
您可以使用自定义文本或该点的已格式化数据版本为图表上的特定点添加标签。
您可以组合使用竖线字符 ( |
) 来分隔 chm
参数集的任何 chm
标记。
有关字符串值的注意事项:标签字符串中只允许使用安全网址字符。为了安全起见,如果字符串中包含不属于字符集 0-9a-zA-Z
的字符,您应该对其进行网址编码。
您可以在 Google 可视化文档中找到网址编码器。
语法
为每个应标记的数据系列指定以下一组参数。如需标记多个系列,请创建额外的参数集,并以竖线字符分隔。您无需标记所有系列。如果您没有为数据系列分配标记,则该数据系列不会获得任何标记。
chm= <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement> |...| <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
- <marker_type>
- 要使用的标记类型。您可以从以下类型中进行选择:
f<text>
- 包含文本的标志。指定字符“f”,后接自定义网址编码文本。如需对文本标记中的逗号进行转义,请在逗号前面加上 \ 符号。示例:fHello\,+World!
t<text>
- 简单的文本标记。指定字符“t”,后跟自定义网址编码文本。如需对文本标记中的逗号进行转义,请在逗号前面加上 \ 符号。示例:tHello\,+World!
A<text>
- 注释标记。这与旗帜标记类似,但标记会对其位置进行协调,以免重叠。<opt_when_points> 的唯一有效格式为 n.d,表示系列中点的索引。opt_which_pointsopt_which_pointsN<formatting_string>
- 此时间点的数据值,具有可选格式。如果您不使用chds
参数(自定义缩放),系统会提供确切的编码值;如果您以任何格式类型使用该参数,则值将缩放到您指定的范围。 请参阅下面带有数字标记的chds
示例。对于堆叠条形图中这种标记类型,如果您为 <series_index> 指定 -1,则会得到一个标记,显示此堆叠条形中的所有值的总和。格式设置字符串的语法如下所示:
<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
- 显示尾随零。默认为 no。s
- 显示组分隔符。默认为 no。x
或y
- 按照指定方式显示 x 或 y 坐标中的数据。x 数据的含义因图表类型而异:对您的图表进行实验以确定其含义。默认值为“y”。
<following_text>
- 每个值之后的文本。
- <color>
- :此集合的标记颜色,采用 RRGGBB 十六进制格式。
- <series_index>series_index
- :要在其上绘制标记的数据系列(从零开始的索引)。如果这是堆叠条形图且标记类型为 N(数据点值),您可以指定 -1,为每堆条形创建一个求和值标记。请参阅下面的示例。
- <opt_when_points>opt_which_points
- [可选] 要在哪个(些)点上绘制标记。默认为所有标记。请使用以下某个值:
n.d
- 要在哪个数据点上绘制标记,其中 n.d 是数据系列中从零开始的索引。如果您指定的是非整数值,则分数表示计算出的中间点。例如,3.5 表示点 3 和点 4 的中间。-1
- 在所有数据点上绘制标记。您也可以将此参数留空,以便在所有数据点上绘制图表。-n
- 在每 n 个数据点上绘制一个标记。nstart:end:n
- 在某个范围(从 n 到 n 索引值(含)之间)的每 n 个数据点上绘制一个标记。n所有参数都是可选的(可能不存在),因此 3::1 表示从第四个元素到最后一个元素(即第 1 步),如果完全省略此参数,则默认为 first:last:1。所有值都可以是浮点数。start 和 end 可以为负数,以便从最后一个值向后计数。如果 start 和 end 均为负数,请确保它们的值是递增的(例如,-6:-1:1)。如果 n 步进值小于 1,它将通过插值给定数据值来计算其他数据点。默认值为 first:last:1x:y
- [N 型标记不支持] 在图表上的特定 x/y 点绘制标记。此点不必位于线上。如需使用此选项,请在标记类型前面添加 @ 字符 (@
)。以浮点值指定坐标,其中0:0
为图表的左下角,0.5:0.5
为图表的中心,1:1
为图表的右上角。例如,要向图表中心添加 15 像素的红色菱形,请使用@d,FF0000,0,0.5:0.5,15
。
- <size>
- :标记的尺寸(以像素为单位)。如果是散点图,其中包含第三个数据系列(用于指定点大小),则此值将按数据范围进行缩放。因此,如果数据范围为 0—100 且 <size> 为 30,则数据值 100 表示宽度为 30 像素,数据值 50 表示宽度为 15 像素,依此类推。
- <opt_z_order>
- [可选] 要在其上绘制标记的图层(与其他标记和所有其他图表元素相比)。这是一个介于 -1.0 到 1.0(含)之间的浮点数,其中 -1.0 表示底部,1.0 表示顶部。图表元素(折线和条形)正好位于零的下方。如果两个标记的值相同,则将按照网址指定的顺序绘制。默认值为 0.0(就在图表元素的上方)。
- <opt_placement>
- [可选] 其他展示位置详情,用于说明标记相对于数据点的放置位置。您可以指定水平和/或垂直相对定位以及偏移。展示位置语法是一个带有“:”分隔符的字符串,如下所示。所有元素均为可选:
<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>
。 如果指定,则可以在chm
参数字符串中为 <opt_z_order> 添加一个空值。示例:N,000000,0,1,10,,b
、N,000000,0,1,10,,lv
和N,000000,0,1,10,,r::10
。- horizontal_and_vertical_justification
- 标记的锚点。这与对齐方式相反,因此左侧锚点实际上会将标记放置在数据点的右侧。您可以从以下列表中选择水平和/或垂直对齐方式:
- 水平放置:“l”“h”或“r”- 水平在左侧、中间或右侧锚定。默认值为“l”。
- 垂直放置:“b”“v”“t”- 垂直于底部、中间或顶部锚定。默认值为“b”。
- 条形相对放置位置 [仅限条形图]:“s”“c”“e”- 条形的底部、中间或顶部。对于堆叠图表,此值与每个系列的条形部分(而非整个条形)相关。如果给定的系列索引为 -1(堆栈总计),则其相对于整个条形。此元素可与纵向展示位置值结合使用:例如“be”或“vs”。 默认值为“e”。
- horizontal_offset
- 此标记的水平偏移量(以像素为单位)。默认值为 0。
- vertical_offset
- 此标记的垂直偏移量(以像素为单位)。非条形图默认值:15;条形图默认:2。
说明 | 示例 | |
---|---|---|
下例展示了条形图上的值标签。 第一个图表 ( 第二个图表 ( |
|
|
您可以使用 此示例中显示的图表包含简单编码值:46、39、29、30、43、41。简单编码范围为 0—61。 |
chd=s:underp |
|
下例中的图表在最低点处带有文本标签,最高点处带有标志标签。 |
|
|
此示例展示了一个堆叠图表,其中包含各个系列的值和系列总计。要显示堆叠的数据系列值,我们必须使用“c”定位选项;否则,顶部条形值会与每个条形顶部的总和值重叠。 | chm= |
|
有关垂直和水平放置工作原理的更多演示。 此示例演示了条形图的各种定位值组合(使用 s、c 和 e 进行垂直放置)。请注意,右侧锚点将标记向左移动,顶部锚点向下移动标记,反之亦然。红点显示了每个条形的底部、中间和顶部。 数字是数据值,使用不同的锚点值固定为每个条形。 | chm= |
|
注解标记会自动调整标签位置,使其不会重叠。第一个 chm 值用于线条填充,之后的值均为注释标记。 |
chm=B,C5D4B5BB,0,0,0 |
|
另一个注释标记示例,展示了瑞士各城市的海拔。 |
范围标记 chm
[条形图、K 线图、折线图表、雷达图表、散点图表]
您可以为背景的水平或垂直条带着色,以突出显示图表的特定区域。
您可以组合使用竖线字符 ( |
) 来分隔 chm
参数集的任何 chm
标记。
语法
为每个要绘制的频段指定以下一组参数。如需绘制多个条带,请创建额外的参数集,并以竖线字符分隔。范围是按指定的顺序绘制的,因此最后一个范围绘制在先前范围之上。
chm= <direction>,<color>,0,<start_point>,<end_point> |...| <direction>,<color>,0,<start_point>,<end_point>
- <direction>
- 指定水平或垂直阴影。针对水平范围使用
r
,针对垂直范围使用R
。 - <color>
- 以 RRGGBB 格式的十六进制数字表示的范围颜色。
- 0
- 预留 - 必须为零。
- <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= |
下面的折线图示例使用范围标记在图表的零位线、中点线和顶部绘制了穿过图表的模糊水平线。 |
|
K 线标记 chm=F
[条形图、折线图]
K 线标记表示数据系列中的方差和方向变化。这些指标通常用于显示一天中的股票值。该标记包含多个部分,用于显示特定时间段(通常为一天)内的最高值和最低值,以及开盘值和收盘值。如需详细了解 K 线标记,请点击此处。
K 线标记绘制为被一条垂直线平分的矩形。需要四个数据系列才能绘制 K 线标记;每个系列指定的内容如下:
- 系列 1 和 4 分别指定垂直线的底部和顶部。这些值通常表示当天的最低值和最高值。
- 数据系列 2 和 3 指定矩形的垂直边框。数据系列 2 是开盘值,数据系列 3 是收盘值。矩形的颜色取决于哪个值更高:当开盘值(数据系列 2)低于收盘值(数据系列 3)时,价格上涨,并且矩形默认以纯绿色填充;当开盘值(数据系列 2)高于收盘值(数据系列 3)时,价格下降,并且矩形默认以红色填充。您只能为值递减的矩形指定填充颜色。指定后,值递增的矩形将处于未填充状态(空)。请注意,数据系列 2 可以是矩形的顶部或底部,具体取决于价格是上涨还是下降。
您可以将 K 线标记与任何其他 chm
参数结合使用,使用竖线字符 ( |
) 分隔 chm
参数。
注意:如果您不希望用于绘制标记的数据对应的线条显示在图表中,则必须在格式类型后面添加一个 0。例如:文本格式数据字符串中的 chd=t0:10,20,30,40
。如需了解详情,请参阅复合图表。
下面的示例显示了每个数据系列的线条:
语法
chm= F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>
- F
- 表示这是一个 K 线标记。
- <opt_declining_color>
- [可选] 当值递减时(当数据系列 2 的值 > 数据系列 3 对应的值时),矩形的填充颜色。这是一个 RRGGBB 格式的十六进制数字。当值增加时,矩形将为空。默认为绿色(增加)或红色(减少)(您无法为值递增指定自定义填充颜色)。
- <data_series_index>
- 要用作 K 线标记的第一个系列的数据系列的索引。这是一个从零开始的索引。因此,如果您在此处指定 1,而您有六个数据系列,则第二、第三、第四和第五个数据系列将用于绘制 K 线标记。
- <opt_when_points>
- [可选] 指定用于绘制标记的数据点。默认为所有标记。请使用以下格式之一:
n.d
- 在数据系列中的单个点上绘制标记,其中 n.d 是数据系列中该点的索引。n.d如果您指定的是非整数值,则分数表示计算出的中间点。例如,3.5 表示点 3 和点 4 的中间。-1
- 在所有数据点上绘制标记。您也可以将此参数留空,以便在所有标记上绘制内容。-n
- 在每 n 个数据点上绘制一个标记。nstart:end:n
- 在某个范围(从 n 到 n 索引值(含)之间)的每个数据点上绘制一个标记。n所有参数都是可选的(可能不存在),因此 3::1 表示从第四个元素到最后一个元素(即第 1 步),如果完全省略此参数,则默认为 first:last:1。所有值都可以是浮点数。start 和 end 可以为负数,以便从最后一个值向后计数。如果 start 和 end 均为负数,请确保它们的值是递增的(例如,-6:-1:1)。如果 n 步进值小于 1,它将通过插值给定数据值来计算其他数据点。默认值为 first:last:1
- <width>
- 所有矩形的宽度(以像素为单位)。
- <opt_z_order>
- [可选] 要在其上绘制标记的图层(与其他标记和所有其他图表元素相比)。这是一个介于 -1.0 到 1.0(含)之间的浮点数,其中 -1.0 表示底部,1.0 表示顶部。图表元素(折线和条形)正好位于零的下方。如果两个标记的值相同,则将按照网址指定的顺序绘制。默认值为 0.0(就在图表元素的上方)。
示例
说明 | 示例 |
---|---|
下例是包含四个系列的折线图上的 K 线标记。自定义填充颜色 图表裁剪了第一个和最后一个矩形。要消除这些值,您可以将 chm 的第四个参数指定为 1:4。 注意数据字符串中的零,以隐藏系列中的线条: <which_point> 参数为空,表示在所有数据点上绘制 K 线。 |
chd=t0: |
下面是一个同一图表的示例,使用了默认颜色并移除了第一项和最后一项。 此为复合图表:它是折线图(基本图表类型)和 K 线标记的组合。 |
|
折线标记 chm=D
[条形图、K 线图表、折线图表、雷达图表、散点图表]
您可以在图表中添加一条用于跟踪数据的折线。这最常用于复合图表。
如需添加多行代码(或将其与任何其他 chm
标记结合使用),请使用竖线 (|
) 分隔符分隔 chm 参数集。您不能使用此参数创建虚线标记。
语法
chm= D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
- D
- 表示这是一个线条标记。
- <color>
- 线条的颜色,采用 RRGGBB 十六进制格式。
- <series_index>series_index
- 用于绘制线条的数据系列的索引。对于第一个数据系列,数据系列索引为
0
,对于第二个数据系列,索引为1
,依此类推。 - <when_points>which_points
- 系列中用于绘制线条的点。请使用以下某个值:
0
- 使用系列中的所有点。start:end
- 使用序列中特定范围的点,从 start 到 end 之间,包括这两个点(从零开始的索引)。 您也可以使用浮点值指定中间点,或将 start 或 end 留空以分别表示第一个或最后一个数据点。start 和 end 可以为负数,作为从最后一个值开始的反向索引。如果 start 和 end 均为负数,请务必以递增值书写它们(例如,-6:-1)。
- <size>
- 线条的宽度(以像素为单位)。
- <opt_z_order>
- [可选] 要在其上绘制标记的图层(与其他标记和所有其他图表元素相比)。这是一个介于 -1.0 到 1.0(含)之间的浮点数,其中 -1.0 表示底部,1.0 表示顶部。图表元素(折线和条形)正好位于零的下方。如果两个标记的值相同,则将按照网址指定的顺序绘制。默认值为 0.0(就在图表元素的上方)。
示例
说明 | 示例 |
---|---|
此示例展示了如何在条形图上绘制标记线。
Z 轴顺序设置为 |
chm=D,0033FF,0,0,5,1 |
此为同一条形图,但还额外添加了一个数据系列,专用于此折线。这是一个复合图表的示例。
复合图表的绘制方法是,向 如需了解详情,请参阅复合图表。 |
chm=D,0033FF,1,0,5,1 |
数据函数 chfd
[所有 chd
图表]
您可以使用 muParser 函数语法指定要在图表数据上运行的自定义函数。函数中使用的数据可出自以下两个来源:
- 来自
chd
的数据系列 - 此数据提取自chd
中指定的系列。 - 在
chfd
参数本身中声明的一系列值 - 您可以为任意数据范围声明起始值、停止值和步进值。
请务必注意,在任何情况下,您都必须将输出分配给 chd
中的现有系列;函数输出会覆盖该系列。只有在处理完所有函数后,图表才会呈现,因此,如果您将多个函数输出到同一数据系列,这些函数将按指定顺序运行,但只会在图表上绘制最终函数的输出。请注意,您可以串联多个函数,以便一个函数可以将上一个函数输出的系列作为输入。
如需为函数行分配颜色或 chm
标记,请将颜色或标记分配给函数的系列索引。请注意,在函数操作数据后,系统会根据数据放置标记。
语法
chfd= <output_series_index>,<function_data>,<function_string> |...| <output_series_index>,<function_data>,<function_string>
- <output_series_index>output_series_index
- 函数输出将写入的
chd
中数据系列的索引(从零开始)。函数输出将完全覆盖任何现有数据。如果某个系列未用作函数的输入,则最佳做法是为该系列分配一个虚拟值。 - <function_data>
- 要绘制的变量和数据。数据可以来自您定义的范围,也可以来自
chd
数据系列之一。您可以为每个函数指定多个变量,使用 ;(分号)分隔符分隔多个变量。请注意,如果您为单个函数定义多个变量,而这些变量的点数量不同,则该函数会在到达第一个端点时停止。例如,如果某个函数同时定义了 x=1—5 step 1 和 y=1—10 step 1,则该函数将在到达第五个点时结束。
<variable_name>,<input_series_index>
或
<variable_name>,<start>,<end>,<step>
- variable_name - 变量的任意字符串名称。 请在由 function_string 定义的函数中使用。
- input_series_index - 要用作输入数据的
chd
数据系列的索引。 - start - 范围的数值起始值。
- end - 范围的结束数值。
- step - 从 start 到 end 的数值步进值。 正值或负值均可,但不可为零。
x,0,100,1
声明了一个名为x
的变量,其值为 0、1、2 ... 100。x,0,100,1;r,0,3.1,.1
声明同一x
变量以及一个名为r
且值为 0、0.1、0.2、...、3.0、3.1 的变量。x,0
会声明一个名为 x 的变量,该变量使用第一个chd
系列中的数据。这些变量将由 function_string 使用。 除非您在 function_string 中指定这些变量,否则系统不会将其绘制在图表上。阶值越小,图表越平滑。 - <函数字符串>function_string
- 使用 muParser 语法编写的函数。该函数会应用于 variable_data 中指定的变量和数据。
您只能引用此本地函数集中声明的变量,而不能引用另一组以竖线分隔的
chfd
参数中声明的变量。不支持 muParser 摘要函数(最小值、最大值、平均值)。重要提示:切记在您的函数中使用%2B
而不是+
!
示例
说明 | 示例 |
---|---|
简单的正弦波。需要注意以下几点:
|
cht=lc |
此行使用了来自 chd 参数的数据。 |
chd=t:5,10 |
函数线和非函数线混合。 请注意颜色是如何通过系列颜色参数 注意标记在函数输出上的位置;数据点是通过 start、end 和 step 计算得出的。因此,如果您的范围是 0—11 step 0.1,则点 0 为 0,点 1 为 0.1,以此类推,直到点 110,其值为 11。 |
chd=t: |
要在二维空间中定义函数,请使用
|
cht=lxy |
尝试点击这些图片,以在图表园地中打开并试用它们;您一定会着迷! |