Định dạng dữ liệu

Tài liệu này giải thích cách gửi dữ liệu biểu đồ của bạn đến Google Chart API.

Mục lục

  1. Tổng quan
  2. Định dạng văn bản cơ bản
  3. Định dạng văn bản có thể tự động chuyển tỷ lệ
  4. Định dạng văn bản với tỷ lệ tuỳ chỉnh
  5. Định dạng mã hoá đơn giản
  6. Định dạng mã hoá mở rộng
  7. Mở rộng dữ liệu và mở rộng trục
  8. Tập lệnh mã hoá JavaScript

Tổng quan

Dữ liệu cho hầu hết tất cả các biểu đồ được gửi bằng cách sử dụng tham số chd. Dữ liệu phải được gửi ở một trong các định dạng sau:

  • Định dạng văn bản cơ bản về cơ bản là các số có dấu phẩy động đơn giản từ 0 đến 100. Định dạng này dễ đọc và viết bằng tay.
  • Định dạng văn bản có tính năng tự động điều chỉnh tỷ lệ biểu đồ sẽ điều chỉnh tỷ lệ cho phù hợp với dữ liệu.
  • Định dạng văn bản có tỷ lệ tuỳ chỉnh tương tự như định dạng văn bản cơ bản, nhưng cho phép bạn chỉ định một dải ô tuỳ chỉnh bằng cách sử dụng tham số URL thứ hai.
  • Định dạng mã hoá đơn giản cho phép bạn chỉ định các giá trị số nguyên từ 0 đến 61 (bao gồm cả 0 và 61) được mã hoá bằng một ký tự chữ-số duy nhất. Phương thức mã hoá này sẽ tạo ra chuỗi dữ liệu ngắn nhất trong mọi định dạng dữ liệu (nếu có giá trị lớn hơn 9).
  • Định dạng mã hoá mở rộng cho phép bạn chỉ định các giá trị số nguyên từ 0 đến 4095 (bao gồm cả 0 và 4095) được mã hoá bằng 2 ký tự chữ-số. Phương thức mã hoá mở rộng phù hợp nhất với biểu đồ có nhiều dữ liệu và phạm vi dữ liệu lớn.

Các giá trị dữ liệu được điều chỉnh theo tỷ lệ cho phù hợp với định dạng sử dụng. Hãy xem bài viết Chia tỷ lệ dữ liệu và Tỷ lệ trục để biết nội dung giải thích về cách thao tác dữ liệu cho phù hợp với biểu đồ.

Chúng tôi cung cấp một đoạn mã JavaScript để mã hoá dữ liệu thành mã hoá đơn giản hoặc định dạng mã hoá mở rộng. Ngoài ra, một số thành viên trong nhóm Google Biểu đồ đã đóng góp các thư viện khác để giúp định dạng: tìm kiếm các bản lưu trữ để tìm chúng.

Định dạng văn bản cơ bản

Dữ liệu định dạng văn bản cơ bản cho phép bạn chỉ định các giá trị dấu phẩy động từ 0 đến 100 (bao gồm cả 0 – 100) dưới dạng số. Các giá trị dưới 0 được đánh dấu là bị thiếu; các giá trị lớn hơn 100 sẽ bị cắt bớt còn 100. Ưu điểm của định dạng văn bản cơ bản là các giá trị dễ đọc và dễ hiểu trong URL, đồng thời các nhãn trục mặc định sẽ hiển thị chính xác giá trị dữ liệu. Tuy nhiên, việc định dạng văn bản (dù đơn giản hay với thông số tuỳ chỉnh) sẽ dẫn đến chuỗi dữ liệu dài nhất trong tất cả các định dạng.

Nếu dữ liệu của bạn chứa các giá trị nằm ngoài phạm vi đã chỉ định cho định dạng văn bản, thì bạn có thể điều chỉnh tỷ lệ dữ liệu bằng cách chuyển đổi dữ liệu đó thành tỷ lệ phần trăm của giá trị lớn nhất trong dữ liệu. Ngoài ra, bạn có thể sử dụng định dạng văn bản với tỷ lệ tuỳ chỉnh để xử lý việc chuyển tỷ lệ cho mình.

Cú pháp:

chd=t:val,val,val|val,val,val...
<data>
Mỗi chuỗi là một hoặc nhiều giá trị được phân tách bằng dấu phẩy. Phân tách nhiều chuỗi dữ liệu bằng dấu gạch đứng (|). Giá trị là các số có dấu phẩy động từ 0 đến 100. Các giá trị nhỏ hơn 0 hoặc ký tự dấu gạch dưới ( _ ) được coi là giá trị rỗng. Các giá trị lớn hơn 100 sẽ bị cắt bớt thành 100.

 

Ví dụ:

Một bảng có 5 giá trị. Dấu gạch dưới được coi là giá trị rỗng, giá trị -30 nằm dưới giá trị tối thiểu, nên sẽ bị loại bỏ và giá trị 200 bị cắt bớt còn 100. Biểu đồ thanh có 5 giá trị, mã hoá văn bản.
chd=t:_,30,-30,50,80,200

Trở lại đầu trang

Định dạng văn bản có tính năng chuyển tỷ lệ tự động

Bạn có thể định cấu hình một số biểu đồ để tự động điều chỉnh tỷ lệ cho phù hợp với dữ liệu của chúng. Biểu đồ sẽ được điều chỉnh theo tỷ lệ để giá trị lớn nhất nằm ở đầu biểu đồ và giá trị nhỏ nhất (hoặc 0, nếu tất cả các giá trị đều lớn hơn 0) sẽ ở dưới cùng.

Mọi giá trị điểm đánh dấu xuất hiện trên biểu đồ sẽ thể hiện giá trị thực tế của chúng, chứ không phải giá trị được điều chỉnh theo tỷ lệ.

Tính năng này chỉ hoạt động với các giá trị được định dạng văn bản và không hoạt động với tất cả các loại biểu đồ. Hãy thử nghiệm với loại biểu đồ của bạn để xem loại biểu đồ đó có được hỗ trợ hay không.

Cú pháp

cht=t:val,val,val...
chds=a

Ví dụ:


chd=t:5,30,50,80,200
chds=a

Lưu ý rằng biểu đồ hình tròn không nên sử dụng giá trị < 0 cho biểu đồ hình tròn.

 Biểu đồ thanh có 5 giá trị, mã hoá văn bản.
chd=t:-5,30,-30,50,80,200
chds=a

Trở lại đầu trang

Định dạng văn bản có tỷ lệ tuỳ chỉnh

Định dạng văn bản có tỷ lệ tuỳ chỉnh cho phép bạn chỉ định số dấu phẩy động dương hoặc âm tuỳ ý, kết hợp với tham số tỷ lệ cho phép bạn chỉ định một phạm vi tuỳ chỉnh cho biểu đồ của mình. Biểu đồ này rất hữu ích khi bạn không muốn lo lắng về việc giới hạn dữ liệu trong một phạm vi cụ thể, hoặc không muốn điều chỉnh tỷ lệ dữ liệu theo cách thủ công cho vừa khít với bên trong biểu đồ. Định dạng này sẽ điều chỉnh dòng 0 cho bạn khi cần. Định dạng của dữ liệu giống với định dạng văn bản cơ bản.

Để tự động chuyển tỷ lệ, hãy chỉ định chds=a.

Việc định dạng văn bản (dù đơn giản hay với thông số tuỳ chỉnh) sẽ dẫn đến chuỗi dữ liệu dài nhất trong tất cả các định dạng.

Cú pháp:

Việc định dạng văn bản với tỷ lệ tùy chỉnh yêu cầu 2 thông số:

chd=t:val,val,val|val,val,val
chds=<series_1_min>,<series_1_max>,...,<series_n_min>,<series_n_max>
chd=t:<data>
Giống như định dạng dữ liệu thuần tuý: một hoặc nhiều giá trị được phân tách bằng dấu phẩy cho mỗi chuỗi, nhiều chuỗi được phân tách bằng dấu gạch đứng (|). Phạm vi các giá trị được phép trong mỗi chuỗi được chỉ định bằng tham số chds.
Chds
Một tập hợp gồm một hoặc nhiều giá trị tối thiểu và tối đa được phép cho mỗi chuỗi dữ liệu, được phân tách bằng dấu phẩy. Bạn phải cung cấp cả giá trị tối đa và tối thiểu. Nếu bạn cung cấp ít cặp hơn số chuỗi dữ liệu có sẵn, thì cặp cuối cùng sẽ được áp dụng cho tất cả các chuỗi dữ liệu còn lại. Lưu ý rằng việc này không thay đổi phạm vi trục; để thay đổi phạm vi trục, bạn phải đặt tham số chxr. Các giá trị hợp lệ nằm trong khoảng từ (+/-)9,999e(+/-)199. Bạn có thể chỉ định các giá trị theo chuẩn hoặc ký hiệu E.
<series_1_min>
Giá trị tối thiểu được phép trong chuỗi đầu tiên. Các giá trị thấp hơn được đánh dấu là bị thiếu.
<series_1_max>
Giá trị tối đa được phép trong chuỗi đầu tiên. Các giá trị cao hơn bị cắt bớt thành giá trị này.

 

Ví dụ:

Biểu đồ thanh có thang đo tối thiểu/tối đa từ -80 đến 140. Các giá trị 30, -60, 50, 140 và 80 nằm trong thang đo nên sẽ không bị cắt bớt. Xin lưu ý rằng đường 0 sẽ được điều chỉnh theo ý bạn, 80/(140 + 80) = 0,36 so với trục y.

Ngoài ra, xin lưu ý rằng phạm vi trục y mặc định vẫn là 0 — 100, mặc dù có tham số chds, vì vậy, các giá trị nhãn không phản ánh các giá trị dữ liệu thực tế.

 Biểu đồ thanh có 5 giá trị, mã hoá văn bản với tỷ lệ dữ liệu.

chd=t:30,-60,50,140,80,-90
chds=-80,140

Trở lại đầu trang

Định dạng mã hoá đơn giản

Định dạng mã hoá đơn giản cho phép bạn chỉ định các giá trị số nguyên từ 0 đến 61 (bao gồm cả 0 và 61) được mã hoá bằng một ký tự chữ-số duy nhất. Điều này sẽ dẫn đến URL chuỗi dữ liệu ngắn nhất trong tất cả định dạng dữ liệu. Tuy nhiên, nếu có biểu đồ dạng đường hoặc biểu đồ thanh dài hơn 100 pixel dọc theo trục dữ liệu, bạn có thể sử dụng một định dạng khác. Lý do là vì chỉ có 62 giá trị dữ liệu được hỗ trợ, nên mức độ chi tiết của dữ liệu lớn hơn nhiều so với mức độ chi tiết của dữ liệu hiển thị và các giá trị sẽ giảm đi một chút (không nhiều, nhưng sẽ hiển thị trên các biểu đồ lớn hơn).

Xin lưu ý rằng nếu bạn sử dụng tham số chds bằng phương thức mã hoá đơn giản, thì kích thước phần tử dữ liệu trên biểu đồ sẽ không bị ảnh hưởng, nhưng mọi giá trị điểm đánh dấu điểm dữ liệu sẽ bị ảnh hưởng.

Cú pháp:

chd=s:
  <series_1>
    ,...,
  <series_n>
<loạt_1>
Một chuỗi, trong đó mỗi ký tự là một điểm dữ liệu duy nhất còn chuỗi được phân tách bằng dấu phẩy. Các giá trị riêng lẻ trong một chuỗi không được phân tách. Dưới đây là các ký tự dữ liệu được hỗ trợ và giá trị tương ứng của các ký tự đó:
  • A—Z, trong đó A = 0, B = 1, v.v. thành Z = 25
  • a—z, trong đó a = 26, b = 27, v.v. đến z = 51
  • 0(zero)—9, trong đó 0 = 52 và 9 = 61
  • Ký tự dấu gạch dưới (_) cho biết giá trị còn thiếu

Bạn có thể sử dụng công cụ sau đây để mã hoá một giá trị duy nhất hoặc mã JavaScript để điều chỉnh tỷ lệ và mã hoá toàn bộ chuỗi URL.

Ví dụ:

Tương đương với chuỗi được mã hoá văn bản chd=t:1,19,27,53,61,-1|12,39,57,45,51,27 <title="chs=320x200&cht=bvs&chd=s:btb19_,mn5tzb&chco=ffcc33,ffe9a4&chxr=0,0,61,5&chxt=y" alt="Biểu đồ thanh xếp chồng với hai chuỗi dữ liệu và mỗi giá trị 6 giá trị, mã hoá đơn giảnchd=s:BTb19_,Mn5tzb src="/static/images_33">

Trở lại đầu trang

Định dạng mã hoá mở rộng

Định dạng mã hoá mở rộng cho phép bạn chỉ định các giá trị số nguyên từ 0 – 4095 (kể cả 0 – 4095) được mã hoá bằng 2 ký tự chữ-số. Phương thức này sử dụng cú pháp hơi khác so với phương thức mã hoá đơn giản.

Xin lưu ý rằng nếu bạn sử dụng tham số chds bằng phương thức mã hoá đơn giản, thì kích thước phần tử dữ liệu trên biểu đồ sẽ không bị ảnh hưởng, nhưng mọi giá trị điểm đánh dấu điểm dữ liệu sẽ bị ảnh hưởng.

Cú pháp:

chd=e:
  <series_1>
    ,...,
  <series_n>
<loạt phim_1>
Một chuỗi, trong đó mỗi 2 ký tự là một điểm dữ liệu duy nhất, còn chuỗi được phân tách bằng dấu phẩy. Các giá trị riêng lẻ trong một chuỗi không được phân tách. Sau đây là các ký tự mã hoá được hỗ trợ:
  • A—Z
  • a—z
  • 0—9
  • kỳ (.)
  • dấu gạch nối (-)
  • Các giá trị bị thiếu được biểu thị bằng dấu gạch dưới đôi (__).

Dưới đây là nội dung mô tả rút gọn về các giá trị được mã hoá:

  • AA = 0, AB = 1, và cứ tiếp tục như vậy đến AZ = 25
  • Aa = 26, Ab = 27, và cứ tiếp tục như vậy đến Az = 51
  • A0 = 52, A1 = 53, v.v. cho A9 = 61
  • A- = 62, A. = 63
  • BA = 64, BB = 65, v.v. cho BZ = 89
  • Ba = 90, Bb = 91, v.v. cho Bz = 115
  • B0 = 116, B1 = 117, v.v. cho B9 = 125
  • B- = 126, B. = 127
  • 9A = 3904, 9B = 3905, v.v. cho đến 9Z = 3929
  • 9a = 3930, 9b = 3931, v.v. cho đến 9z = 3955
  • 90 = 3956, 91 = 3957, v.v. cho đến 99 = 3965
  • 9- = 3966, 9. = 3967
  • -A = 3968, -B = 3969, v.v. cho đến -Z = 3993
  • -a = 3994, -b = 3995, v.v. cho đến -z = 4019
  • -0 = 4020, -1 = 4021, v.v. cho đến -9 = 4029
  • -- = 4030, -. = 4031
  • .A = 4032, .B = 4033, v.v. cho đến .Z = 4057
  • .a = 4058, .b = 4059, v.v. cho đến .z = 4083
  • .0 = 4084, .1 = 4085, v.v. cho đến .9 = 4093
  • .- = 4094, .. = 4095

Bạn có thể sử dụng công cụ sau đây để mã hoá một giá trị duy nhất hoặc mã JavaScript để điều chỉnh tỷ lệ và mã hoá toàn bộ chuỗi URL.

Ví dụ:

Tương đương với chuỗi được mã hoá văn bản chd=t:90,1000,2700,3500|3968,-1,1100,250 Biểu đồ thanh xếp chồng có hai chuỗi gồm 4 giá trị, mỗi chuỗi mã hoá mở rộng.
chd=e:BaPoqM2s,-A__RMD6

Trở lại đầu trang

Mở rộng dữ liệu và mở rộng trục

Dữ liệu được điều chỉnh theo tỷ lệ để vừa với biểu đồ của bạn, một cách rõ ràng (khi sử dụng định dạng văn bản với tỷ lệ tuỳ chỉnh) hoặc ngầm ẩn (tất cả các loại khác). Tức là mỗi biểu đồ được điều chỉnh theo tỷ lệ để phù hợp với phạm vi có sẵn của định dạng, không phải phạm vi thực tế của dữ liệu mà bạn cung cấp.

Bạn nên điều chỉnh tỷ lệ dữ liệu sao cho dữ liệu trải rộng hết các giá trị mà định dạng của bạn cho phép, nhằm làm cho sự khác biệt trở nên rõ ràng hơn. Bạn có thể điều chỉnh tỷ lệ dữ liệu bằng cách điều chỉnh tỷ lệ dữ liệu cho phù hợp với định dạng mà bạn sử dụng, hoặc chỉ định rõ phạm vi dữ liệu (tức là sử dụng định dạng văn bản có khả năng điều chỉnh tỷ lệ tuỳ chỉnh).

Xin lưu ý rằng các giá trị nhãn trục được tính trên một thang đo hoàn toàn độc lập và không liên quan gì đến các giá trị dữ liệu, nhưng hãy sử dụng phạm vi mặc định từ 0 đến 100. Tuy nhiên, bạn có thể thay đổi phạm vi đó.

Phần này mô tả cả hai vấn đề này.

Dữ liệu được điều chỉnh theo tỷ lệ cho phù hợp với phạm vi định dạng [Tất cả biểu đồ, ngoại trừ biểu đồ hình tròn và biểu đồ Venn]

Các định dạng khác nhau sẽ hỗ trợ phạm vi giá trị khác nhau. Dữ liệu được điều chỉnh theo tỷ lệ theo phạm vi định dạng, để giá trị tối đa mà định dạng của bạn hỗ trợ hiển thị ở đầu trục đó, còn giá trị tối thiểu của định dạng sẽ hiển thị ở dưới cùng. Ví dụ sau đây cho thấy cùng một giá trị (100) sử dụng định dạng văn bản cơ bản (phạm vi từ 0 đến 100), văn bản có tỷ lệ tuỳ chỉnh (phạm vi tuỳ chỉnh từ 0 đến 200) và định dạng mã hoá mở rộng (phạm vi 0—4095).

Định dạng văn bản cơ bản Định dạng văn bản có tỷ lệ tuỳ chỉnh Định dạng mã hoá mở rộng
Biểu đồ thanh có văn bản cơ bản với tỷ lệ tuỳ chỉnh

Giá trị: 100 (chd=t:100)

Dải ô định dạng: 0-100

100 được hiển thị là 100/100 trên tỷ lệ.

Giá trị 100 (chd=t:100, chds=0,200)

Dải ô định dạng: 0-200

100 được kết xuất theo tỷ lệ 100/200.

Giá trị: 100 (chd=e:Bk)

Dải ô định dạng: 0 — 4095

100 được hiển thị là 100/4095 trên tỷ lệ.

Một cách dễ dàng để điều chỉnh tỷ lệ dữ liệu cho phù hợp với biểu đồ là sử dụng định dạng văn bản có khả năng điều chỉnh theo tỷ lệ. Một phương pháp liên quan hơn là điều chỉnh tỷ lệ dữ liệu theo cách thủ công cho vừa với phạm vi mà định dạng của bạn hỗ trợ.

Biểu đồ hình tròn và biểu đồ Venn: Với biểu đồ hình tròn và biểu đồ Venn, tất cả các giá trị đều tương ứng với nhau chứ không phải với tổng tỷ lệ của biểu đồ.

chd=e:BkDIEs chd=t:100,200,300
chds=0,300

Phạm vi nhãn của trục được tính toán độc lập [Thanh, Đường, Rađa, Tán xạ và Hình nến]

Bạn có thể chọn hiển thị các giá trị trục bằng cách sử dụng tham số chxt. Tuy nhiên, điều quan trọng cần lưu ý là các nhãn trục không được tính toán để phản ánh dữ liệu biểu đồ, mà được tính toán độc lập bởi API hoặc do bạn chỉ định rõ ràng.

Phạm vi trục mặc định là 0 đến 100, bất kể giá trị dữ liệu hoặc tỷ lệ dữ liệu. Ví dụ: nếu bạn hiển thị trục y bằng nhãn trục mặc định trên một biểu đồ sử dụng phương thức mã hoá mở rộng (phạm vi 0 — 4095), thì nhãn trục y vẫn sẽ đọc 0 — 100 trừ phi bạn thay đổi rõ ràng, như giải thích bên dưới. Dưới đây là ví dụ cho thấy các nhãn trục y mặc định trong một biểu đồ thanh mã hoá mở rộng với giá trị dữ liệu là 100:


chd=e:Bk (tương đương với chd=t:100)

Tuy nhiên, bạn có thể chỉ định phạm vi trục bằng cách sử dụng tham số chxr. Nếu muốn các giá trị trục phản ánh các giá trị dữ liệu thực tế, bạn phải chỉ định các giá trị trục tối thiểu và tối đa khớp với phạm vi định dạng của mình. Xin lưu ý rằng định dạng văn bản cơ bản đã có tỷ lệ từ 0 đến 100. Vì vậy, nếu bạn đang sử dụng định dạng văn bản cơ bản (không điều chỉnh tỷ lệ tuỳ chỉnh), thì các giá trị trục sẽ khớp với giá trị dữ liệu theo mặc định. Hãy cùng minh hoạ điều này bằng một vài ví dụ. Sau đây là 3 biểu đồ có cùng dữ liệu (15,26,51,61), nhưng khác định dạng và tỷ lệ trục:

Mã hoá đơn giản, không cần chuyển tỷ lệ trục Mã hoá đơn giản, Trục quy mô Văn bản cơ bản, không chuyển tỷ lệ trục

chd=s:Paz9
 

Phạm vi giá trị mã hoá đơn giản: 0 — 61

Phạm vi trục mặc định (0—100)

Phạm vi mã hoá nhỏ hơn phạm vi trục nhãn, vì vậy, các thanh không tương ứng với giá trị thực tế trên nhãn trục. Tuy nhiên, các thanh này sẽ được điều chỉnh theo tỷ lệ thích hợp.

chd=s:Paz9
    chxr=0,0,61,10

Phạm vi giá trị mã hoá đơn giản: 0 — 61

Phạm vi trục được đặt rõ ràng thành 0 — 61

Phạm vi mã hoá và phạm vi trục bằng nhau, vì vậy, các thanh sẽ tương ứng với giá trị chính xác trên trục.

chd=t:15,26,51,61
 

Phạm vi giá trị định dạng văn bản cơ bản: 0 — 100

Phạm vi trục mặc định (0—100)

Phạm vi mã hoá và phạm vi trục lại giống nhau, vì vậy, các giá trị dữ liệu chính xác sẽ hiển thị trên trục theo mặc định.

Vì phạm vi định dạng văn bản lớn hơn phạm vi của định dạng mã hoá đơn giản (100 đơn vị so với 61 đơn vị), nên các thanh sẽ nhỏ hơn so với trong các biểu đồ khác, nhưng tất cả các biểu đồ vẫn tỷ lệ với nhau.

Trở lại đầu trang

Tập lệnh mã hóa JavaScript

Để sử dụng trong thực tế, có lẽ bạn sẽ dễ dàng mã hoá dữ liệu theo phương thức lập trình hơn là theo cách thủ công.

Đoạn mã JavaScript sau đây mã hoá một chuỗi đơn thành chế độ mã hoá đơn giản hoặc extended rồi điều chỉnh tỷ lệ các giá trị dữ liệu cho phù hợp với toàn bộ phạm vi của bộ mã hoá đó. Bạn phải cung cấp dữ liệu dưới dạng một mảng số dương. Mọi giá trị đã cung cấp không phải là số dương sẽ được mã hoá thành giá trị bị thiếu bằng cách sử dụng ký tự dấu gạch dưới (_).

var simpleEncoding =
  'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';

// This function scales the submitted values so that
// maxVal becomes the highest value.
function simpleEncode(valueArray,maxValue) {
  var chartData = ['s:'];
  for (var i = 0; i < valueArray.length; i++) {
    var currentValue = valueArray[i];
    if (!isNaN(currentValue) && currentValue >= 0) {
    chartData.push(simpleEncoding.charAt(Math.round((simpleEncoding.length-1) *
      currentValue / maxValue)));
    }
      else {
      chartData.push('_');
      }
  }
  return chartData.join('');
}

// Same as simple encoding, but for extended encoding.
var EXTENDED_MAP=
  'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-.';
var EXTENDED_MAP_LENGTH = EXTENDED_MAP.length;
function extendedEncode(arrVals, maxVal) {
  var chartData = 'e:';

  for(i = 0, len = arrVals.length; i < len; i++) {
    // In case the array vals were translated to strings.
    var numericVal = new Number(arrVals[i]);
    // Scale the value to maxVal.
    var scaledVal = Math.floor(EXTENDED_MAP_LENGTH *
        EXTENDED_MAP_LENGTH * numericVal / maxVal);

    if(scaledVal > (EXTENDED_MAP_LENGTH * EXTENDED_MAP_LENGTH) - 1) {
      chartData += "..";
    } else if (scaledVal < 0) {
      chartData += '__';
    } else {
      // Calculate first and second digits and add them to the output.
      var quotient = Math.floor(scaledVal / EXTENDED_MAP_LENGTH);
      var remainder = scaledVal - EXTENDED_MAP_LENGTH * quotient;
      chartData += EXTENDED_MAP.charAt(quotient) + EXTENDED_MAP.charAt(remainder);
    }
  }

  return chartData;
}

Để mã hoá dữ liệu, hãy gọi hàm simpleEncode hoặc extendedEncode, truyền vào mảng chứa dữ liệu (valueArray) và giá trị lớn nhất của dữ liệu (maxValue). Để tạo một khoảng trống giữa giá trị cao nhất và đầu biểu đồ, hãy đặt maxValue lớn hơn số lớn nhất trong mảng dữ liệu như sau:

var valueArray = new Array(0,1,4,4,6,11,14,17,23,28,33,36,43,59,65);
var maxValue = 70;
simpleEncode(valueArray, maxValue);

Trở lại đầu trang