此页面介绍了如何使用 Charts API 创建彩色地图。此图表是经过改进的新版本,与旧版地图图表 (cht=t
) 相比,支持更大的地图和更多功能。
目录
图表专用功能 |
标准功能 |
概览
您可以创建一张地图,并以自定义颜色突出显示各个国家/地区或州。您可以让地图缩放至适当的级别以正确显示您选择的国家/地区,也可以使用纬度和经度值缩放至自定义级别。
支持的参数
地图图表支持以下参数:
参数 | 必填还是选填 | 说明 |
---|---|---|
cht=map<opt_zoom_and_center> |
必需 | 指定地图图表。 opt_zoom_and_center - 可选字符串,可让您在特定区域上缩放或居中图表。查看详情。 |
chs |
必需 | 地图尺寸。地图的尺寸上限为 600 像素宽,600 像素高,或总共 300,000 像素。 |
chd= |
可选 | 如果使用此值,则数据值将按照 chco 指定的渐变色指示相应国家/地区的颜色。 |
chld= |
必需 | 以竖线分隔的国家/地区或州列表,将用 |
|
可选 | 图表颜色。此字符串的格式取决于您是否使用
|
chtt, chts |
可选 | 图表标题和样式 |
chm |
可选 | 图表标记 |
chma |
可选 | 图表外边距 |
chf=bg... |
可选 | 纯色填充(仅限背景) |
chdl |
可选 | 图表图例 |
示例
说明 | 示例 | |||
---|---|---|---|---|
在此示例中:
|
|
|||
一张显示了法国的地图,其中突出显示了两个地区:
|
chld=FR-D|FR-B|FR |
|||
此地图使用了渐变色表现地图。
|
chd=t:0,50,100 |
|||
请注意,可以在指定的图表尺寸范围内剪裁地图。这是因为我们不会为了适应指定的图表尺寸而扭曲地图,但会将地图限制到您在 chld 中指定的区域。 因此,为了避免图表边界内的区域被剪裁,您可能需要手动调整地图大小。 |
|
缩放和居中
默认情况下,图表会缩放并居中,以将您选定的区域居中,并使其在定义的地图尺寸范围内尽可能贴近渲染区域。不过,您可以通过以下两种不同方式自定义图表的中心和缩放级别:
按像素
要按像素大小调整边界,请使用以下格式:
cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>
其中,每个边框尺寸表示要在自动计算的缩放级别之外显示的额外边框(以像素为单位)。
您只能缩小(正值);您不能使用像素缩放将放大(负值)到比默认缩放级别更近的位置。
示例:
这些示例显示的都是伦敦(纬度
无缩放(默认) | 每边缩小 30 像素 | 缩小地图,并向右移动到底 |
---|---|---|
|
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=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”。
示例
说明 | 示例 |
---|---|
标题使用默认颜色和字体大小的图表。 请使用加号 ( 使用竖线字符 ( 此处未指定 |
chtt=Site+visitors+by+month| |
一个图表,带有蓝色右对齐的 20 点标题。 |
chtt=Site+visitors |
图表边距 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 像素。如果您将 |
|
背景填充 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% 的透明度)。请注意,表格单元格背景透过图表显示出来。 |
|
图表图例文本和样式 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 |
第一个图表展示了横向图例条目( |
|
此示例演示了如何更改字体大小。 |
|
形状标记 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 |
|
另一个注释标记示例,展示了瑞士各城市的海拔。 |