替换提醒:此地图图表已被更新版本替换。
本页介绍如何使用 Chart API 创建彩色的地图。
目录
概览
您可以创建一张地图,其中以自定义颜色突出显示各个国家/地区或州。如需指定地图,您需要指定地图应放大的世界区域。您还将指定一个列表,其中包括应该在地图上着色的区域,以及一个并行数据列表(用于为每个相应的国家/地区分配一个数值)。每个国家/地区根据分配给其的值,采用渐变色进行着色。您可以选择为数据值指定自定义颜色渐变。
地图图表支持以下参数:
参数 | 必填还是选填 | 说明 |
---|---|---|
cht=t |
必需 | 指定地图图表。 |
chs |
必需 | 地图尺寸。地图的最大尺寸为 440x220。 |
chtm=<zoom_area> |
必需 | 图表中显示的地理区域。
|
chld=<country_or_state_codes> |
必需 | 要应用值的国家或地区的列表。
示例: |
chd=<country_values> |
必需 | 与区域列表平行的值列表,其中值适用于相应的区域。值是标准设置了格式的数据值。系统会根据 chco 中指定的范围为每个区域分配一种颜色,其中范围内的最小值适用于最低颜色,而该范围内的最大值适用于最后一种颜色。
|
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient> |
可选 | 与数据格式范围的低数据值和高数据值相对应的颜色范围。数据值会沿着这种渐变转换为颜色值,并应用于相应的国家/地区。
|
chtt, chts |
可选 | 图表标题和样式 |
chma |
可选 | 图表边距 |
chf=bg |
可选 | 纯色填充(仅限背景) |
示例
说明 | 示例 |
---|---|
在此示例中:
|
|
此图表与上一个图表类似,但包含的更多详情。 |
chtm=africa |
此图表指明,没有通过指定一个未定义的值 ( |
chs=440x220 |
美国各州代码
以下是地图缩放至美国时支持的状态代码 (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”。
示例
说明 | 示例 |
---|---|
标题、默认颜色和字体大小的图表。 使用加号 ( 使用竖线字符 ( 此处未指定 |
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
[所有图表]
您可以为背景和/或图表区域指定纯色填充,或者为整个图表指定透明度值。您可以使用竖线字符 (|
) 指定多种填充。(地图:仅限背景)。
语法
chf=<fill_type>,s,<color>|...
- <fill_type>fill_type
- 要填充的图表部分。指定以下某个值:
bg
- 背景填充c
- 图表区域填充。不支持地图图表。a
- 将整个图表(包括背景)设为透明。<color>
的前六位数会被忽略,只有最后两位数(透明度值)会应用到整个图表和所有填充。b<index>
- 条形纯色填充(仅限条形图)。 将 <index> 替换为条形的系列索引,即可以纯色填充条形。其效果类似于在条形图中指定chco
。有关示例,请参阅条形图系列颜色。
- 秒
- 表示纯色或透明填充。
- <color>
- 填充颜色,采用 RRGGBB 十六进制格式。对于透明度,前六位数会被忽略,但无论如何都必须将其包含在内。
示例
说明 | 示例 |
---|---|
此示例使用浅灰色 ( |
|
下例用浅灰色 ( |
|
此示例将整个图表的透明度设为 50%(十六进制格式的 80 表示 128,即约为 50% 的透明度)。请注意,表格单元格背景透过图表显示出来。 |
|
使用 6 个字符的十六进制值字符串以及两个可选的透明度值来指定颜色,格式为 RRGGBB[AA]
。
例如:
FF0000
= 红色00FF00
= 绿色0000FF
= 蓝色000000
= 黑色FFFFFF
= 白色
AA
是可选的透明度值,其中 00
表示完全透明,FF
表示完全不透明。例如:
0000FFFF
= 蓝色常亮0000FF66
= 透明蓝色