地图图表（已弃用版本）

 

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

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

目录

图表专用功能

  1. Overview
  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> 必需

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

  • country_or_state 代码 - 这些代码是一组由两个字符组成的代码，中间无分隔符。使用以下任一类型（不能混用）：

示例：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> 可选

对应于数据格式范围的下限和上限数据值的颜色范围。数据值将沿此渐变转换为颜色值，并应用于相应的国家/地区。
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 阿拉斯加 中东地区 缅因 确定 俄克拉荷马
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 [所有图表]

您可以为背景和/或图表区域指定纯色填充，也可以为整个图表指定透明度值。您可以使用竖线字符 (|) 指定多种填充。（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

返回页首

颜色格式

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

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

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

  • 0000FFFF = 纯蓝色
  • 0000FF66 = 透明蓝色

返回页首