Trang này được dịch bởi Cloud Translation API.

Câu hỏi thường gặp

Bắt đầu
Sử dụng API
Khắc phục sự cố
Chính sách về API Hình ảnh trực quan của Google
Trở nên tích cực trong cộng đồng

Bắt đầu

API Hình ảnh trực quan của Google là gì?: API Hình ảnh của Google cho phép bạn tạo biểu đồ và báo cáo ứng dụng qua dữ liệu có cấu trúc, đồng thời giúp tích hợp trực tiếp các 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?: Thông qua API Hình ảnh trực quan của Google, 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 của mình hoặc được truy xuất từ những 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 API Hình ảnh và cho phép mọi hình ảnh và/hoặc ứng dụng tuân thủ Hình ảnh trực quan truy cập vào dữ liệu của bạn. Định dạng này cho phép sử dụng bằng cách báo cáo, phân tích hoặc lập biểu đồ các ứng dụng. 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 cho API Hình ảnh ở đâu?: Bạn có thể tìm hướng dẫn cho nhà phát triển và tất cả tài liệu có liên quan khác tại https://developers.google.com/Chart/interactive/docs.
Làm cách nào để tạo 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. URL nguồn dữ liệu cũng có thể bao gồm các tham số Ngôn ngữ truy vấn trong biểu đồ. Trong trường hợp này, truy vấn (chẳng hạn như sắp xếp, nhóm, v.v.) đượ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ã ví dụ của các ứ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ụ về API Hình ảnh trực quan.
Ứng dụng Flash có thể truy cập API Hình ảnh không?: Hoàn toàn có thể. API Hình ảnh sử dụng API JavaScript, nhưng có những 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 hữu ích tại http://code.google.com/p/swfobject. Xem phần dưới đây để 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 nguồn dữ liệu?: Hãy đọc phần sử dụng và tạo một biểu đồ để tìm hiểu cách hoạt động của các 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 của Nguồn dữ liệu cho biểu đồ của Google để bắt đầu nhanh nếu bạn 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 hóa của Google cho Bộ công cụ web của Google (GWT) cho phép bạn truy cập vào hình ảnh 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 hóa tuân thủ API hình ảnh hóa trong Java bằng cách sử dụng trình biên dịch GWT. Thư viện đề xuất phát hành cũng hỗ trợ mô hình sự kiện API hình ảnh.
Tôi có thể truy cập biểu đồ từ mộ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 hóa của Google cho Bộ công cụ web của Google (GWT) cho phép bạn truy cập vào hình ảnh 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 hóa tuân thủ API hình ảnh hóa trong Java bằng cách sử dụng trình biên dịch GWT. Thư viện đề xuất phát hành cũng hỗ trợ mô hình sự kiện 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 của Google để nhận trợ giúp từ cộng đồng nhà phát triển về Hình ảnh trực quan. Nhóm Google Hình ảnh cũng tham gia vào nhóm này để trả lời câu hỏi.

Sử dụng API

Sự khác biệt giữa API biểu đồ của Google và API hình ảnh của Google là gì?

Graph API (API biểu đồ) cung cấp một cách đơn giản để tạo các biểu đồ hình ảnh thuộc nhiều loại bằng cách gửi một URL có định dạng bao gồm cả tùy chọn cấu hình dữ liệu và biểu đồ cho 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 tùy chọn khác nhau. Các tập dữ liệu của API biểu đồ bị giới hạn ở kích thước của một URL (khoảng 2K).

API Hình ảnh trực quan cung cấp một cách để kết nối các biểu đồ với các nguồn dữ liệu trên web và xuất bản chúng:

API Hình ảnh trực quan cung cấp API JavaScript để truy cập các biểu đồ.
Thư viện biểu đồ chứa các biểu đồ do Google tạo. Tuy nhiên, bất kỳ bên thứ ba nào cũng có thể tạo hình ảnh trực quan tuân thủ API Hình ảnh trực quan của riêng họ.
Biểu đồ và biểu đồ API hình ảnh có thể là bất kỳ nội dung nào mà một trình duyệt có thể kết xuất. Nội dung này bao gồm hình ảnh, JavaScript, đồ họa vectơ, Flash, v.v.
Có một số lượng đáng kể các biểu đồ của API biểu đồ có thể truy cập được thông qua API hình ảnh, mặc dù một số tùy chọn cấu hình của chúng có thể không khả dụng.
API cũng cung cấp giao thức wire được ghi lại 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 có một mô hình sự kiện đã xác định cho phép các biểu đồ gửi và nhận sự kiện, theo đó 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?

Khi sử dụng API Hình ảnh trực quan, bạn có thể truy cập vào dữ liệu trên máy từ trình duyệt bằng cách tạo định dạng DataTable chuẩn của API hoặc truy cập bất kỳ nguồn dữ liệu nào hỗ trợ API này. Những ứ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 Force.com của nhà phát triển. 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 muốn 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ý ngoại lệ?

Bạn có thể sử dụng các 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ự kiến và đưa ra thông báo lỗi cho các thông tin không khớp hay không.

Việc nhúng biểu đồ vào trang web có an toàn không?

Việc chạy mã của bên thứ ba ngay trên trang web của bạn sẽ gây ra rủi ro tiềm ẩn. Google không đưa ra lời hứa hay tuyên bố nào 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. Những ứng dụng biểu đồ không tuân thủ Điều khoản dịch vụ của API Google Visual có thể bị xóa khỏi thư viện.

Tôi có thể dùng biểu đồ mà không cần kết nối 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ác tính năng tương tác của Google Chart. Điều này là do các thư viện hình ảnh mà trang của bạn yêu cầu đượ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 máy tính 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 khả năng tương tác của Biểu đồ Google, bạn có thể chụp ảnh màn hình và sử dụng chúng theo ý 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->View->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 duyệt qua 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".

Chúng tôi hy vọng rằng bảng điều khiển này sẽ giúp bạn giải quyết vấn đề ngay lập tức. Tuy nhiên, đôi khi sẽ khó để dịch thông báo trong bảng điều khiển sang nguyên nhân cơ bản. Dưới đây là một số sai lầm phổ biến:

Bạn có thể đ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 của mình, bạn cũng nên có một lệnh gọi duy nhất như sau:
```
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
```
Bạn có thể đặt lệnh gọi này trong phần đầu hoặc phần nội dung của trang web, tùy thuộc vào thời điểm bạn muốn tải.

Tốt nhất, bạn chỉ nên gọi google.charts.load một lần kèm theo tất cả các gói cần thiết 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ử riêng (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ữ có phân biệt chữ hoa, chữ thường.

Nếu bạn vẫn bối rối, hãy tìm kiếm nhóm thảo luận API Hình ảnh trực quan của Google để xem liệu có ai gặp phải vấn đề tương tự hay không. Nếu bạn không tìm thấy bài đăng nào trả lời câu hỏi của mình, hãy đăng câu hỏi lên nhóm cùng với một đường liên kết đến một trang web có vấn đề. Nếu có thể, hãy thêm một jsfiddle.

Vì sao các ngày và tháng của tôi không hoạt động?

Bảng xếp hạng của Google sử dụng JavaScript, vốn sử dụng phương thức 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 nằm trong khoả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 một lần, hãy trừ một lệnh trước khi đặt dữ liệu vào một đối tượng ngày JavaScript.

Tại sao biểu đồ của tôi hoạt động trên một số trình duyệt nhưng không phải tất cả?

Chúng tôi đề xuất caniuse.com để cung cấp nhiều thông tin về các trường hợp không tương thích với trình duyệt. Với Bảng xếp hạng của Google, đôi khi có vấn đề trong Internet Explorer 8 trở xuống vì hai lý do sau:

IE8 không hỗ trợ SVG, do đó Biểu đồ không chuyển được vào VML, vốn bị hạn chế hơn.

JavaScript của IE8 không cho phép dấu phẩy cuối trong danh sách.

Tại sao biểu đồ dựa trên Flash của tôi không hiển thị khi tôi thử nghiệm biểu đồ?

Do các 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 của máy chủ web (ví dụ: http://www.myhost.com/myviz.html). Đây thường chỉ là vấn đề kiểm thử; vấn đề không phải là vấn đề khi bạn truy cập vào biểu đồ từ một địa chỉ http://. Bạn có thể khắc phục vấn đề này theo mô tả trên trang web của 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 hình ảnh của Google

Chính sách chương trình hình ảnh của Google là gì?

Như mô tả trong Điều khoản dịch vụ, chúng tôi có thể từ chối đưa 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.
Hành vi 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, can thiệp hoặc gây hại cho máy tính của người dùng hay hoạt động của trang web lưu trữ.
Nội dung 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 về DMCA của chúng tôi để biết thêm thông tin.
Vi phạm nhãn hiệu.
Hành vi 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ư đầy đủ về mặt pháp lý. Ngoài ra, chúng tôi yêu cầu các nhà phát triển đảm bảo rằng biểu đồ của họ được bảo mật và duy trì ứng dụng của họ, miễn là biểu đồ nằm trong thư mục biểu đồ.

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

API Hình ảnh của Google có sẵn cho mục đích thương mại không?

Đúng vậy. Để có bản in nhỏ, vui lòng tham khảo Điều khoản dịch vụ của API Google Visual.

Tôi có thể sử dụng Google Visual API để 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 trực quan để tạo phần mềm phía máy khách. Bạn chỉ có thể sử dụng API Hình ảnh trực quan thông qua giao diện được cung cấp. Để có bản in nhỏ, vui lòng tham khảo Điều khoản dịch vụ của API Google Visual.

Google có ghi lại tất cả dữ liệu biểu đồ của tôi không?

Dữ liệu biểu đồ có trong yêu cầu HTTP được lưu trong nhật ký tạm thời trong quá 2 tuần để thử nghiệm nội bộ và gỡ lỗi. Tất nhiên là bạn phải 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ì công cụ này có thể thu thập dữ liệu được.

Vi phạm chính sách chương trình.

Khi bạn vi phạm các Chính sách chương trình này, biểu đồ của bạn có thể bị vô hiệu hóa hoặc bị liệt kê vào danh sách cấm và bị xoá khỏi Tài khoản Google của bạn.

Tham gia cộng đồng năng động

Làm cách nào để chia sẻ ứng dụng Biểu đồ của tôi với người khác?: Bắt đầu bằng cách đặt biểu đồ vào Thư viện biểu đồ. Bạn có thể liên kết trở lại trang web của mình và cung cấp mã nguồn nếu bạn muốn. Hãy tham gia nhóm thảo luận của chúng tôi để nhận được phản hồi của cộng đồng.
Thư viện biểu đồ là gì?: Thư viện biểu đồ là danh sách các ứng dụng sử dụng API Hình ảnh trực quan. Công cụ này cung cấp một vị trí trung tâm để cộng đồng 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 đồ đến 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 quá trình triển khai của bạn trên Nhóm hình ảnh. Nếu thích thì chúng tôi có thể nhắc đến chính nó.