Câu hỏi thường gặp

Bắt đầu

GoogleVisual API là gì?
Google trực quan hoá API cho phép bạn tạo biểu đồ và các ứng dụng báo cáo thông qua dữ liệu có cấu trúc, đồng thời giúp tích hợp trực tiếp những dữ liệu này vào trang web của bạn.
Tôi có thể làm gì với API Hình ảnh hoá?
Với Google trực quan hoá API, bạn có thể truy cập vào dữ liệu có cấu trúc (được tạo cục bộ trong trình duyệt) hoặc truy xuất dữ liệu đó từ các nguồn dữ liệu được hỗ trợ ở định dạng bảng đơn giản. Bạn cũng có thể triển khai nguồn dữ liệu của riêng mình làm nguồn dữ liệu của API Trực quan hoá và cho phép mọi hình ảnh và/hoặc ứng dụng tuân thủ hình ảnh trực quan hoá truy cập vào dữ liệu của bạn. Người dùng có thể sử dụng định dạng này trong các ứng dụng báo cáo, phân tích hoặc biểu đồ. Do đó, bạn có thể trực quan hoá dữ liệu và/hoặc thêm chức năng mới vào các ứng dụng, chẳng hạn như Bảng tính Google.
Tôi có thể tìm tài liệu về API Hình ảnh hoá ở đâu?
Bạn có thể tìm thấy hướng dẫn cho nhà phát triển và mọi tài liệu khác có liên quan tại https://developers.google.com/chart/interactive/docs.
Làm cách nào để tạo một Biểu đồ mới?
Cách tốt nhất để bắt đầu là đọc phần Giới thiệu và phần Bắt đầu nhanh.
URL nguồn dữ liệu là gì?
URL nguồn dữ liệu là giá trị nhận dạng URL duy nhất của nguồn dữ liệu API Hình ảnh hoá. URL nguồn dữ liệu cũng có thể bao gồm các tham số Ngôn ngữ truy vấn của biểu đồ. Trong trường hợp này, một truy vấn (chẳng hạn như sắp xếp, nhóm, v.v.) sẽ được thực hiện trên nguồn dữ liệu trước khi tìm nạp dữ liệu.
Tôi có thể tìm mã mẫu của ứng dụng Biểu đồ bằng API Hình ảnh ở đâu?
Bạn có thể tìm thấy mã mẫu trong tài liệu về mã ví dụ của API Hình ảnh hoá.
Ứng dụng Flash có thể truy cập API Hình ảnh hoá không?
Hoàn toàn có thể. API Hình ảnh hoá sử dụng API JavaScript, nhưng có một số thư viện cho phép ứng dụng Flash kết nối với mã JavaScript. Bạn có thể tìm thấy một thư viện như vậy mà bạn có thể thấy hữu ích tại http://code.google.com/p/swfobject. Hãy xem bên dưới để biết một số vấn đề phát triển ảnh hưởng đến Flash.
Làm cách nào để triển khai một nguồn dữ liệu?
Đọc phần sử dụng và tạo biểu đồ để tìm hiểu cách hoạt động của biểu đồ, sau đó đọc bài viết Triển khai nguồn dữ liệu để tìm hiểu cách tạo nguồn dữ liệu. Bạn cũng có thể dùng thư viện Java nguồn dữ liệu của Google Biểu đồ để bắt đầu nhanh chóng nếu sử dụng Java.
Tôi có thể truy cập biểu đồ từ ứng dụng Java không?
Có. Thư viện Hình ảnh hoá của Google dành cho Bộ công cụ Web của Google (GWT) cho phép bạn truy cập hình ảnh trực quan hoá tuân thủ API từ mã Java được biên dịch bằng trình biên dịch GWT và viết hình ảnh trực quan hoá tuân thủ API Hình ảnh hoá trong Java bằng trình biên dịch GWT. Thư viện bản phát hành dùng thử cũng hỗ trợ mô hình sự kiện của Visual API (API Hình ảnh).
Tôi có thể truy cập biểu đồ từ ứng dụng được viết bằng trình biên dịch Bộ công cụ web của Google (GWT) không?
Có. Thư viện Hình ảnh hoá của Google dành cho Bộ công cụ Web của Google (GWT) cho phép bạn truy cập hình ảnh trực quan hoá tuân thủ API từ mã Java được biên dịch bằng trình biên dịch GWT và viết hình ảnh trực quan hoá tuân thủ API Hình ảnh hoá trong Java bằng trình biên dịch GWT. Thư viện bản phát hành dùng thử cũng hỗ trợ mô hình sự kiện của Visual API (API Hình ảnh).
Tôi có câu hỏi/vấn đề khác, tôi nên liên hệ với ai để biết thêm thông tin?
Vui lòng đăng câu hỏi của bạn trong nhóm thảo luận về API Hình ảnh hoá của Google để nhận trợ giúp từ cộng đồng nhà phát triển Hình ảnh hoá. Nhóm Google Trực quan hoá cũng tham gia nhóm này để trả lời các câu hỏi.

Sử dụng API

Sự khác biệt giữa API Google Biểu đồ và API Trực quan hoá của Google là gì?

API Biểu đồ cung cấp một cách đơn giản để tạo nhiều loại biểu đồ hình ảnh bằng cách gửi một URL được định dạng bao gồm cả các tùy chọn cấu hình biểu đồ và dữ liệu đến máy chủ của Google. API Biểu đồ bao gồm một tập hợp các biểu đồ khép kín với nhiều lựa chọn. Tập dữ liệu API Biểu đồ bị giới hạn ở kích thước của một URL (khoảng 2K).

API Trực quan hoá cung cấp một cách thức kết nối các biểu đồ và nguồn dữ liệu qua web cũng như để xuất bản những biểu đồ và nguồn dữ liệu đó:

  • API Hình ảnh hoá cung cấp API JavaScript để truy cập vào biểu đồ.
  • Thư viện biểu đồ của công cụ này bao gồm các biểu đồ do Google tạo. Ngoài ra, thư viện này cũng cho phép bất kỳ bên thứ ba nào tạo hình ảnh trực quan tương thích với Giao thức trực quan hoá của riêng họ.
  • Biểu đồ và biểu đồ của API Trực quan hoá có thể là bất kỳ nội dung nào mà trình duyệt hiển thị. Dữ liệu này bao gồm hình ảnh, JavaScript, đồ hoạ vectơ, Flash, v.v.
  • Một số lượng đáng kể biểu đồ API của Biểu đồ có thể truy cập được thông qua API Hình ảnh, mặc dù một số tuỳ chọn cấu hình của các biểu đồ này có thể không có sẵn.
  • API này cũng cung cấp giao thức dây được ghi chép và cách để mọi người hiển thị nguồn dữ liệu của họ cho bất kỳ hình ảnh API nào.
  • API này có một mô hình sự kiện được xác định cho phép các biểu đồ gửi và nhận sự kiện, từ đó giao tiếp với trang lưu trữ và/hoặc các biểu đồ khác trên trang.
Tôi có thể truy cập vào những nguồn dữ liệu nào bằng API Hình ảnh hoá?
Với API Hình ảnh hoá, bạn có thể truy cập vào dữ liệu cục bộ từ trình duyệt của mình bằng cách tạo định dạng DataTable chuẩn của API hoặc truy cập vào bất kỳ nguồn dữ liệu nào hỗ trợ API. Một số ứng dụng nổi tiếng đã hỗ trợ API này là Bảng tính Google và Salesforce.com trên nền tảng dành cho nhà phát triển Force.com. Bạn cũng có thể triển khai dữ liệu của riêng mình dưới dạng nguồn dữ liệu Biểu đồ.
Ứng dụng của tôi yêu cầu dữ liệu mà ứng dụng nhận được ở một định dạng cụ thể. Làm cách nào để xử lý các ngoại lệ?
Bạn có thể sử dụng phương thức getNumberOfColumns() và getColumnType() của lớp google.visualization.DataTable để kiểm tra xem dữ liệu bạn nhận được có khớp với dữ liệu bạn mong đợi hay không và đưa ra thông báo lỗi cho các trường hợp không khớp.
Nhúng biểu đồ vào trang web của tôi có an toàn không?
Việc chạy mã của bên thứ ba trực tiếp trên trang web của bạn cũng gây ra rủi ro tiềm ẩn. Google không hứa hẹn hay tuyên bố về hiệu suất, chất lượng, tính bảo mật hoặc nội dung của ứng dụng. Các ứng dụng biểu đồ không tuân thủ Điều khoản dịch vụ của Google Optimization API (Điều khoản dịch vụ) của Google Optimization API có thể bị xoá khỏi thư viện.
Tôi có thể sử dụng biểu đồ khi không có mạng không?
Máy tính của người dùng phải có quyền truy cập vào https://www.gstatic.com/charts/Loader.js để sử dụng các tính năng tương tác của Google Biểu đồ. Điều này là do các thư viện hình ảnh mà trang của bạn yêu cầu sẽ được tải động trước khi bạn sử dụng. Mã để tải thư viện thích hợp là một phần của tập lệnh đi kèm và được gọi khi bạn gọi phương thức google.charts.load(). Điều khoản dịch vụ của chúng tôi không cho phép bạn tải mã google.charts.load hoặc google.visualization xuống để sử dụng khi không có mạng.
Tôi có thể tải xuống và lưu trữ mã biểu đồ trên thiết bị hoặc trên mạng nội bộ không?
Rất tiếc, điều khoản dịch vụ của chúng tôi không cho phép bạn tải xuống và lưu hoặc lưu trữ mã google.charts.load hoặc google.visualization. Tuy nhiên, nếu không cần tính tương tác của Google Biểu đồ, bạn có thể chụp ảnh màn hình biểu đồ và sử dụng chúng nếu muốn.

Khắc phục sự cố

Tại sao biểu đồ của tôi không xuất hiện?

Trước tiên, hãy kiểm tra bảng điều khiển JavaScript của bạn. Trên Chrome, bạn có thể truy cập vào Bảng điều khiển JavaScript qua Chrome->Xem->Nhà phát triển->Bảng điều khiển JavaScript, hoặc Chrome->Công cụ->Bảng điều khiển JavaScript. Tất cả trình duyệt hiện đại đều có bảng điều khiển JavaScript; bạn có thể cần phải kiểm tra các trình đơn có tên như "Nâng cao" hoặc "Công cụ dành cho nhà phát triển" để tìm bảng điều khiển này.

Hy vọng rằng bảng điều khiển sẽ dẫn bạn ngay đến sự cố. Tuy nhiên, đôi khi rất khó để chuyển thông báo trên bảng điều khiển sang nguyên nhân cơ bản. Dưới đây là một số lỗi thường gặp:

  • Có thể bạn đang sử dụng Trình tải của Google không đúng cách.
    • Chỉ tải biểu đồ/loader.js một lần. Bất kể bạn có bao nhiêu biểu đồ trên trang web, bạn chỉ nên có một và chỉ một lệnh gọi như sau: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Lệnh gọi này có thể hiển thị trong phần đầu hoặc phần nội dung của trang web, tuỳ thuộc vào thời điểm bạn muốn tải diễn ra.
    • Tốt nhất là chỉ gọi google.charts.load một lần, với tất cả các gói bạn cần cho trang web của mình. 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
<script>
  google.charts.load("current", {packages: ["corechart", "timeline"]});

  google.charts.setOnLoadCallback(drawBarChart1);
  function drawBarChart1() {
    ...
    var barChart1 = new google.visualization.BarChart(document.getElementById('chart1'));
    ...
  }

  google.charts.setOnLoadCallback(drawBarChart2);
  function drawBarChart2() {
    ...
    var barChart2 = new google.visualization.BarChart(document.getElementById('chart2'));
    ...
  }

  google.charts.setOnLoadCallback(drawTimeline);
  function drawTimeline() {
    ...
    var timeline = new google.visualization.Timeline(document.getElementById('chart3'));
    ...
  }

</script>
<div id="chart1"></div>
...
<div id="chart2"></div>
...
<div id="chart3"></div>
  • Mỗi biểu đồ phải có một mã phần tử duy nhất (ví dụ: chart1, chart2 trong ví dụ trên).
  • Tìm lỗi chính tả. Hãy nhớ rằng JavaScript là ngôn ngữ phân biệt chữ hoa chữ thường.

Nếu bạn vẫn còn bối rối, hãy tìm kiếm trong nhóm thảo luận API Google Hình ảnh trực quan để xem có ai gặp vấn đề tương tự hay không. Nếu bạn không tìm thấy bài đăng nào giải đáp thắc mắc của mình, hãy đăng câu hỏi lên nhóm kèm theo đường liên kết đến trang web minh hoạ vấn đề. Nếu có thể, hãy bao gồm jsfiddle.

Tại sao các tháng và ngày của tôi được nghỉ một lần?
Google Biểu đồ sử dụng JavaScript trong đó sử dụng cơ chế lập chỉ mục dựa trên 0. Ngày đầu tiên của tháng là 0 và các tháng dao động từ 0 (tháng 1) đến 11 (tháng 12). Nếu mã của bạn giả định lập chỉ mục dựa trên một cơ sở, hãy trừ đi một trước khi đưa dữ liệu vào đối tượng ngày JavaScript.
Tại sao các biểu đồ của tôi hoạt động trong một số trình duyệt, nhưng không phải tất cả?
Bạn nên truy cập caniuse.com để tham khảo nhiều thông tin về việc trình duyệt không tương thích. Với Google Biểu đồ, đôi khi xảy ra sự cố trong Internet Explorer 8 trở xuống, vì hai lý do:
  • IE8 không hỗ trợ SVG nên Biểu đồ sẽ gặp lỗi trong VML, hạn chế hơn.
  • JavaScript của IE8 không cho phép dấu phẩy theo sau trong danh sách.
    • Tại sao biểu đồ dựa trên Flash của tôi không xuất hiện khi tôi đang thử nghiệm?
    Do chế độ cài đặt bảo mật Flash, các biểu đồ dựa trên Flash có thể không hoạt động chính xác khi được truy cập từ một vị trí tệp trong trình duyệt (ví dụ: file:///c:/webhost/myhost/myviz.html) thay vì từ URL máy chủ web (ví dụ: http://www.myhost.com/myviz.html). Đây thường chỉ là vấn đề kiểm thử; không phải là vấn đề khi bạn truy cập biểu đồ từ địa chỉ http://. Bạn có thể khắc phục sự cố này như mô tả trên trang web Macromedia. Nói chung, bạn nên tránh phát triển Flash khi có thể.

    Chính sách chương trình của Google Trực quan hoá

    Chính sách chương trình của Google Trực quan hoá là gì?
    Như mô tả trong Điều khoản dịch vụ, chúng tôi có thể từ chối cung cấp và hiển thị nội dung vi phạm chính sách chương trình của chúng tôi bằng cách hiển thị hoặc liên kết đến:
    • Nội dung bất hợp pháp.
    • Xâm phạm quyền riêng tư cá nhân.
    • Nội dung khiêu dâm hoặc tục tĩu.
    • Nội dung, chẳng hạn như mã độc hại, can thiệp hoặc gây hại cho máy tính của người dùng hoặc hoạt động của trang web lưu trữ.
    • Kích động thù địch hoặc kích động bạo lực.
    • Vi phạm bản quyền. Vui lòng xem chính sách DMCA của chúng tôi để biết thêm thông tin.
    • Vi phạm nhãn hiệu.
    • Mạo danh bên thứ ba.

    Các nhà phát triển tạo biểu đồ thu thập dữ liệu, đồng ý duy trì và liên kết với một chính sách quyền riêng tư thoả đáng về mặt pháp lý. Ngoài ra, chúng tôi yêu cầu nhà phát triển phải đảm bảo biểu đồ của họ bảo mật và duy trì ứng dụng miễn là biểu đồ đó nằm trong thư mục biểu đồ.

    Các chính sách này có thể được sửa đổi tuỳ từng thời điểm mà không cần thông báo.

    API Trực quan hoá của Google có dùng được cho mục đích thương mại không?
    Có. Để tìm hiểu thêm về các văn bản chi tiết, vui lòng tham khảo Điều khoản dịch vụ của API Google Vị trí.
    Tôi có thể sử dụng API Trực quan hoá của Google để tạo phần mềm phía máy khách không?
    Hiện tại, chúng tôi không cho phép nhà phát triển sử dụng API Hình ảnh để tạo phần mềm phía máy khách. Bạn chỉ có thể sử dụng API Hình ảnh hoá thông qua giao diện được cung cấp. Để tìm hiểu thêm, vui lòng tham khảo Điều khoản dịch vụ của API Google trực quan hoá.
    Google có ghi lại tất cả dữ liệu biểu đồ của tôi không?
    Dữ liệu biểu đồ trong yêu cầu HTTP được lưu trong nhật ký tạm thời trong tối đa 2 tuần cho mục đích kiểm thử và gỡ lỗi nội bộ. Tất nhiên, bạn nên hiểu rằng nếu biểu đồ của bạn xuất hiện trong một thẻ hình ảnh trên một trang web công khai, thì Google có thể thu thập dữ liệu biểu đồ đó.
    Vi phạm chính sách chương trình.
    Việc vi phạm các Chính sách chương trình này có thể dẫn đến việc vô hiệu hoá hoặc xoá biểu đồ của bạn, bị liệt vào danh sách đen và không được tải các biểu đồ lên trong tương lai, chấm dứt Tài khoản Google của bạn và/hoặc xoá tất cả biểu đồ.

    Hoạt động tích cực trong cộng đồng

    Làm cách nào để chia sẻ đơn đăng ký Biểu đồ của tôi với người khác?
    Bắt đầu bằng cách đặt biểu đồ của bạn trên Thư viện biểu đồ. Bạn có thể liên kết lại trang web của mình và cung cấp mã nguồn nếu muốn. Hãy tham gia nhóm thảo luận của chúng tôi để nhận ý kiến phản hồi của cộng đồng.
    Thư viện biểu đồ là danh sách các ứng dụng sử dụng API Hình ảnh. Nền tảng này cung cấp một vị trí trung tâm cho cộng đồng các nhà phát triển Hình ảnh trực quan để chia sẻ các ứng dụng Biểu đồ. Để gửi ứng dụng biểu đồ cho thư viện, hãy đăng ký trực tuyến.
    Làm cách nào để quảng bá nguồn dữ liệu Biểu đồ của tôi?
    Đăng phương thức triển khai của bạn lên Nhóm trực quan hoá. Nếu thích, chúng tôi thậm chí có thể tự đề cập đến nó.