地圖圖表 (已淘汰)

 

替換快訊：這張地圖圖表已由較新版本取代。

本頁說明如何使用 Charts 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> 必要

要套用值的國家/地區清單。

  • 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> 選用

對應至資料格式範圍低度和高資料值的顏色範圍。資料值會沿著此漸層轉換為顏色值，並套用至對應國家/地區。

  • default_color - [選用] 未指派資料的區域顏色。預設值為 BEBE (中灰色)。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 密西西比州 SD 南達科他州
DE 德拉瓦州 MO 密蘇里州 TN 田納西州
FL 佛羅里達州 MT 蒙大拿州 TX 德州
GA 喬治亞州 NE 內布拉斯加州 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>
要在圖表中顯示的標題。您無法指定這個部分顯示的位置，但可以選擇指定字型大小和顏色。請使用 + 符號代表空格，並以直立線字元 ( |) 表示換行。

 

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>
圖表中填滿的部分。你可以指定下列其中一個值：
  • 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% 的透明度 (128 十六進位數字 80 或約 50%)。請注意，透過圖表顯示的表格儲存格背景。

以藍色標示點和 50% 透明度的散佈圖。

chf=a,s,00000080

返回頁首

顏色格式

使用 6 位數十六進位值字串和兩個選用透明度值指定顏色，格式為 RRGGBB[AA]。例如：

  • FF0000 = 紅色
  • 00FF00 = 綠色
  • 0000FF = 藍色
  • 000000 = 黑色
  • FFFFFF = 白色

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

  • 0000FFFF = 亮藍色
  • 0000FF66 = 透明藍色

返回頁首