- Memulai
- Apa yang dimaksud dengan Google Visualization API?
- Apa yang dapat saya lakukan dengan Visualization API?
- Di mana saya dapat menemukan dokumentasi untuk Visualization API?
- Bagaimana cara membuat Diagram baru?
- Apa yang dimaksud dengan URL Sumber Data?
- Di mana saya dapat menemukan kode contoh aplikasi Diagram menggunakan Visualization API?
- Dapatkah aplikasi Flash mengakses Visualization API?
- Dapatkah saya mengakses diagram dari aplikasi Java?
- Dapatkah saya mengakses diagram dari aplikasi yang ditulis dengan compiler Google Web Toolkit (GWT)?
- Saya memiliki pertanyaan/masalah yang berbeda, siapa yang dapat saya hubungi untuk mendapatkan informasi selengkapnya?
- Menggunakan API
- Apa perbedaan antara Google Chart API dan Google Visualization API?
- Sumber data apa yang dapat saya akses menggunakan Visualization API?
- Aplikasi saya mengharapkan data yang diterima dalam format tertentu. Bagaimana cara menangani pengecualian?
- Apakah cara aman untuk menyematkan diagram di situs saya?
- Dapatkah saya menggunakan diagram secara offline?
- Dapatkah saya mendownload dan menghosting kode diagram secara lokal, atau pada intranet?
- Pemecahan masalah
- Kebijakan Google Visualization API
- Apa yang dimaksud dengan Kebijakan Program Visualisasi Google?
- Apakah Google Visualization API tersedia untuk penggunaan komersial?
- Dapatkah saya menggunakan Google Visualization API untuk membuat software sisi klien?
- Apakah Google mencatat semua data diagram saya ke dalam log?
- Pelanggaran kebijakan program
- Menjadi Aktif di Komunitas
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()
dangetColumnType()
dari classgoogle.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 kodegoogle.charts.load
ataugoogle.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
ataugoogle.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
dalamchart2
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
- 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.
- Apa itu Galeri Bagan?
- 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.