Trang này mô tả cách tạo nhiều chú thích, bong bóng, ghim và hình ảnh đồ hoạ khác mà URL có thể yêu cầu, hoặc cách thêm dưới dạng điểm đánh dấu ở đầu các biểu đồ khác.
Mục lục
Giới thiệu
API biểu đồ cho phép bạn tạo nhiều chú thích, ghim hoặc bong bóng thú vị kết hợp văn bản và hình ảnh. Những mục này được gọi là biểu tượng động.
Bạn có thể tạo một hình ảnh biểu tượng động độc lập hoặc đặt một biểu tượng động ở đầu biểu đồ dưới dạng loại điểm đánh dấu bằng cách sử dụng tham số chem
. Trang này sẽ mô tả cách tạo biểu tượng động dưới dạng hình ảnh độc lập hoặc điểm đánh dấu trên một biểu đồ khác. Trang tham khảo Biểu tượng động cho Đồ hoạ thông tin mô tả tất cả các loại điểm đánh dấu động có sẵn.
Cú pháp để tạo biểu tượng động phụ thuộc vào việc bạn muốn dùng biểu tượng độc lập hay làm điểm đánh dấu động trong một biểu đồ khác.
Biểu tượng độc lập
Bạn có thể yêu cầu một hình ảnh biểu tượng động giống như cách bạn yêu cầu bất kỳ biểu đồ nào khác. Một biểu tượng động độc lập hỗ trợ một bộ tham số khác với các biểu đồ khác:
Thông số | Bắt buộc hoặc Không bắt buộc | Nội dung mô tả |
---|---|---|
chst=<icon_string_constant> |
Bắt buộc | Mô tả loại biểu tượng cần tạo.
|
chld=<icon_data> |
Bắt buộc | Dữ liệu cụ thể được dùng để mô tả kích thước, chế độ xoay, văn bản và các dữ liệu bắt buộc khác của biểu tượng.
|
cht |
KHÔNG DÙNG | Biểu đồ biểu tượng động độc lập không sử dụng tham số cht . |
chs |
KHÔNG DÙNG | Biểu đồ biểu tượng động độc lập không sử dụng tham số chs . |
chd |
KHÔNG DÙNG | Sử dụng tham số chld để truyền dữ liệu sang một biểu tượng động độc lập. |
Ví dụ
https://chart.googleapis.com/chart?chst=d_bubble_icon_text_small&chld=ski|bb|Wheeee!|FFFFFF|000000
Điểm đánh dấu động
Bạn có thể nhúng một biểu tượng động làm loại điểm đánh dấu trên một số loại biểu đồ khác nhau bằng cách sử dụng tham số chem
. Hãy xem tài liệu về chem
để tìm hiểu cách thực hiện.
Ví dụ
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
Các đặc điểm phổ biến của biểu tượng
Hầu hết các biểu tượng có thể liên kết với các chuỗi văn bản hoặc bóng.
Chuỗi văn bản
Tất cả văn bản hiển thị được chuyển đến API của Chart phải được mã hoá UTF-8 và sau đó mới được mã hoá URL.
Điều này chỉ ảnh hưởng đến các ký tự không an toàn cho URL (các ký tự an toàn cho URL chủ yếu là các chữ cái tiếng Anh a-z cả viết hoa và viết thường, cùng với một bộ dấu câu nhỏ). Ví dụ: Giá trị được mã hoá UTF-8 và URL được mã hoá cho chữ cái "è" là "%C3%A8
" và đối với ký tự tiếng Trung 駅 là "%E9%A7%85
". Hầu hết các trình duyệt sẽ cho phép bạn sử dụng giá trị chưa được mã hoá trong chuỗi URL (ví dụ: 駅) và sẽ mã hoá giá trị đó cho bạn phía sau hậu trường.
Tuy nhiên, có thể ai đó đang xem URL biểu đồ của bạn đang sử dụng một trình duyệt không thực hiện việc này. Vì vậy, tốt nhất là bạn nên UTF-8 và mã hoá URL tất cả các ký tự không phải ASCII trong chuỗi văn bản. Xin lưu ý rằng điều này chỉ áp dụng cho văn bản xuất hiện trong bong bóng hoặc ghim, chứ không áp dụng cho ký tự &, | hoặc các ký tự khác thuộc cú pháp URL.
Khi sử dụng tham số chem
để chỉ định điểm đánh dấu biểu tượng động, bạn cũng phải thoát một số ký tự nhất định trong văn bản, như mô tả trong tài liệu chem
.
Bóng
Bạn có thể thêm bóng cho nhiều biểu tượng hoặc thậm chí là vẽ bóng cho một số biểu tượng mà không có biểu tượng đó!
Biểu tượng bị đổ
Nhiều biểu tượng trong số này có thể được vẽ có hoặc không có bóng. Nếu tính năng đổ bóng là một tuỳ chọn, tên biểu tượng sẽ có một phiên bản kết thúc bằng _withshadow
và một phiên bản khác không có đuôi đó. Bạn có thể chỉ định một biểu tượng có phần cuối cùng, tuỳ thuộc vào việc bạn có muốn đổ bóng hay không.
Dưới đây là ví dụ về bong bóng văn bản trung bình và một ghim có và không có bóng:
chst=d_bubble_icon_text_big |
chst=d_bubble_icon_text_big_withshadow |
chst=d_map_pin_icon |
chst=d_map_pin_icon_withshadow |
Bóng tự do
Một số loại biểu tượng cho phép bạn tự vẽ bóng của chúng. Bạn nên thực hiện việc này nếu đang sử dụng nhiều biểu tượng đổ bóng chồng lên nhau trên đồ hoạ và các biểu tượng này ở gần đến mức bóng từ một biểu tượng này rơi vào một biểu tượng khác. Ví dụ: đây là hai bong bóng bị đổ bóng, Robert đã vẽ trước tiên, sau đó là Alice:
Hãy lưu ý cách cái bóng của Alice che phủ một phần Robert. Để khắc phục tình trạng này, trước tiên, bạn có thể vẽ bóng của Alice, sau đó là bong bóng Robert, rồi đến Alice không có bóng. Có thể không hoàn toàn thực tế về mặt ánh sáng và bóng, nhưng cách này tránh che khuất một bong bóng bằng bóng của một bong bóng khác:
chem=
y;s=bubble_text_small_shadow;d=bb,Alice,FF8,000;ds=0;dp=1;py=1 // Alice, no shadow
y;s=bubble_text_small_withshadow;d=bbtr,Robert,FF8,000;ds=0;dp=3.5;py=1 // Robert with shadow
y;s=bubble_text_small;d=bb,Alice,FF8,000;ds=0;dp=1;py=1 // Alice shadow
Mọi điểm đánh dấu đều chỉ định cùng một thứ tự z là 1 (py=1
), vì vậy, các điểm đánh dấu sẽ được vẽ theo thứ tự đã nêu, ở đầu các thành phần trong biểu đồ (đường trong biểu đồ). Đầu tiên, bóng của Alice được vẽ, sau đó là bong bóng Robert ở trên cùng và cuối cùng là bong bóng Alice ở trên cùng.
Hãy xem tài liệu về loại biểu tượng cụ thể để tìm hiểu xem bạn có thể chỉ vẽ bóng của biểu tượng đó hay không.
Biểu tượng theo bối cảnh
Bạn có thể chỉ định một biểu tượng thay đổi màu sắc, kích thước hoặc cách xếp chồng theo điểm được chỉ định. Các loại biểu tượng này chỉ được cung cấp dưới dạng điểm đánh dấu biểu tượng động (tham số chem
), không phải ở dạng biểu tượng độc lập.
Các biểu tượng này có thể được hiển thị trên một chuỗi khác ngoài chuỗi chỉ định màu sắc, kích thước hoặc thông tin xếp chồng của chúng. Tức là giá trị ds
của tham số chem
chỉ định chuỗi sẽ hiển thị biểu tượng, nhưng các giá trị để xác định kích thước hoặc màu sắc của biểu tượng thì được chỉ định trong các tham số cho dưới đây. Một cách hữu hiệu của tính năng này là sử dụng một chuỗi dữ liệu ẩn cho dữ liệu biểu tượng nhưng hiển thị các biểu tượng trên một dòng hoặc thanh hiển thị. Dưới đây là một số ví dụ:
Biểu tượng hiển thị trên loạt nguồn | Biểu tượng hiển thị trên chuỗi không phải nguồn | Biểu tượng sử dụng bộ sách bị ẩn |
---|---|---|
chem=
|
chem=
|
chd=t1:
|
Các loại mã đánh dấu ngữ cảnh
Loại bút đánh dấu | Giá trị chem giây |
Ví dụ: |
---|---|---|
Biến thể màu sắc | s=cm_color |
|
Biến thể kích thước | s=cm_size |
|
Biến thể về màu sắc và kích thước | s=cm_color_size |
|
Biến thể cách xếp chồng | s=cm_repeat |
|
Tính năng xếp chồng và biến đổi màu sắc | s=cm_repeat_color |
Chuỗi căn chỉnh cho biểu tượng theo bối cảnh
Các biểu tượng theo ngữ cảnh hỗ trợ chuỗi căn chỉnh tuỳ chọn để chỉ định cách căn chỉnh và bù trừ của biểu tượng với điểm dữ liệu. Chuỗi này có cú pháp như sau:
<alignment>[+/-<h_anchor_offset>+/-<v_anchor_offset>]
- alignment
- Hai chữ cái mô tả cách căn chỉnh của biểu tượng với điểm. Ví dụ:
tl
(trên cùng bên trái) vàrb
(dưới cùng bên phải). Hãy xem nội dung mô tả tham số alignment_string của thông sốchem
để biết nội dung mô tả và trang thông tin đầy đủ. - h_anchor_offset
- [Không bắt buộc] Độ lệch ngang của điểm neo, tính bằng pixel. Các giá trị bao gồm cả số 0 phải đứng sau dấu + hoặc -. Quan trọng: Bạn phải mã hoá url + dưới dạng %2B.
- v_anchor_offset
- [Không bắt buộc] Độ lệch dọc của điểm neo, tính bằng pixel. Các giá trị bao gồm cả số 0 phải đứng sau dấu + hoặc -. Quan trọng: Bạn phải mã hoá url + dưới dạng %2B.
Xin lưu ý rằng bạn cũng có thể dùng thành phần of
của tham số chem
để chỉ định độ dời theo chiều ngang và chiều dọc. Nếu bạn chỉ định cả thành phần of
và giá trị h_anchor_offset v_anchor_offset
, thì tất cả độ dời sẽ được áp dụng cho biểu tượng.
Ví dụ:
hb-0-0 Dưới cùng ở giữa theo chiều ngang Không có độ lệch |
lb-0-0 Dưới cùng bên trái Không có mức chênh lệch |
rb-0-0 Dưới cùng bên phải Không có độ lệch |
ht-0-0 Trên cùng theo chiều ngang Không có mức chênh lệch |
hb-20-0 Dưới cùng ở giữa theo chiều ngang -20 chiều ngang 0 chiều dọc |
hb%2b20-0 Ở dưới cùng ở giữa theo chiều ngang +20 chiều ngang 0 chiều dọc |
hb-0%2b10 Ở dưới cùng ở giữa theo chiều ngang 0 theo chiều ngang +10 chiều dọc |
hb-0-20 Dưới cùng ở giữa theo chiều ngang 0 theo chiều ngang -20 chiều dọc |
Biến thể màu (cm_color
)
Bạn có thể thay đổi màu của điểm đánh dấu biểu đồ theo ngữ cảnh theo điểm mà điểm đánh dấu đó đại diện. Bạn phải chỉ định một dải màu và giá trị dữ liệu sẽ được điều chỉnh theo tỷ lệ thành màu tương ứng trong dải màu đó.
Cú pháp
chem=y;s=cm_color;ds=<series_rendering_index>; ...other_values... ; d=<icon_shape>,<color_data_series>,<low_color>,<middle_color>,<high_color>,<icon_size>,<outline_color>,<alignment>
- <icon_shape>
- Biểu tượng cần sử dụng. Chỉ định một chuỗi mã nhận dạng một trong những hình ảnh liệt kê ở cuối trang.
- <color_data_series>
- Chỉ mục có gốc 0 của chuỗi dữ liệu được dùng để điều chỉnh màu của các biểu tượng.
- <low_color>
- Giá trị màu thấp trong dải ô, dưới dạng màu thập lục phân HTML gồm 3 hoặc 6 chữ số (không có dấu #). Giá trị này được liên kết với giá trị thấp nhất có thể trong dải ô dữ liệu có sẵn.
- <middle_color>
- Giá trị màu ở giữa trong dải ô, dưới dạng màu thập lục phân HTML gồm ba hoặc sáu chữ số (không có dấu #). Giá trị này được liên kết với giá trị ở giữa trong dải ô dữ liệu có sẵn.
- <high_color>
- Giá trị màu cao trong dải ô, ở dạng màu thập lục phân HTML gồm ba hoặc sáu chữ số (không có dấu #). Dữ liệu này được liên kết với giá trị cao nhất có thể trong phạm vi dữ liệu có sẵn.
- <icon_size>
- Kích thước của biểu tượng, tính bằng pixel. Các giá trị sau được hỗ trợ: 12, 16, 24.
- <outline_color>
- Màu đường viền của biểu tượng, dưới dạng màu thập lục phân HTML gồm 3 hoặc 6 chữ số (không có dấu #).
- <alignment>
- Một chuỗi không bắt buộc mô tả cách căn chỉnh và độ dời biểu tượng.
Ví dụ
|
chem=y;s=cm_color; |
Biến thể kích thước (cm_size
)
Bạn có thể thay đổi kích thước riêng của một điểm đánh dấu biểu đồ theo ngữ cảnh, theo chuỗi dữ liệu mà bạn chọn.
Cú pháp
chem=y;s=cm_size;ds=<series_rendering_index>; ...other_values... ; d=<icon_type>,<size_data_series>,<zero_value_size>,<size_multiplier>,<min_size>,<outline_color>,<fill_color>,<alignment>
- <icon_type>
- Hình dạng của biểu tượng. Chọn một trong các giá trị sau:
maps_pin
,disk
hoặcsquare
. - <size_data_series>
- Chỉ mục bắt đầu từ số 0 của chuỗi dữ liệu được dùng để thay đổi kích thước của các biểu tượng.
- <zero_value_size>
- Kích thước cơ sở của biểu tượng, ở giá trị dữ liệu tối thiểu cho chuỗi.
- <size_multiplier>
- Hệ số tỷ lệ kích thước. Giá trị này được nhân với chênh lệch giữa giá trị dữ liệu của mỗi biểu tượng và giá trị chuỗi tối thiểu để tính kích thước biểu tượng sau cùng. Do đó, một biểu tượng ở giá trị dữ liệu bằng 0 sẽ không chịu ảnh hưởng của hệ số này.
- <min_size> (kích thước tối thiểu)
- Kích thước tối thiểu cho mọi biểu tượng, tính bằng pixel.
- <outline_color>
- Màu đường viền của biểu tượng, dưới dạng màu thập lục phân HTML gồm 3 hoặc 6 chữ số (không có dấu #).
- <fill_color>
- Màu tô cho biểu tượng, dưới dạng màu thập lục phân HTML gồm 3 hoặc 6 chữ số (không có dấu #).
- <alignment>
- Một chuỗi không bắt buộc mô tả cách căn chỉnh và độ dời biểu tượng.
Ví dụ
Ví dụ cơ bản. Biểu tượng có giá trị bằng 0 hiển thị ở kích thước giá trị bằng 0, là 30 pixel. Kích thước tăng lên cùng với dữ liệu. | chd=t:0,10,20,30,40,50,60,70 |
Trong ví dụ này, các biểu tượng lấy dữ liệu kích thước từ đường màu vàng nhưng hiển thị trên đường màu xanh dương.
|
chem=chem=y;s=cm_size;ds=1;dp=all;d=maps_pin,0,10,90,10,8F8,000,hb |
Biến thể màu sắc và kích thước (cm_color_size
)
Bạn có thể thay đổi cả màu và kích thước của điểm đánh dấu biểu đồ theo ngữ cảnh, theo chuỗi dữ liệu mà bạn chọn.
Cú pháp
chem=y;s=cm_color_size;ds=<series_rendering_index>; ...other_values... ; d=<icon_type>,<color_data_series>,<low_color>,<middle_color>,<high_color>,<size_data_series>,<zero_value_size>,<size_multiplier>,<min_size>,<outline_color>,<alignment>
- <icon_type>
- Hình dạng của biểu tượng. Chọn một trong các giá trị sau:
maps_pin
,disk
hoặcsquare
. - <color_data_series>
- Chỉ mục có gốc 0 của chuỗi dữ liệu được dùng để điều chỉnh màu của các biểu tượng.
- <low_color>
- Giá trị màu thấp trong dải ô, dưới dạng màu thập lục phân HTML gồm 3 hoặc 6 chữ số (không có dấu #). Giá trị này được liên kết với giá trị thấp nhất có thể trong dải ô dữ liệu có sẵn.
- <middle_color>
- Giá trị màu ở giữa trong dải ô, dưới dạng màu thập lục phân HTML gồm ba hoặc sáu chữ số (không có dấu #). Giá trị này được liên kết với giá trị ở giữa trong dải ô dữ liệu có sẵn.
- <high_color>
- Giá trị màu cao trong dải ô, ở dạng màu thập lục phân HTML gồm ba hoặc sáu chữ số (không có dấu #). Dữ liệu này được liên kết với giá trị cao nhất có thể trong phạm vi dữ liệu có sẵn.
- <size_data_series>
- Chỉ mục bắt đầu từ số 0 của chuỗi dữ liệu được dùng để thay đổi kích thước của các biểu tượng.
- <zero_value_size>
- Kích thước cơ sở của biểu tượng, ở giá trị dữ liệu tối thiểu cho chuỗi.
- <size_multiplier>
- Hệ số tỷ lệ kích thước. Giá trị này được nhân với chênh lệch giữa giá trị dữ liệu của mỗi biểu tượng và giá trị chuỗi tối thiểu để tính kích thước biểu tượng sau cùng. Do đó, một biểu tượng ở giá trị dữ liệu bằng 0 sẽ không chịu ảnh hưởng của hệ số này.
- <min_size> (kích thước tối thiểu)
- Kích thước tối thiểu cho mọi biểu tượng, tính bằng pixel.
- <outline_color>
- Màu đường viền của biểu tượng, dưới dạng màu thập lục phân HTML gồm 3 hoặc 6 chữ số (không có dấu #).
- <alignment>
- Một chuỗi không bắt buộc mô tả cách căn chỉnh và độ dời biểu tượng.
Ví dụ
Ví dụ này sử dụng hai dòng. Các ghim sử dụng dữ liệu màu sắc từ chuỗi mà các thành phần hiển thị, nhưng sử dụng dữ liệu kích thước từ các chuỗi khác.
|
chd=s:0akAZtnkmi,nbMPJOKXXS |
Biến thể xếp chồng (cm_repeat
)
Bạn có thể thay đổi chiều cao của ngăn xếp biểu tượng theo giá trị dữ liệu tại một điểm cụ thể.
Cú pháp
chem=y;s=cm_repeat;ds=<series_rendering_index>; ...other_values... ; d=<icon_shape>,<repeat_series_index>,<scaling_factor>,<stacking_direction>,<icon_size>,<fill_color>,<outline_color>,<spacing>,<alignment>
- <icon_shape>
- Biểu tượng cần sử dụng. Chỉ định một chuỗi mã nhận dạng một trong những hình ảnh liệt kê ở cuối trang.
- <repeat_series_index>
- Chỉ mục bắt đầu từ số 0 của chuỗi dữ liệu được dùng để tính số lượng biểu tượng cần đặt tại thời điểm này.
- <scaling_factor> (hệ số tỷ lệ)
- Giá trị chuỗi dữ liệu nguồn được chia theo tỷ lệ từ 0 đến 1 rồi nhân với giá trị này để xác định số lượng điểm đánh dấu cần đặt tại điểm này. Một phần giá trị sẽ bị cắt bớt.
- <stacking_direction>
- Hướng xếp chồng: "h" (chữ thường) cho chiều ngang hoặc "V" (chữ hoa) cho chiều dọc.
- <icon_size>
- Kích thước của từng điểm đánh dấu, tính bằng pixel. Các giá trị sau được hỗ trợ: 12, 16, 24.
- <fill_color>
- Màu tô cho biểu tượng, dưới dạng màu thập lục phân HTML gồm 3 hoặc 6 chữ số (không có dấu #).
- <outline_color>
- Màu đường viền của biểu tượng, dưới dạng màu thập lục phân HTML gồm 3 hoặc 6 chữ số (không có dấu #).
- <spacing>
- Khoảng trống giữa mỗi điểm đánh dấu trong một ngăn xếp, tính bằng pixel.
- <alignment>
- Một chuỗi không bắt buộc mô tả cách căn chỉnh và độ dời biểu tượng.
Ví dụ
Ví dụ này sử dụng một chuỗi dữ liệu giả thứ hai. Khung hiển thị không được hiển thị trên biểu đồ, nhưng được dùng như một cách để sắp xếp đồng đều tất cả các ngăn xếp, bắt đầu từ cuối biểu đồ.
|
chd=s1:0akAZtnkmi,AAAAAAAAAA
|
Biến thể màu và xếp chồng (cm_repeat_color
)
Bạn có thể thay đổi cả chiều cao và màu của ngăn xếp biểu tượng, theo giá trị dữ liệu tại một điểm cụ thể.
Cú pháp
chem=y;s=cm_repeat_color;ds=<series_rendering_index>; ...other_values... ; d=<icon_shape>,<repeat_series_index>,<scaling_factor>,<stacking_direction>,<icon_size>,<color_data_series>,<low_color>,<middle_color>,<high_color>,<outline_color>,<spacing>,<alignment>
- <icon_shape>
- Biểu tượng cần sử dụng. Chỉ định một chuỗi mã nhận dạng một trong những hình ảnh liệt kê ở cuối trang.
- <repeat_series_index>
- Chỉ mục bắt đầu từ số 0 của chuỗi dữ liệu được dùng để tính số lượng biểu tượng cần đặt tại thời điểm này.
- <scaling_factor> (hệ số tỷ lệ)
- Giá trị chuỗi dữ liệu nguồn được chia theo tỷ lệ từ 0 đến 1 rồi nhân với giá trị này để xác định số lượng điểm đánh dấu cần đặt tại điểm này. Một phần giá trị sẽ bị cắt bớt.
- <stacking_direction>
- Hướng xếp chồng: "h" (chữ thường) cho chiều ngang hoặc "V" (chữ hoa) cho chiều dọc.
- <icon_size>
- Kích thước của từng điểm đánh dấu, tính bằng pixel. Các giá trị sau được hỗ trợ: 12, 16, 24.
- <color_data_series>
- Chỉ mục có gốc 0 của chuỗi dữ liệu được dùng để điều chỉnh màu của các biểu tượng.
- <low_color>
- Giá trị màu thấp trong dải ô, dưới dạng màu thập lục phân HTML gồm 3 hoặc 6 chữ số (không có dấu #). Giá trị này được liên kết với giá trị thấp nhất có thể trong dải ô dữ liệu có sẵn.
- <middle_color>
- Giá trị màu ở giữa trong dải ô, dưới dạng màu thập lục phân HTML gồm ba hoặc sáu chữ số (không có dấu #). Giá trị này được liên kết với giá trị ở giữa trong dải ô dữ liệu có sẵn.
- <high_color>
- Giá trị màu cao trong dải ô, ở dạng màu thập lục phân HTML gồm ba hoặc sáu chữ số (không có dấu #). Dữ liệu này được liên kết với giá trị cao nhất có thể trong phạm vi dữ liệu có sẵn.
- <outline_color>
- Màu đường viền của biểu tượng, dưới dạng màu thập lục phân HTML gồm 3 hoặc 6 chữ số (không có dấu #).
- <spacing>
- Khoảng trống giữa mỗi điểm đánh dấu trong một ngăn xếp, tính bằng pixel.
- <alignment>
- Một chuỗi không bắt buộc mô tả cách căn chỉnh và độ dời biểu tượng.
Ví dụ
|
chem= |