Pertanyaan Umum (FAQ)

Memulai

Apa itu Google Visualization API?
Google Visualization API memungkinkan Anda membuat diagram dan aplikasi pelaporan melalui data terstruktur dan membantu mengintegrasikannya langsung ke situs Anda.
Apa yang dapat saya lakukan dengan Visualization API?
Dengan Google Visualization API, Anda dapat mengakses data terstruktur yang dibuat secara lokal di browser atau diambil dari sumber data yang didukung dalam format tabel yang sederhana. Anda juga dapat menerapkan sumber data Anda sendiri sebagai sumber data Visualization API dan mengaktifkan visualisasi dan/atau aplikasi yang mematuhi Visualisasi untuk mengakses data Anda. Format ini bisa digunakan dengan aplikasi pelaporan, analisis, atau diagram. Dengan demikian, Anda dapat memvisualisasikan data dan/atau menambahkan fungsi baru ke aplikasi, seperti Google Spreadsheet.
Di mana saya dapat menemukan dokumentasi untuk Visualization API?
Anda dapat menemukan panduan developer dan semua dokumentasi terkait lainnya di https://developers.google.com/chart/interactive/docs.
Bagaimana cara membuat Diagram baru?
Cara terbaik untuk memulai adalah dengan membaca Pengantar, dan bagian Panduan Memulai.
Apa itu URL Sumber Data?
URL Sumber Data adalah ID URL unik dari sumber data Visualization API. URL sumber data juga dapat menyertakan parameter Bahasa Kueri Diagram. Dalam hal ini, kueri (seperti pengurutan, pengelompokan, dll.) dilakukan pada sumber data sebelum mengambil data.
Di mana saya dapat menemukan kode contoh aplikasi Chart yang menggunakan Visualization API?
Anda dapat menemukan kode contoh di dokumentasi kode contoh Visualization API.
Bisakah aplikasi Flash mengakses Visualization API?
Tentu saja. Visualization API menggunakan JavaScript API, tetapi ada library yang memungkinkan aplikasi Flash terhubung dengan kode JavaScript. Salah satu library yang mungkin berguna bagi Anda dapat ditemukan di http://code.google.com/p/swfobject. Lihat di bawah untuk beberapa masalah pengembangan yang memengaruhi Flash.
Bagaimana cara menerapkan sumber data?
Baca bagian tentang menggunakan dan membuat diagram untuk mempelajari cara kerja diagram, lalu baca Menerapkan Sumber Data untuk mempelajari cara membuat sumber data. Anda juga dapat menggunakan library Java Sumber Data Google Chart untuk memulai dengan cepat jika menggunakan Java.
Dapatkah saya mengakses bagan dari aplikasi Java?
Ya. Library Visualisasi Google untuk Google Web Toolkit (GWT) memungkinkan Anda mengakses visualisasi yang sesuai dengan API dari kode Java yang dikompilasi dengan compiler GWT dan menulis visualisasi yang sesuai dengan Visualization API di Java menggunakan compiler GWT. Library kandidat rilis juga mendukung model peristiwa Visualization API.
Dapatkah saya mengakses diagram dari aplikasi yang ditulis dengan compiler Google Web Toolkit (GWT)?
Ya. Library Visualisasi Google untuk Google Web Toolkit (GWT) memungkinkan Anda mengakses visualisasi yang sesuai dengan API dari kode Java yang dikompilasi dengan compiler GWT dan menulis visualisasi yang sesuai dengan Visualization API di Java menggunakan compiler GWT. Library kandidat rilis juga mendukung model peristiwa Visualization API.
Saya memiliki pertanyaan/masalah yang berbeda, siapa yang harus saya hubungi untuk mendapatkan informasi lebih lanjut?
Posting pertanyaan Anda di grup diskusi Google Visualization API untuk mendapatkan bantuan dari komunitas developer Visualisasi. Tim Visualisasi Google juga berpartisipasi dalam grup ini untuk menjawab pertanyaan.

Menggunakan API

Apakah perbedaan antara Google Chart API dan Google Visualization API?

Chart API menyediakan cara sederhana untuk membuat berbagai jenis diagram gambar dengan mengirimkan URL berformat yang menyertakan opsi konfigurasi diagram dan data ke server Google. Chart API mencakup kumpulan diagram tertutup dengan berbagai opsi. Set data Chart API dibatasi hingga ukuran URL (sekitar 2K).

Visualization API memberikan cara untuk menghubungkan diagram dan sumber data melalui web dan untuk memublikasikannya:

  • Visualization API menyediakan JavaScript API untuk mengakses bagan.
  • Galeri diagramnya mencakup diagram yang dibuat Google, tetapi juga terbuka bagi pihak ketiga untuk membuat visualisasi yang sesuai dengan Visualization API mereka sendiri.
  • Diagram dan diagram API visualisasi dapat berupa apa pun yang dapat dirender oleh browser. Konten ini mencakup gambar, JavaScript, grafik vektor, Flash, dll.
  • Sejumlah besar diagram Chart API dapat diakses melalui Visualization API, meskipun beberapa opsi konfigurasinya mungkin tidak tersedia.
  • API ini juga menyediakan protokol kabel yang terdokumentasi dan cara bagi siapa saja untuk mengekspos sumber datanya ke salah satu visualisasi API.
  • API ini memiliki model peristiwa yang ditentukan yang memungkinkan diagram menampilkan dan menerima peristiwa, sehingga berkomunikasi dengan halaman host dan/atau diagram lain di halaman tersebut.
Sumber data apa yang dapat saya akses menggunakan Visualization API?
Dengan Visualization API, Anda dapat mengakses data secara lokal dari browser dengan membuat format DataTable standar API, atau mengakses sumber data apa pun yang mendukung API. Aplikasi terkenal yang sudah mendukung API ini adalah Google Spreadsheet dan Salesforce.com pada platform developer Force.com mereka. Anda juga dapat menerapkan data Anda sendiri sebagai sumber data Diagram.
Aplikasi saya mengharapkan data yang diterima dalam format tertentu. Bagaimana cara menangani pengecualian?
Anda dapat menggunakan metode getNumberOfColumns() dan getColumnType() class google.visualization.DataTable untuk menguji apakah data yang Anda dapatkan cocok dengan yang Anda harapkan, dan mengeluarkan pesan error karena ketidakcocokan.
Apakah aman untuk menyematkan bagan di situs web saya?
Menjalankan kode pihak ketiga secara langsung di situs Anda menimbulkan risiko bawaan. Google tidak menjanjikan atau membuat pernyataan tentang performa, kualitas, keamanan, atau konten aplikasi. Aplikasi diagram yang tidak mematuhi Persyaratan Layanan Google Visualization API dapat dihapus dari galeri.
Dapatkah saya menggunakan diagram secara offline?
Komputer pengguna Anda harus memiliki akses ke https://www.gstatic.com/charts/loader.js untuk menggunakan fitur interaktif Google Chart. Hal ini karena library visualisasi yang diperlukan halaman Anda dimuat secara dinamis sebelum Anda menggunakannya. Kode untuk memuat library yang sesuai adalah bagian dari skrip yang disertakan, dan akan dipanggil saat Anda memanggil metode google.charts.load(). Persyaratan layanan kami tidak mengizinkan Anda mendownload kode google.charts.load atau google.visualization untuk digunakan secara offline.
Dapatkah saya mengunduh dan menghosting kode diagram secara lokal atau di intranet?
Maaf; persyaratan layanan kami tidak mengizinkan Anda untuk mendownload dan menyimpan atau menghosting kode google.charts.load atau google.visualization. Namun, jika tidak memerlukan interaktivitas Google Chart, Anda dapat mengambil screenshot diagram dan menggunakannya sesuai keinginan.

Pemecahan masalah

Mengapa bagan saya tidak muncul?

Pertama, periksa konsol JavaScript Anda. Di Chrome, Anda dapat mengakses konsol JavaScript melalui Chrome->View->Developer->JavaScript Console, atau Chrome->Tools->JavaScript Console. Semua browser modern memiliki konsol JavaScript; Anda mungkin perlu melihat-lihat menu dengan nama seperti "Lanjutan" atau "Alat Pengembang" untuk menemukannya.

Mudah-mudahan, konsol web membawa Anda ke masalah. Namun, terkadang akan sulit untuk menerjemahkan pesan konsol ke penyebab utamanya. Berikut adalah beberapa kesalahan umum:

  • Anda mungkin salah menggunakan Google Loader.
    • Hanya muat chart/loader.js sekali. Berapa pun diagram yang Anda miliki di halaman web, Anda hanya boleh memiliki satu panggilan seperti ini: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Panggilan ini dapat berada di bagian atas atau isi halaman web, bergantung pada kapan Anda ingin pemuatan dilakukan.
    • Idealnya, panggil google.charts.load hanya sekali, yang berisi semua paket yang Anda perlukan untuk halaman web. 
      <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>
  • Setiap diagram harus memiliki ID elemen unik (misalnya, chart1, chart2 dalam contoh di atas).
  • Cari kesalahan ketik. Ingatlah, JavaScript adalah bahasa yang membedakan huruf besar dan kecil.

Jika Anda masih bingung, telusuri grup diskusi Google Visualization API untuk melihat apakah ada yang mengalami masalah yang sama. Jika tidak dapat menemukan postingan yang menjawab pertanyaan Anda, posting pertanyaan ke grup bersama dengan link ke halaman web yang menunjukkan masalah tersebut. Jika memungkinkan, sertakan jsfiddle.

Mengapa bulan dan hari libur hanya satu?
Google Chart menggunakan JavaScript, yang menggunakan pengindeksan berbasis nol. Hari pertama setiap bulan adalah 0, dan rentang bulannya berkisar dari 0 (Januari) hingga 11 (Desember). Jika kode Anda mengasumsikan pengindeksan berbasis satu, kurangi satu sebelum menempatkan data ke objek tanggal JavaScript.
Mengapa diagram saya berfungsi di beberapa browser, tetapi tidak semuanya?
Kami merekomendasikan caniuse.com untuk berbagai informasi tentang inkompatibilitas browser. Dengan Google Chart, terkadang ada masalah di Internet Explorer 8 dan versi sebelumnya, karena dua alasan:
  • IE8 tidak mendukung SVG, sehingga Chart gagal beralih ke VML, yang lebih terbatas.
  • JavaScript IE8 tidak mengizinkan koma di akhir dalam daftar.
    • Mengapa diagram berbasis Flash tidak muncul saat saya mengujinya?
    Karena setelan keamanan Flash, diagram berbasis Flash mungkin tidak berfungsi dengan benar saat diakses dari lokasi file di browser (misalnya file:///c:/webhost/myhost/myviz.html), bukan dari URL server web (misalnya, http://www.myhost.com/myviz.html). Hal ini biasanya hanya merupakan masalah pengujian; masalah ini tidak menjadi masalah jika Anda mengakses diagram dari alamat http://. Anda dapat mengatasi masalah ini seperti yang dijelaskan di situs Macromedia. Secara umum, sebaiknya hindari pengembangan Flash bila memungkinkan.

    Kebijakan Program Visualisasi Google

    Apa itu Kebijakan Program Visualisasi Google?
    Sebagaimana dijelaskan dalam Persyaratan Layanan, kami dapat menolak untuk menyertakan dan menampilkan konten yang melanggar kebijakan program kami dengan menampilkan atau menautkan ke:
    • Konten ilegal.
    • Invasi privasi pribadi.
    • Pornografi atau kecabulan.
    • Konten, seperti kode berbahaya, yang mengganggu atau berbahaya bagi komputer pengguna atau fungsi halaman web host.
    • Promosi kebencian atau memicu kekerasan.
    • Pelanggaran hak cipta. Harap lihat kebijakan DMCA kami untuk informasi lebih lanjut.
    • Pelanggaran merek dagang.
    • Peniruan identitas pihak ketiga.

    Developer yang membuat diagram yang mengumpulkan data, setuju untuk mempertahankan dan menautkan ke kebijakan privasi yang memadai secara hukum. Selain itu, kami mengharuskan developer untuk memastikan bahwa diagram mereka aman, dan untuk memelihara aplikasi mereka selama berada dalam direktori diagram.

    Kebijakan ini dapat direvisi dari waktu ke waktu tanpa pemberitahuan.

    Apakah Google Visualization API tersedia untuk penggunaan komersial?
    Ya. Untuk mengetahui detailnya, lihat Persyaratan Layanan Google Visualization API.
    Bisakah saya menggunakan Google Visualization API untuk membuat software sisi klien?
    Saat ini kami tidak mengizinkan developer menggunakan Visualization API untuk membuat software sisi klien. Anda hanya dapat menggunakan Visualization API melalui antarmuka yang disediakan. Untuk mengetahui detailnya, lihat Persyaratan Layanan Google Visualization API.
    Apakah Google mencatat semua data diagram saya?
    Data diagram yang disertakan dalam permintaan HTTP disimpan dalam log sementara tidak lebih dari dua minggu untuk tujuan pengujian internal dan proses debug. Tentu saja Anda harus memahami bahwa jika diagram Anda muncul dalam tag gambar di halaman web publik, diagram tersebut dapat di-crawl.
    Pelanggaran kebijakan program.
    Pelanggaran terhadap Kebijakan Program ini dapat mengakibatkan penonaktifan atau penghapusan diagram, daftar yang tidak diizinkan untuk mengupload diagram mendatang, penghentian Akun Google Anda, dan/atau penghapusan semua diagram.

    Menjadi Aktif di Komunitas

    Bagaimana cara membagikan pendaftaran Chart saya kepada orang lain?
    Mulailah dengan menempatkan diagram Anda di Galeri Diagram. Anda dapat menautkan kembali ke situs Anda dan memberikan kode sumber jika Anda mau. Bergabunglah dalam grup diskusi untuk mendapatkan masukan dari komunitas.
    Chart Gallery adalah listingan aplikasi yang menggunakan Visualization API. Platform ini menyediakan lokasi sentral bagi komunitas pengembang Visualisasi untuk berbagi aplikasi Bagan. Untuk mengirimkan aplikasi diagram Anda ke galeri, ajukan permohonan secara online.
    Bagaimana cara mempromosikan sumber data Diagram saya?
    Posting penerapan Anda di Grup Visualisasi. Jika suka, kami bahkan bisa menyebutkannya sendiri.