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 sederhana. Anda juga dapat menerapkan sumber data Anda sendiri sebagai sumber data Visualization API dan mengaktifkan visualisasi apa pun dan/atau aplikasi yang sesuai dengan Visualisasi untuk mengakses data Anda. Formatnya dapat 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 mengurutkan, mengelompokkan, dsb.) dilakukan pada sumber data sebelum mengambil data.
Di mana saya dapat menemukan kode contoh aplikasi Chart menggunakan Visualization API?
Anda dapat menemukan kode contoh dalam dokumentasi kode contoh Visualization API.
Dapatkah aplikasi Flash mengakses Visualization API?
Tentu saja. API Visualisasi menggunakan JavaScript API, tetapi ada library yang memungkinkan aplikasi Flash terhubung dengan kode JavaScript. Salah satu library tersebut mungkin berguna untuk Anda 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 Mengimplementasikan Sumber Data untuk mempelajari cara membuat sumber data. Anda juga dapat menggunakan library Java Sumber Data Google Chart untuk memulai dengan cepat jika Anda menggunakan Java.
Dapatkah saya mengakses diagram dari aplikasi Java?
Ya. Library Visualisasi Google untuk Google Web Toolkit (GWT) memungkinkan Anda mengakses visualisasi API yang sesuai dari kode Java yang dikompilasi dengan compiler GWT dan untuk menulis visualisasi yang sesuai dengan Visualisasi API di Java menggunakan GWT complier. 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 API yang sesuai dari kode Java yang dikompilasi dengan compiler GWT dan untuk menulis visualisasi yang sesuai dengan Visualisasi API di Java menggunakan GWT complier. Library kandidat rilis juga mendukung model peristiwa Visualization API.
Saya memiliki pertanyaan/masalah yang berbeda, siapa yang harus saya hubungi untuk mendapatkan informasi selengkapnya?
Posting pertanyaan Anda di grup diskusi Google Visualization API untuk mendapatkan bantuan dari komunitas developer Visualization. Tim Visualisasi Google juga berpartisipasi dalam grup ini untuk menjawab pertanyaan.

Menggunakan API

Apa 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 data dan diagram ke server Google. Chart API mencakup kumpulan diagram tertutup dengan berbagai opsi. Set data Chart API dibatasi ukuran URL-nya (sekitar 2 ribu).

API Visualisasi menyediakan cara untuk menghubungkan diagram dan sumber data melalui web serta memublikasikannya:

  • Visualization API menyediakan JavaScript API untuk mengakses diagram.
  • Galeri diagramnya menyertakan bagan yang dibuat Google, tetapi juga terbuka untuk pihak ketiga mana pun guna membuat visualisasi yang sesuai dengan Visualization API.
  • Diagram dan diagram API visualisasi dapat berupa apa pun yang dapat dirender oleh browser. 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 juga menyediakan protokol kabel yang terdokumentasi dan cara bagi siapa saja untuk mengekspos sumber data mereka ke visualisasi API apa pun.
  • API memiliki model peristiwa yang ditentukan yang memungkinkan diagram untuk menampilkan dan menerima peristiwa serta berkomunikasi dengan halaman host dan/atau diagram lainnya di halaman.
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 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() dari class google.visualization.DataTable untuk menguji apakah data yang Anda dapatkan cocok dengan yang Anda harapkan, dan untuk mengeluarkan pesan error jika ada ketidakcocokan.
Apakah aman untuk menyematkan diagram di situs saya?
Menjalankan kode pihak ketiga langsung di situs Anda dapat 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 agar dapat 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 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 mendownload dan menghosting kode diagram secara lokal, atau pada intranet?
Maaf; persyaratan layanan kami tidak mengizinkan Anda mendownload dan menyimpan atau menghosting kode google.charts.load atau google.visualization. Namun, jika tidak memerlukan interaktivitas Google Chart, Anda dapat mengambil screenshot dan menggunakannya sesuai keinginan.

Pemecahan masalah

Mengapa diagram saya tidak muncul?

Pertama, periksa konsol JavaScript Anda. Di Chrome, Anda dapat mengakses konsol JavaScript melalui Chrome->Tampilan->Developer->Konsol JavaScript, atau Chrome->Alat->Konsol JavaScript. Semua browser modern memiliki konsol JavaScript; Anda mungkin perlu menelusuri menu dengan nama seperti "Lanjutan" atau "Alat Developer" untuk menemukannya.

Mudah-mudahan, konsol langsung mengarahkan Anda ke masalah. Namun, terkadang akan sulit untuk menerjemahkan pesan konsol ke penyebab utamanya. Berikut ini beberapa kesalahan umum:

  • Anda mungkin salah menggunakan Loader Google.
    • Hanya muat chart/loader.js satu kali. Berapa pun jumlah diagram yang Anda miliki di halaman web, Anda harus memiliki satu dan hanya satu panggilan seperti ini: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      ID ini dapat berada di bagian awal atau isi halaman web, bergantung pada kapan Anda ingin pemuatan terjadi.
    • Idealnya, panggil google.charts.load hanya sekali, dengan semua paket yang diperlukan untuk halaman web Anda. 
      <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 yang unik (mis., chart1 dalam chart2 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 orang yang mengalami masalah serupa. Jika Anda tidak dapat menemukan postingan yang menjawab pertanyaan Anda, posting pertanyaan Anda ke grup bersama dengan link ke halaman web yang menunjukkan masalah tersebut. Jika memungkinkan, sertakan jsfiddle.

Mengapa beberapa bulan dan hari saya libur?
Google Chart menggunakan JavaScript, yang menggunakan pengindeksan berbasis nol. Hari pertama dalam sebulan adalah 0, dan bulan berkisar dari 0 (Januari) hingga 11 (Desember). Jika kode Anda mengasumsikan pengindeksan berbasis satu, kurangi satu data sebelum menempatkan data Anda ke dalam objek tanggal JavaScript.
Mengapa diagram saya berfungsi di beberapa browser tetapi tidak semuanya?
Sebaiknya gunakan caniuse.com untuk mendapatkan banyak informasi tentang inkompatibilitas browser. Pada Google Chart, terkadang ada masalah di Internet Explorer 8 dan sebelumnya, karena dua alasan:
  • IE8 tidak mendukung SVG, sehingga Chart 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 pada 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 saat Anda mengakses diagram dari alamat http://. Anda dapat mengatasi masalah ini seperti yang dijelaskan di situs Macromedia. Secara umum, sebaiknya hindari pengembangan Flash jika memungkinkan.

    Kebijakan Program Visualisasi Google

    Apa itu Kebijakan Program Visualisasi Google?
    Seperti yang dijelaskan dalam Persyaratan Layanan, kami dapat menolak untuk menyertakan dan menampilkan konten yang melanggar kebijakan program kami dengan menampilkan atau menautkan ke:
    • Konten ilegal.
    • Pelanggaran privasi pribadi.
    • Pornografi atau kecabulan.
    • Konten, seperti kode berbahaya, yang mengganggu atau membahayakan komputer pengguna atau fungsi halaman host.
    • Mendorong kebencian atau memicu kekerasan.
    • Pelanggaran hak cipta. Lihat kebijakan DMCA kami untuk informasi selengkapnya.
    • 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 mewajibkan developer untuk memastikan bahwa diagram mereka aman, dan demi mempertahankan 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 informasi mendetail, lihat Persyaratan Layanan Google Visualization API.
    Dapatkah 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 informasi mendetail, lihat Persyaratan Layanan Google Visualization API.
    Apakah Google mencatat semua data diagram saya?
    Data diagram yang disertakan dalam permintaan HTTP disimpan di log sementara selama tidak lebih dari dua minggu untuk tujuan pengujian dan proses debug internal. Tentunya Anda harus memahami bahwa diagram Anda dapat di-crawl di tag gambar publik pada halaman web publik.
    Pelanggaran terhadap kebijakan program.
    Pelanggaran terhadap Kebijakan Program ini dapat menyebabkan penonaktifan atau penghapusan diagram, dimasukkan ke daftar yang tidak diizinkan agar tidak dapat mengupload diagram yang akan datang, penghentian akun Google, dan/atau penghapusan semua diagram Anda.

    Menjadi Aktif di Komunitas

    Bagaimana cara membagikan aplikasi Diagram saya kepada orang lain?
    Mulai dengan menempatkan diagram Anda di Galeri Diagram. Anda dapat menautkan kembali ke situs Anda dan memberikan kode sumber jika menginginkannya. Bergabunglah dalam grup diskusi kami untuk mendapatkan masukan dari komunitas.
    Galeri Diagram adalah listingan aplikasi yang menggunakan Visualization API. Ini menyediakan lokasi pusat bagi komunitas developer Visualisasi untuk berbagi aplikasi Diagram. Untuk mengirimkan aplikasi diagram ke galeri, ajukan permohonan secara online.
    Bagaimana cara mempromosikan sumber data Diagram saya?
    Posting implementasi Anda di Grup Visualisasi. Jika kami menyukainya, kami bahkan dapat menyebutkannya sendiri.