Biểu đồ bản đồ (Phiên bản không dùng nữa)

 

Cảnh báo thay thế: Biểu đồ bản đồ này đã được thay thế bằng phiên bản mới hơn.

Trang này mô tả cách tạo bản đồ được tô màu bằng API Biểu đồ.

Mục lục

Các tính năng dành riêng cho biểu đồ

  1. Tổng quan
  2. Quy tắc tiểu bang Hoa Kỳ

Tính năng tiêu chuẩn

  1. Tiêu đề biểu đồ (chtt, chts)
  2. Lề biểu đồ (chma)
  3. Chèn nền
    1. Solid Fills (chf) Đổ đầy chất rắn

Tổng quan

Bạn có thể tạo một bản đồ có nhiều quốc gia hoặc tiểu bang được đánh dấu bằng các màu tuỳ chỉnh. Để chỉ định một bản đồ, bạn sẽ chỉ định khu vực nào trên thế giới mà bản đồ sẽ phóng to. Bạn cũng sẽ chỉ định danh sách các khu vực sẽ được tô màu trên bản đồ và một danh sách dữ liệu song song gán một giá trị số cho mỗi quốc gia tương ứng. Mỗi quốc gia được tô màu theo một độ dốc, theo giá trị được gán cho quốc gia đó. Bạn có thể tuỳ ý chỉ định độ dốc màu tuỳ chỉnh cho các giá trị dữ liệu.

Biểu đồ bản đồ hỗ trợ các tham số sau:

Thông số Bắt buộc hoặc Không bắt buộc Nội dung mô tả
cht=t Bắt buộc Chỉ định một biểu đồ bản đồ.
chs Bắt buộc Kích thước bản đồ. Kích thước tối đa cho bản đồ là 440x220.
chtm=<zoom_area> Bắt buộc

Khu vực địa lý hiển thị trong biểu đồ.

  • zoom_area – Một trong những giá trị sau
    • africa
    • asia
    • europe
    • middle_east
    • south_america
    • usa
    • world
chld=<country_or_state_codes> Bắt buộc

Danh sách quốc gia hoặc tiểu bang mà bạn đang áp dụng giá trị.

  • mã quốc gia_hoặc_tiểu bang – Đây là một tập hợp các mã gồm hai ký tự, không có dấu phân cách ở giữa. Hãy sử dụng một trong những loại sau (bạn không thể kết hợp nhiều loại):

Ví dụ: chld=DZEGMG
chd=<country_values> Bắt buộc

Danh sách các giá trị song song với danh sách khu vực, trong đó giá trị áp dụng cho khu vực tương ứng. Giá trị là giá trị dữ liệu được định dạng chuẩn. Mỗi khu vực sẽ được gán một màu theo thang màu được chỉ định trong chco, trong đó giá trị thấp nhất trong dải ô áp dụng cho màu thấp nhất và giá trị cao nhất trong dải ô đó áp dụng cho màu cuối cùng.

  • country_values – Danh sách trong chuỗi định dạng thích hợp. Ví dụ: t:10,20,30, s:aU2Ff và e:BaPoqM-A.
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient> Không bắt buộc

Một dải màu tương ứng với giá trị dữ liệu thấp và cao của dải định dạng dữ liệu. Giá trị dữ liệu được chuyển đổi thành giá trị màu dọc theo độ dốc này và áp dụng cho các quốc gia tương ứng.

  • default_color – [Không bắt buộc] Màu của các khu vực chưa được chỉ định dữ liệu. Tuỳ chọn mặc định là BEBEBE (xám trung bình). Số thập lục phân ở định dạng RRGGBB.
  • start_of_gradient – [Không bắt buộc] Màu tương ứng với giá trị tối thiểu trong phạm vi định dạng dữ liệu. Giá trị mặc định là 0000FF (màu xanh dương). Số thập lục phân ở định dạng RRGGBB.
  • ... - [Không bắt buộc] Bạn có thể có bao nhiêu màu trung gian tùy thích.
  • end_of_gradient – [Không bắt buộc] Màu tương ứng với giá trị tối đa trong phạm vi định dạng dữ liệu. Mặc định là FF0000 (màu đỏ). Số thập lục phân ở định dạng RRGGBB
chtt, chts Không bắt buộc Tiêu đề và kiểu của biểu đồ
chma Không bắt buộc Lề biểu đồ
chf=bg Không bắt buộc Màu nền đồng nhất (chỉ nền)

 

Ví dụ

Nội dung mô tả Ví dụ:

Trong ví dụ này:

  • Khu vực thu phóng biểu đồ là Châu Phi (chtm=africa).
  • 3 quốc gia sẽ được chỉ định giá trị: Algeria, Ai Cập và Madagascar (chld=DZEGMG)
  • Ba giá trị được chỉ định cho các quốc gia đó lần lượt là 0, 100 và 50 (chd=t:0,100,50). Đây là giá trị tối thiểu, tối đa và trung bình cho dữ liệu định dạng văn bản.
  • Phạm vi màu là đỏ cho 0, xanh lục cho 100 và trắng cho các quốc gia chưa được chỉ định (chco=FFFFFF,FF0000,00FF00).
  • Biểu đồ cũng có nền màu xanh dương nhạt (chf=bg,s,EAF7FE).

Bản đồ Châu Phi
cht=t
chtm=africa
chld=DZEGMG
chd=t:0,100,50
chco=FFFFFF,FF0000,00FF00
chf=bg,s,EAF7FE

Biểu đồ này tương tự như biểu đồ trước nhưng có nhiều thông tin chi tiết hơn.

 Bản đồ Châu Phi
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

Biểu đồ này chỉ định việc không có quốc gia nào được đánh dấu bằng cách chỉ định một giá trị không xác định (chd=t:-1).

 Bản đồ thế giới
chs=440x220
chd=t:-1
cht=t
chtm=world

Trở lại đầu trang

Mã tiểu bang Hoa Kỳ

Dưới đây là các mã tiểu bang được hỗ trợ khi bản đồ được phóng to sang Hoa Kỳ (chld=usa).

AL Alabama Los Angeles Louisiana OH (OH) Ohio
AK (Bắc Macedonia) Alaska TÔI Maine OK Oklahoma
AZ (AZ) Arizona MD Maryland HOẶC Oregon
Thực tế tăng cường (AR) Arkansas MA (Morocco) Massachusetts PA Pennsylvania
CA California MI Michigan RI (Liban) Rhode Island
CO (Colombia) Colorado MN (Bắc Macedonia) Minnesota SC Nam Carolina
CT Connecticut MS Mississippi SD South Dakota
DE Delaware MO Missouri TN (Tunisia) Tennessee
FL (Liechtenstein) Florida MT Montana TX Texas
GA Gruzia ĐB Nebraska UT Utah
HI Hawaii NV Nevada Lưu lượng truy cập Vermont
Mã nhận dạng Idaho NH New Hampshire VA (Tòa Thánh Vatican) Virginia
IL Illinois NJ New Jersey WA Washington
Ấn Độ Indiana NM New Mexico WV (Tây Ban Nha) West Virginia
IA (IA) Iowa New York New York WI Wisconsin
KS (KS) Kansas NC North Carolina TH 4 Wyoming
Cayman Kentucky ND (Thuỵ Điển) North Dakota

Trở lại đầu trang

Tính năng tiêu chuẩn

Các tính năng còn lại trên trang này là các tính năng tiêu chuẩn của biểu đồ.

Tiêu đề biểu đồ chtt, chts [Tất cả biểu đồ]

Bạn có thể chỉ định văn bản tiêu đề, màu sắc và kích thước phông chữ cho biểu đồ của mình.

Cú pháp

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt – Chỉ định tiêu đề biểu đồ.

<chart_title>
Tiêu đề xuất hiện trên biểu đồ. Bạn không thể chỉ định vị trí xuất hiện phông chữ này, nhưng bạn có thể tuỳ ý chỉ định kích thước và màu phông chữ. Sử dụng dấu + để biểu thị dấu cách và dấu gạch đứng ( | ) để biểu thị dấu ngắt dòng.

 

chts [Không bắt buộc] – Màu và kích thước phông chữ cho tham số chtt.

<color>
Màu tiêu đề, ở định dạng thập lục phân RRGGBB. Màu mặc định là đen.
<font_size>
Cỡ chữ của tiêu đề, tính bằng điểm.
<opt_alignment>
[Không bắt buộc] Căn chỉnh tiêu đề. Chọn một trong các giá trị chuỗi có phân biệt chữ hoa chữ thường sau: "l" (bên trái), "c" (ở giữa) "r" (bên phải). Mặc định là "c".

 

Ví dụ

Nội dung mô tả Ví dụ:

Biểu đồ có tiêu đề, sử dụng màu và kích thước phông chữ mặc định.

Chỉ định một khoảng trắng có dấu cộng (+).

Sử dụng ký tự dấu gạch đứng (|) để buộc ngắt dòng.

chts không được chỉ định ở đây.

 Biểu đồ thanh dọc có tiêu đề
chtt=Site+visitors+by+month|
January+to+July

Biểu đồ có tiêu đề màu xanh dương, căn phải và gồm 20 điểm.

 Biểu đồ thanh dọc có màu xanh dương, 20 pixel, tiêu đề
chtt=Site+visitors
chts=FF0000,20,r

Trở lại đầu trang

Lề biểu đồ chma [Tất cả biểu đồ]

Bạn có thể chỉ định kích thước lề của biểu đồ, bằng pixel. Lề được tính toán vào trong của kích thước biểu đồ đã chỉ định (chs); việc tăng kích thước lề không làm tăng tổng kích thước biểu đồ, nhưng sẽ thu nhỏ vùng biểu đồ, nếu cần.

Theo mặc định, lề là bất kỳ phần nào còn lại sau khi tính toán kích thước biểu đồ. Giá trị mặc định này thay đổi theo loại biểu đồ. Lề mà bạn chỉ định là giá trị tối thiểu; nếu vùng biểu đồ chừa khoảng trống cho lề, thì kích thước lề sẽ là bất kỳ giá trị nào còn lại; bạn không thể ép lề nhỏ hơn kích thước yêu cầu cho bất kỳ chú giải và nhãn nào. Dưới đây là sơ đồ thể hiện các phần cơ bản của biểu đồ:

Lề biểu đồ, vùng chú giải và vùng biểu đồ

Lề trên biểu đồ bao gồm các nhãn trục và vùng hiển thị. Vùng chú giải sẽ tự động đổi kích thước để vừa với văn bản một cách chính xác, trừ phi bạn chỉ định chiều rộng lớn hơn bằng cách sử dụng chma. Trong trường hợp đó, vùng chú giải sẽ mở rộng kích thước lề rộng hơn, khiến vùng biểu đồ nhỏ hơn. Bạn không thể cắt chú giải bằng cách chỉ định kích thước quá nhỏ, nhưng bạn có thể làm cho chú giải chiếm nhiều dung lượng hơn mức cần thiết.

Mẹo: Trong biểu đồ thanh, nếu các thanh có kích thước cố định (mặc định) thì không thể giảm chiều rộng của vùng biểu đồ. Bạn phải chỉ định một kích thước thanh nhỏ hơn hoặc có thể đổi kích thước bằng chbh.

 

Cú pháp

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
<left_margin>, <left_margin>, <left_margin>, <left_margin>
Kích thước lề tối thiểu xung quanh vùng biểu đồ, tính bằng pixel. Tăng giá trị này để đưa vào một số khoảng đệm nhằm ngăn nhãn trục va vào đường viền của biểu đồ.
<opt_legend_width>, <opt_legend_height>
[Không bắt buộc] Chiều rộng của lề xung quanh phần chú giải, tính bằng pixel. Hãy sử dụng tính năng này để tránh để phần chú giải chạm vào vùng biểu đồ hoặc các cạnh của hình ảnh.

 

Ví dụ

Nội dung mô tả Ví dụ:

Trong ví dụ này, biểu đồ có lề tối thiểu là 30 pixel mỗi bên. Vì chú giải biểu đồ rộng hơn 30 pixel, nên lề ở bên phải được đặt thành chiều rộng của chú giải biểu đồ và khác với các lề khác.

Nhãn trục nằm ngoài vùng biểu đồ nên được vẽ trong không gian lề.

Biểu đồ dạng đường có nền màu xám và lề ở mỗi bên.
chma=30,30,30,30

Để thêm lề xung quanh chú giải, hãy đặt giá trị cho thông số <opt_legend_width> và <opt_legend_height>.

Trong ví dụ này, chú giải có chiều rộng khoảng 60 pixel. Nếu bạn đặt <opt_legend_width> thành 80 pixel, thì lề sẽ mở rộng ra 20 pixel bên ngoài chú giải.

Biểu đồ dạng đường có nền màu xám và lề ở mỗi bên.
chma=20,20,20,30|80,20

Trở lại đầu trang

Lấp đầy nền chf [Tất cả biểu đồ]

Bạn có thể chỉ định màu nền và kiểu cho vùng dữ liệu biểu đồ và/hoặc toàn bộ nền của biểu đồ. Các loại màu nền bao gồm màu nền đồng nhất, màu nền có sọc và màu chuyển tiếp. Bạn có thể chỉ định các màu nền khác nhau cho các phần khác nhau (ví dụ: toàn bộ khu vực biểu đồ hoặc chỉ vùng dữ liệu). Màu tô vùng biểu đồ sẽ ghi đè màu nền. Tất cả màu nền được chỉ định bằng tham số chf và bạn có thể kết hợp nhiều loại màu nền (màu đậm, màu sọc, màu chuyển tiếp) trong cùng một biểu đồ bằng cách phân tách các giá trị bằng ký tự dấu gạch đứng ( | ). Màu nền của biểu đồ sẽ thay thế màu nền của biểu đồ.

Lấp đầy chf [Tất cả biểu đồ]

Bạn có thể chỉ định một màu nền đồng nhất cho nền và/hoặc vùng biểu đồ, hoặc chỉ định một giá trị trong suốt cho toàn bộ biểu đồ. Bạn có thể chỉ định nhiều màu nền bằng cách sử dụng ký tự dấu gạch đứng (|). (Maps: chỉ nền).

Cú pháp

chf=<fill_type>,s,<color>|...
<fill_type>
Phần biểu đồ được điền. Hãy chỉ định một trong các giá trị sau:
  • bg – Màu nền
  • c – Điền vùng biểu đồ. Không hỗ trợ biểu đồ bản đồ.
  • a – Hiển thị toàn bộ biểu đồ (bao gồm cả nền). Sáu chữ số đầu tiên của <color> sẽ bị bỏ qua và chỉ có hai chữ số cuối cùng (giá trị trong suốt) được áp dụng cho toàn bộ biểu đồ và tất cả các màu được điền.
  • b<index> - Thanh tô màu đồng nhất (chỉ dành cho biểu đồ thanh). Thay thế <index> bằng chỉ mục chuỗi của các thanh để tô một màu đồng nhất. Hiệu ứng này tương tự như việc xác định chco trong biểu đồ thanh. Hãy xem phần Màu của chuỗi biểu đồ thanh để biết ví dụ.
s
Thể hiện trạng thái lấp đầy đồng nhất hoặc trong suốt.
<color>
Màu tô, ở định dạng thập lục phân RRGGBB. Đối với giá trị trong suốt, 6 chữ số đầu tiên sẽ bị bỏ qua, nhưng bạn vẫn phải đưa vào.

 

Ví dụ

Nội dung mô tả Ví dụ:

Ví dụ này lấp đầy nền biểu đồ bằng màu xám nhạt (EFEFEF).

Biểu đồ dạng đường màu đỏ với vùng tô màu đen.

chf=bg,s,EFEFEF

Ví dụ này tô nền biểu đồ bằng màu xám nhạt (EFEFEF) và tô màu biểu đồ bằng màu đen (000000).

Biểu đồ dạng đường màu đỏ với vùng biểu đồ màu đen và nền xám nhạt.

chf=c,s,000000|
bg,s,EFEFEF
Ví dụ này áp dụng độ trong suốt 50% cho toàn bộ biểu đồ (80 ở hệ thập lục phân là 128, hoặc độ trong suốt khoảng 50%). Hãy lưu ý nền của ô trong bảng đang hiện qua biểu đồ.

Biểu đồ tán xạ với các điểm có màu xanh dương và độ trong suốt 50%.

chf=a,s,00000080

Trở lại đầu trang

Định dạng màu

Chỉ định màu bằng cách sử dụng một chuỗi gồm 6 ký tự gồm các giá trị thập lục phân, cùng với hai giá trị trong suốt không bắt buộc, ở định dạng RRGGBB[AA]. Ví dụ:

  • FF0000 = Đỏ
  • 00FF00 = Xanh lục
  • 0000FF = Xanh lam
  • 000000 = Đen
  • FFFFFF = Màu trắng

AA là một giá trị độ trong suốt không bắt buộc, trong đó 00 hoàn toàn trong suốt và FF hoàn toàn mờ đục. Ví dụ:

  • 0000FFFF = Màu xanh lam đồng nhất
  • 0000FF66 = Màu xanh lam trong suốt

Trở lại đầu trang