地圖圖表 (已淘汰)

 

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

本頁說明如何使用 Charts 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> 這是必填欄位

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

範例：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 南達科他州
德國 德拉瓦州 MO 密蘇里州 TN 田納西州
FL 佛羅里達州 MT 蒙大拿州 TX 德克薩斯州
GA 喬治亞 NE 內布拉斯加州 UT 猶他州
HI 夏威夷州 NV 內華達州 VT 佛蒙特州
ID 愛達荷州 NH 新罕布夏州 VA 維吉尼亞州
IL 伊利諾州 NJ 紐澤西州 WA 華盛頓州
印度 印第安那州 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，約為 50%)。請注意整張圖表中的表格儲存格背景。

含有藍色點，透明度為 50% 的散佈圖。

chf=a,s,00000080

返回頁首

顏色格式

指定顏色時，您可以使用包含十六進位值的 6 字元字串，以及兩個選用的透明度值，格式為 RRGGBB[AA]。例如：

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

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

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

返回頁首