地图图表

本页介绍了如何使用 Charts API 创建彩色地图。此图表是经过改进的新版本，与旧版地图图表 (cht=t) 相比，支持更大的地图和更多的功能。

目录

图表专属功能

  1. 概览
  2. 支持的参数
  3. 缩放和居中

标准功能

  1. 图表标题（chtt、chts）
  2. 图表颜色 (chco)
  3. 图表边距 (chma)
  4. 背景填充
    1. 纯色填充 (chf)
  5. 图表图例 (chdl, Chdlp)
  6. 形状标记 (chm)
  7. 文本和数据标记 (chm)

概览

您可以创建一张地图，其中以自定义颜色突出显示各个国家/地区或州。您可以让地图缩放到适当的级别以正确显示所选国家/地区，也可以使用纬度和经度值将地图放大或缩小到自定义级别。

支持的参数

地图图表支持以下参数：

参数 必填还是选填 说明
cht=map<opt_zoom_and_center> 必需

指定地图图表。

opt_zoom_and_center - 可选字符串，可让您在特定区域缩放图表或将图表居中。查看详情。
chs 必需 地图尺寸。地图的最大尺寸为宽 600 像素、高 600 像素，或总尺寸为 30 万像素。
chd=
 <first_country_value>,
 ...,
 <last_country_value>		 可选 如果使用此参数，数据值将指示相应国家/地区的颜色以及 chco 指定的颜色渐变。
chld=
 <country_or_region_codes>|...|		 必需

以竖线分隔的国家/地区或州列表，将以 chco 指定的颜色突出显示。除非您进行自定义缩放或居中，否则地图会自动进行缩放以涵盖所有指定的国家/地区。代码必须大写。这些代码是 ISO 3166-1-alpha-2 代码：两个大写字符，后跟短划线和表示区域或城市的第二个标识符。示例：GB（英国）、GB-LND（伦敦）、US-NJ（美国新泽西州）

chco

  • 如果未使用 chd：
    chco=
     <unselected_land_color>|
     <first_region_color>|
       ...|
     <last_region_color>
  • 如果使用了 chd：
    chco=
     <unselected_land_color>,
     <color_range_start>,
       ...,
     <color_range_end>
 可选

图表颜色。此字符串的格式取决于您是否使用 chd。在这两种语法中，<unselected_land_color> 都是 chld 中未指定的任何区域的颜色。请注意，不同语法的分隔线有所不同（一种采用英文逗号，另一种采用竖线）。如果未使用此属性，该区域将会显示轮廓，但不会着色。

  • chd二手 - 第二个及后面的颜色描述颜色范围。您必须在 chld 中为每个国家/地区提供一个 chd 值，且相应的国家/地区会按照从 <first_region_color>（最小数据范围值）到 <last_region_color>（最大数据范围值）的范围进行着色。请参见下表中的示例。
  • chd 未使用 - 第二个颜色及后面的颜色会按照列出的顺序应用于 chld 中的相应区域。如果国家/地区数量多于颜色数量，系统会将最后一种颜色应用于列表中超出部分的所有国家/地区。
chtt, chts 可选 图表标题和样式
chm 可选 图表标记
chma 可选 图表边距
chf=bg... 可选 纯色填充（仅限背景）
chdl 可选 图表图例

 

示例

说明 示例

在此示例中：

  • cht=map:fixed=-60,0,80,-35 - 图表缩放区域介于纬度 -60 到 80 之间，经度介于 0 到 -35 之间
  • chld=CA-BC|CN|IT|GR|US-UT - 高危地区包括不列颠哥伦比亚省、中国、意大利、希腊和犹他州。
  • chm - 表示旗帜的图表标记。
  • chma=0,110,0,0 - 为了正确适应图例，右侧边框增至 110 像素。
  • chtt=Last+Five+Olympic+Hosts - 图表标题，用 + 表示空格。

显示五个奥运会主办国家的地图，显示了国旗标记。
cht=map:fixed=-60,0,80,-35
chs=600x350
chld=CA-BC|CN|IT|GR|US-UT
chdl=Vancouver|Beijing|Torino|Athens|Salt+Lake+City
chco=B3BCC0|5781AE|FF0000|FFC726|885E80|518274
chtt=Last+Five+Olympic+Hosts
chm=f2010+Winter,000000,0,0,10
f2008+Summer,000000,0,1,10
f2008+Winter,000000,0,2,10,1,:-5:10
f2004+Summer,000000,0,3,10
f2004+Summer,000000,0,4,10
chma=0,110,0,0

显示法国的地图，突出显示了两个区域：

  • chld=FR-D|FR-B|FR - 指定了三个区域：勃尔贡（东部）、阿基坦（西南部）和法国。
  • chco=676767|FF4444|44FF44|4444FF - 此地图中未指定 chd 参数，因此第一个颜色值之后的每个颜色值都用于指定相应的国家/地区。 红色表示勃朗峰，绿色表示阿基坦，蓝色表示法国。您可以看到，后面的颜色不会遮盖之前的颜色。
 法国地图，其中突出显示了两个省份。
chld=FR-D|FR-B|FR
chco=676767|FF4444|44FF44|4444FF

此地图使用了渐变色表现地图。

  • chd=t:0,50,100 - chd 参数表示颜色渐变。此处指定了文本编码，范围为 0—100。
  • chco=CCCCCC,FF0000,000000 - 背景颜色为浅灰色 (CCCCCC)，颜色范围从红色 (FF0000) 到黑色 (000000)。显示的中间国家/地区是该渐变的中间颜色。
 显示颜色渐变的地图。
chd=t:0,50,100
chco=CCCCCC,FF0000,000000
请注意，可以在指定的图表尺寸内剪裁地图。这是因为，我们不会为了适应指定的图表尺寸而使地图失真，但会将地图限制为您在 chld 中指定的区域。 因此，为了避免图表边界内的区域被剪裁，您可能需要手动调整地图大小。
狭长形国家/地区的方形地图

cht=map
chs=300x300
chld=GB

英格兰境内自然狭长，因此指定方形地图会在右侧包含剪裁区域：

 狭长形国家/地区的方形地图

cht=map
chs=180x300
chld=GB

调整图表宽度，以剪裁掉多余的内容。请注意，底部仍存在一些剪裁，需要通过降低地图高度来修复。

 狭长形国家/地区的方形地图

cht=map
chs=180x300
chld=GB

法国国土的形状要规则得多，因此更适合在方形地图中使用。

返回页首

缩放和居中

默认情况下，图表会缩放并居中，以位于所选区域的中心位置，并使其在定义的地图尺寸内尽可能贴近渲染区域。不过，您可以通过两种不同的方式自定义图表的居中和缩放级别：

按像素

要按像素大小调整边界，请使用以下格式：

cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>

其中，每个边框尺寸是指在自动计算的缩放级别之外要显示的附加边框（以像素为单位）。

您只能缩小（正值）；而不能使用像素缩放功能放大（负值）缩放级别。

示例：

这些示例均显示了伦敦（纬度

无缩放（默认） 每边缩小 30 像素 缩小地图，并向右移动到底

底部显示过多空白地图。
cht=map

 底部多余的地图。
cht=map:auto=30,30,30,30		 缩放区域已重新取景。
cht=map:auto=50,0,80,0

 

按纬度和经度

您可以使用以下语法，按纬度和经度指定所渲染地图的确切顶部、底部、左侧和右侧边框：

cht=map:fixed=<bottom_border_lat>,<left_border_long>,<top_border_lat>,<right_border_long>

其中 <bottom_border_lat> 和 <top_border_lat> 分别指定下边框和上边框的纬度，<left_border_long> 和 <right_border_long> 指定左右边框的经度。

注意：由于墨卡托投影法失真（基本上是指，将曲线地图投影到平面图片上），因此聚焦于高窄的条形可能会导致地图出现一些意外的大小差异。

示例：

以下示例显示了经度为 0.1°，纬度为 51.5° 的伦敦（以蓝色突出显示）。注意地图剪裁的情况，因为地图会尝试仅显示英国（如指定），并填充指定的图表而不失真。

居中 纬度偏移 +10* 缩减所有的值，放大地图

cht=map:fixed=40,-10,60,10


cht=map:fixed=50,-10,70,10
cht=map:fixed=48,-3,54,3

注意：尽管我们向上移动了相同数量的度，但中间图片的尺寸略小于第一张图片。这是因为我们会将 3-D 球面投影到 2-D 图片上。您必须增加第二个图表的宽度，使其大小与第一个图表相同。

返回页首

标准功能

此网页上的其他功能均为标准图表功能。

图表标题 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”。

 

示例

说明 示例

标题、默认颜色和字体大小的图表。

使用加号 (+) 指定一个空格。

使用竖线字符 (|) 强制换行。

此处未指定 chts。

 包含标题的纵向条形图表
chtt=Site+visitors+by+month|
January+to+July

标题颜色为蓝色，右侧对齐，20 点的图表。

 包含 20 像素的蓝色标题的纵向条形图表
chtt=Site+visitors
chts=FF0000,20,r

返回页首

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

 

示例

说明 示例

在此示例中，图表每边的最小外边距为 30 像素。由于图表图例的宽度超过 30 像素，因此右侧的外边距会设置为图表图例的宽度，并且与其他外边距不同。

轴标签位于图表区域之外，因此在边缘空间内绘制。

包含灰色背景和各边边距的折线图表。
chma=30,30,30,30

如需在图例周围添加外边距，请为 <opt_legend_width> 和 <opt_legend_height> 形参设置值。

在本例中，图例的宽度约为 60 像素。如果您将 <opt_legend_width> 设置为 80 像素，则外边距会延长到图例之外 20 像素。

包含灰色背景和各边边距的折线图表。
chma=20,20,20,30|80,20

返回页首

背景填充 chf [所有图表]

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

纯色填充 chf [所有图表]

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

语法

chf=<fill_type>,s,<color>|...
<fill_type>fill_type
要填充的图表部分。指定以下某个值：
  • bg - 背景填充
  • c - 图表区域填充。不支持地图图表。
  • a - 将整个图表（包括背景）设为透明。 <color> 的前六位数会被忽略，只有最后两位数（透明度值）会应用到整个图表和所有填充。
  • b<index> - 条形纯色填充（仅限条形图）。 将 <index> 替换为条形的系列索引，即可以纯色填充条形。其效果类似于在条形图中指定 chco。有关示例，请参阅条形图系列颜色。
秒
表示纯色或透明填充。
<color>
填充颜色，采用 RRGGBB 十六进制格式。对于透明度，前六位数会被忽略，但无论如何都必须将其包含在内。

 

示例

说明 示例

此示例使用浅灰色 (EFEFEF) 填充图表背景。

带有黑色区域填充的红色折线图表。

chf=bg,s,EFEFEF

下例用浅灰色 (EFEFEF) 填充图表背景，并用黑色填充了图表区域 (000000)。

带有黑色图表区域和浅灰色背景的红色折线图表。

chf=c,s,000000|
bg,s,EFEFEF
此示例将整个图表的透明度设为 50%（十六进制格式的 80 表示 128，即约为 50% 的透明度）。请注意，表格单元格背景透过图表显示出来。

包含蓝色散点且透明度为 50% 的散点图表。

chf=a,s,00000080

返回页首

图表图例文字和样式 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>
图例条目的文本。每个标签都会应用于 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
chco=FF0000,00FF00,0000FF

一个大圆圈中包含两个小圆圈的文氏图


chdl=First|Second|Third
chco=ff0000,00ff00,0000ff

第一个图表演示水平图例条目（chdlp=t，默认布局为水平布局），第二个图表演示底部垂直图例条目 (chdlp=bv)。

一个大圆圈中包含两个小圆圈的文氏图
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=t

一个大圆圈中包含两个小圆圈的文氏图
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=bv
此示例演示了如何更改字体大小。

一个大圆圈中包含两个小圆圈的文氏图
chdls=0000CC,14

返回页首

形状标记 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_ which_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>
：绘制标记时所依据的数据系列中从零开始的索引。h 标记以及按 x/y 位置指定位置的标记（以 @ 字符开头）会被忽略。您可以使用隐藏的数据系列作为标记来源；有关详情，请参阅复合图表。分组垂直条形图支持特殊的扩展语法，以便将标记与特定条形对齐。
<opt_ which_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 个数据点上绘制一个标记（索引值介于 start 到 end 之间（包括这两个值）。nnn所有参数都是可选的（可以不存在），因此 3::1 表示从第四个元素到最后一个元素，即第 1 步，如果完全省略此参数，则默认采用 first:last:1。所有值都可以是浮点数。start 和 end 可以为负值，以便从最后一个值开始反向计数。如果 start 和 end 均为负数，请确保它们以递增值列出（例如，-6:-1:1）。 如果 n 步值小于 1，它将通过插值给定的数据值来计算其他数据点。n默认值为 first:last:1
  • x: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）的浮点数，其中 -1.0 表示底部，1.0 表示顶部。图表元素（折线和条形）正好低于零。如果两个标记具有相同的值，则系统会按照网址指定的顺序绘制它们。默认值为 0.0（正好位于图表元素的上方）。
<opt_offset>
[可选] 可让您指定相对于指定位置的水平和垂直偏移。以下语法使用 : 分隔符：reserved:<horizontal_offset>:<vertical_offset>。 如果指定，则可以在 <opt_z_order> 的 chm 参数字符串中添加空值。示例：o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
  • reserved - 留空。
  • <horizontal_offset> - 一个正数或负数，用于指定水平偏移量（以像素为单位）。可选；如果未使用，请留空。
  • <vertical_offset> - 一个正数或负数，用于指定垂直偏移量（以像素为单位）。可选；如果未使用，请留空。

 

示例

说明 示例

下面列举了几个形状和线条标记的示例。

  • a,990066,0,0.0,9.0 - 紫色箭头，第一个数据系列，位于第一个点，大小为 9。
  • c,FF0000,0,1.0,20.0 - 红色十字，第一个数据系列，位于第二个点，尺寸 9。
  • d,80C65A,0,2,20.0 - 绿色菱形，第一个数据系列，第三个点，尺寸 9。
  • H,000000,0,3,1:40 - 黑色水平线，第一个数据系列，数据点 3，宽 1 像素，长 40 像素。
  • o,FF9900,0,4.0,12.0 - 橙色圆形，第一个数据系列，位于第五点，大小 12。
  • s,3399CC,0,5.0,11.0 - 蓝色方形，第一个数据系列，位于第六点，大小 11。
  • v,BBCCED,0,6.0,1.0 - 向上指向某个点的垂直线，第一个数据系列，第七点，宽 1 像素。
  • V,3399CC,0,7.0,1.0 - 从图表底部到顶部的竖线，第一个数据系列，第八点，宽 1 像素。
  • x,FFCC33,0,8.0,20.0 - 黄色“X”，第一个数据系列，第九点，大小 20。
  • H,FFFF00,0,9,2 - 黄色水平线，与数据点 9 处的图表宽度相同。
  • h,FF0000,0,0.5,1 - 位于指定高度的红色横线，第一个数据系列，位于图表高度的一半，宽 1 像素。
 带有标记的折线图表
chm=
  a,990066,0,0.0,9.0|
  c,FF0000,0,1.0,20|
  d,80C65A,0,2.0,20.0|
  H,000000,0,3,1:40|
  o,FF9900,0,4.0,12.0|
  s,3399CC,0,5.0,11.0|
  v,BBCCED,0,6,1.0|
  V,3399CC,0,7,1.0|
  x,FFCC33,0,8,20|
  H,FFFF00,0,9,2|
  h,FF0000,0,0.5,1

下例对一个数据系列使用菱形，对另一个数据系列使用圆形。

如果两个或多个标记占据同一点，则会按照标记在 chm 参数中的显示顺序绘制这些标记。在这里，圆形是第一个使用 chm 指定的标记，因此首先绘制了圆形。先指定并绘制菱形，这样就会将其绘制在圆形上。

 折线图：一条折线的每个数据点上有 15 个像素的圆圈，另一条折线包含 10 个像素的菱形。一个菱形绘制在两条折线的公共点上
chm=
  o,FF9900,0,-1,15.0|
  d,FF0000,1,-1,10.0

此折线图的每秒数据点上带有一个标记（-2 表示每隔一个点）。

 每两个数据点上带有一个标记的折线图表
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-2,6
此折线图使用的标记数量是数据点的两倍（-0.5 表示每半个点）。 每两个数据点上带有一个标记的折线图表
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-.5,6
以下示例展示了如何使用 h 和 v 标记创建自定义颜色和粗细的网格线。将 z-order 值（最后一个值）设置为 -1，以便在数据线下方绘制网格线。
每两个数据点上带有一个标记的折线图表
chm=
  h,76A4FB,0,0:1:.2,2,-1|
  V,76A4FB,0,::2,0.5,-1

此例向折线图表添加了纵向填充线：

  • v - 向图表添加竖线
  • FF0000 - 红线
  • 0 - 序列索引
  • : :.5 - 范围说明符：从 start 到 end，每 0.5 个点。
  • 2 - 厚度为 2 像素。
 每两个数据点上带有一个标记的折线图表
chm=
  v,FF0000,0,::.5,2
此示例使用确切坐标向图表添加了箭头和文本标记。第一个标记 D 是条形下方的轨迹线。第二个标记是箭头，第三个标记是箭头文本。
chm=
  D,003971,1,0,3|
  @a,000000,0,.25:.75,7|
  @tExpected,000000,0,.35:.85,10
固定在特定数据点上的水平线 (H) 可用于显示相对值，或强调图表上数据值的高度。
chm=H,FF0000,0,18,1

此图表演示的标记可以在 <size> 参数中指定线段粗细和长度。

  • E,000000,0,6,1:20 - 黑色错误栏，线条宽 1 像素，顶部和底部栏长 20 像素。底部固定在数据系列 0 的点 8 上，顶部固定在数据系列 1 的点 8 上。
  • H,990066,1,2,5:50 - 紫色水平线，宽 5 像素，长 50 像素，居中于数据点 2。
  • V,3399CC,0,8,3:50- 蓝色竖线 宽 3 像素，长 50 像素，以数据点 8 为中心。
 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,30"chm=
  E,000000,0,6,1:20|
  H,990066,1,2,5:50|
  V,3399CC,0,8,3:50

返回页首

文本和数据值标记 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_which_points> 的唯一有效格式是 opt_which_points，用于表示系列中点的索引。
  • N<formatting_string> - 此点的数据值，格式可选。如果您不使用 chds 参数（自定义缩放），则它会提供精确的编码值；如果将该参数与任何格式类型搭配使用，则该值将缩放到您指定的范围。 请参阅下面的带有数字标记的 chds 示例。在堆叠条形图中使用此标记时，如果您为 <series_index> 指定 -1，则会得到一个标记，用于显示此堆叠条形中所有值的总和。series_index格式字符串语法如下：
           <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 - 显示组分隔符。默认值为“否”。
      • x 或 y - 按指定方式显示 x 坐标或 y 坐标中的数据。x 数据的含义因图表类型而异：请使用您的图表进行实验以确定其含义。默认值为 'y'。
    • <following_text> - 每个值后面的文本。
<color>
：此集合的标记的颜色，采用 RRGGBB 十六进制格式。
<series_index>
：绘制标记时所依据的数据系列中从零开始的索引。如果这是堆叠条形图且标记类型为 N（数据点值），您可以指定 -1，以为每个条形堆叠创建求和值标记。请参阅下文中的示例。
<opt_ which_points>opt_which_points
[可选] 要在哪个/哪些点上绘制标记。默认值为所有标记。请使用以下某个值：
  • n.d - 要在哪个数据点上绘制标记，其中 n.d 是数据系列中从零开始的索引。n.d如果您指定非整数值，则小数表示计算出的中间点。例如，3.5 表示点 3 和点 4 之间的一半。
  • -1 - 在所有数据点上绘制标记。此外，您也可以将此参数留空，以便在所有数据点上进行绘制。
  • -n - 在每 n 个数据点上绘制一个标记。n
  • start:end:n - 在范围中的第 n 个数据点上绘制一个标记，索引值介于 start 到 end 之间（包括这两个值）。nnn所有参数都是可选的（可以不存在），因此 3::1 表示从第四个元素到最后一个元素，即第 1 步，如果完全省略此参数，则默认采用 first:last:1。所有值都可以是浮点数。start 和 end 可以为负值，以便从最后一个值开始反向计数。如果 start 和 end 均为负数，请务必以递增值列出（例如，-6:-1:1）。如果 n 步值小于 1，它将通过插值给定的数据值来计算其他数据点。n默认值为 first:last:1
  • x: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）的浮点数，其中 -1.0 表示底部，1.0 表示顶部。图表元素（折线和条形）正好低于零。如果两个标记的值相同，就会按照网址指定的顺序绘制它们。默认值为 0.0（正好位于图表元素的上方）。
<opt_placement>
[可选] 其他展示位置详情，用于说明此标记相对于数据点的放置位置。您可以指定水平和/或垂直相对定位以及偏移量。展示位置语法是一个带有 : 分隔符的字符串，如此处所示。所有元素均为可选：<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>。 如果指定，则可以在 <opt_z_order> 的 chm 参数字符串中添加空值。示例：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。

说明 示例

下面是一个条形图上的值标签示例。

第一个图表 (N*p0*) 指定一个数据值标记，值以百分比的形式显示，四舍五入到小数点后零，所有值均以 11 点显示。请注意，数据值均介于 0.0 和 1.0 之间，在采用百分比格式时，这些值向上移动了两位小数。

第二个图表 (N*cEUR1*) 以欧元值的格式显示了相同的值，保留一个小数位，黑色，所有值均采用 11 点式文本。

每个条形上带有百分比标签的条形图表
chm=
  N*p0*,000000,0,-1,11
chd=t:
  0.4356,0.3562,0.4834,0.575,0.673,0.6091

每个条形上带有欧元标签的条形图表


chm=
  N*cEUR1*,000000,0,-1,11

您可以使用 chds 参数来缩放显示的数值。您可以对所有数据格式（包括简单编码和扩展编码）使用 chds。这不会影响条形大小或轴标签，而只会影响数据标记值。

此示例展示了一个图表，其中包含简单编码值 46、39、29、30、43、41。简单编码范围为 0—61。chds 参数定义了自定义标记比例 0—1，因此标记值会缩放到此范围，但条形高度不受影响（如果是文本格式数据，条形也会进行缩放）。
chd=s:underp
chm=N,000000,0,-1,11
chds=0,1

下面的图表示例在最低点带有文本标签，并在最高点带有标志标签。

绿色虚线的数据点上绘有以下标记的折线图表：10 点蓝色文字的标签和带有 15 点红色文字的旗帜。
chm=
  tMin,0000FF,0,1,10|
  fMax,FF0000,0,3,15
此示例展示了一个堆叠图表，其中包含各个系列的值以及系列的总计值。要显示堆叠的系列值，我们必须使用“c”定位选项；否则，顶部条形的值会与每个条形顶部的总和值重叠。
chm=
  N,FF0000,-1,,12|
  N,000000,0,,12,,c|
  N,000000,1,,12,,c|
  N,ffffff,2,,12,,c
关于垂直和水平放置方式的更多演示。此示例演示了条形图的锚点值的各种组合（使用 s、c 和 e 表示垂直放置）。请注意，右侧锚点将标记向左移动，顶部锚点将标记向下移动，反之亦然。红点表示每个条形的底部、中心和顶部。 该数字是数据值，对每个条形使用不同的定位值进行固定。
chm=
  N,000000,0,0,10,,rs
  N,000000,0,1,10,,ls
  N,000000,0,2,10,,c
  N,000000,0,3,10,,e
  N,000000,0,4,10,,e::15
  N,000000,0,5,10,,e::-12
注释标记会自动调整标签位置，以免重叠。第一个 chm 值用于线条填充，以下值均为注解标记。
chm=B,C5D4B5BB,0,0,0
  AA,666666,0,3,15
  AB,666666,0,5,15
  AC,666666,0,24,15
  AD,666666,0,25,15
  AE,666666,0,26,15
  AF,666666,0,51,15
  AG,666666,0,60,15
  AH,666666,0,73,15
  AI,666666,0,80,15
  AJ,666666,0,99,15
另一个注释标记示例，展示了瑞士各城市的海拔。

返回页首