Häufig gestellte Fragen

Erste Schritte

Was ist die Google Visualization API?
Mit der Google Visualization API können Sie Diagramme und Berichtsanwendungen über strukturierte Daten erstellen und direkt in Ihre Website einbinden.
Was kann ich mit der Visualization API tun?
Mit der Google Visualization API können Sie auf strukturierte Daten zugreifen, die lokal in Ihrem Browser erstellt oder aus unterstützten Datenquellen in einem einfachen tabellarischen Format abgerufen wurden. Sie können auch Ihre eigene Datenquelle als Visualisierungs-API-Datenquelle implementieren und eine Visualisierungskonforme Visualisierung und/oder Anwendung für den Zugriff auf Ihre Daten aktivieren. Das Format kann von Berichterstellungs-, Analyse- oder Diagrammanwendungen verwendet werden. Auf diese Weise können Sie die Daten visualisieren und/oder Anwendungen wie Google-Tabellen neue Funktionen hinzufügen.
Wo finde ich die Dokumentation für die Visualization API?
Den Entwicklerleitfaden und alle zugehörigen Informationen finden Sie unter https://developers.google.com/chart/interactive/docs.
Wie erstelle ich ein neues Diagramm?
Am besten lesen Sie die Einführung und den Abschnitt Kurzanleitung.
Was ist eine Datenquellen-URL?
Eine Datenquellen-URL ist die eindeutige URL-ID einer Datenquelle der Visualization API. Die URL einer Datenquelle kann auch Parameter für Diagrammsprachen enthalten. In diesem Fall wird eine Abfrage (z. B. Sortieren, Gruppieren usw.) für die Datenquelle ausgeführt, bevor die Daten abgerufen werden.
Wo finde ich Beispielcode für Diagramm-Apps, die die Visualization API verwenden?
Beispielcode finden Sie in der Dokumentation zu Beispielcode der Visualization API.
Kann eine Flash-Anwendung auf die Visualization API zugreifen?
Auf jeden Fall. Die Visualization API verwendet eine JavaScript API. Es gibt jedoch Bibliotheken, die es JavaScript-Apps ermöglichen, eine Verbindung zu JavaScript-Code herzustellen. Eine solche Bibliothek finden Sie möglicherweise unter http://code.google.com/p/swfobject. Unten finden Sie einige Entwicklungsprobleme mit Flash.
Wie implementiere ich eine Datenquelle?
Lesen Sie den Abschnitt Diagramme verwenden und erstellen, um mehr über die Funktionsweise von Diagrammen zu erfahren. Lesen Sie dann den Abschnitt Datenquellen implementieren, um zu erfahren, wie eine Datenquelle erstellt wird. Sie können auch die Java-Bibliothek für Google-Diagrammdaten verwenden, um schnell zu beginnen, wenn Sie Java verwenden.
Kann ich über eine Java-Anwendung auf ein Diagramm zugreifen?
Ja. Mit der Google Visualization Library für das Google Web Toolkit (GWT) können Sie über den GWT-Compiler auf API-konforme Visualisierungen aus Java-Code zugreifen und mithilfe des GWT-Compilers Visualisierungs-Visualisierungen für Java erstellen. Die Release-Kandidaten-Bibliothek unterstützt auch das Ereignismodell der Visualization API.
Kann ich über eine Anwendung, die mit dem Google Web Toolkit-Compiler geschrieben wurde, auf ein Diagramm zugreifen?
Ja. Mit der Google Visualization Library für das Google Web Toolkit (GWT) können Sie über den GWT-Compiler auf API-konforme Visualisierungen aus Java-Code zugreifen und mithilfe des GWT-Compilers Visualisierungs-Visualisierungen für Java erstellen. Die Release-Kandidaten-Bibliothek unterstützt auch das Ereignismodell der Visualization API.
Ich habe eine andere Frage bzw. ein anderes Problem. An wen kann ich mich wenden, um weitere Informationen zu erhalten?
Posten Sie Ihre Frage in der Diskussionsgruppe zur Google Visualization API, um Hilfe von der Entwickler-Community für Visualization zu erhalten. Das Google-Visualisierungsteam nimmt ebenfalls an dieser Gruppe teil, um Fragen zu beantworten.

API verwenden

Was ist der Unterschied zwischen der Google Chart API und der Google Visualization API?

Mit der Chart API können Sie Bildtypen ganz einfach erstellen. Dazu senden Sie eine formatierte URL, die sowohl die Daten- als auch die Diagrammkonfigurationsoptionen enthält, an einen Google-Server. Die Chart API enthält einen geschlossenen Satz von Diagrammen mit verschiedenen Optionen. Die Chart API-Datasets sind auf die Größe einer URL begrenzt (etwa 2 KB).

Mit der Visualization API können Sie Diagramme und Datenquellen über das Web verbinden und veröffentlichen:

  • Die Visualization API bietet eine JavaScript API für den Zugriff auf Diagramme.
  • Die Diagrammgalerie enthält von Google erstellte Diagramme. Sie ist aber auch für alle Drittanbieter zugänglich, die eigene Visualisierungen für die API erstellen können.
  • Visualization API-Diagramme und -Diagramme können alles sein, was von einem Browser gerendert werden kann. Dazu gehören Bilder, JavaScript, Vektorgrafiken, Flash usw.
  • Über die Visualization API kann auf eine beträchtliche Anzahl von Chart API-Diagrammen zugegriffen werden. Unter Umständen sind jedoch nicht alle Konfigurationsoptionen verfügbar.
  • Die API bietet außerdem ein dokumentiertes Wirkprotokoll und die Möglichkeit, jedem Nutzer seine Datenquellen für eine der APIs-Visualisierungen zugänglich zu machen.
  • Die API hat ein definiertes Ereignismodell, mit dem Diagramme Ereignisse auslösen und empfangen und somit mit ihrer Hostseite und/oder anderen Diagrammen auf der Seite kommunizieren können.
Auf welche Datenquellen kann ich mit der Visualization API zugreifen?
Mit der Visualization API können Sie lokal auf Daten aus Ihrem Browser zugreifen, indem Sie das standardmäßige DataTable-Format der API erstellen oder auf eine beliebige Datenquelle zugreifen, die die API unterstützt. Bekannte Anwendungen, die die API bereits unterstützen, sind Google Tabellen und Salesforce.com auf der Entwicklerplattform Force.com. Sie können auch Ihre eigenen Daten als Diagrammdatenquelle implementieren.
Meine Anwendung erwartet, dass die empfangenen Daten in einem bestimmten Format vorliegen. Wie gehe ich mit Ausnahmen um?
Sie können die Methoden getNumberOfColumns() und getColumnType() der Klasse google.visualization.DataTable verwenden, um zu testen, ob die erhaltenen Daten Ihren Erwartungen entsprechen. Für nicht übereinstimmende Werte wird eine Fehlermeldung ausgegeben.
Ist es sicher, ein Diagramm in meine Website einzubetten?
Code von Drittanbietern direkt auf Ihrer Website auszuführen, stellt ein inhärentes Risiko dar. Google übernimmt keine Gewährleistungen für die Leistung, Qualität, Sicherheit oder Inhalte von Anwendungen. Diagrammanwendungen, die nicht den Nutzungsbedingungen der Google Visualization API entsprechen, können aus den Galerien entfernt werden.
Kann ich Diagramme offline verwenden?
Die Computer der Nutzer müssen Zugriff auf https://www.gstatic.com/charts/loader.js haben, um die interaktiven Funktionen von Google Charts verwenden zu können. Das liegt daran, dass die von deiner Seite benötigten Visualisierungsbibliotheken dynamisch geladen werden, bevor du sie verwendest. Der Code zum Laden der entsprechenden Bibliothek ist Teil des enthaltenen Skripts und wird beim Aufrufen der Methode google.charts.load() aufgerufen. Gemäß unseren Nutzungsbedingungen ist es nicht möglich, den Code google.charts.load oder google.visualization zur Offlineverwendung herunterzuladen.
Kann ich den Diagrammcode lokal und in einem Intranet herunterladen und hosten?
Gemäß unseren Nutzungsbedingungen ist es nicht zulässig, den Code google.charts.load oder google.visualization herunterzuladen und zu speichern oder zu hosten. Wenn Sie jedoch die Interaktivität von Google Charts nicht benötigen, können Sie einen Screenshot der Diagramme erstellen und sie nach Bedarf verwenden.

Fehlerbehebung

Warum wird mein Diagramm nicht angezeigt?

Prüfen Sie zuerst Ihre JavaScript-Konsole. In Chrome können Sie die JavaScript-Konsole über Chrome > Ansicht > Entwickler > JavaScript-Konsole oder Chrome > Tools > JavaScript-Konsole aufrufen. Alle modernen Browser verfügen über eine JavaScript-Konsole. Möglicherweise müssen Sie sich in Menüs mit Namen wie "Erweitert" oder "Entwicklertools" umsehen.

Hoffentlich führt Sie die Konsole sofort zu dem Problem. Manchmal ist es jedoch schwierig, die Konsolennachricht für die zugrunde liegende Ursache zu übersetzen. Hier einige häufige Probleme:

  • Möglicherweise verwenden Sie Google Loader nicht korrekt.
    • Laden Sie die Diagramme/Loader.js einmal. Unabhängig davon, wie viele Diagramme Sie auf Ihrer Webseite haben, sollte der Aufruf jeweils nur so aussehen: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Er kann sich im Kopf oder im Hauptteil Ihrer Webseite befinden, je nachdem, wann der Ladevorgang stattfinden soll.
    • Rufen Sie google.charts.load am besten nur einmal auf und geben Sie an, welche Pakete Sie für Ihre Webseite benötigen. 
      <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>
  • Jedes Diagramm sollte eine eindeutige Element-ID haben (z.B. chart1, chart2 im Beispiel oben).
  • Suchen Sie nach Tippfehlern. Denken Sie daran, dass in JavaScript zwischen Groß- und Kleinschreibung unterschieden wird.

Wenn Sie das Problem immer noch nicht gefunden haben, suchen Sie in der Diskussionsgruppe der Google Visualization API, ob ein ähnliches Problem aufgetreten ist. Wenn du keinen Beitrag findest, in dem deine Frage beantwortet wird, poste deine Frage in der Gruppe zusammen mit einem Link zu einer Webseite, auf der das Problem demonstriert wird. Nehmen Sie nach Möglichkeit ein jsfiddle auf.

Warum weichen meine Monate und Tage um eine?
Google Charts verwendet JavaScript, das eine nullbasierte Indexierung ermöglicht. Der erste Tag des Monats ist 0, die Monate reichen von 0 (Januar) bis 11 (Dezember). Wenn Ihr Code von einer einsbasierten Indexierung abhängt, subtrahieren Sie dies, bevor Sie Ihre Daten in ein JavaScript-Datumsobjekt einfügen.
Warum funktionieren meine Diagramme in einigen, aber nicht in allen Browsern?
Auf caniuse.com findest du viele Informationen zu Browserinkompatibilitäten. Bei Google Charts treten manchmal aus zwei Gründen Probleme in Internet Explorer 8 und früheren Versionen auf:
  • IE8 unterstützt kein SVG. Daher wird in Charts ein Failover auf VML durchgeführt, das stärker begrenzt ist.
  • In JavaScript von IE8 sind nachgestellte Kommas in Listen nicht zulässig.
    • Warum wird mein Flash-basiertes Diagramm beim Testen nicht angezeigt?
    Aufgrund von Flash-Sicherheitseinstellungen funktionieren Flash-basierte Diagramme möglicherweise nicht richtig, wenn der Zugriff von einer Datei im Browser aus (z.B. file:///c:/webhost/myhost/myviz.html) und nicht von einer Webserver-URL (z.B. http://www.myhost.com/myviz.html) erfolgt. Dies ist in der Regel ein Testproblem. Es ist kein Problem, wenn Sie über eine http://-Adresse auf das Diagramm zugreifen. Du kannst dieses Problem beheben, wie auf der Macromedia-Website beschrieben. Im Allgemeinen empfehlen wir, nach Möglichkeit die Flash-Entwicklung zu vermeiden.

    Google-Programmrichtlinien zur Visualisierung

    Welche Programmrichtlinien gelten für Google?
    Wie in den Nutzungsbedingungen beschrieben, können wir die Anzeige von Inhalten, die gegen unsere Programmrichtlinien verstoßen, ablehnen und anzeigen, indem wir auf Folgendes verweisen oder darauf verweisen:
    • Illegale Inhalte.
    • Verletzungen des Datenschutzes
    • Pornografie oder Obszönes
    • Inhalte wie schädlicher Code, die den Computer eines Nutzers oder die Funktion der Host-Webseite beeinträchtigen oder ihm schaden.
    • Inhalte, die Hass verbreiten oder zu Gewalt anstiften
    • Verletzungen des Urheberrechts. Weitere Informationen finden Sie in unserer Richtlinie zum Digital Millennium Copyright Act (DMCA).
    • Markenrechtsverletzungen.
    • Betrügerisches Auftreten als Dritte.

    Entwickler, die Diagramme erstellen, in denen Daten erhoben werden, verpflichten sich, eine rechtlich angemessene Datenschutzerklärung zu führen und darauf zu verweisen. Darüber hinaus müssen Entwickler dafür sorgen, dass ihr Diagramm sicher ist und ihre Anwendung beibehalten wird, solange sie sich im Diagrammverzeichnis befindet.

    Diese Richtlinien können von Zeit zu Zeit ohne vorherige Ankündigung überarbeitet werden.

    Ist die Google Visualization API für die kommerzielle Nutzung verfügbar?
    Ja. Weitere Informationen zum Kleingedruckten finden Sie in den Nutzungsbedingungen für die Google Visualization API.
    Kann ich die Google Visualization API verwenden, um clientseitige Software zu erstellen?
    Derzeit ist es Entwicklern nicht möglich, mit der Visualization API clientseitige Software zu erstellen. Sie können die Visualization API nur über die bereitgestellte Schnittstelle verwenden. Weitere Informationen zum Kleingedruckten finden Sie in den Nutzungsbedingungen für die Google Visualization API.
    Protokolliert Google alle meine Diagrammdaten?
    Die in der HTTP-Anfrage enthaltenen Diagrammdaten werden für interne Test- und Fehlerbehebungszwecke nicht länger als zwei Wochen gespeichert. Natürlich sollten Sie verstehen, dass Ihr Diagramm gecrawlt werden kann, wenn es in einem Bild-Tag auf einer öffentlichen Webseite erscheint.
    Verstöße gegen die Programmrichtlinien.
    Verstöße gegen diese Programmrichtlinien können dazu führen, dass Ihr Diagramm deaktiviert oder entfernt wird, dass Sie von der Aufnahme zukünftiger Diagramme ausgeschlossen werden, Ihre Google-Konten gekündigt und/oder alle Ihre Diagramme gelöscht werden.

    Aktiv in der Community werden

    Wie kann ich meine Chart-Anwendung mit anderen teilen?
    Fügen Sie Ihr Diagramm zuerst in die Diagrammgalerie ein. Sie können einen Link zu Ihrer Website einfügen und den Quellcode bei Bedarf angeben. Nehmen Sie an unserer Diskussionsgruppe teil, um Feedback zur Community zu erhalten.
    In der Chart Gallery finden Sie eine Liste der Anwendungen, die die Visualization API verwenden. Sie bietet der zentralen Entwicklercommunity für die Visualisierung den zentralen Ort, um Diagrammanwendungen zu teilen. Wenn Sie einen Antrag für das Diagramm in der Galerie einreichen möchten, müssen Sie sich online bewerben.
    Wie kann ich meine Chart-Datenquelle hochstufen?
    Stellen Sie Ihre Implementierung in der Visualisierungsgruppe bereit. Wenn es uns gefällt, können wir es sogar selbst erwähnen.