地图图表（已弃用版本）

 

替换提醒：此地图图表已被更新版本替换。

本页介绍如何使用 Chart API 创建彩色的地图。

目录

图表专属功能

  1. 概览
  2. 美国各州代码

标准功能

  1. 图表标题（chtt、chts）
  2. 图表边距 (chma)
  3. 背景填充
    1. 纯色填充 (chf)

概览

您可以创建一张地图，其中以自定义颜色突出显示各个国家/地区或州。如需指定地图，您需要指定地图应放大的世界区域。您还将指定一个列表，其中包括应该在地图上着色的区域，以及一个并行数据列表（用于为每个相应的国家/地区分配一个数值）。每个国家/地区根据分配给其的值，采用渐变色进行着色。您可以选择为数据值指定自定义颜色渐变。

地图图表支持以下参数：

参数 必填还是选填 说明
cht=t 必需 指定地图图表。
chs 必需 地图尺寸。地图的最大尺寸为 440x220。
chtm=<zoom_area> 必需

图表中显示的地理区域。

  • zoom_area - 以下值之一
    • africa
    • asia
    • europe
    • middle_east
    • south_america
    • usa
    • world
chld=<country_or_state_codes> 必需

要应用值的国家或地区的列表。

  • 国家/地区或州/省/自治区/直辖市代码 - 是一组双字符代码，中间不分隔任何分隔符。使用以下任一类型（不能混用多种类型）：

示例：chld=DZEGMG
chd=<country_values> 必需

与区域列表平行的值列表，其中值适用于相应的区域。值是标准设置了格式的数据值。系统会根据 chco 中指定的范围为每个区域分配一种颜色，其中范围内的最小值适用于最低颜色，而该范围内的最大值适用于最后一种颜色。

  • country_values - 采用适当格式字符串的列表。示例：t:10,20,30、s:aU2Ff 和 e:BaPoqM-A。
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient> 可选

与数据格式范围的低数据值和高数据值相对应的颜色范围。数据值会沿着这种渐变转换为颜色值，并应用于相应的国家/地区。

  • default_color - [可选] 未分配数据的区域的颜色。默认值为 BEBEBE（中灰色）。 一个 RRGGBB 格式的十六进制数字。
  • start_of_gradient - [start_of_gradient] 与数据格式范围内的最小值对应的颜色。默认值为 0000FF（蓝色）。一个 RRGGBB 格式的十六进制数字。
  • ... - [可选] 您可以根据需要使用任意数量的中间颜色。
  • end_of_gradient - [end_of_gradient] 与数据格式范围内的最大值对应的颜色。默认值为 FF0000（红色）。 一个 RRGGBB 格式的十六进制数字
chtt, chts 可选 图表标题和样式
chma 可选 图表边距
chf=bg 可选 纯色填充（仅限背景）

 

示例

说明 示例

在此示例中：

  • 图表缩放区域为非洲 (chtm=africa)。
  • 将给这三个国家/地区分配值：阿尔及利亚、埃及和马达加斯加 (chld=DZEGMG)
  • 分配给这些国家/地区的三个值分别为 0、100 和 50 (chd=t:0,100,50)，分别是文本格式数据的最小值、最大值和中间值。
  • 颜色范围为红色表示 0，绿色表示 100，白色表示未分配的国家/地区 (chco=FFFFFF,FF0000,00FF00)。
  • 图表还采用了浅蓝色的背景填充 (chf=bg,s,EAF7FE)。

非洲地图
cht=t
chtm=africa
chld=DZEGMG
chd=t:0,100,50
chco=FFFFFF,FF0000,00FF00
chf=bg,s,EAF7FE

此图表与上一个图表类似，但包含的更多详情。

 非洲地图
chtm=africa
chld=DZEGMGAOBWNGCFKECGCVSNDJTZGHMZZM
chco=FFFFFF,FF0000,FFFF00,00FF00
chd=t:0,100,50,32,60,40,43,12,14,54,98,17,70,76,18,29
chf=bg,s,EAF7FE

此图表指明，没有通过指定一个未定义的值 (chd=t:-1) 来突出显示任何国家/地区。

 世界地图
chs=440x220
chd=t:-1
cht=t
chtm=world

返回页首

美国各州代码

以下是地图缩放至美国时支持的状态代码 (chld=usa)。

AL 亚拉巴马 LA 路易斯安那州 OH 俄亥俄州
AK 阿拉斯加 ME 缅因 确定 俄克拉荷马
AZ 亚利桑那州 MD 马里兰州 或 俄勒冈州
AR 阿肯色州 MA 马萨诸塞州 PA 宾夕法尼亚州
CA 加利福尼亚 MI 密歇根州 RI 罗得岛州
CO 科罗拉多州 MN 明尼苏达 SC 南卡罗来纳
CT 康涅狄格州 MS 密西西比 标清 南达科他
DE 特拉华 MO 密苏里 TN 田纳西州
FL 佛罗里达 MT 蒙大拿州 TX 得克萨斯州
GA 格鲁吉亚 东北 内布拉斯加 UT 犹他
HI 夏威夷 NV 内华达州 VT 佛蒙特
ID 爱达荷 NH 新罕布什尔州 VA 弗吉尼亚
IL 伊利诺伊州 NJ 新泽西州 WA 华盛顿
IN 印第安纳州 NM 新墨西哥 WV 西弗吉尼亚州
IA 爱荷华 NY 纽约 WI 威斯康星
KS 堪萨斯州 NC 北卡罗来纳 WY 怀俄明州
KY 肯塔基州 ND 北达科他

返回页首

标准功能

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

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

返回页首

颜色格式

使用 6 个字符的十六进制值字符串以及两个可选的透明度值来指定颜色，格式为 RRGGBB[AA]。 例如：

  • FF0000 = 红色
  • 00FF00 = 绿色
  • 0000FF = 蓝色
  • 000000 = 黑色
  • FFFFFF = 白色

AA 是可选的透明度值，其中 00 表示完全透明，FF 表示完全不透明。例如：

  • 0000FFFF = 蓝色常亮
  • 0000FF66 = 透明蓝色

返回页首