Sık Sorulan Sorular

Başlarken

Google Görselleştirme API'sı nedir?
Google Görselleştirme API'sı, yapılandırılmış veriler üzerinde grafikler ve raporlama uygulamaları oluşturmanıza olanak tanır ve bunları doğrudan web sitenize entegre etmenize yardımcı olur.
Görselleştirme API'sı ile ne yapabilirim?
Google Görselleştirme API'si ile tarayıcınızda yerel olarak oluşturulan veya desteklenen veri kaynaklarından alınan yapılandırılmış verilere basit bir tablo biçiminde erişebilirsiniz. Ayrıca kendi veri kaynağınızı Görselleştirme API'si veri kaynağı olarak uygulayabilir ve Görselleştirmeyle uyumlu herhangi bir görselleştirmenin ve/veya uygulamanın verilerinize erişmesine izin verebilirsiniz. Bu biçim; raporlama, analiz veya grafik uygulamaları için uygundur. Bu şekilde, verileri görselleştirebilir ve/veya Google E-Tablolar gibi uygulamalara yeni işlevler ekleyebilirsiniz.
Görselleştirme API'sıyla ilgili belgeleri nerede bulabilirim?
Geliştirici kılavuzunu ve ilgili diğer tüm belgeleri https://developers.google.com/chart/interactive/docs adresinde bulabilirsiniz.
Nasıl yeni bir Grafik oluşturabilirim?
Kullanmaya başlamanın en iyi yolu Giriş ve Hızlı Başlangıç bölümünü okumaktır.
Veri Kaynağı URL'si nedir?
Veri Kaynağı URL'si, Görselleştirme API'sı veri kaynağının benzersiz URL tanımlayıcısıdır. Bir veri kaynağı URL'si, grafik Sorgu Dili parametrelerini de içerebilir. Bu durumda, verileri getirmeden önce veri kaynağı üzerinde bir sorgu (sıralama, gruplandırma vb.) gerçekleştirilir.
Görselleştirme API'sını kullanan Grafik uygulamalarının örnek kodlarını nerede bulabilirim?
Örnek kodu, Görselleştirme API'si örnek kodu dokümanlarında bulabilirsiniz.
Bir Flash uygulaması Görselleştirme API'sına erişebilir mi?
Kesinlikle. Görselleştirme API'si bir JavaScript API'si kullanır, ancak Flash uygulamalarının JavaScript koduna bağlanmasını sağlayan kitaplıklar vardır. Bu tür bir kitaplıktan yararlanabilirsiniz: http://code.google.com/p/swfobject. Flash'ı etkileyen bazı geliştirme sorunları için aşağıya bakın.
Bir veri kaynağını nasıl uygularım?
Grafiklerin kullanma ve oluşturma ile ilgili bölümünü okuyun. Ardından, veri kaynağı oluşturmayı öğrenmek için Veri Kaynağını Uygulama bölümünü okuyun. Java kullanıyorsanız hızlı bir şekilde başlamak için Google Chart Data Source Java kitaplığını da kullanabilirsiniz.
Java uygulamasından bir grafiğe erişebilir miyim?
Evet. Google Web Araç Seti (GWT) için Google Görselleştirme Kitaplığı, GWT derleyici ile derlenmiş Java kodundan API uyumlu görselleştirmelere erişmenize ve GWT derleyiciyi kullanarak Java'da Görselleştirme API'sı uyumlu görselleştirmeler yazmanıza olanak tanır. Sürüm aday kitaplığı, Görselleştirme API'sı etkinlik modelini de destekler.
Google Web Toolkit (GWT) derleyicisi ile yazılmış bir uygulamadan bir grafiğe erişebilir miyim?
Evet. Google Web Araç Seti (GWT) için Google Görselleştirme Kitaplığı, GWT derleyici ile derlenmiş Java kodundan API uyumlu görselleştirmelere erişmenize ve GWT derleyiciyi kullanarak Java'da Görselleştirme API'sı uyumlu görselleştirmeler yazmanıza olanak tanır. Sürüm aday kitaplığı, Görselleştirme API'sı etkinlik modelini de destekler.
Farklı bir sorum/sorunum var. Daha fazla bilgi edinmek için kiminle iletişime geçmeliyim?
Görselleştirme geliştirici 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 kullanın

Google Chart API ile 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çeneklere sahip kapalı bir grafik grubu içerir. Chart API veri kümeleri, bir URL'nin boyutuyla (yaklaşık 2 bin) sınırlıdır.

Görselleştirme API'si, web üzerinden grafikler ile veri kaynaklarını birbirine bağlamak ve bunları yayınlamak için bir yöntem sunar:

  • Görselleştirme API'sı, grafiklere erişmek için bir JavaScript API'si sağlar.
  • Grafik galerisinde Google tarafından oluşturulan grafikler yer alır. Ancak tüm üçüncü taraflar da kendi Görselleştirme API'sı ile uyumlu görselleştirmelerini oluşturabilir.
  • Görselleştirme API'sı grafikleri ve grafikleri, bir tarayıcı tarafından oluşturulabilen her şey olabilir. Buna resimler, JavaScript, vektör grafikler, Flash vb. dahildir.
  • Görselleştirme API'sı üzerinden çok sayıda Chart API grafiğe erişilebilir ancak bazı yapılandırma seçenekleri kullanılamayabilir.
  • API ayrıca belgelenmiş bir kablo protokolü ve herkesin veri kaynaklarını API görselleştirmelerinden herhangi birine maruz bırakmasına olanak tanır.
  • API'nin, grafiklerin etkinlik yayınlamasına ve almasına ve böylece ana makine sayfası ve/veya sayfadaki diğer grafiklerle iletişim kurmasına izin veren tanımlanmış bir etkinlik modeli vardır.
Görselleştirme API'sını kullanarak hangi veri kaynaklarına erişebilirim?
Görselleştirme API'si sayesinde, API'nin standart DataTable biçimini oluşturarak tarayıcınızdan verilere yerel olarak erişebilir veya API'yi destekleyen herhangi bir veri kaynağına erişebilirsiniz. Force.com geliştirici platformundaki Google E-Tablolar ve Salesforce.com, API'yi halihazırda destekleyen popüler uygulamalardır. Kendi verilerinizi de Grafik veri kaynağı olarak 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 için hata mesajı göndermek amacıyla google.visualization.DataTable sınıfının getNumberOfColumns() ve getColumnType() yöntemlerini kullanabilirsiniz.
Web siteme grafik yerleştirmek güvenli mi?
Doğrudan web sitenizde üçüncü taraf kodu çalıştırmak doğal riskler doğurur. Google; uygulama performansı, kalitesi, güvenlik veya içerik konusunda hiçbir vaatte ya da beyanda bulunmaz. Google Görselleştirme API'sı Hizmet Şartları'na uymayan grafik uygulamaları galerilerden kaldırılabilir.
Grafikleri çevrimdışı kullanabilir miyim?
Google Charts'ın etkileşimli özelliklerini kullanmak için kullanıcılarınızın bilgisayarlarının https://www.gstatic.com/charts/loader.js'ye erişimi olmalıdır. Bunun nedeni, sayfanızın gerektirdiği görselleştirme kitaplıklarının siz kullanmadan önce dinamik olarak yüklenmesidir. Uygun kitaplığı yükleme kodu, eklenen 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, google.charts.load veya google.visualization kodunu internet bağlantısı olmadan kullanmak için indirmenize izin vermez.
Grafik kodunu yerel olarak veya bir intranette indirip barındırabilir miyim?
Maalesef hizmet şartlarımız, google.charts.load veya google.visualization kodunu indirmenize ve kaydetmenize ya da barındırmanıza izin vermez. Bununla birlikte, Google Grafikler'in etkileşimliliğine 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->Görünüm->Geliştirici->JavaScript Konsolu veya Chrome->Araçlar->JavaScript Konsolu üzerinden erişebilirsiniz. Tüm modern tarayıcılarda JavaScript konsolu vardır; bu konsolu bulmak için "Gelişmiş" veya "Geliştirici Araçları" gibi adlara sahip menüleri araştırmanız gerekebilir.

Konsolun sizi hemen soruna yönlendireceğini umuyoruz. Ancak bazen konsol mesajını asıl nedene çevirmek zor olabilir. Sık karşılaşılan sorunlardan bazıları şunlardır:

  • Google Loader'ı yanlış kullanıyor olabilirsiniz.
    • Grafikleri/loader.js'yi yalnızca bir kez yükleyin. Web sayfanızda kaç grafik olursa olsun şunun gibi yalnızca bir tane çağrı olmalıdır: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Bu, yüklemenin ne zaman gerçekleşmesini istediğinize bağlı olarak web sayfanızın başlığında veya gövdesinde olabilir.
    • İdeal olarak, web sayfanız için ihtiyacınız olan tüm paketlerle birlikte google.charts.load öğesini yalnızca bir kez çağırı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, chart2) kaldırın.
  • Yazım hatalarını arayın. JavaScript'in büyük/küçük harfe duyarlı bir dil olduğunu unutmayın.

Halen yanıt bulamadıysanız Google Görselleştirme API'sı tartışma grubunda arama yaparak benzer bir sorunla karşılaşan olup olmadığını öğrenin. Sorunuzun yanıtını içeren 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.

Bana özel ay ve gün sayısı neden bir?
Google Charts, sıfır tabanlı dizine ekleme kullanan JavaScript kullanmaktadır. Ayın ilk günü 0'dır. Aylar 0 (Ocak) ile 11 (Aralık) aralığındadır. Kodunuzda tek tabanlı dizine ekleme varsayıldığında verilerinizi JavaScript tarih nesnesine koymadan önce bunlardan birini çıkarın.
Grafiklerim neden bazı tarayıcılarda çalışıyor da hepsinde çalışmıyor?
Tarayıcı uyumsuzluklarıyla ilgili bilgi dolu bir hazine için caniuse.com'u öneririz. Google Grafikler ile Internet Explorer 8 ve önceki sürümlerde bazen iki nedenden dolayı sorunlar olabilir:
  • IE8, SVG'yi desteklemediğinden Charts, daha sınırlı olan VML'ye geçiş yapar.
  • IE8'in JavaScript'i, listelerde sondaki virgüllere izin vermez.
    • Flash tabanlı grafiğim test ettiğimde neden görünmüyor?
    Flash güvenlik ayarları nedeniyle, Flash tabanlı grafikler bir web sunucusu URL'sinden (ör. http://www.anamakinem.com/myviz.html) değil, tarayıcıdaki bir dosya konumundan (ör. file:///c:/webhost/myhost/myviz.html) erişildiğinde doğru şekilde çalışmayabilir. Bu sorun genellikle yalnızca testle ilgili bir sorundur. Grafiğe bir http:// adresinden eriştiğinizde sorun yaşamazsınız. Bu sorunu Macromedia 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ığı üzere, aşağıdaki içerikleri görüntüleyerek veya bunlara bağlantı vererek program politikamızı ihlal eden içeriği dahil etmeyi ve görüntülemeyi reddedebiliriz:
    • Yasa dışı içerik.
    • Kişisel gizliliğin ihlali
    • Pornografi veya müstehcenlik
    • Kullanıcının bilgisayarını veya ana makine web sayfasının çalışmasını engelleyen veya zarar veren içerik (ör. kötü amaçlı kod).
    • Nefreti veya şiddeti teşvik eden içerikler.
    • Telif hakkı ihlalleri. Daha fazla bilgi için DMCA politikamızı inceleyebilirsiniz.
    • Ticari marka ihlalleri.
    • Üçüncü tarafların kimliğine bürünme.

    Veri toplayan grafikler oluşturan geliştiriciler, yasal olarak yeterli düzeyde bir gizlilik politikasına sahip olmayı ve bu politikaya bağlantı vermeyi kabul ederler. Ayrıca, geliştiricilerin grafiklerinin güvenli olduğundan emin olmaları ve grafik dizininde yer aldığı sürece uygulamalarını korumaları gerekir.

    Bu politikalar zaman zaman bildirimde bulunmaksızın değiştirilebilir.

    Google Görselleştirme API'sı ticari kullanım için mevcut mu?
    Evet. Ayrıntılı bilgi için lütfen 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'sini kullanabilir miyim?
    Şu anda geliştiricilerin istemci tarafı yazılım oluşturmak için Görselleştirme API'sini kullanmasına izin verilmemektedir. 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 iki haftadan uzun süre boyunca geçici günlüklere kaydedilir. Grafiğinizin herkese açık bir web sayfasındaki resim etiketinde görünüyorsa elbette taranabileceğini unutmayın.
    Program politikalarının ihlali.
    Bu Program Politikaları'nın ihlal edilmesi; grafiğinizin devre dışı bırakılmasına veya kaldırılmasına, gelecekte grafikleri yüklememeniz için kara listeye alınmanıza, Google hesaplarınızın feshedilmesine ve/veya tüm grafiklerinizin silinmesine neden olabilir.

    Toplulukta Aktif Olma

    Chart uygulamamı başkalarıyla nasıl paylaşabilirim?
    İlk olarak, grafiğinizi Grafik Galerisi'ne yerleştirin. İsterseniz tekrar sitenize bağlantı verebilir ve kaynak kodunuzu sağlayabilirsiniz. Topluluğun geri bildirimini almak için tartışma grubumuza katılın.
    Grafik Galerisi, Görselleştirme API'sini kullanan uygulamaların bir listesidir. Görselleştirme geliştirici topluluğunun Chart uygulamalarını paylaşabileceği merkezi bir konum sağlar. Grafik başvurunuzu galeriye göndermek için online başvuru yapın.
    Grafik veri kaynağımı nasıl tanıtabilirim?
    Uygulamanızı Görselleştirme Grubu'nda yayınlayın. Beğenirsek bundan kendimiz bile bahsedebiliriz.