地图图表

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

目录

图表专用功能

  1. Overview
  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 像素高，或总共 300,000 像素。
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 used - 第二个及后面的颜色描述的是颜色范围。 您必须为 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> 和 <bottom_border_lat> 指定下方和顶部边框的纬度，bottom_border_lat> 和 <bottom_border_lat> 指定左侧和右侧边框的经度。

注意：由于墨卡托投影法失真（大致来说，就是将曲线地图投影到平面图片上），因此聚焦于高窄条带可能会导致地图出现一些意想不到的尺寸差异。

示例：

以下示例显示的是伦敦（以蓝色突出显示），即经度 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 [所有图表]

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

语法

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

 

示例

说明 示例

此示例用浅灰色 (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>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_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: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 表示顶部。图表元素（折线和条形）正好位于零的下方。如果两个标记的值相同，则它们将按照网址指定的顺序绘制。默认值为 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> - 指定垂直偏移量（以像素为单位）的正数或负数。可选；如果未使用，请留空。

 

示例

说明 示例

以下示例展示了几个形状和线条标记。

  • 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 轴顺序值（最后一个值）设置为 -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 像素，长五十像素，以数据点 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:5
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_when_points> 的唯一有效格式为 n.d，表示系列中点的索引。opt_which_pointsopt_which_points
  • N<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 个数据点上绘制一个标记。n
  • start:end:n - 在某个范围（从 n 到 n 索引值（含）之间）的每 n 个数据点上绘制一个标记。n所有参数都是可选的（可能不存在），因此 3::1 表示从第四个元素到最后一个元素（即第 1 步），如果完全省略此参数，则默认为 first:last:1。所有值都可以是浮点数。start 和 end 可以为负数，以便从最后一个值向后计数。如果 start 和 end 均为负数，请确保它们的值是递增的（例如，-6:-1:1）。如果 n 步进值小于 1，它将通过插值给定数据值来计算其他数据点。默认值为 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 表示顶部。图表元素（折线和条形）正好位于零的下方。如果两个标记的值相同，则将按照网址指定的顺序绘制。默认值为 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。

说明 示例

下例展示了条形图上的值标签。

第一个图表 (N*p0*) 指定了数据值标记，所有值均以百分比表示，四舍五入到小数点后 0 位，黑色的值以 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
另一个注释标记示例，展示了瑞士各城市的海拔。

返回页首