地圖圖表

本頁說明如何使用 Charts API 建立彩色地圖。這張圖表是全新改良版本，支援比舊版地圖 (cht=t) 更大的地圖及更多地圖項目。

目錄

圖表專屬功能

  1. Overview
  2. 支援的參數
  3. 縮放與中心

標準功能

  1. 圖表標題 (chtt、chts)
  2. 圖表顏色 (chco)
  3. 圖表邊界 (chma)
  4. 背景填滿
    1. 實心填充 (chf)
  5. 圖表圖例 (chdl, Chdlp)
  6. 形狀標記 (chm)
  7. 文字和資料標記 (chm)

總覽

您可以建立地圖，在其中以自訂顏色醒目顯示多個國家/地區或州/省。您可以將地圖縮放到適當等級，以正確顯示所選國家/地區，或者使用經緯度值將地圖放大或縮小到自訂等級。

支援的參數

地圖圖表支援下列參數：

參數 必填或選填 說明
cht=map<opt_zoom_and_center> 這是必填欄位

指定地圖圖表。

opt_zoom_and_center - 選擇性的字串，可讓您縮放或將圖表置於特定區域。瞭解詳情
chs 這是必填欄位 地圖尺寸。地圖的尺寸上限為 600 像素，高度為 600 像素或總計 300,000 像素。
chd=
 <first_country_value>,
 ...,
 <last_country_value>		 選用 如果使用，資料值將指出對應國家/地區的顏色，以及 chco 指定的色彩漸層。
chld=
 <country_or_region_codes>|...|		 這是必填欄位

以直線符號分隔的國家/地區或州清單，將以 chco 指定的顏色醒目顯示。地圖會自動縮放到指定的所有國家/地區，除非您自行自訂縮放或置中設定。代碼必須為大寫。這些代碼為 ISO 3166-1-alpha-2 代碼：兩個大寫字元 (選擇性) 後面接一個破折號和第二個區域或城市 ID。例如：GB (英國)、GB-LND (倫敦)、US-NJ (美國紐澤西州)

chco

  • 如果「未使用」chd：
    chco=
     <unselected_land_color>|
     <first_region_color>|
       ...|
     <last_region_color>
  • 如果「使用」chd：
    chco=
     <unselected_land_color>,
     <color_range_start>,
       ...,
     <color_range_end>
 選用

圖表顏色。這個字串的格式取決於您是否使用 chd。在這兩種語法中，<unselected_land_color> 都是 chld 中未指定的任何區域顏色。請注意，不同語法的分隔線不同 (一種是半形逗號，另一個中的直立線)。如未使用，區域會以外框顯示，不會上色。

  • chd 已使用 - 第二和後續顏色用來描述色彩範圍。您必須在 chld 中為每個國家/地區提供一個 chd 值，並為對應國家/地區標上 <first_region_color> (最小資料範圍值) 到 <last_region_color> (資料範圍最大值)。請參閱下表中的範例。
  • chd 未使用：第二及後續顏色會套用至 chld 中的對應區域。如果國家/地區數量超過顏色，系統會將最後一個顏色套用至清單中多餘的國家/地區。
chtt, chts 選用 圖表標題和樣式
chm 選用 圖表標記
chma 選用 圖表邊界
chf=bg... 選用 純填滿 (僅限背景)
chdl 選用 圖表圖例

 

例子

說明 範例

在這個例子中：

  • cht=map:fixed=-60,0,80,-35：圖表縮放區域為緯度 -60 至 80 (緯度) 至 35 點 (經度 -35) 之間
  • chld=CA-BC|CN|IT|GR|US-UT - 高人氣地區是英屬哥倫比亞、中國、義大利、希臘、猶他州。
  • chm：旗標的圖表標記。
  • chma=0,110,0,0 - 右側框線增加為 110 像素，以符合圖例。
  • chtt=Last+Five+Olympic+Hosts - 圖表標題，以「+」表示空格。

五個奧運主機國家/地區的地圖，顯示旗幟標記。
cht=map:fixed=-60,0,80,-35
chs=600x350
chld=CA-BC|CN|IT|GR|US-UT
chdl=Vancouver|Beijing|Torino|Athens|Salt+Lake+City
chco=B3BCC0|5781AE|FF0000|FFC726|885E80|518274
chtt=Last+Five+Olympic+Hosts
chm=f2010+Winter,000000,0,0,10
f2008+Summer,000000,0,1,10
f2008+Winter,000000,0,2,10,1,:-5:10
f2004+Summer,000000,0,3,10
f2004+Summer,000000,0,4,10
chma=0,110,0,0

顯示法國的地圖，並醒目顯示兩個區域：

  • chld=FR-D|FR-B|FR - 指定了三個區域：東南部、阿基坦 (西南部) 和法國。
  • chco=676767|FF4444|44FF44|4444FF - 這張地圖未指定任何 chd 參數，因此第一個之後的每個顏色值都會用來指定對應國家/地區。寶哥紅色代表紅色，綠色代表 Aquitaine，藍色代表法國。您可以看到之後的顏色不會遮蔽較早的顏色。
 醒目顯示兩個省的法國地圖。
chld=FR-D|FR-B|FR
chco=676767|FF4444|44FF44|4444FF

本地圖示範如何使用色彩漸層。

  • chd=t:0,50,100 - chd 參數代表顏色漸層。這裡指定文字編碼，範圍介於 0 至 100 之間。
  • chco=CCCCCC,FF0000,000000 - 背景顏色為淺灰色 (CCCCCC)，顏色範圍從紅色 (FF0000) 到黑色 (000000)。顯示的中間國家/地區是該漸層的中間色。
 地圖顯示顏色漸層。
chd=t:0,50,100
chco=CCCCCC,FF0000,000000
請注意，地圖可以在指定圖表大小內裁剪。這是因為我們不會扭曲地圖以符合特定圖表大小，但只會將地圖限制在您為指定圖表大小中指定的區域。 因此，為了避免圖表邊界內的裁剪區域，您可能需要手動調整地圖大小。
長國家/地區的正方形地圖

cht=map
chs=300x300
chld=GB

英格蘭是自然綿長的細小，因此指定正方形地圖時，系統會在右側指定裁剪區域：

 長國家/地區的正方形地圖

cht=map
chs=180x300
chld=GB

請調整圖表寬度，將多餘部分裁剪掉。請注意，如果底部仍有部分裁剪內容，只要減少地圖高度即可加以修正。

 長國家/地區的正方形地圖

cht=map
chs=180x300
chld=GB

法國的形狀比較規律，因此在正方形地圖中能夠更自然。

返回頁首

縮放與置中

根據預設，圖表會縮放並置中，方便您將所選區域置中，並盡可能配合定義地圖尺寸內的算繪區域。不過，您可以使用兩種不同方式自訂圖表的中心和縮放等級：

依像素

如要按像素大小調整邊框，請使用以下格式：

cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>

其中每個邊框大小都是指要顯示的額外框線 (以像素為單位)，超過自動計算的縮放等級。

只能縮小 (正值)，使用像素縮放功能時，不得放大 (負值)。

例如：

這些例子全都是倫敦 (Lat)

不縮放 (預設) 縮小每邊 30 像素 縮小並向右縮小

底部地圖空白。
cht=map

 底部地圖過多。
cht=map:auto=30,30,30,30		 已重新置中縮放縮放區域。
cht=map:auto=50,0,80,0

 

依緯度和經度

您可以運用下方顯示的語法，根據經緯度指定地圖算繪結果的頂端、底部、左側和右側框線：

cht=map:fixed=<bottom_border_lat>,<left_border_long>,<top_border_lat>,<right_border_long>

其中 <bottom_border_lat> 和 <bottom_border_lat> 可指定上下框線的緯度，bottom_border_lat> 和 <bottom_border_lat> 則指定左右框線的經度。

注意：由於麥卡托投影扭曲失真 (基本上是將弧形地圖投射到平面的圖片)，因此著重於高而狹窄的條紋，可能會導致地圖出現非預期的尺寸差異。

例如：

以下範例顯示經度 0.1° 的倫敦，緯度 51.5°。請注意，地圖裁剪的原因包括：地圖只會嘗試顯示英國 (如指定) 並填滿指定圖表，不會扭曲失真。

置中 緯度偏移 +10* 縮減所有值以縮放

cht=map:fixed=40,-10,60,10


cht=map:fixed=50,-10,70,10
cht=map:fixed=48,-3,54,3

請注意，即使將相同的度數往上移動，中間圖片的大小還是比第一張圖片小一點。這是因為我們將 3D 球體投影到 2D 圖片上。您必須增加第二個圖表的寬度，讓第二個圖表的大小與第一個圖表相同。

返回頁首

標準功能

本頁其他功能為標準圖表功能。

圖表標題 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

返回頁首

圖表圖例文字和樣式 chdl、chdlp、chdls [所有圖表]

圖例是圖表的側邊部分，會提供每個序列的小文字說明。您可以在這個圖例中指定與各個序列相關聯的文字，並指定這些序列在圖表上的顯示位置。

另請參閱 chma，瞭解如何設定圖例的邊界。

字串值注意事項：標籤字串只能使用安全網址字元。為了安全起見，如果字串含有字元集 0-9a-zA-Z 內的字元，請進行網址編碼。您可以在 Google 視覺化說明文件中找到網址編碼器。

語法

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

 

chdl - 每個序列的文字會顯示在圖例中。

<data_series_label>
圖例項目的文字。每個標籤都會套用至 chd 陣列中的對應序列。聊天室請使用 + 標記。如未指定這個參數，圖表就不會取得圖例。您無法在標籤中指定換行符號。圖例通常會展開以保留圖例文字，且圖表區域會縮小以配合圖例。

chdlp - [選用] 圖例的位置和圖例項目的順序。您可以指定 <position> 和/或 <label_order>。如果兩者都指定，請使用長條字元分隔。如果要略過 chdl 中的空白圖例項目，您可以在任何值中加入「s」。範例：chdlp=bv、chdlp=r、chdlp=bv|r、chdlp=bvs|r

<opt_position>
[選用] 指定圖例在圖表中的位置。如要指定圖例與圖表區域或圖片邊框之間的額外邊框間距，請使用 chma 參數。選擇下列其中一個值：
  • b - 圖表底部的圖例，橫列中的圖例項目。
  • bv - 圖表底部的圖例，垂直欄中的圖例項目。
  • t - 圖表頂端的圖例，橫列中的圖例項目。
  • tv - 圖表頂端的圖例，垂直欄中的圖例項目。
  • r - [預設] 圖表右側的圖例，垂直欄中的圖例項目。
  • l - 圖表左側的圖例，垂直欄中的圖例項目。
<opt_label_order>
[選用] 標籤在圖例中顯示的順序。 選擇下列其中一個值：
  • l - [垂直圖例預設值] 依指定 chdl 的順序顯示標籤。
  • r - 按給 chdl 的指定順序顯示標籤。這在堆疊長條圖中非常實用，可在顯示長條時以相同的順序顯示圖例
    。
  • a - [水平圖例的預設值] 自動排序：大致是指按照長度，以最短為單位排序，以 10 像素的區塊為測量單位。當兩個元素的長度相同 (分割為 10 個像素區塊) 時，系統會優先顯示第一個元素。
  • 0,1,2... - 自訂標籤順序。這個清單會列出 chdl 從零開始的標籤索引，以半形逗號分隔。

chdls - [選用] 用來指定圖例文字的顏色和字型大小。

<color>
圖例文字顏色，採用 RRGGBB 十六進位格式。
<size>
圖例文字的點大小。

 

例子

說明 範例

兩個圖例範例。請按照資料序列的順序指定圖例文字。

有對應圖例的紅、藍、綠折線圖

chdl=NASDAQ|FTSE100|DOW
chco=FF0000,00FF00,0000FF

具有兩個小圓圈的文氏圖，由一個大圓圈包圍


chdl=First|Second|Third
chco=ff0000,00ff00,0000ff

第一張圖表展示了水平圖例項目 (chdlp=t，預設版面配置為水平)，第二張展示底部垂直的圖例項目 (chdlp=bv)。

具有兩個小圓圈的文氏圖，由一個大圓圈包圍
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=t

具有兩個小圓圈的文氏圖，由一個大圓圈包圍
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=bv
這個範例說明如何變更字型大小。

具有兩個小圓圈的文氏圖，由一個大圓圈包圍
chdls=0000CC,14

返回頁首

形狀標記 chm [酒吧、線條、雷達、散佈圖]

您可以為圖表上的全部或個別資料點指定圖形標記，如果有兩個以上的標記位於同一個點，則標記會依照 chm 參數中出現的順序繪製。您也可以在資料點上建立文字標記，相關說明請參閱資料點標記。

您可以使用直立線字元 ( |) 將形狀標記與任何其他 chm 參數結合，藉此分隔 chm 參數。

語法

為每個應標示的系列指定下列一組參數。如要標示多個序列，請建立其他參數集，並以直立線字元分隔。您不需要標記所有系列叢書。如未將標記指派給資料序列，就不會獲得任何標記。

散佈圖中的形狀標記行為略有不同。詳情請參閱該說明文件。

chm=
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
    |...|
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
@
[選用] 如果標記類型前面含有選用的 @ 字元，則 <opt_what_points> 應使用 x:y 格式。
<marker_type>
要使用的標記類型。指定下列其中一種類型：
  • a - 箭頭
  • c - 交叉
  • C - 矩形。如果矩形標記，您至少須有兩個資料序列，其中序列 0 會指定底部邊緣，序列 1 則指定頂部邊緣。<size> 會以像素為單位，指定矩形的寬度。
  • d - 鑽石級
  • E - 錯誤列標記 ( ) 建立此標記時需要兩個資料序列，一個是底部值，第二個序列中的對應點則為頂部。此外，也會公開擴充的 <size> 語法：line_thickness[:top_and_bottom_width]，其中 top_and_bottom_width 是選用項目。請參考下列範例。
  • h：指定高度的圖表水平線。(<opt_which_points> 參數的有效格式為 opt_which_points。)
  • H：通過指定資料標記的水平線。這個外掛程式支援擴充 <size> 語法，可讓您指定確切的行長度：line_thickness[:length] 為選填欄位 :length，且預設為完整圖表區域寬度。
  • o - 社交圈
  • s - 正方形
  • v：從 X 軸到資料點的垂直線
  • V - 可調整長度的垂直線。這個外掛程式支援擴充 <size> 值語法，可讓您指定確切的行長度：line_thickness[:length] 為選填欄位 :length，且預設為完整圖表區域高度。以資料點為中心標記。
  • x - X
<color>
這個系列的標記顏色，採用 RRGGBB 十六進位格式。
series_index>
要繪製標記的資料序列以零為基準的索引。針對按照 x/y 位置指定位置的 h 標記和標記 (開頭為 @ 字元) 會遭到忽略。您可以使用隱藏的資料序列做為標記來源，詳情請參閱複合式圖表。已分組的垂直長條圖支援特殊的擴充語法，以便將標記與特定長條對齊。
<opt_which_points>
[選用] 要在哪個點繪製標記。預設值為所有標記。請使用下列其中一個值：
  • n.d：要繪製標記的位置。意義因標記類型而異：
    • 除了 h 以外的所有類型：要繪製標記的目標資料點，其中 n.d 代表序列中以零為基礎的索引。如果您指定非整數值，則分數表示計算出的中繼點。例如，3.5 表示點 3 和點 4 點之間的一半。
    • h - 從 0.0 到 1.0 的數字，其中 0.0 代表圖表底部，1.0 則是圖表頂端。
  • -1：在所有資料點上繪製標記。您也可以將這個參數留空，以便在所有資料點上繪製。
  • -n - 在每個「n」n資料點上繪製一個標記。浮點值；如果 n 小於 1，圖表會為您計算其他中介點。舉例來說，-0.5 的標記數量會是資料點的兩倍。
  • start:end:n：在範圍中每個n資料點 (從 n 到 n 索引值 (含)) 繪製一個標記。所有參數皆為選用 (可能不會顯示)，因此 3::1 會從第四個元素到最後一個步驟 1，而完全省略這個參數將預設為 first:last:1。所有值可以是浮點數。start 和 end 可以是負數，以從最後一個值回溯計算。如果 start 和 end 都是負數，請務必使用遞增值列出 (例如 -6:-1:1)。如果 n 步值小於 1，則會內插指定資料值來計算其他資料點。預設值為 first:last:1
  • x:y：在圖表上的特定 x/y 點繪製標記。這個點不一定要在線上。在標記類型前方加上 @ 字元，即可使用這個選項。將座標指定為浮點值，其中 0:0 是圖表的左下角，1:1 則是圖表右上角。舉例來說，如要在圖表中央新增 15 像素的紅色鑽石，請使用 @d,FF0000,0,0.5:0.5,15。
<size>
標記的大小，以像素為單位。這個參數大多會採用一個數字值，V、H 和 S 標記均支援 <size>[:width] 這個語法，其中選用的第二部分會指定線條或標記的長度。
<opt_z_order>
[選用] 比起其他標記和所有其他圖表元素，用於繪製標記的圖層。這是介於 -1.0 到 1.0 (含) 之間的浮點數，-1.0 是底部，1.0 則是頂端。圖表元素 (折線和長條) 小於 0。如果兩個標記的值相同，系統會按照網址提供的順序繪製標記。預設值為 0.0 (在圖表元素上方)。
<opt_offset>
[選用] 讓您指定與指定位置之間的水平和垂直偏移。以下是使用 : 分隔符號的語法：reserved:<horizontal_offset>:<vertical_offset>。如果有指定，您可以在 chm 參數字串的 <opt_z_order> 中加入空白 , 值。例如：o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
  • reserve - 留空。
  • <horizontal_offset> - 指定水平偏移的正數或負數，以像素為單位。選用，如未使用，請留空。
  • <vertical_offset> - 指定垂直偏移的正數或負數，以像素為單位。選用，如未使用，請留空。

 

例子

說明 範例

以下是幾種形狀和線條標記的範例。

  • a,990066,0,0.0,9.0 - 紫色箭頭，第一個序列，第一個點，尺寸 9。
  • c,FF0000,0,1.0,20.0 - 紅色交叉點，第一個序列，第二個點，尺寸 9。
  • d,80C65A,0,2,20.0 - 綠色菱形，第一序列，第三點，尺寸 9。
  • H,000000,0,3,1:40 - 黑色水平線、第一序列、資料點 3、1 像素寬、40 像素。
  • o,FF9900,0,4.0,12.0 - 橘色圓圈，第一個序列，第五個點，尺寸 12。
  • s,3399CC,0,5.0,11.0 - 藍色正方形，第一序列，第六點，尺寸 11。
  • v,BBCCED,0,6.0,1.0：對齊點、第一序列、第七點、1 像素寬。
  • V,3399CC,0,7.0,1.0：圖表上上下垂直線條，第一序列，第八點，寬度為 1 像素。
  • x,FFCC33,0,8.0,20.0 - 黃色「X」，第一串，第 9 個點，尺寸 20。
  • H,FFFF00,0,9,2 - 資料點為 9 的圖表寬度水平黃線。
  • h,FF0000,0,0.5,1 - 指定高度的紅色水平線，第一序列、圖表上半部，寬 1 像素。
 附有標記的折線圖
chm=
  a,990066,0,0.0,9.0|
  c,FF0000,0,1.0,20|
  d,80C65A,0,2.0,20.0|
  H,000000,0,3,1:40|
  o,FF9900,0,4.0,12.0|
  s,3399CC,0,5.0,11.0|
  v,BBCCED,0,6,1.0|
  V,3399CC,0,7,1.0|
  x,FFCC33,0,8,20|
  H,FFFF00,0,9,2|
  h,FF0000,0,0.5,1

以下範例中的一個資料序列使用了鑽石，另一個資料序列則是圓形。

如有兩個以上的標記位於同一個點，則標記會依照 chm 參數中出現的順序繪製。這裡的圓形是第一個使用 chm 指定的標記，因此系統會先繪製這個標記。菱形會指定並繪製，然後會在圓形上方繪製。

 折線圖，一條線條的每個資料點各有 15 像素圓圈，另一線則有 10 個像素菱形。系統會在兩條線共同的點上繪製菱形
chm=
  o,FF9900,0,-1,15.0|
  d,FF0000,1,-1,10.0

以下是一張折線圖，其中包含每秒資料點 (-2 代表其他資料點) 的標記。

 顯示標記的折線圖，每秒鐘都有標記
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-2,6
以下是折線圖，標記數量是資料點的兩倍 (-0.5 代表每半點)。 顯示標記的折線圖，每秒鐘都有標記
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-.5,6
這個範例說明如何使用 h 和 v 標記，建立具有自訂顏色和粗細的格線。Z 順序值 (最後一個值) 會設為 -1，讓格線顯示在資料線條下方。
顯示標記的折線圖，每秒鐘都有標記
chm=
  h,76A4FB,0,0:1:.2,2,-1|
  V,76A4FB,0,::2,0.5,-1

這張圖表會在折線圖中加入垂直填滿線條：

  • v：圖表的垂直線
  • FF0000 - 紅線
  • 0 - 系列叢書索引
  • : :.5 - 範圍指定碼：從開始到結束，每 0.5 點。
  • 2 - 厚度 2 像素。
 顯示標記的折線圖，每秒鐘都有標記
chm=
  v,FF0000,0,::.5,2
這個範例會使用確切座標，在圖表中加入箭頭和文字標記。第一個 D 標記是長條圖下方的追蹤線。第二個標記是箭頭，第三個標記是箭頭文字。
chm=
  D,003971,1,0,3|
  @a,000000,0,.25:.75,7|
  @tExpected,000000,0,.35:.85,10
如要顯示相對值，或加強圖表中資料值的高度，使用固定於特定資料點 (H) 的水平線便相當實用。
chm=H,FF0000,0,18,1

這張圖表展示可在 <size> 參數中指定線條粗細和長度的標記。

  • E,000000,0,6,1:20 - 黑色錯誤列，寬度為 1 像素寬，頂端和底部長條為 20 像素。底部錨定為序列 0 點 8，頂端則錨定在序列 1 點 8。
  • H,990066,1,2,5:50 - 紫色、水平線 5 像素，以資料點 2 為中心，值為 50 像素。
  • V,3399CC,0,8,3:50- 藍色的垂直線 3 個像素寬，以 50 像素為中心，以資料點 8 為中心。
 title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,9CE90066,1,290,1,2,5:5"
chm=
  E,000000,0,6,1:20|
  H,990066,1,2,5:50|
  V,3399CC,0,8,3:50

返回頁首

文字和資料值標記 chm [Bar、Line、Radar、Satter]

您可以使用自訂文字來為圖表中的特定點加上標籤，也可以為特定時間點的資料格式化版本加上標籤。

您可以使用直立線字元 ( |) 合併任何 chm 標記，藉此分隔 chm 參數集。

字串值注意事項：標籤字串只能使用安全網址字元。為了安全起見，如果字串含有字元集 0-9a-zA-Z 內的字元，請進行網址編碼。您可以在 Google 視覺化說明文件中找到網址編碼器。

語法

針對每個應標示的系列，指定下列一組參數。如要標示多個序列，請建立其他參數集，並以直立線字元分隔。您不需要標記所有系列叢書。如未將標記指派給資料序列，就不會獲得任何標記。

chm=
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
    |...|
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
<marker_type>
要使用的標記類型。可供選用的類型如下：
  • f<text> - 包含文字的旗標。請指定「f」字元，後面加上自訂網址編碼的文字。如要在文字標記中逸出逗號，請在半形逗號之前加上「\」符號。範例：fHello\,+World!
  • t<text> - 簡單的文字標記。請指定「t」這個字元，後面加上自訂網址編碼的文字。如要在文字標記中逸出逗號，請在半形逗號之前加上「\」符號。範例：tHello\,+World!
  • A<text> - 註解標記。這與標記標記類似，但標記會協調位置，避免重疊。<opt_which_points> 的有效格式是 opt_which_points，表示序列中某一點的索引。
  • N<formatting_string> - 目前資料的值 (選用格式)。如未使用 chds 參數 (自訂縮放功能)，則會提供確切的編碼值。如果搭配任何格式類型使用這個參數，值就會縮放至您指定的範圍。請參閱下方帶有數字標記的 chds 範例。在堆疊長條圖中使用這種標記類型，如果您為 <series_index> 指定 -1，就會取得標記，顯示這個堆疊長條圖中所有值的總和。格式字串語法如下：
           <preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>。
    以上所有元素皆為選用元素。以下是每個元素的含義：
    • <preceding_text> - 放在每個值前面的文字。
    • *...* - 以常值星號包裝的選用區塊，可指定數字的格式詳細資料。支援下列值 (皆為選用值)：
      • <number_type> - 代表數值的數字格式。選擇下列其中一種交通方式：
        • f - [預設] 浮點格式。建議您同樣使用 <decimal_places> 值來指定精確度。
        • p - 百分比格式，系統會自動加上 % 符號。注意：使用這種格式時，0.0 至 1.0 之間的資料值會對應至 0 - 100% (例如 0.43 會顯示為 43%)。
        • e：科學記號格式。
        • c<CUR> - 以指定貨幣設定數字格式，並採用適用的貨幣標記。將 <CUR> 換成三個字母的貨幣代碼。範例：cEUR 代表歐元。您可以在 ISO 網站找到代碼清單，但並非所有符號都受到支援。
      • <decimal_places> - 用於指定要顯示的小數位數的整數。這個值會四捨五入 (不會截斷) 至這個長度。預設值為 2。
      • z - 顯示結尾零。預設值為 no。
      • s - 顯示群組分隔符。預設值為 no (否)。
      • x 或 y：顯示 x 或 y 座標的資料 (依指定)。X 資料的意義因圖表類型而異：請測試不同圖表，以判斷其代表的意義。預設值為「y」。
    • <following_text> - 後面接每個值的文字。
<color>
此組合的標記顏色，採 RRGGBB 十六進位格式。
series_index>
要繪製標記的資料序列以零為基準的索引。如果是堆疊長條圖，標記類型為 N (資料點值)，您可以指定「-1」來建立各長條堆疊的加總值標記。請參閱以下範例。
<opt_which_points>
[選用] 要在哪個點繪製標記。預設值為所有標記。請使用下列其中一個值：
  • n.d - 要繪製標記的資料點，其中 n.d 代表序列中從零開始的索引。如果您指定非整數值，則分數表示計算出的中間點。例如，3.5 表示介於點 3 和點 4 點之間的一半。
  • -1：在所有資料點上繪製標記。您也可以將這個參數留空，以便在所有資料點上繪製。
  • -n - 在每個「n」n資料點上繪製一個標記。
  • start:end:n：在範圍中的每個 n 個資料點 (包含 start 到 end 索引值 (含首尾) 上繪製標記。所有參數皆為選用 (可能不會顯示)，因此 3::1 會從第四個元素到最後一個步驟 1，而完全省略這個參數將預設為 first:last:1。所有值可以是浮點數。start 和 end 可以是負數，以從最後一個值回溯計算。如果 start 和 end 都是負數，請務必使用遞增值列出 (例如 -6:-1:1)。如果 n 步驟值小於 1，則會內插指定資料值，以計算其他資料點。預設值為 first:last:1
  • x:y - [不支援 N 類型標記] 在圖表上的特定 x/y 點繪製標記。這個點不一定要在線上。在標記類型之前加上 @ 字元 (@)，即可使用這個選項。將座標指定為浮點值，其中 0:0 是圖表左下角，0.5:0.5 是圖表的中心，1:1 則是圖表右上角。舉例來說，如要在圖表中央新增 15 像素的紅色鑽石，請使用 @d,FF0000,0,0.5:0.5,15。
<size>
標記的大小 (以像素為單位)。如果這是包含第三個資料序列的散佈圖 (用於指定點大小)，這個值會根據資料範圍進行調整。因此，如果資料範圍是 0 到 100，<size> 為 30，100 的資料值寬度為 30 像素，50 的資料值會是 15 像素寬，依此類推。
<opt_z_order>
[選用] 比起其他標記和所有其他圖表元素，用於繪製標記的圖層。這是介於 -1.0 到 1.0 (含) 之間的浮點數，-1.0 是底部，1.0 則是頂端。圖表元素 (折線和長條) 小於 0。如果兩個標記的值相同，系統會按照網址提供的順序繪製這些標記。預設值為 0.0 (位於圖表元素上方)。
<opt_placement>
[選用] 其他刊登位置詳細資料，說明與資料點相關的標記位置。您可以指定水平和/或垂直相對位置以及偏移。刊登位置語法是包含「:」分隔符號的字串，如下所示。所有元素皆為選用元素：<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>。 如果有指定，您可以在 chm 參數字串的 <opt_z_order> 中加入空白 , 值。例如：N,000000,0,1,10,,b 和 N,000000,0,1,10,,lv 和 N,000000,0,1,10,,r::10。
horizontal_and_vertical_justification
標記的錨點。的行為與正當理由相反，因此左側錨點實際上會將標記放在資料點的右側。您可以從下列清單中選擇水平和/或垂直對齊器：
  • 水平配置：l、h 或 r：靠左、置中或靠右錨定/水平放置。預設值為「l」。
  • 直向刊登位置：b、 v、t - 底部、中間或垂直錨定廣告。預設值為「b」。
  • 長條圖相關位置 [僅限長條圖]：以「s」、「c」、「e」表示長條的基準、中央或頂部。如為堆疊圖表，這個值是與每個序列長條區段的相對值，而非整個長條。如果提供的序列索引為 -1 (堆疊總計)，代表與整個長條相比。這可以與直向刊登位置值合併，例如「be」或「vs」。預設值為「e」。
horizontal_offset
此標記的水平偏移，以像素為單位。預設值為 0。
vertical_offset
這個標記的垂直偏移值，以像素為單位。非長條圖預設：15；長條圖預設：2。

說明 範例

以下是長條圖的值標籤範例。

第一張圖表 (N*p0*) 指定了資料值標記，所有值皆以 11 點文字的格式呈現，所有值都會以黑色四捨五入至小數點後零位數。請注意，資料值介於 0.0 和 1.0 之間，這也是使用百分比格式時，上位到小數點後兩位。

第二張圖表 (N*cEUR1*) 顯示所有值，並以 11 點文字的格式呈現與歐元值 (小數點後的數字) 相同的值。

長條圖的每長條上方有百分比標籤
chm=
  N*p0*,000000,0,-1,11
chd=t:
  0.4356,0.3562,0.4834,0.575,0.673,0.6091

每個長條上方都顯示歐元標籤的長條圖


chm=
  N*cEUR1*,000000,0,-1,11

您可以使用 chds 參數調整顯示的數值。您可以針對所有資料格式使用 chds，包括簡易編碼和擴充編碼。這不會影響長條大小或軸標籤，但只會影響資料標記值。

此範例顯示含有 46、39、29、30、43、41 簡單編碼值的圖表。簡易編碼範圍為 0 至 61。chds 參數定義的是自訂標記比例 0 到 1，因此標記值會調整為這個範圍，但長條高度則不受影響 (如果這是文字格式資料，長條也會縮放)。
chd=s:underp
chm=N,000000,0,-1,11
chds=0,1

以下的圖表範例在最短點已加上文字標籤，且在最快點加上旗標標籤。

折線圖中顯示 10 點藍色文字標籤，以及標示 15 pt 紅色文字的折線圖，並以虛線的資料點繪製而成。
chm=
  tMin,0000FF,0,1,10|
  fMax,FF0000,0,3,15
這個範例顯示堆疊圖表，含有個別序列的值和序列總數。如要顯示堆疊的序列值，請務必使用「c」定位選項；如果不行，頂端長條值會重疊每個長條頂端的總值。
chm=
  N,FF0000,-1,,12|
  N,000000,0,,12,,c|
  N,000000,1,,12,,c|
  N,ffffff,2,,12,,c
進一步示範垂直和水平放置方式。這個範例說明長條圖的各種錨點值組合 (使用 s、c 和 e 表示垂直刊登位置)。請注意，右側錨定標記如何向左移動標記，頂端錨定標記則是將標記向下移動，反之亦然。紅點代表每個長條的底部、中心點和頂端。數字是資料值，以每個長條的不同錨點值固定。
chm=
  N,000000,0,0,10,,rs
  N,000000,0,1,10,,ls
  N,000000,0,2,10,,c
  N,000000,0,3,10,,e
  N,000000,0,4,10,,e::15
  N,000000,0,5,10,,e::-12
註解標記會自動調整標籤位置，避免重疊。第一個 chm 值用於填滿線條填滿，下列的值都是註解標記。
chm=B,C5D4B5BB,0,0,0
  AA,666666,0,3,15
  AB,666666,0,5,15
  AC,666666,0,24,15
  AD,666666,0,25,15
  AE,666666,0,26,15
  AF,666666,0,51,15
  AG,666666,0,60,15
  AH,666666,0,73,15
  AI,666666,0,80,15
  AJ,666666,0,99,15
另一個註解標記範例，示範瑞士城市高度。

返回頁首