折線圖

   

本文件說明您可以使用 Chart API 建立的各種折線圖。

目錄

圖表專屬功能

  1. 圖表類型 (cht)
  2. 資料精細程度
  3. 序列顏色 (chco)

標準功能

  1. 複合圖表
  2. 圖表標題 (chtt、chts)
  3. 圖表圖例文字和樣式 (chdl、chdlp、chdls)
  4. 圖表利潤 (chma)
  5. 軸樣式和標籤
    1. 可見軸 (chxt)
    2. 軸範圍 (chxr)
    3. 自訂軸標籤 (chxl)
    4. 軸標籤位置 (chxp)
    5. 軸標籤樣式 (chxs)
    6. 軸線標記 (chxtc)
  6. 背景填滿 (chf)
    1. 恆亮填滿 (chf)
    2. 漸層填滿 (chf)
    3. 條紋填滿 (chf)
  7. 格線 (chg)
  8. 線條樣式 (chls)
  9. 動態標記 (chem)
  10. 換行 (chm)
  11. 形狀標記 (chm)
  12. 文字和資料值標記 (chm)
  13. 範圍標記 (chm=r|R)
  14. K 線標記 (chm=F)
  15. 線條標記 (chm=D)
  16. 資料函式 (chfd)

圖表類型 (cht)

您可以建立各種折線圖，請使用以下語法指定折線圖：

語法

cht=<chart_type>

其中 <chart_type> 是以下其中一種類型：

參數 說明 範例

lc

折線圖，其中資料點會沿著 x 軸平均間隔。系統預設會顯示軸線。如要在軸線上顯示值，您必須指定 chxt。

有黃色線條的圖表
cht=lc
chd=t:40,60,60,45,47,75,70,72

ls

與 lc 圖表類似，但根據預設不會顯示軸線。又稱為走勢圖。

藍色走勢圖
cht=ls
chd=t:27,25,60,31,25,39,25,
31,26,28,80,28,27,31,27,
29,26,35,70,25

lxy

可讓您為每個點指定 x 和 y 座標，而不只是 y 值。

如要指定 lxy 圖表的資料點，必須以 2 的倍數來指定序列。每組第一個序列是該行的 x 座標，第二個系列則是該線條的對應 y 座標。例如：

chd=t:<line_1_x1>,<line_1_x2>,...|<line_1_y1>,<line_1_y2>,...|
      <line_2_x1>,<line_2_x2>,...|<line_2_y1>,<line_2_y2>,...

如果「只要」讓資料點在 x 軸上均等，請為該序列的 x 集提供一個未定義的值。在這個範例中，紅色的「Unicorns」(獨角獸) 線會將資料點沿著 X 軸平均間距。如要進一步瞭解未定義的值，請參閱「資料格式」一文。

在這個範例中，「Ponies」行會指定所有點的確切 x 和 y 值，「獨角獸」行則會在 X 軸上平均分配這些值。

注意：如要建立複合 lxy 圖表，請注意 chd 參數都必須以二的倍數顯示資料。例如：chd=t0: 可隱藏所有線條，chd=t2: 用於繪製一行，chd=t4: 則繪製兩行，依此類推。如果指定 chd=t1:，則不會繪製任何線條。如果指定 chd=t3:，則只會繪製一條線。

 折線圖中有不平均間距的資料點，以及紅色、綠色和虛線的線條
cht=lxy
chd=t:
  10,20,40,80,90,95,99|
  20,30,40,50,60,70,80|
  -1|
  5,10,22,35,85

返回頁首

資料精細程度

折線圖時請小心不要高估資料點所需的資料點。舉例來說，如要顯示過去 10 年來熱門巧克力冰淇淋的熱門程度，匯總每天的搜尋查詢會產生超過 3,600 個值。畫出這種精細程度的圖表並不合理。在寬度為 1024 像素的圖表中，一個資料點約佔像素的 25 度。(此外，這會導致傳入網址的資料過大)。以下範例說明瞭這一點。

200 像素寬圖，包含 40 個資料點 (每個資料點 5 個像素)：

黃色線形圖：各資料點在 X 軸上的分散程度較低，因此更容易閱讀

80 個資料點 (每個資料點僅限 2.5 像素)：

黃色線形圖：資料點在 X 軸上大幅堆疊，因此難以辨識

150 個資料點 (每個資料點僅限 1.3 像素)：

黃色折線圖：資料點在 X 軸上難以辨識，因此難以辨識

300 個資料點 (每個資料點不到 1 個像素)：

黃色折線圖：資料點在 X 軸上難以辨識，因此難以辨識

返回頁首

序列顏色 chco

您可以使用 chco 參數指定特定係列或所有系列的顏色。

語法

chco=
<color_1>, ... <color_n>
<color>
RRGGBB 格式的十六進位數字。指定單一值即可將相同的顏色套用至所有序列。新增顏色值 (以半形逗號分隔)，即可為不同的序列指定不同的顏色。如果顏色少於系列數量，未指定係列則會從頭開始循環顯示指定顏色。

 

例子

說明 範例

您為每個系列叢書指定單一顏色時，系統會為各個系列叢書指派顏色。這個範例指定了三個資料序列和三種顏色。

折線圖，一條紅色、一個藍色和一條綠色線條

chco=FF0000,00FF00,0000FF

這個範例也包含三個資料序列，但僅指定兩種顏色。由於未指定第三個序列的顏色，因此會使用第一個顏色 (紅色) 繪製第三條線。

折線圖中有兩條紅線和一條藍線

chco=FF0000,0000FF

返回頁首

複合圖表

您可以在折線圖中加入線條、K 線圖和形狀標記，製作複合圖表。詳情請參閱複合圖表。

標準功能

本頁其餘功能是標準圖表功能。

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

返回頁首

圖表圖例文字和樣式 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

返回頁首

圖表利潤 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

返回頁首

軸樣式和標籤 [Line, Bar, Google-o-meter, Radar, Scatter]

您可以指定要在圖表上顯示哪些軸，也可以為其自訂標籤、位置、範圍和樣式。

並非所有圖表預設顯示軸線。你可以使用 chxt 參數，精確指定圖表應顯示哪些軸。預設軸線不會顯示數字；您必須在 chxt 參數中指定軸才能顯示數字。

您可以選擇讓軸顯示代表資料值的數字，也可以指定自訂軸。預設值為顯示數值，且值會縮放為 0 至 100 之間的數值。不過，您可以使用 chxr 變更該範圍以顯示任何範圍，也可以使用 chxs 設定值的樣式 (例如顯示貨幣符號或小數位數)。

如果您選擇使用自訂值 (例如「Mon, Tues, Wed」)，也可以使用 chxl 參數。如要將這些標籤沿著軸線的特定位置放置，請使用 chxp 參數。

最後，您可以使用 chxs 和 chxtc 參數，指定自訂和數值軸標籤的顏色、大小、對齊方式和其他屬性。

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

本節涵蓋下列主題：

可見軸 chxt

根據預設，長條圖、折線圖、雷達圖和散佈圖會顯示一或兩條軸線，但這幾行不包含值。如要在軸線上顯示值或變更顯示的軸，您必須使用 chxt 參數。根據預設，除非您使用 chxr 屬性明確縮放軸值，否則軸值的範圍為 0 到 100。如要隱藏折線圖中的所有軸線，請在 cht 參數中的圖表類型值後方指定 :nda (例如：cht=lc:nda)。

根據預設，頂端和底部軸不會依數值顯示勾號，左右軸則會顯示勾號。您可以使用 chxs 參數變更這項行為。

語法

chxt=
  <axis_1>
    ,...,
  <axis_n>
<axis>
要在圖表中顯示的軸。可用的軸如下：
  • x - 底部 X 軸
  • t - 頂端 X 軸 [Google-o-Meter 不支援]
  • y - 左 Y 軸
  • r - 右側 Y 軸 [Google-o-Meter 不支援]

您可以指定多個相同類型的軸，例如：cht=x,x,y。這會沿著圖表底部堆疊兩組 X 軸。如想沿著顯示數值的軸新增自訂標籤，這種做法就非常實用 (請參閱下例)。軸是從內部繪製而來，因此如果您有 x,x，第一個 x 代表最內層的副本，下一個 x 是指下一個向外副本，依此類推。

 

例子

說明 範例

這個範例顯示含有 X 軸、Y 軸、上軸 (t) 和右軸 (r) 的折線圖。

未指定任何標籤，因此圖表會預設為所有軸的 0 到 100 範圍。

請注意，根據預設，頂端和底部軸不會在標籤顯示勾號。

折線圖加上了標籤：左右兩側加上 0、25、40、60、80 和 100 個標籤，以及標籤：0、25、50、75 和 100，上下
chxt=x,y,r,t
您可以重複加入相同的值，為每個軸加入多組標籤。這個範例顯示兩組 x 和兩組 y 軸。這在僅使用預設軸標籤時並不實用，如此處所示。不過，您可以使用 chxl 參數，為每個軸的每個副本指定自訂標籤。

<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chco=76A4FB&chls=2.0&chs=7"=20&hl=zh-Hant" />

<img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chco=76A4FB&chls=2.0&chs=1"?hl=zh-Hant&hl=zh-Hant&hl=zh-Hant&hl=zh-TW|02030%30%27%

這個範例顯示包含 X 軸、Y 軸、上 T 軸和右側 r 軸的水平長條圖。

系統會省略軸標籤，因此 Chart API 會在 X 軸和 T 軸顯示 0 到 100 的範圍。

Y 軸和 r 軸的範圍取決於長條數量。在本範例中，共有五個長條，因此圖表 API 會顯示 0 到 4 的範圍。第一個標籤會置於第一個長條的中心，第二個標籤則位於第二個長條的底部，以此類推。

折線圖加上了標籤：左右兩側加上 0、25、40、60、80 和 100 個標籤，以及標籤：0、25、50、75 和 100，上下
chxt=x,y,r,t
只要在圖表類型後方指定 :nda，即可隱藏折線圖中的預設軸。 含有隱藏軸的折線圖
cht=lc:nda

返回頁首

軸範圍 chxr

您可以使用 chxr 參數，指定每個軸分別顯示的值範圍。請注意，這項操作「不會」 變更圖表元素的縮放，只會變更軸標籤的縮放。如要讓軸數字描述實際資料值，請分別將 <start_val> 和 <end_val> 分別設為資料格式範圍中下限和上限的值。詳情請參閱 Axis 資源調度相關說明。

如要指定軸範圍，請使用 chxt 參數顯示軸。

如要指定自訂軸值，請使用 chxl 參數。

語法

請使用直立線字元 ( |) 分隔多個軸標籤範圍。

chxr=
  <axis_index>,<start_val>,<end_val>,<opt_step>
    |...|
  <axis_index>,<start_val>,<end_val>,<opt_step>
<axis_index>
要套用標籤的軸。這是從 chxt 指定的軸陣列內，從零開始的索引。舉例來說，R 軸在 chxt=x,r,y 中的是 1。
<start_val>
數字，定義這個軸的最小值。
<end_val>
數字，定義這個軸的最大值。
<opt_step>
[選用] 軸上刻點之間的計數步數。此步驟沒有預設的步驟值，系統會嘗試顯示一組適當的間距。

 

例子

說明 範例

這個範例顯示左右 Y 軸 (y 和 r) 和 1 軸 (x)。

每個軸都有定義的範圍。由於未指定任何標籤或位置，因此值會從指定範圍內取得，且會在該範圍內平均間距。在折線圖表中，各個值會沿著 X 軸平均分配。

r 軸 (索引 2) 的軸方向會反轉 (索引 2)，因為第一個值 (1000) 大於最後一個值 (0)。


chxt=x,y,r
chxr=
  0,0,500|
  1,0,200|
  2,1000,0

在本例中，X 軸指定的值。

軸標籤會沿著軸平均間隔。<opt_step> 參數的值為五 (5)。

長條圖，X 軸為 200、300 和 400 chxt=x
chxr=0,10,50,5

返回頁首

自訂軸標籤chxl

您可以使用 chxl 參數，在任何軸上指定自訂字串軸標籤。您可以視需要指定多個標籤，數量不限。如果您顯示軸 (使用 chxt 參數)，且未指定自訂標籤，系統會套用標準的數值標籤。如要指定自訂數字範圍，請改用 chxr 參數。

如要設定標籤在軸上的特定位置，請使用 chxp 參數。

語法

為每個要加上標籤的軸指定一組參數。請使用直立線字元 (|) 分隔多組標籤。

chxl=
  <axis_index>:|<label_1>|...|<label_n>
    |...|
  <axis_index>:|<label_1>|...|<label_n>
<axis_index>
要套用標籤的軸。這是 chxt 參數陣列的索引。舉例來說，如果您有 chxt=x,x,y,y，那麼索引 0 會是第一個 x 軸，1 是第二個 X 軸。
<label_1>| ... |<label_n>
要沿著這個軸放置的一或多個標籤。這些可以是字串或數字值；字串不一定要在引號中。label_1 會顯示在軸上的最低位置，而 label_n 會以最高位置顯示。其他標籤會在每個標籤之間平均間距。以 + 符號表示空格。您無法在標籤中指定換行符號。請使用直立線字元分隔標籤。注意： 請勿在 chxl 參數的最後一個標籤後方放置直立線。

 

例子

說明 範例

這張圖表顯示如何在兩個軸上新增自訂標籤。請注意這些值的間距方式，以及最後一個 chxl 值不以直線結尾的結尾。

 折線圖左側是 0 和 100、右側是 A、B 和 C、X 軸是 1 月、7 月、1 月、7 月和 1 月，下方則是 2005、2006 和 2007
chxt=x,y
chxl=
0:|Jan|Feb|March|April|May|
1:|Min|Mid|Max

這個範例包含左右 Y 軸 (y 和 r) 的軸標籤，同時也包含 X 軸 (x) 的兩組值。您可以使用 chxs 在 Y 軸上加上刻點標記。

折線圖左側是 0 和 100、右側是 A、B 和 C、X 軸是 1 月、7 月、1 月、7 月和 1 月，下方則是 2005、2006 和 2007
chxt=x,y,r,x
chxl=
0:|Jan|July|Jan|July|Jan|
1:|0|50|100|
2:|A|B|C|
3:|2005|2006|2007

這個範例包含左右 Y 軸的軸標籤 (y 和 r)，還有 X 軸 (x) 的兩組值。請注意，較低 x 軸組合的空白標籤，用來在值之間進行間隔。

這個範例使用左側 Y 軸上的軸標籤預設值。

長條圖左側為 0 和 100，右側是 A、B 和 C，X 軸是 1 月、7 月、1 月、7 月和 Jan，下方則是 2005、2006 和 2007
chxt=x,y,r,x
chxl=
0:|Jan|July|Jan|July|Jan|
2:|A|B|C|
3:|2005||2006||2007

如果您想加入一般標籤來描述整個軸 (例如為某軸「費用」和「學生」加上標籤)，請使用 chxt 屬性在兩邊新增額外的軸，然後使用 chxl 兩邊新增一個自訂標籤，並使用 chxp 在軸中間放置一個自訂標籤。
chxt=x,x,y,y
chxl=1:|Martinis|3:|Score
chxp=1,50|3,50

返回頁首

軸標籤位置 chxp

您可以使用 chxl 指定的預設標籤或自訂標籤，指定要顯示的軸標籤。如果不使用這個參數指定確切位置，標籤會沿著軸平均間隔且採用預設步驟值。如未指定 chxl，勾號標籤就會為預設值 (通常是資料值或長條圖中的長條)。

語法

請使用直立線字元 (|) 分隔多個位置集。

chxp=
  <axis_1_index>,<label_1_position>,...,<label_n_position>
    |...|
  <axis_m_index>,<label_1_position>,...,<label_n_position>
<axis_index>
您要指定位置的軸。這是 chxt 參數陣列的索引。舉例來說，如果您有 chxt=x,x,y,y，則索引 0 是第一個 x 軸，1 是第二個 x 軸，以此類推。
<label_1_position>,...,<label_n_position>
標籤沿著軸的位置。這是以半形逗號分隔的數值清單，其中每個值會設定 chxl 陣列中對應標籤的位置：第一個項目會套用至第一個標籤，依此類推。位置是該軸的範圍中的值。請注意，除非您已使用 chxr 指定自訂範圍，否則這個值一律為 0 至 100。依據為該軸的標籤數量，您必須以標籤數量為準。

 

例子

說明 範例

這個範例包含圖表上特定位置的 r 軸標籤。標籤文字是使用 chxl 參數指定。

指定位置為 0 的標籤會放在 Y 軸或 r 軸的底部，或是 X 軸或 t 軸左側。

指定位置為 100 的標籤會放在 Y 軸或 r 軸的頂端，或是 X 軸或 t 軸右側。

Line chart with min, average, and max on the right, 20, 40, 60, 80, and 100 on the left, and 0, 25, 50, 75, and 100 along the x-axis
chxt=x,y,r
chxl=2:|min|average|max
chxp=2,10,35,75

這個範例說明顯示預設標籤值，但只會在指定位置顯示。

chxp=1,10,35,75 - Y 軸應該只顯示三個標籤：10、35 和 75。未指定自訂標籤文字，因此會顯示這些軸值。請注意，使用 chxp 時，標籤不必平均間隔。如果沒有在此指定 chxp，y 軸的預設標籤值距離將是每 20 個單位，如第二個圖表所示。

 Line chart with 10, 35, and 75 on the left, and 0, 25, 50, 75, and 100 along the x-axis
chxt=x,y
chxp=1,10,35,75
顯示預設軸位置的折線圖。
chxt=x,y
未指定 chxp

返回頁首

軸標籤樣式chxs

您可以為軸標籤 (自訂標籤和預設標籤值) 指定字型大小、顏色和對齊方式。同一軸上的所有標籤格式皆相同。如果軸有多個副本，您可以用不同格式分別設定副本。您也可以指定標籤字串的格式，例如顯示貨幣符號或結尾的零。

根據預設，頂端和底部軸不會依值顯示勾號，左側和右側軸則顯示勾號。

語法

多個軸的值應以直立線字元 (|) 分隔。

chxs=
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
   |...|
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
<axis_indexaxis_index>
要套用此項目的軸。這是匯入 chxt 參數，從零開始的索引。
<opt_format_string>
[選用] 這是選用格式字串，如果使用的話，該字串緊接在軸索引編號後面，且中間沒有半形逗號。開頭會以常值字母 N 開頭，後面接有下列值 (選用)： 格式化字串語法如下：
       N<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>：每個值接續的常值文字。
<opt_label_color>
要套用至軸文字 (而非軸線) 的顏色，以 RRGGBB 十六進位格式。使用 opt_axis_color 可個別指定軸線顏色。預設值為灰色。
<opt_font_size>
[選用] 可指定字型大小 (以像素為單位)。這是選用參數。
<opt_alignment>
[選用] 標籤對齊設定。針對頂端或底部軸，這項資訊說明瞭標籤與上方或下方的刻點標記對齊的方式。如果是左側或右側軸，則說明在定界框內對齊時 (輕觸軸) 的方式。指定下列其中一個數字：
  • -1 - 頂端或底部：標籤在刻點的右側；向左或向右：標籤在所屬區域靠左對齊。R 軸標籤的預設值。
  • 0 - 頂端或底部：標籤位於刻點中央；向左或向右：標籤在其區域置中。X 軸和 T 軸標籤的預設設定。
  • 1 - 頂端或底部：標籤在刻點的左側；向左或向右：標籤在所屬區域靠右對齊。Y 軸標籤的預設值。
<opt_axis_or_tick>
[選用；Google-o-meter 不支援] 是否顯示這個軸的刻點標記和/或軸線。虛線標記和軸線僅適用於最內側的軸 (例如，兩個 X 軸的外側不支援)。請使用下列其中一個值：
  • l (小寫「L」) - 僅繪製軸線。
  • t - 只畫出勾號。勾號是指軸標籤旁的小線條。
  • lt：[預設] 繪製所有標籤的軸線和刻點標記。
  • _ - (底線) 不繪製軸線和刻點符號。如要隱藏軸線，請使用這個值。
<tick_color>
[optional; not 支援 in Google-o-meter] 刻點標記顏色，使用 RRGGBB 十六進位格式。預設值為灰色。
<opt_axis_color>
[選用] 這個軸線的顏色，使用 RRGGBB 十六進位格式。預設值為灰色。

 

例子

說明 範例

第二個 X 軸 (1 月、2 月、3 月) 已指定字型大小和顏色。

折線圖左側是最小值、平均值和最大值、右側的 0、1、2、3 和 4，X 軸代表 0 至 100，下方則是 1 月、2 月和 3 月，以藍色標示

chxt=x,y,r,x
chxr=2,0,4
chxl=3:|Jan|Feb|Mar|
     1:|min|average|max
chxp=1,10,35,75
chxs=3,0000DD,13,0,t

字型大小、顏色和對齊方式是在右側 Y 軸上。繪製是沒有軸線的勾號。

折線圖以 0 到 100 軸表示，X 軸依序為 0 到 100、1 軸、2 月份、3 分、Y 軸和 0 至 4 符號，Y 軸表示最小值、平均值和最大值的紅色刻點。

chxt=x,y,r,x
chxl=3:|Jan|Feb|Mar|
     2:|min|average|max
chxp=2,10,35,95
chxs=2,0000DD,13,-1,t,FF0000

這張圖表包含三個資料集，並顯示三組軸標籤 (每個序列一個)。每一組標籤都會使用自訂格式設定字串格式化，如下所示：

  • 0N*e,000000|
    • 0 代表第一個資料序列
    • N 表示格式化字串
    • * 表示格式指定碼的開頭
    • e 表示科學記號
    • * 表示格式指定碼的結尾
    • 000000 表示黑色文字。
  • 1N*cUSD*Mil,FF0000|
    • 1 表示第二個系列
    • N 表示格式化字串
    • * 表示格式指定碼的開頭
    • c 表示貨幣標記
    • USD 會將美元指定為要使用的貨幣標記
    • * 表示格式指定碼的結尾
    • Mil 是後面的字串
    • FF0000 表示紅色文字。
  • 2N*sz2*,0000FF
    • 2 代表第三系列
    • N 表示格式設定字串
    • * 表示格式指定碼的開頭
    • s 表示顯示分組指定碼 (在美式英文語言代碼中，每三個零為一個半形逗號)
    • z2 表示結尾是兩個零
    • 0000FF 表示藍色文字。

軸標籤範圍是使用 chxr 參數 (axis_index、start、end、step) 來設定。如未設定，預設值為 0 至 100。
chd=s:
  984sttvuvkQIBLKNCAIi,
  DEJPgq0uov17zwopQODS,
  AFLPTXaflptx159gsDrn
chxr=
  0,0,1000000,250000|
  1,0,60|
  2,0,5000
chxs=
  0N*e,000000|
  1N*cUSD*Mil,FF0000|
  2N*sz2*,0000FF

返回頁首

軸線標記樣式chxtc

您可以為特定軸指定長刻度記號。通常用於延長圖表長度的勾號。使用 chxs 參數即可變更勾號顏色。

多個軸的值應以直立線字元 (|) 分隔。系列中的值應以半形逗號分隔。

語法

chxtc=
  <axis_index_1>,<tick_length_1>,...,<tick_length_n>
    |...|
  <axis_index_m>,<tick_length_1>,...,<tick_length_n>
<axis_indexaxis_index>
要套用此項目的軸。這是匯入 chxt 參數，從零開始的索引。使用長條符號分隔不同軸的值。
<tick_length_1>,...,<tick_length_n>
該軸上的刻度標記長度，以像素為單位。如果指定單一值，這個值就會套用至所有值；如果指定了多個值，軸刻點標記會在該軸的值清單上循環播放。正值會在圖表區域外繪製，並由圖表邊框裁剪。正值的最大值為 25。負值會繪製在圖表區域內，並由圖表區域邊框裁剪。

 

例子

說明 範例

使用 chxtc 建立長紅色勾號的範例。此處的勾號標記長度超過圖表區域寬度，但經過裁剪以符合圖表大小。

  • chxt=x,y,r,x - 顯示左軸、右軸和底部軸。
  • chxl=2:|min|average|max|3:|Jan|Feb|Mar - 指派給「r」(右側) 和外部 X 軸的標籤文字。
  • chxp=2,10,35,95 - 三個標籤的自訂標籤位置，沿著 r 軸 (index=2) 的位置。
  • chxs=2,0000dd,13,-1,t,FF0000 - r 軸的標籤樣式：文字顏色、文字大小、靠左對齊及紅色勾號。
  • chxtc=1,10|2,-180 - y 和 r 軸的軸尺長度。第一個值指定軸外的 10 個像素長刻點。第二個值在軸上指定 180 像素的長刻度；負數表示刻點位於軸內，而刻點則經裁剪，以符合圖表內的大小。

折線圖以 0 到 100 軸呈現，X 軸依序為 0 到 100、1 軸、2 月份、3 分、Y 軸和 0 至 4 符號，Y 軸代表最小、平均和最大紅色刻度。

chxt=x,y,r,x
chxl=
  2:|min|average|max|
  3:|Jan|Feb|Mar
chxp=2,10,35,95
chxs=
  2,0000dd,13,-1,t,FF0000
chxtc=1,10|2,-180
這張圖表顯示的是交替刻度長度。chxtc 會指定 Y 軸 (5 和 15) 的兩個刻點長度值，而圖表上繪製的刻度在兩個值之間會交替使用。
chxt=x,y
chxtc=
  1,5,15

返回頁首

背景填滿 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

返回頁首

漸層填滿chf [Line、Bar、Google-o-meter、Radar、Scatter、Venn]

您可以將一或多個漸層填滿效果套用至圖表區域或背景。漸層填滿效果會從一種顏色淡出。(圓餅圖、Google-公制圖表：僅限背景)。

每個漸層填滿會分別指定角度，以及錨定至指定位置的兩種以上顏色。不同錨點之間移動時，顏色各有不同。必須有至少兩種具有不同 <color_centerpoint> 值的顏色，才能淡入另一個顏色。每個其他漸層都由 <color>,<color_centerpoint> 配對指定。

語法

chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1>
    ,...,
  <color_n>,<color_centerpoint_n>
<填入類型fill_type>
要填滿的圖表區域。下列其中一欄：
  • bg - 背景填滿
  • c - 圖表區域填滿。
  • b<index> - 長條漸層填滿 (僅限長條圖)。將 <index> 換成長條的序列索引，以填入漸層。如需範例，請參閱長條圖圖表系列顏色。
lg
指定漸層填滿。
<角度>
這個數字可指定從 0 (水平) 到 90 (垂直) 的漸層角度。
<color>
填滿顏色，以 RRGGBB 十六進位格式。
<color_centerpoint>
指定顏色的錨點。接近另一個錨點時，顏色就會從這個點開始淡出。這個值的範圍介於 0.0 (底部或左側) 到 1.0 (頂端或右側邊緣)，並傾斜至 <angle> 指定的角度。

 

例子

說明 範例

圖表區域具有水平線性漸層，並以零度 (0) 的角度指定。

顏色為桃紅色 (FFE7C6)，置中於左側 (位置 0.0)，藍色 (76A4FB)，右側則是置中 (位置：1.0)。

圖表背景會以灰色 (EFEFEF) 繪製。

深灰色折線圖有灰色背景和圖表區域，由左至右分別為白色及藍色線性漸層

chf=
  c,lg,0,
  FFE7C6,0,(桃紅色)
  76A4FB,1 (藍色)

圖表區域採用對角線 (從左下到右下方) 線性漸層，指定的角度為四十五度 (45)。

桃紅色 (FFE7C6) 是第一個指定的顏色。圖表左下方是「純桃色」。

藍色 (6A4FB) 是指定的第二個顏色。圖表右上方純藍色。請注意，我們如何指定 0.75 的偏移值，以提供向右上角逐漸消失的藍色尖峰。

圖表背景會以灰色 (EFEFEF) 繪製。

深灰色折線圖有灰色背景和圖表區域，從左下到右、白色到藍色的對角線漸層

chf=
  c,lg,45,
  FFE7C6,0, (桃紅色)
  76A4FB,0.75 (藍色)

圖表區域具有垂直 (由上至下) 線性漸層，其角度為九十度 (90)。

藍色 (76A4FB) 是指定的第一個顏色。圖表頂端純藍色。

桃紅色 (FFE7C6) 是指定的第二個顏色。圖表底部是純桃色。

圖表背景會以灰色 (EFEFEF) 繪製。

深灰色折線圖有灰色背景和圖表區域，由下往上到藍色垂直的垂直漸層

chf=
  c,lg,90,
  FFE7C6,0, (桃紅色)
  76A4FB,0.5 (藍色)

返回頁首

 

條紋填滿chf [Line, Bar, Google-o-meter, Radar, Scatter, Venn]

您可以為圖表區域或整個圖表指定條紋背景填滿效果。(圓餅圖、Google-公制圖表：僅限背景。)

語法

chf=
  <fill_type>,ls,<angle>,<color_1>,<width_1>
    ,...,
  <color_n>,<width_n>
<填入類型fill_type>
要填滿的圖表區域。下列其中一欄：
  • bg - 背景填滿
  • c - 圖表區域填滿
  • b<index> - 條紋填滿 (僅限長條圖)。將 <index> 取代為要以條紋填滿的長條的序列索引。如需範例，請參閱長條圖系列顏色。
ls
指定線性條紋填滿效果。
<角度>
所有條紋的角度 (相對於 Y 軸)。使用 0 做為垂直條紋，使用 90 做為水平條紋。
<color>
此條紋的顏色，採用 RRGGBB 十六進位格式。針對每個其他條紋重複執行 <color> 與 <width>。至少須有兩條條紋。除非填滿圖表，否則會進行替換。
<width>
此條紋的寬度，從 0 到 1，其中 1 是圖表的完整寬度。系統會重複新增線條，直到圖表填滿為止。針對每個其他條紋重複執行 <color> 與 <width>。至少須有兩條條紋。除非填滿圖表，否則會進行替換。

 

例子

說明 範例
  • bg,ls,0 - 背景條紋填滿 y 軸 (與 Y 軸平行的零度角) 的條紋。線條會填滿圖表背景和繪圖區域。
  • CCCCCC,0.15 - 第一個條紋呈現深灰色，寬度為圖表寬度 15%。
  • FFFFFF,0.1 - 第二條條紋是白色，寬度為 10%，與圖表寬度相同。
 藍色折線圖，從左到右交錯呈灰色和白色條紋
chf=
  bg,ls,0,
  CCCCCC,0.15,
  FFFFFF,0.1
  • c,ls,90 - 圖表區域，Y 軸上有水平條紋，角度為九十度。線條會填滿圖表區域，但圖表背景省略。
  • 999999,0.25 - 第一條紋是深灰色，寬度為圖表寬度 25%。
  • CCCCCC,0.25 - 與第一條紋相同，但淺灰色。
  • FFFFFF,0.25 - 與第一條紋相同，但白色。
 由下到上、深灰色、淺灰色、白色和深灰色條紋的藍線圖
chf=
  c,ls,90,
  999999,0.25,
  CCCCCC,0.25,
  FFFFFF,0.25

返回頁首

格線chg [Line、Bar、Radar、Scatter]

您可以使用 chg 參數指定圖表上的實線或虛線格線。

但你無法指定線條的粗細或顏色。想瞭解更多在圖表上繪製線條的方法，請參閱形狀標記 (chm 類型 h、H、v 或 V)、範圍標記 (chm) 和軸刻點標記 (chxtc)。

語法

chg=
  <x_axis_step_size>,<y_axis_step_size>,<opt_dash_length>,<opt_space_length>,<opt_x_offset>,<opt_y_offset>
<x_axis_step_size>、<y_axis_step_size>
用於計算圖表要顯示多少 x 或 Y 格線線。100 / step_size = 圖表中的格線數。因此，20,25 代表 5 個垂直格線和 4 條水平格線。
<opt_dash_length>、 <opt_space_length>
[選用] 用於定義虛線格線。第一個參數是每一行虛線的長度 (以像素為單位)。 第二個參數是虛線之間的間距 (以像素為單位)。將 <opt_space_length> 指定為 0，表示實線。預設值為 4,1。
<opt_x_offset>,<opt_y_offset>
[選用] 依圖表比例縮放的單位數量，分別用來偏移 x 和 y 格線線。可以是正值或負值。如果您要指定這個值，也必須一併指定所有先前的值。預設值為 0,0。

 

例子

說明 範例

這些範例只會使用 <x_axis_step_size> 和 <y_axis_step_size> 參數。根據預設，Chart API 會顯示虛線格線。

 折線圖中有 5 個垂直和兩條水平淡灰色虛線格線
chg=20,50
折線圖中有 5 個垂直和兩條水平淡灰色虛線格線
chg=20,50

此範例使用較大的空格來顯示較淺的格線 (1,5)。

 折線圖中有 5 種垂直和兩條水平色調，淺灰色與虛線格線
chg=20,50,1,5

如要顯示實線格線，請將 <opt_space_length> 參數指定為零 (0)。

此外，這張圖表的 X 軸偏移值是 10。

 折線圖中有 5 個垂直和兩條水平淡灰色，實心格線
chg=20,50,1,0,10

此圖表顯示 X 軸偏移值 10，y 軸偏移為 20。

 折線圖中有 5 個垂直和兩條水平淡灰色，實心格線
chg=20,50,3,3,10,20

返回頁首

線條樣式 chls [線條、雷達]

可以使用 chls 參數指定線條粗細和實線/虛線樣式。這個參數只能用於設定折線圖或雷達圖中的線條樣式，而只有在複合圖表的基礎類型為折線圖時，才能使用這個參數設定線條樣式。

語法

以直立線字元 ( |) 分隔多個行樣式；第一個樣式適用於第一行，第二個樣式則適用於下一行，依此類推。如果您擁有的樣式少於行數，系統會將預設樣式套用至所有未指定的行。

chls=
  <line_1_thickness>,<opt_dash_length>,<opt_space_length>
    |...|
  <line_n_thickness>,<opt_dash_length>,<opt_space_length>
<line_1_thickness>
線條的粗細，以像素為單位。
<opt_dash_length>、 <opt_space_length>
[選用] 用於定義虛線格線。第一個參數是每一行虛線的長度 (以像素為單位)。 第二個參數是虛線之間的間距 (以像素為單位)。如果是實線，則未指定任何值。如果只指定 <opt_dash_length>，<opt_space_length> 就會設為 <opt_dash_length>。預設值為 1,0 (實線)。

 

例子

說明 範例

這裡的虛線是由 3,6,3 指定，較粗的實線則由 5 指定。

 折線圖，一條實線和一條虛線
chls=3,6,3|5

返回頁首

動態圖示標記 chem [Bar、Line、Radar、Scatter]

建立圖表，並將一或多個動態圖示指定為化學值。chem 的語法如下。紫色以半形分號分隔的所有項目皆為選用，在網址中即可完全省略這些項目。如要加入多個標記，可以加入多個以 | 字元分隔的語法字串。如要進一步瞭解動態圖示，請參閱動態圖示頁面。

您也可以將圖表嵌入其他圖表，做為動態圖示。請參閱下方的「內嵌圖表」子章節。

chem=
  y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
   |...|
  y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
s=<icon_string_constant>
動態圖示的字串標記常數，來自動態圖示頁面。此常數與獨立圖示的 chst 參數「幾乎」相同。但若獨立圖示字串的開頭是「d_」，您應該移除這個前置字串，才能取得對等的動態圖示標記。範例：獨立圖示：d_bubble_icon_text_small；對等的動態圖示標記：bubble_icon_text_small。
d=<marker_data_stringmarker_data_string>
這個特定標記類型需要的資料。這會保留用於在 chld 參數中用於對等獨立圖示的字串，不過 ，所有 | 分隔符號都應以半形逗號取代 (請記得使用半形逗號取代多行文字的直立線標記！)。請注意，在資料字串中，您也必須使用 @ 符號逸出下列字元：直立線 ( | )、 at ( @ )、等於 ( = )、半形逗號 ( , )、分號 ( ; )。 範例：hello@,+world、5@@10+cents+each。
ds=<which_series>
[選用] 這個標記所屬的資料序列索引，從零開始。預設值為 0。
dp=<which_points>
[選用] 指定用來繪製標記的資料點。預設值為 0 (系列的第一個點)。請使用下列其中一種格式：
  • n.d - 要繪製標記的資料點，其中「n.d」n.d是序列中從零開始的索引。如果指定非整數值，分數則會指出計算的中繼點。例如，3.5 代表點 3 到點 4 之間的中段。
  • range,<start>,<end>,<step> - 在從 start 到 end (含) 之間的每個 step 資料點上繪製標記。起始和結束是索引值，可以是浮點數，用來表示中繼值。所有值皆為選用值，預設值為：start=0、end=last item、step=1。如果略過值，仍須加入任何中繼逗號，但不必加入空白的結尾半形逗號。例如：dp=range,0,4 會在元素 0 到 4 上繪製標記；dp=range,5,10,2 會在元素 5、7 和 9 上繪製標記；dp=range,2 會在第三個點和較晚的點上繪製點；dp=range,3,,1.5 會在從四個項目到最後一個項目之間的每 1.5 個資料點上繪製標記。
  • all - 為每個元素繪製標記。這相當於 range,0,end_index。範例：dp=all
  • every,n - 在每個第 n 個標記上繪製標記。範例：dp=every,2 會在項目 0、2 和 4 上繪製標記。
py=<z_order>
[選用] 繪製標記的圖層，與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數，-1.0 為底部，而 1.0 為頂端。圖表元素 (折線圖和長條) 正低於零。如果兩個標記的值相同，則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。
po=<x,y>
[選用] 圖表上繪製標記時的絕對位置。x 和 y 是兩個浮點數，其中 0.0,0.0 是左下角，1.0,1.0 代表右上角。
=<x_offset,y_offset>
[選用] 代表圖示與正常位置偏移的像素數量。x_offset 和 y_offset 為正整數或負整數。請務必在嵌入的動態圖示中指定這個值，因為標記會沿著該點的垂直和水平置中，也就是說，該點可能不會與資料標記對齊。直立圖釘的理想位移為 of=0,22；傾斜圖釘的良好位移是 of=-12,20 或 of=12,20，視斜面方向而定，但您可能必須進行實驗。預設值為 0,0。

 

例子

說明 範例
在以下示例中，同樣的動態圖示是以獨立圖片的形式建立，並當做折線圖中的標記使用。

圖表 1：https://chart.googleapis.com/chart?chs=300x140&cht=lc&chco=FF9900,224499&
chd=t:75,74,66,30,10,5,3,1&chls=1|1&
chem=y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0&chm=v,ccccFF,0,::.2,2

圖表 2：https://chart.googleapis.com/chart?chst=d_bubble_icon_text_small&chld=ski|bb|Wheeee!|FFFFFF|000000

含有動態圖示標記的折線圖。
chem=
  y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0

動態圖示標記與獨立圖片相同。


chst=
  d_bubble_icon_text_small
chld=
  ski|bb|Wheeee!|FFFFFF|000000

請注意，動態圖示標記的水平和垂直置中。因此，如果您使用含有尾數的動態圖示，尾部並不會位於圖表點上，因此標記中心為。第一張圖表將標記置於資料點 3 的中心，該資料點實際上將尾部稍微放在線條上的標記右側。

第二個圖表使用 of 值，將標記的尾部移至所需資料點上方。傾斜圖釘的良好位移為 -12,20。
chem=y;
  s=map_xpin_letter;
  d=pin_sleft,A,FF0000;
  dp=3;
  ds=1

chem=y;
  s=map_xpin_letter;
  d=pin_sleft,A,FF0000;
  dp=3;
  ds=1;
  of=-12,0

如要加入多個動態圖示，請重複使用 | 字元分隔的語法字串。

這個範例顯示一個範圍以及兩個個別標記。

請注意垂直圖釘與 0,22 之間的位移，傾斜圖釘的偏移值則為 12,20，讓圖釘與所描述的序列對齊。
chem=
  y;s=map_xpin_letter;d=pin_sright,A,FF0000;dp=4;ds=0;py=1;of=12,20|
  y;s=map_pin_icon;d=baby,FF5555;ds=1;dp=6;of=0,22|
  y;s=map_pin_icon;d=camping,DEF763;ds=2;dp=range,2,5
這說明瞭多行文字標記。新增文字後，標記必須偏移，因為對話框會依照文字調整大小，進而在圖表上重新置中。請注意，在 d 資料字串中，文字中的換行符號會以半形逗號表示。
chem=y;
  s=bubble_texts_big;
  d=bbbr,FFC6A5,000000,Outlier,Forgot+to+feed;
  ds=0;
  dp=13;
  of=-120,2

內嵌圖表

您可以使用動態圖示語法，將圖表嵌入其他圖表。

嵌入圖表標記有兩種樣式：嵌入泡泡中的圖表，以及不含泡泡的嵌入式圖表。以下是這兩種網址的範例：

無泡泡圖
含有泡泡的圖表
不含泡泡的圖表

以下是 s=<icon_string_constant>;d=<marker_data_string> 參數的具體細節，適用於非對話框和泡泡內嵌圖表 (以上說明的參數不會再次說明)：

語法

Non-bubble:
  chem=y;s=ec;d=<alignment_string>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>

Bubble:
  chem=y;s=ecb;d=<frame_type>,<padding>,<frame_color>,<fill_color>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>
alignment_string
[僅限非對話框] 無泡泡嵌入圖表的哪個部分會固定在資料點。請選擇下圖中的其中一個雙字母字串常數：校正字串
chart_data
嵌入圖表的資料。以上就是要嵌入圖表網址 https://chart.googleapis.com/chart? 後方的所有內容。請使用下方的工具，或是遵循工具下方的規則。
frame_type
[Bubble only] 其中一個動態圖示框架樣式常數。
邊框間距
[僅限對話框] 對話框中的邊框間距 (以像素為單位)。
frame_color
[僅限對話框] 影格顏色，以六位數 HTML 顏色字串表示，不含 # 標記。範例：FF00FF。
fill_color
[僅限對話框] 對話框內填充顏色的六位數 HTML 顏色字串，不含 # 標記。範例：FF00FF。

已嵌入圖表資料

請使用以下轉換工具來產生圖表字串，或按照工具隨後提供的規則，手動產生圖表字串。

手動轉換規則

1. 首先，依照顯示順序，將參數和值組合中的所有下列字元替換為下列值：

取代 有了
%7C 或 %7c
|
@
@@
%
%25
,
@,
|
@|
;
@;
&
%26
=
%3D

2. 然後將 parameter1=value1&parameter2=value2... 組合中的所有 & 和 = 值替換為半形逗號。

返回頁首

換行 chm [Line, Radar]

您可以使用單色填滿資料行下方的區域。

您可以使用直立線字元 ( |) 結合行填入與任何其他 chm 參數，以分隔 chm 參數。

語法

chm=
  <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
    |...|
  <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
<b_or_B>
選擇要填滿圖表底部，還是只填滿下一行。
  • B - 從 <start_line_index> 填滿圖表底部。<end_line_index> 支援特殊語法，可讓您填入圖表片段。最簡單的方法是在圖表中加入想填滿的單一線條。
  • b - 填滿多線圖中的兩條線。起始行和結尾線會以 <start_line_index> 和 <end_line_index> 表示。
<color>
填滿顏色的 RRGGBB 格式十六進位數字。
<start_line_index>
填入開始的行索引。chd 中指定的第一個資料序列的索引為 0 (0)，第二個資料序列的索引為 1，依此類推。
<end_line_index>
  • 填入類型「b」- 要停止填滿的行。這一行必須低於目前行。
  • 填入類型 「B」- 下列其中一個選項：
    • any value - 系統會忽略這個參數中的所有單一數字，填入從指定線條到圖表底層的填滿效果
    • start:end：如要填滿圖表下方的垂直區塊，請指定 start:end，其中這些資料點索引會說明開始和停止填滿的位置。這兩個值皆為選用值，預設為 first_point:last_point。 (請參閱以下範例)。
<0>
預留項目 - 必須為零。

 

例子

說明 範例

如果是單一系列叢書，最簡單的方法就是使用 chm=B。 這會填滿線條下方的整個區域。

雷達圖只能使用這個填滿區域類型。chm=b 不適用於雷達圖。


chm=B,76A4FB,0,0,0

以下是其中有兩條折線和兩條填滿的圖表。填寫底線下方的區域和第一行上方必須用到特殊技術，接下來我們會說明。


chd=s:
cefhjkqwrlgYcfgc,
QSSVXXdkfZUMRTUQ,
HJJMOOUbVPKDHKLH,

chm=
b,224499,0,1,0| (藍色)
b,FF0000,1,2,0| (紅色)

在多線圖中，如要從圖表頂端填滿第一行，您需包含的序列包含資料格式中最高資料值的兩個複本。因此，例如用於擴充編碼的「....」，「100,100」代表基本文字格式，依此類推。從本系列影片到第一行。

如要填滿圖表的最後一行，請納入一系列的序列，其中包含資料格式最低資料值的兩個複本。例如，擴充編碼的 AAAA、基本文字格式 0,0 等等。

線條本身會以黑色繪製，並使用 chco 繪製。

 圖表上有三條線；圖中由下到第一條以綠色顯示，紅色從第一線到第二線，深藍色，第三條線到第三線，以及淡藍色
chd=e:
  ...., (最高值)
  cefhjkqwrlgYcfgc,
  QSSVXXdkfZUMRTUQ,
  HJJMOOUbVPKDHKLH,
  AAAA (零值)
chm=
  b,76A4FB,0,1,0| (淺藍色)
  b,224499,1,2,0| (藍色)
  b,FF0000,2,3,0| (紅色)
  b,80C65A,3,4,0 (綠色)
chco=000000

以下是垂直填滿區塊的折線圖。方法是為 <end_line_index> 指定 start:end 組合，行填入類型「B」。

  • B,76A4FB,0,0:3,0 - 第 0 行下方的藍色垂直填滿，由資料點 0 到 3 繫結。
  • B,990000,0,7:10,0 - 第 0 行下方的紅色垂直填滿，以資料點 7 至 10 的限制。
  • B,DEDC06,0,12:,0 - 從資料點 12 到系列結尾，第 0 行下方的黃色垂直填滿。
chm=
  B,76A4FB,0,0:3,0|
  B,990000,0,7:10,0|
  B,DEDC06,0,12:,0

以下範例說明如何在雷達圖中使用線條填滿。

 雷達圖
chm=
  B,FF000080,0,1.0,5.0|
  B,FF990080,1,1.0,5.0

返回頁首

形狀標記 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_ which_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>
要繪製標記的資料序列的從零開始索引。如果 h 標記和標記是以 x/y 位置指定位置 (開頭為 @ 字元)，系統會忽略這項設定。您可以使用隱藏的資料序列做為標記的來源，詳情請參閱複合圖表。分組的垂直長條圖支援特殊擴充語法，以便將標記與特定長條對齊。
<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 到 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 (在圖表元素上方)。
<opt_offset>
[選用] 可讓您指定與指定位置之間的水平和垂直偏移值。以下是使用 : 分隔符號的語法：reserved:<horizontal_offset>:<vertical_offset>。如果有指定，即可在 <opt_z_order> 的 chm 參數字串中加入空白的 , 值。範例：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、一個像素寬度、40 個像素長。
  • o,FF9900,0,4.0,12.0 - 橘色圓圈，第一個序列，第五點，尺寸為 12。
  • s,3399CC,0,5.0,11.0 - 藍色正方形，第一個序列，第六點，尺寸 11。
  • v,BBCCED,0,6.0,1.0 - 向上垂直線，向上線，第一個序列到第七點，寬度為一個像素。
  • V,3399CC,0,7.0,1.0 - 圖表頂端垂直線，第一個序列、第一個序列、八點、一個像素寬度。
  • x,FFCC33,0,8.0,20.0 - 黃色 'X'，第一個系列，第九點，大小為 20。
  • H,FFFF00,0,9,2 - 資料點 9 處的圖表寬度水平線。
  • h,FF0000,0,0.5,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。
  • 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,9900CV6,1,2,506"
chm=
  E,000000,0,6,1:20|
  H,990066,1,2,5:50|
  V,3399CC,0,8,3:50

返回頁首

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

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

您可以使用直立線字元 ( |) 合併任何 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」n.d是序列中從零開始的索引。如果您指定非整數值，分數則代表計算的中繼點。例如，3.5 代表點 3 到點 4 之間的中段。
  • -1 - 在所有資料點上繪製標記。您也可以將這個參數留空，以便在所有資料點上進行繪製。
  • -n - 在每個「n」n個資料點上繪製標記。
  • start:end:n - 在範圍中的每「n」n個資料點上繪製標記，從 n 到 n 索引值 (含頭尾)。所有參數不一定都是選用項目，因此 3:1 會從第四個元素到最後一個元素，步驟 1 完全省略這個參數，並完全省略這個參數，會預設為 first:last:1。所有值都可以是浮點數。start 和 end 可以是負值，從最後一個值反向計算。如果 start 和 end 均為負值，請確認這些值列於遞增值 (例如 -6:-1:1)。如果 n 步值小於 1，系統會透過內插資料值來計算其他資料點。預設值是 first:last:1
  • x:y - [N 類型標記不支援]] 在圖表上的特定 x/y 點繪製標記。這個點不必位於線條上。如要在標記類型前加上 in 字元 (@)，請使用這個選項。將座標指定為浮點值，其中 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 (接近圖表元素上方)。
<opt_placement>
[選用] 其他刊登位置詳細資料，說明標記放置位置 (相對於資料點)。您可以指定水平和/或垂直的相對位置以及偏移值。刊登位置語法是一種字串，其中含有分隔符號，如下所示。所有元素皆為選用元素：<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>。如果有指定，您可以在 <opt_z_order> 的 chm 參數字串中加入空白的 , 值。範例：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

以下圖表範例在最小點包含文字標籤，並在最大點加入標記標籤。

折線圖顯示 10pt 的藍色文字標籤，以及有 15pt 紅色文字的旗幟，這些文字分別繪製在虛線綠線的資料點上。
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
另一個顯示瑞士城市海拔高度的註解標記範例。

返回頁首

範圍標記 chm [長條圖、K 線圖、線條、雷達、散佈圖]

您可以為背景的水平或垂直錶帶加上顏色，藉此凸顯圖表中的特定區域。

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

語法

請為每個要繪製的錶帶指定下列一組參數。如要繪製多個頻帶，請建立其他參數組合，並以直立線字元分隔。這些範圍會按照指定的順序繪製，因此最後一個繪製的範圍會繪製在先前範圍的上方。

chm=
  <direction>,<color>,0,<start_point>,<end_point>
    |...|
  <direction>,<color>,0,<start_point>,<end_point>
<direction>
指定水平或垂直陰影。使用 r 做為水平範圍，使用 R 表示垂直範圍。
<color>
以 RRGGBB 格式的十六進位數字表示範圍顏色。
0
預留項目 - 必須為零。
<start_point>
範圍的起始位置。
  • 對於「水平」範圍標記，這是 Y 軸上的位置，其中 0.00 是圖表底部，而 1.00 位於圖表頂端。
  • 以「垂直」範圍標記來說，這是 X 軸上的位置，其中 0.00 是圖表的左側，1.00 代表圖表右側。
<end_point>
範圍的結束位置。
  • 對於「水平」範圍標記，這是 Y 軸上的位置，其中 0.00 是圖表底部，而 1.00 位於圖表頂端。
  • 以「垂直」範圍標記來說，這是 X 軸上的位置，其中 0.00 是圖表的左側，1.00 代表圖表右側。

 

例子

說明 範例

範圍標記可以是細線或一種顏色。

  • r,E5ECF9,0,0.75,0.25 - 範圍標記，純藍色，(保留)，圖表高度的 0.5。
  • r,000000,0,0.1,0.11 - 範圍標記，黑色 (保留)，從 Y 軸向上 0.1 開始，結束在 Y 軸上 (細黑線) 0.11。
 折線圖顯示淡藍色水平錶帶從 Y 軸向上延伸到 75% 的
chm=
  r,E5ECF9,0,0.75,0.25|
  r,000000,0,0.1,0.11

這個範例顯示垂直範圍標記。第一個標記是紅線 (FF0000)，第二個標記是淡藍色錶帶 (A0BAE9)。

 折線圖顯示 X 軸交往 25% 到 75% 的淡藍色垂直錶帶，以及 X 軸沿線 10% 的細直線 10%
chm=
  R,FF0000,0,0.1,0.11|
  R,A0BAE9,0,0.75,0.25

標記會按照指定的順序繪製。在這個範例中，您可以看到垂直紅色標記在淡藍色水平標記之前繪製。

 折線圖顯示藍色垂直頻帶和淡藍色水平錶帶，沿著 X 軸和 Y 軸延伸到 25% 至 75%。沿著 x 軸和 y 軸移動的細長直線和細水平黑色線條百分之十
chm=
  R,FF0000,0,0.1,0.11|
  R,A0BAE9,0,0.75,0.25|
  r,E5ECF9,0,0.75,0.25|
  r,000000,0,0.1,0.11

以下折線圖範例使用範圍標記繪製圖表的零線、中點線和頂部較淡的水平線。

 有一條黃色線條和三條水平線的波形圖
chm=
  r,000000,0,0.499,0.501|
  r,000000,0,0.998,1.0|
  r,000000,0,0.0,0.002

返回頁首

K 線標記 chm=F [Bar, Line]

K 線標記表示資料序列中的變異數和方向變化。經常用於顯示一天內的股價。標記中有顯示高和低值的路段，以及特定時間範圍 (通常是一天) 的開盤和結束值。如要進一步瞭解 K 線標記，請參閱這個網頁。

K 線標記是一個由垂直分隔的矩形繪製而成。我們需要四個資料序列來繪製一個 K 線標記，以下是每個序列指定的內容：

  • 系列 1 和 4 分別指定垂直線的底部和頂端。這些數值通常代表當天的低值和最高值。
  • 系列 2 和 3：指定矩形的垂直框線。第 2 層是開盤價，第 3 系列則是結尾值。矩形的顏色取決於高度：當開盤值 (第 2 號) 低於最終值 (第 3 輪) 時，價格會增加，且矩形會預設為實心綠色；開盤值 (第 2 輪) 高於收尾值 (第 3 輪) 時，價格會降低，而矩形會填滿紅色。您只能針對要縮小的矩形指定填滿顏色。指定這個值時，值為增加的矩形會是未填滿 (空白)。請注意，序列 2 可以是矩形頂端或底部，取決於價格上漲或下跌。

您也可以使用直立線字元 ( |) 合併 K 線標記與其他 chm 參數，藉此分隔 chm 參數。

注意：如果您不希望繪製標記時呈現的資料線條，就必須在格式類型後方加上 0。例如：文字格式資料字串中的 chd=t0:10,20,30,40。詳情請參閱複合圖表。

以下範例顯示每個系列叢書的行：

語法

chm=
  F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>
F
表示這是 K 線標記。
<opt_declining_color>
[選用] 值降低時，矩形的填滿顏色 (當序列 2 值 > 對應的序列 3 值時)。此為 RRGGBB 格式的十六進位數字。值增加時，矩形會是空白。預設為恆亮綠燈，以恆亮紅色以減少數值 (不得針對增加的值指定自訂填滿顏色)。
<data_series_index>
資料序列索引，為 K 線標記的第一個序列。這個索引從零開始。因此，如果您在此處指定 1，而您有六個序列，那麼第二個、第三、第四和第五種就會用來繪製 K 線標記。
<opt_what_points>
[選用] 指定用來繪製標記的資料點。預設值為所有標記。請使用下列其中一種格式：
  • n.d：在系列的單一點上繪製標記，其中「n.d」n.d是序列中點的索引。如果指定非整數值，分數則代表計算的中繼點。例如，3.5 代表點 3 到點 4 之間的中段。
  • -1 - 在所有資料點上繪製標記。您也可以將這個參數留空，以便在所有標記上繪圖。
  • -n - 在每個「n」n個資料點上繪製標記。
  • start:end:n - 在範圍中的每「n」n個資料點上繪製標記，從 n 到 n 索引值 (含頭尾)。所有參數不一定都是選用項目，因此 3:1 會從第四個元素到最後一個元素，步驟 1 中完全省略這個參數，則會預設為 first:last:1。所有值都可以是浮點數。start 和 end 可以是負值，從最後一個值反向計算。如果 start 和 end 均為負值，請確認這些值列於遞增值 (例如 -6:-1:1)。如果 n 步值小於 1，系統會透過內插資料值來計算其他資料點。預設值是 first:last:1
<寬>
所有矩形的寬度，以像素為單位。
<opt_z_order>
[選用] 繪製標記的圖層，與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數，-1.0 為底部，而 1.0 為頂端。圖表元素 (折線和長條) 小於零。如果兩個標記的值相同，則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。

 

例子

說明 範例

以下是折線圖中含有四個序列的 K 線標記範例。已指定自訂填滿顏色 0000FF (藍色)，當系列 3 中的點小於序列 2 中的對應點時，系統會使用此顏色填滿矩形。

圖表會剪輯第一個和最後一個矩形。如要去除這些值，您可以在第四個 chm 參數中指定 1:4。

請注意，如要隱藏序列行，請注意資料字串中的零：chd=t0。這表示所有圖表資料都用於標記。

<which_point> 參數為空白，會在所有資料點上繪製 K 線。

折線圖上有四條橘色線條和四個財務標記

chd=t0:
  0, 5,10, 7,12, 6|
  35,25,45,47,24,46|
  15,40,30,27,39,54|
  70,55,63,59,80,60
chm=F,0000FF,0,,20

以下是相同的圖表範例，使用預設顏色並移除第一個和最後一個項目。

這是複合圖表，這是折線圖 (基本圖表類型) 和 K 線標記的組合。cht=t:1 中的值 1 表示第一個之後的所有資料序列，都不應以基本圖表類型 (折線圖) 的形式隱藏。chm=F,,1,1:4,20 中的前 1 表示 K 線資料來自第 2、3、4 和 5 序列 (1 為從零開始)。 如要進一步瞭解如何繪製這類複合圖表，請參閱複合圖表。

折線圖，其中一條橘色線條和四個財務標記。
cht=lc
chm=
  F,,1,1:4,20
chd=t1:
  15,40,30,27,39,54|
  ...

返回頁首

線條標記 chm=D [長條圖、K 線圖、線條、雷達、散佈圖]

您可以在圖表中新增用來追蹤資料的線條。這類圖表最常用於複合圖表。

如要新增多行 (或與其他 chm 標記合併)，請使用直立線 ( |) 分隔符號分隔 chm 參數集。您無法使用這項參數製作虛線標記。

語法

chm=
  D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
D
代表這是線條標記。
<color>
線條的顏色，採用 RRGGBB 十六進位格式。
<series_index>
用於繪製線條的資料序列索引。第一個資料序列的資料序列索引為 0，第二個資料序列的 1，依此類推。
<which_points>
序列中要用來繪製線條的點。請使用下列其中一個值：
  • 0 - 使用系列中的所有分數。
  • start:end - 使用從 start 到 end (從零開始計算) 之間的特定範圍點。您也可以使用浮點值指定中繼點，或將 start 或 end 留空，分別表示第一個或最後一個資料點。start 和 end 可以是負值，做為從最後一個值開始的反向索引。如果 start 和 end 均為負值，請務必以遞增的值寫入 (例如 -6:-1)。
<size>
線條的寬度 (以像素為單位)。
<opt_z_order>
[選用] 繪製標記的圖層，與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數，-1.0 為底部，而 1.0 為頂端。圖表元素 (折線和長條) 小於零。如果兩個標記的值相同，則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。

 

例子

說明 範例

以下是在長條圖上繪製標記線條的範例。Z 軸順序設為 1，因此線條會繪製在長條上方。

這個範例在長條和資料列中都使用相同資料。		 含有折線標記的長條圖
chm=D,0033FF,0,0,5,1
chd=s:1XQbnf4

這和相同的長條圖，但包含折線專用的額外資料序列。以下為複合圖表範例。藉由在 chd 參數中加入其他資料序列，加上一個值至 chd 即可讓圖表「忽略」其他資料序列，藉此繪製複合圖表。

詳情請參閱複合圖表。

 含有折線標記的長條圖
chm=D,0033FF,1,0,5,1
chd=s1:1XQbnf4,43ksfg6

返回頁首

資料函式chfd [全部 chd圖表]

您可以使用 muParser 函式語法，指定要對圖表資料執行的自訂函式。函式使用的資料可能來自以下兩個來源之一：

  • 來自 chd 的資料序列 - 系統會從 chd 的指定序列中提取資料。
  • chfd 參數本身宣告的值範圍 - 您可宣告任意資料範圍的開始、停止和步驟值。

請務必注意，在所有情況下，您必須將輸出內容指派給 chd 中的現有系列，該序列將由函式輸出覆寫。只有在所有函式都經過處理之後，系統才會顯示圖表。因此，如果您將多個函式指派給輸出至同一個資料序列，系統會依指定順序執行函式，但圖表上只會顯示最終函式的輸出內容。請注意，您可以鏈結函式，讓一個函式可做為輸入序列的輸入序列 (由先前函式輸出)。

如要為函式行指派顏色或 chm 標記，請將顏色或標記指派給函式的序列索引。請注意，系統會根據函式處理後的資料來放置標記。

語法

chfd=
  <output_series_index>,<function_data>,<function_string>
    |...|
  <output_series_index>,<function_data>,<function_string>
<output_series_index>
chd 中的資料序列索引 (從零開始)，用於寫入函式輸出內容。函式輸出將完全覆寫任何現有資料。如果某個系列並非函式的輸入內容，最佳做法是為該序列指派一個虛擬值。
<function_data>
要繪製的變數和資料。資料可以來自您定義的範圍，或來自其中一個 chd 資料序列。您可以為每個函式指定多個變數，也可以使用多個變數的 ; (分號) 分隔符號。請注意，如果您為單一函式定義了多個變數，且這些變數的點數不同，則該函式會在到達第一個端點時停止。例如，如果函式定義了 x=1 至 5 步驟 1 和 y=1 至 10 步驟 1，則函式會在到達第五點時結束。
    <variable_name>,<input_series_index>
         或
    <variable_name>,<start>,<end>,<step>
  • variable_name - 變數的任意字串名稱。請在 function_string 定義的函式中使用這項參數。
  • input_series_index - 要做為輸入資料的 chd 資料序列索引。
  • start：範圍中的數值起始值。
  • end：範圍的結束數值。
  • step - start 到 end 之間的數字步驟值。 可以是正數或負數，但不能為零。
範例： x,0,100,1 宣告了名為 x 的變數，值為 0、1、2、... 100。x,0,100,1;r,0,3.1,.1 會宣告相同的 x 變數，以及名為 r 的變數，值為 0、0.1、0.2、...、3.0、3.1。 x,0 會宣告名為 x 的變數，這個變數會使用第一個 chd 系列中的資料。function_string 會使用這些變數。除非您在 function_string 中指定這些變數，否則圖表不會標示這些字元。步數越小，圖表就會越順暢。
<function_stringfunction_string>
您的函式 (以 muParser 語法 編寫)。該函式適用於 variable_data 中指定的變數和資料。您只能參照這個本機函式集中宣告的變數，無法參照其他管道式 chfd 參數組合中宣告的變數。不支援匯總 muParser 函式 (最小值、最大值、平均值)。重要事項：請記得在您的函式中使用 %2B，而不是 +！

 

例子

說明 範例

簡單的正弦波。請注意以下事項：

  • chd=t:-1：由於資料是在 chfd 參數中宣告，因此我們為圖表資料使用虛擬變數。
  • chco=FF0000 - 第一個系列叢書指定了紅色。即使不使用 chd 的資料，系統仍會針對該繪製函式使用該序列的對應顏色。
  • chfd=0,x,0,11,0.1,sin(x)*50%2B50 - 我們宣告一個稱為 x 的變數，其值為 0 到 11，以 0.1 遞增。會指派給第一個系列，也就是第一個系列顏色 (FF0000)。套用至 x 的函式是 sin(x) * 50 + 50。請注意我們如何在該函式中對 + 進行編碼。

 

 chfd 指定的正弦波
cht=lc
chd=t:-1
chco=FF0000
chfd=
  0,x,0,11,0.1,sin(x)*50%2B50
chxt=x,y
這一行使用來自 chd 參數的資料。
chd=t:5,10
chfd=0,x,0,x*4

混合函式和非函式行。

請注意系列顏色參數 chco 指定顏色的方式。

請注意函式輸出中標記的位置；資料點從「start」、「end」和「step」開始計算，因此如果範圍是 0 到 11 步驟 0.1，點 0 為 0，點 1 為 0.1，依此類推，直到第 110 點的值為 11。

 一個使用 chfd 的系列，一個使用 chd 做為資料。
chd=t:
  -1
  15,45
chco=
  FF0000,000000
chfd=
  0,x,0,11,0.1,sin(x)*50%2B50
chm=
  c,00A5C6,0,110,10
  a,00A5C6,0,60,10

如要以兩個維度定義函式，請使用 lxy 圖表，指派兩個虛擬序列，並分別指派一個函式。

  • 0,x,0,10,0.1,sin(x)*50%2B50 - 序列 0 (X 軸值) 含有名為 x 的變數，其值為 0 至 10、步驟 0.1 以及函式 sin(x)*50 + 50
  • 0,y,0,10,0.1,sin(y)*50%2B50 - 序列 0 (y 軸值) 含有名為 y 的變數，其值為 0 至 10、步驟 0.1 以及函式 sin(x)*50 + 50
 一個圓形
cht=lxy
chd=t:-1|-1
chfd=
  0,x,0,10,0.1,sin(x)*50%2B50|
  1,y,0,10,0.1,cos(y)*50%2B50

chfd 參數能讓你盡情發揮創意。

請嘗試點選這些圖片，以便在圖表遊樂場中開啟並暢玩這些圖片，一探究竟！

返回頁首