![cht=bvs&chbh=5,2&chm=D,0033FF,2,0,5,1&chbh=20&chs=75x50&chd=s2:1XQbnf4,EWoQMUB,9halxp9&chco=4D89F9,C6D9FD&chbh=FD&chbh](https://developers-dot-devsite-v2-prod.appspot.com/static/chart/image/images/chart_197.png?authuser=3&hl=zh-tw)
總覽
您可以將多種圖表類型與折線圖或 K 線圖標記結合,藉此凸顯資料趨勢或顯示差異。將折線或 K 線標記新增至長條圖、散佈圖或其他圖表類型時,產生的圖表稱為複合圖表。部分複合圖表看起來會像兩種圖表的組合,例如一個含有追蹤線的長條圖:
有些則看起來像是全新的圖表類型,例如方塊圖:
.
建立複合圖表
所有複合圖表均包含一或多個基本圖表類型 (折線圖、散佈圖、長條圖或雷達),以及一或多組標記。這些標記需要資料才能放在圖表上。有時您可以使用與在圖表上繪製長條或點相同的資料序列,但通常您會希望標記擁有專屬的資料集。如果希望圖表為基本圖表和標記使用不同的資料序列,您必須隱藏基本圖表中的標記資料,以免圖表嘗試繪製更多長條或線條。操作方法如下:
- 將標記資料序列新增至
chd
參數的結尾。舉例來說,如果長條圖包含chd=t:30,10,20
資料,您可以為線條標記新增資料,如下所示:chd=t:30,10,20|60,40,50
。 - 隱藏基本圖表中的額外標記資料。如果您只是在追蹤線的長條圖中加入額外資料序列,圖表就會以新的長條顯示。為避免這種情況,你必須隱藏這個額外系列。如要隱藏序列,請在
chd
格式描述元後方加上一個數字,例如chd=t1:30,10,20|60,40,50
。此數字告知 Chart API 要「使用」 多少資料序列,為cht
參數定義的基本圖表類型繪製元素 (長條圖的長條、折線圖的資料點等)。繪製圖表時,該圖表類型會忽略額外的資料序列。請注意,這是從 1 為基礎的數字,而非從 0 開始計算。因此,t1
表示「只使用第一個資料序列做為長條圖」,t2
表示「只使用前兩個序列做為長條」等。 - 使用隱藏的資料序列繪製K 線標記、線條標記或其他標記。如需繪製標記的操作說明,請參閱連結區段。參照隱藏的資料序列做為標記的來源。您可以視需要加入其他隱藏資料序列,數量不限,然後用於其他圖表標記。
以下是我們剛才說明的圖表:
cht=bvg
chd=t1:30,10,20|60,40,50
chm=D,0033FF,1,0,5,1
圖表類型
以下分別列出標記類型及相關圖表類型:
標記類型 | 支援的基本圖表類型 |
---|---|
折線圖 | 折線圖、散佈圖、長條圖、雷達 |
K 線圖 | 線條、長條圖 |
所有其他 | 折線圖、散佈圖、長條圖、雷達 |
以下列舉幾種可建立的複合圖表類型:
圖表類型 | 說明 | 範例 |
---|---|---|
線條標記圖表 | 折線標記可用來顯示許多其他圖表類型的趨勢。 | ![]() ![]() |
K 線圖 | K 線圖通常用於顯示財務資料。 | ![]() |
箱形圖 | 方塊圖表可用來呈現按範圍四分位數分組的資料。 |
![]() |
嵌入的圖表 | 您也可以將圖表嵌入其他圖表。 | ![]() |
其他標記 | 您可以在任何支援的基本圖表類型中隱藏標記資料,並搭配任何其他偏好的標記使用。 | ![]() chd=t1: |
折線標記圖表
您可以在折線圖、scatter、長條圖或雷達圖表中新增線條,醒目顯示趨勢。
基本類型 + 標記類型 | 說明 | 範例 |
---|---|---|
長條 + 線條 | 此為含有追蹤記錄線的長條圖。前兩個資料序列用於堆疊長條圖,其餘序列則用於線條。
|
![]() chm= |
散佈圖 + 線條 | 您可以在散佈圖中加入折線來呈現平均值。請注意,散佈圖會以不同的方式隱藏標記資料,詳情請參閱散佈圖。 |
|
長條 + 線條 | 以下是另一個堆疊長條圖,且圖上有獨立的線條。 |
![]() cht=bvs |
長條圖 + 社交圈 | 與前一張圖表相同,但使用的是圓形標記,而非線條標記。我們已指定每 0.5 個資料值,這會在虛線中加入計算的中介點。 | ![]() cht=bvs |
K 線圖
K 線圖至少需要四個資料序列才能繪製 K 線,還有適用於任何其他圖表元素的額外序列。K 線圖只能顯示一組 K 線標記,或者也可以是 K 線標記加上長條圖或折線圖的組合,如下所示:
基本類型 + 標記類型 | 說明 | 範例 |
---|---|---|
線條 (隱藏) + K 線圖 | 這個範例顯示只顯示 K 線標記的圖表。
|
![]() cht=lc |
線條 + K 線圖 | 以下折線圖範例是加上 K 線標記的折線圖。 提供五個資料序列;第一個用於圖表類型 (折線),其餘「隱藏」資料序列則用於 K 線標記。 我們在 <which_points> 值中使用
|
|
線條 + K 線圖 | 另一個 K 線圖的範例,但含自訂的填滿顏色。 |
![]() chd=t1: |
長條 + K 線圖 | 以下這張長條圖包含 K 線標記。 我們在此顯示第一個和最後一個 K 線標記,因為長條的間距足以避免圖表邊界遭到裁剪。 |
![]() cht=bvg |
箱狀圖表
箱形圖 (又稱為「盒子圖」或「盒子圖」) 是一種圖表,能夠以四分位數顯示一或多個序列 (「四分位數」是指跨值範圍 25% 的群組,可能除外)。方塊圖表與 K 線圖類似,但多了 K 線下和上半部的標記,再加上第 50 個百分位數的標記。
方塊圖是由多個標記組成,如下所示:
![]() chm= |
![]() chm= |
![]() chm= |
![]() |
一組K 線標記 (chm=F ),用於方塊內文: |
第一組可調整長度的水平線形狀標記 (chm=H ),適用於最小、第 50 和第 100 個百分位數的線條: |
(選用) 一些圓形形狀標記 (chm=o ),顯示資料集中的離群值。 |
全部彙整在一起,這樣就得到了方形圖! |
方塊圖表的基本圖表類型可以是任何長條圖類型 (bhs
、bvs
、bhg
、bvg
) 或折線圖類型 (lc
、ls
、lxy
)。但如果如要隱藏基本圖表類型,請在資料格式參數中加入零 (例如 chd=t0:
或 chd=s0:
)。
方形圖表至少須有五個資料序列:四個資料序列,一個用於方塊,一個則代表最大和最小標記;一個適用於 50% 標記,另外還有任何您需要的額外資料序列,例如離群標記。以下是建議的系列叢書順序。請注意,如果序列 1 中的值大於序列 2 中的對應值,方塊將填入 chm=F
標記顏色;如果系列 1 中的值小於序列 2 中的值,方塊就不會填滿。詳情請參閱「K 線標記」。
未填寫包裝盒的系列叢書順序:
- 最小值
- 25% 標記 (填滿已填滿的方塊為 75%)
- 75% 標記 (填滿填滿方塊的 25%)
- 最大值
- 50% 標記
- 第 6 輪以上系列適用於其他標記資料,例如離群值。
您可以在 K 線標記資料前後加上額外的標記序列,但這麼做較簡單。
您可以指定不同的標記、不同的基本圖表類型,或以不同方式排序資料,藉此製作不同的方形圖表樣式
說明 | 範例 | ||
---|---|---|---|
這是標準方塊圖表,但將不同顏色指派給不同圖表元素,可醒目顯示建立各個圖表元素所用的標記。
|
|
||
Lc 圖表類型一律會顯示軸線。如要建立不含軸線的圖表,請指定 ls 類型圖表。 |
|
||
如要建立填滿方塊,請讓第二個序列中的點大於第三個序列中的對應點。而在右側程式碼中,較大的值會以紅色標示。 | ![]() chd=t0: |
內嵌圖表
您可以使用動態圖示,將任何圖表類型嵌入長條圖、折線圖、雷達或scatter圖表。請參閱「動態圖示」(chem
) 標記說明文件的「內嵌圖表」一節。
標準功能
本頁其他功能為標準圖表功能。
線條標記 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.0 (在圖表元素上方)。
例子
說明 | 範例 |
---|---|
本例是在長條圖上繪製標記線。由於 z-order 設為 |
![]() chm=D,0033FF,0,0,5,1 |
這與長條圖相同,但還有一條折線專屬的其他資料序列。這是複合圖的範例。如要繪製複合圖表,請在 詳情請參閱複合圖表。 |
![]() chm=D,0033FF,1,0,5,1 |
形狀標記 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:1x: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>
- 指定垂直偏移的正數或負數,以像素為單位。選用,如未使用,請留空。
例子
說明 | 範例 |
---|---|
以下是幾種形狀和線條標記的範例。
|
![]() chm= |
以下範例中的一個資料序列使用了鑽石,另一個資料序列則是圓形。 如有兩個以上的標記位於同一個點,則標記會依照 |
![]() chm= |
以下是一張折線圖,其中包含每秒資料點 (-2 代表其他資料點) 的標記。 |
![]() chd=t: |
以下是折線圖,標記數量是資料點的兩倍 (-0.5 代表每半點)。 | ![]() chd=t: |
這個範例說明如何使用 h 和 v 標記,建立具有自訂顏色和粗細的格線。Z 順序值 (最後一個值) 會設為 -1,讓格線顯示在資料線條下方。 |
![]() chm= |
這張圖表會在折線圖中加入垂直填滿線條:
|
![]() chm= |
這個範例會使用確切座標,在圖表中加入箭頭和文字標記。第一個 D 標記是長條圖下方的追蹤線。第二個標記是箭頭,第三個標記是箭頭文字。 | ![]() chm= |
如要顯示相對值,或加強圖表中資料值的高度,使用固定於特定資料點 (H ) 的水平線便相當實用。 |
![]() chm=H,FF0000,0,18,1 |
這張圖表展示可在 <size> 參數中指定線條粗細和長度的標記。
|
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= |
K 線標記 chm=F
[Bar, Line]
K 線標記表示資料序列的變化和方向變化。通常用於顯示一天中的股票值。標記中包含顯示最高和最低值的路段,以及特定時間範圍 (通常是一天) 的開盤價和收盤價。如要進一步瞭解 K 線標記,請參閱這裡。
K 線標記繪製成的矩形是一條垂直線兩相交的矩形。這需要四個資料序列繪製一個 K 線標記,每個序列會指定的項目如下:
- 序列 1 和 4 分別指定垂直線的底部和頂部。這些數值通常代表當天的最低和最高值。
- Series 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 是系列中資料點的索引。如果您指定非整數值,則分數表示計算出的中繼點。例如,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.0 (在圖表元素上方)。
例子
說明 | 範例 |
---|---|
以下是含有四個序列折線圖的 K 線標記範例。指定自訂填滿顏色 第一個和最後一個矩形會修剪至圖表。如要去除這些值,您可以將 chm 的第四個參數指定為 1:4。 記下資料字串中的零,隱藏序列的各行: <which_point> 參數空白,會在所有資料點上繪製 K 線。 |
chd=t0: |
以下是相同圖表的範例,使用預設顏色並移除第一個項目和最後一個項目。 這是複合圖,結合了折線圖 (基本圖表類型) 和 K 線標記。 |
|