Sık Sorulan Sorular

Başlayın

Google Görselleştirme API'sı nedir?
Google Görselleştirme API'sı, yapılandırılmış veriler üzerinde grafik ve raporlama uygulamaları oluşturmanıza ve bunları doğrudan web sitenize entegre etmenize yardımcı olur.
Görselleştirme API'sı ile ne yapabilirim?
Google Görselleştirme API'sı ile, tarayıcınızda yerel olarak oluşturulan veya desteklenen veri kaynaklarından basit bir tablo biçiminde alınan yapılandırılmış verilere erişebilirsiniz. Ayrıca kendi veri kaynağınızı Görselleştirme API'si veri kaynağı olarak uygulayabilir ve Görselleştirme ile uyumlu görselleştirmelerin ve/veya uygulamanın verilerinize erişmesine izin verebilirsiniz. Biçim, raporlama, analiz veya grafik uygulamaları tarafından kullanılmaya uygundur. Bu sayede, verileri görselleştirebilir ve/veya uygulamalara Google E-tablolar gibi yeni işlevler ekleyebilirsiniz.
Görselleştirme API'sını içeren belgeleri nerede bulabilirim?
Geliştirici kılavuzunu ve diğer tüm ilgili belgeleri https://developers.google.com/graphic/interactive/docs adresinde bulabilirsiniz.
Yeni bir Grafik nasıl oluşturulur?
Başlamanın en iyi yolu Giriş bölümünü ve Hızlı başlangıç bölümünü okumaktır.
Veri Kaynağı URL'si nedir?
Veri Kaynağı URL'si, Görselleştirme API'si veri kaynağının benzersiz URL tanımlayıcısıdır. Veri kaynağı URL'si, Grafik Sorgu Dili parametrelerini de içerebilir. Bu durumda, veriler alınmadan önce veri kaynağında bir sorgu (sıralama, gruplama vb.) yapılır.
Görselleştirme API'sını kullanan Grafik uygulamalarının örnek kodunu nerede bulabilirim?
Görselleştirme API'si örnek kod dokümanlarında örnek kod bulabilirsiniz.
Bir Flash uygulaması, Görselleştirme API'sine erişebilir mi?
Kesinlikle. Görselleştirme API'si bir JavaScript API'si kullanır, ancak Flash uygulamalarının JavaScript koduyla bağlanmasını sağlayan kitaplıklar da vardır. Yararlı bulabileceğiniz bu tür bir kitaplıka http://code.google.com/p/swfobject adresinden ulaşabilirsiniz. Flash'ı etkileyen bazı geliştirme sorunları için aşağıya bakın.
Veri kaynaklarını nasıl uygularım?
Grafiklerin nasıl çalıştığını öğrenmek için grafik kullanma ve oluşturma bölümünü, ardından nasıl veri kaynağı oluşturacağınızı öğrenmek için Veri Kaynağını Uygulama bölümünü okuyun. Java kullanıyorsanız hızlı bir başlangıç yapmak için Google Grafik Verileri Kaynağı Java kitaplığından da yararlanabilirsiniz.
Bir Java uygulamasından bir grafiğe erişebilir miyim?
Evet. Google Web Araç Seti (GWT) için Google Görselleştirme Kitaplığı, GWT derleyiciyle derlenen Java kodundan API uyumlu görselleştirmelere erişmenizi ve GWT derleyiciyi kullanarak Java'da Görselleştirme API'si ile uyumlu görselleştirmeler yazmanızı sağlar. Sürüm aday kitaplığı, Görselleştirme API'si etkinlik modelini de destekler.
Google Web Araç Seti (GWT) derleyiciyle yazılan bir uygulamadan grafiğe erişebilir miyim?
Evet. Google Web Araç Seti (GWT) için Google Görselleştirme Kitaplığı, GWT derleyiciyle derlenen Java kodundan API uyumlu görselleştirmelere erişmenizi ve GWT derleyiciyi kullanarak Java'da Görselleştirme API'si ile uyumlu görselleştirmeler yazmanızı sağlar. Sürüm aday kitaplığı, Görselleştirme API'si etkinlik modelini de destekler.
Farklı bir sorum/sorunum var. Daha fazla bilgi almak için kiminle iletişime geçmeliyim?
Görselleştirme Geliştiricisi topluluğundan yardım almak için lütfen sorunuzu Google Görselleştirme API'sı tartışma grubunda yayınlayın. Soruları yanıtlamak için Google Görselleştirme Ekibi de bu gruba katılır.

API'yi kullanma

Google Chart API ve Google Görselleştirme API'sı arasındaki fark nedir?

Chart API, bir Google sunucusuna hem veri hem de grafik yapılandırma seçeneklerini içeren biçimlendirilmiş bir URL göndererek çeşitli türlerde resim grafikleri oluşturmanın basit bir yolunu sunar. Chart API, çeşitli seçeneklerin bulunduğu kapalı bir grafik kümesi içerir. Chart API veri kümeleri, URL'lerin boyutuyla (yaklaşık 2K) sınırlıdır.

Görselleştirme API'sı, web ile grafikler arasında bağlantı kurmak ve bunları yayınlamak için bir yol sağlar:

  • Görselleştirme API'sı, grafiklere erişmek için bir JavaScript API'si sağlar.
  • Grafik galerisi, Google tarafından oluşturulan grafikleri içerir ancak üçüncü taraf kişiler de kendi Görselleştirme API'si ile görselleştirmeleri oluşturabilir.
  • Görselleştirmeler API'si grafikleri, bir tarayıcı tarafından oluşturulabilen herhangi bir şey olabilir. Bu veriler arasında resimler, JavaScript, vektör grafikleri, Flash vb. bulunur.
  • Oldukça fazla sayıda Chart API grafiğine Görselleştirme API'si üzerinden erişilebilir ancak bu yapılandırma seçeneklerinden bazıları kullanılamayabilir.
  • API ayrıca belgeli bir kablo protokolü ve herkesin veri kaynaklarını API görselleştirmelerinden herhangi birine gösterebilmesi için bir yol sağlar.
  • API'de, grafiklerin etkinlik gönderip almasına ve böylece ana makine sayfasıyla ve/veya sayfadaki diğer grafiklerle iletişim kurmasına olanak tanıyan tanımlı bir etkinlik modeli vardır.
Görselleştirme API'sini kullanarak hangi veri kaynaklarına erişebilirim?
görselleştirme API'siyle, API'nin standart DataTable biçimini oluşturarak tarayıcınızdan verilere yerel olarak erişebilir ya da API'yi destekleyen tüm veri kaynaklarına erişebilirsiniz. API'yi destekleyen bilinen uygulamalar, Force.com geliştirici platformunda yer alan Google E-Tablolar ve Salesforce.com uygulamalarıdır. Kendi verilerinizi grafik veri kaynağı olarak da uygulayabilirsiniz.
Uygulamam, aldığı verilerin belirli bir biçimde olmasını bekliyor. İstisnaları nasıl ele alabilirim?
Aldığınız verilerin beklediğinizle eşleşip eşleşmediğini test etmek ve uyuşmazlıklar nedeniyle hata mesajı vermek için google.visualization.DataTable sınıfının getNumberOfColumns() ve getColumnType() yöntemlerini kullanabilirsiniz.
Web siteme grafik yerleştirmek güvenli mi?
Üçüncü taraf kodunu doğrudan web sitenizde çalıştırmak doğası gereği riskler doğurur. Google, uygulama performansı, kalitesi, güvenliği veya içeriği konusunda hiçbir vaatte bulunmaz. Google Görselleştirme API'sı Hizmet Şartları'na uymayan grafik uygulamaları galerilerden kaldırılabilir.
Grafikleri çevrimdışı kullanabilir miyim?
Kullanıcılarınızın bilgisayarlarında Google Listeler'in etkileşimli özelliklerinin kullanılabilmesi için https://www.gstatic.com/graphics/loader.js adresinin olması gerekir. Bunun nedeni, sayfanızın gerektirdiği görselleştirme kitaplıklarının, bunları kullanmadan önce dinamik olarak yüklenmesidir. Uygun kitaplığı yükleme kodu, verilen komut dosyasının bir parçasıdır ve google.charts.load() yöntemini çağırdığınızda çağrılır. Hizmet şartlarımız, çevrimdışı kullanmak için google.charts.load veya google.visualization kodunu indirmenize izin vermez.
Grafik kodunu yerel olarak veya bir intranetten indirip barındırabilir miyim?
Maalesef hizmet şartlarımız google.charts.load veya google.visualization kodunu indirmenize ve kaydetmenize izin vermez. Ancak Google Listeler'in etkileşimine ihtiyacınız yoksa grafiklerin ekran görüntüsünü alabilir ve istediğiniz gibi kullanabilirsiniz.

Sorun giderme

Grafiğim neden görünmüyor?

İlk olarak JavaScript konsolunuzu kontrol edin. Chrome'da JavaScript konsoluna Chrome->View->Developer->JavaScript Console veya Chrome->Araçlar->JavaScript Konsolu üzerinden erişebilirsiniz. Tüm modern tarayıcıların JavaScript konsolu vardır. Bunları bulmak için "Gelişmiş" veya "Geliştirici Araçları" gibi adlara sahip menüleri incelemeniz gerekebilir.

Konsolda sizi hemen soruna yönlendirir. Bununla birlikte, bazen konsol mesajını temel nedene çevirmek zor olabilir. Sık karşılaşılan bazı hatalar aşağıda verilmiştir:

  • Google Yükleyici'yi hatalı kullanıyor olabilirsiniz.
    • Listeler/loader.js için yalnızca bir kez bir kez yükleyin. Web sayfanızda kaç grafik olursa olsun, aşağıdaki gibi yalnızca bir çağrınız olmalıdır: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Bu, yükün ne zaman gerçekleşmesini istediğinize bağlı olarak web sayfanızın başında veya gövdesinde olabilir.
    • İdeal olarak google.charts.load, web sayfanız için ihtiyacınız olan tüm paketlerle birlikte yalnızca bir kez arayın. 
      <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>
  • Her grafiğin benzersiz bir öğe kimliği olmalıdır (ör. chart1, yukarıdaki örnekte chart2) görebilirsiniz.
  • Yazım hataları olup olmadığına bakın. JavaScript'in büyük/küçük harfe duyarlı bir dil olduğunu unutmayın.

Halen yanıt bulamadıysanız, benzer bir sorunla karşılaşıp karşılaşmadığını görmek için Google Görselleştirme API'sı tartışma grubunda arama yapın. Sorunuzun yanıtlandığı bir yayını bulamıyorsanız sorunuzu, sorunu gösteren bir web sayfasının bağlantısıyla birlikte gruba gönderin. Mümkünse bir jsfiddle ekleyin.

Aylar ve günlerim neden teker teker kapanıyor?
Google Listeler, sıfır tabanlı dizine ekleme kullanan JavaScript'i kullanır. Ayın ilk günü 0'dır ve aylar 0 (Ocak) ile 11 (Aralık) arasında değişir. Kodunuz tek tabanlı dizine ekleme işlemini varsayorsa verilerinizi bir JavaScript tarih nesnesine koymadan önce bunlardan birini çıkarın.
Neden grafiklerim tüm tarayıcılarda değil de bazı tarayıcılarda çalışıyor?
Tarayıcı uyumsuzluklarıyla ilgili birçok bilgi edinmek için caniuse.com adresini ziyaret etmenizi öneririz. Google Listeler'de bazen Internet Explorer 8 ve önceki sürümlerde iki nedenden dolayı sorun olabilir:
  • IE8, SVG'yi desteklemediğinden Listeler daha sınırlı olan VML'ye devredilir.
  • IE8'in JavaScript'i listelerde virgüllerin sonuna izin vermez.
    • Flash tabanlı grafiğim neden test edilirken görünmüyor?
    Flash güvenlik ayarları nedeniyle, web sunucusu URL'sinden (ör. http://www.myhost.com/myviz.html) değil, tarayıcıdaki bir dosya konumundan (ör. file:///c:/webhost/myhost/myviz.html) erişildiğinde Flash tabanlı grafikler düzgün çalışmayabilir. Bu genellikle yalnızca bir test sorunudur; grafiğe bir http:// adresinden eriştiğinizde sorun olmaz. Bu sorunu, Makromedia web sitesinde açıklandığı şekilde çözebilirsiniz. Genel olarak, mümkün olduğunda Flash geliştirmeden kaçınmanızı öneririz.

    Google Görselleştirme Programı Politikası

    Google Görselleştirme Programı Politikası nedir?
    Hizmet Şartları'nda açıklandığı gibi, aşağıdaki gibi görünen veya bağlantılar içeren program politikamızı ihlal eden içerikleri dahil etmeyi ve görüntülemeyi reddedebiliriz:
    • Yasa dışı içerik.
    • Kişisel gizliliği ihlal ediyor.
    • Pornografi veya müstehcenlik.
    • Kullanıcının bilgisayarına müdahale eden veya kullanıcının bilgisayarına ya da barındırma web sayfasının çalışmasına zarar veren kötü amaçlı kod gibi içerikler.
    • Nefreti veya şiddeti teşvik eden içerikler.
    • Telif hakkı ihlalleri. Daha fazla bilgi için lütfen DMCA politikamızı inceleyin.
    • Ticari marka ihlalleri.
    • Üçüncü tarafların kimliğine bürünme.

    Veri toplayan grafikler oluşturan ve bu şekilde yasal olarak yeterli düzeyde gizlilik politikası tutmayı ve bağlantı vermeyi kabul eden geliştiriciler. Ayrıca, geliştiricilerin grafiklerinin güvenli olduğundan emin olmalarını ve grafik dizininde bulunduğu sürece uygulamalarını sürdürmelerini zorunlu tutarız.

    Bu politikalar zaman zaman bildirimde bulunulmadan revize edilebilir.

    Google Görselleştirme API'sı ticari amaçla kullanılabilir mi?
    Evet. Ayrıntılı bilgi için Google Görselleştirme API'sı Hizmet Şartları'na bakın.
    İstemci tarafı yazılım oluşturmak için Google Görselleştirme API'sını kullanabilir miyim?
    Şu anda geliştiricilerin istemci tarafı yazılımlar oluşturmak için Görselleştirme API'sini kullanmasına izin vermiyoruz. Görselleştirme API'sini yalnızca sağlanan arayüz üzerinden kullanabilirsiniz. Ayrıntılı bilgi için lütfen Google Görselleştirme API'sı Hizmet Şartları'na bakın.
    Google tüm grafik verilerimi günlüğe kaydediyor mu?
    HTTP isteğine dahil edilen grafik verileri, dahili test ve hata ayıklama amacıyla en fazla iki hafta boyunca geçici günlüklere kaydedilir. Grafiğiniz herkese açık bir web sayfasındaki bir resim etiketinde görünüyorsa elbette anlaşılabilir.
    Program politikalarının ihlali.
    Bu Program Politikaları'nın ihlali, grafiğinizin devre dışı bırakılmasına veya kaldırılmasına, gelecekteki grafiklerin yüklenmesinin kara listeye alınmasına, Google hesaplarınızın feshedilmesine ve/veya tüm grafiklerinizin silinmesine neden olabilir.

    Toplulukta Aktif Olma

    Grafik uygulamamı başkalarıyla nasıl paylaşabilirim?
    Başlamak için grafiğinizi Grafik Galerisi'ne yerleştirin. Sitenize tekrar bağlanabilir ve isterseniz kaynak kodunuzu sağlayabilirsiniz. Topluluğun geri bildirimlerini almak için tartışma grubumuza katılın.
    Grafik Galerisi, Görselleştirme API'sını kullanan uygulamaların bir listesidir. Görselleştirme geliştirici topluluğunun, Grafik uygulamalarını paylaşabileceği merkezi bir konum sağlar. Grafik uygulamanızı galeriye göndermek için online olarak başvurun.
    Grafik veri kaynağımı nasıl tanıtabilirim?
    Uygulamanızı Görselleştirme Grubu'nda yayınlayın. Beğenirsek kendimizden bile bahsedebiliriz.