FAQs

Erste Schritte

Was ist die Google Visualization API?
Mit der Google Visualization API können Sie anhand strukturierter Daten Diagramme und Berichtsanwendungen erstellen und diese direkt in Ihre Website einbinden.
Was kann ich mit der Visualization API tun?
Mit der Google Visualization API können Sie in einem einfachen Tabellenformat auf strukturierte Daten zugreifen, die lokal in Ihrem Browser erstellt oder aus unterstützten Datenquellen abgerufen wurden. Sie können auch eine eigene Datenquelle als Datenquelle für die Visualization API implementieren und den Zugriff auf Ihre Daten für eine Visualisierungs- und/oder Anwendung mit Visualisierungen aktivieren. Das Format kann von Berichts-, Analyse- oder Diagrammanwendungen verwendet werden. So 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 weitere zugehörige Dokumentationen finden Sie unter https://developers.google.com/chart/interactive/docs.
Wie erstelle ich ein neues Diagramm?
Lesen Sie am besten die Einführung und die Kurzanleitung.
Was ist eine Datenquellen-URL?
Die Datenquellen-URL ist die eindeutige URL-Kennung einer Visualization API-Datenquelle. Eine Datenquellen-URL kann auch Parameter für die Abfragesprache des Diagramms enthalten. In diesem Fall wird vor dem Abrufen der Daten eine Abfrage (z. B. Sortieren oder Gruppieren) für die Datenquelle ausgeführt.
Wo finde ich Beispielcode für Diagrammanwendungen, die die Visualization API verwenden?
Beispielcode finden Sie in der Dokumentation zum Beispielcode für die 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, mit denen Flash-Anwendungen eine Verbindung mit JavaScript-Code herstellen können. Eine solche Bibliothek, die Sie möglicherweise nützlich finden, finden Sie unter http://code.google.com/p/swfobject. Unten finden Sie Informationen zu einigen Entwicklungsproblemen, die sich auf Flash auswirken.
Wie implementiere ich eine Datenquelle?
Im Abschnitt Diagramme verwenden und erstellen erfahren Sie, wie Diagramme funktionieren. Lesen Sie anschließend Datenquelle implementieren, um zu erfahren, wie Sie eine Datenquelle erstellen. Wenn Sie Java verwenden, können Sie für einen schnellen Einstieg auch die Java-Bibliothek für die Google-Diagramm-Datenquelle verwenden.
Kann ich von einer Java-Anwendung aus auf ein Diagramm zugreifen?
Ja. Über die Google-Visualisierungsbibliothek für das Google Web Toolkit (GWT) können Sie auf den API-konformen Java-Code zugreifen, der mit dem GWT-Compiler kompiliert wurde. Außerdem haben Sie die Möglichkeit, mit dem GWT-Complier die Visualization API-konforme Visualisierungen in Java zu schreiben. Die Bibliothek für Releasekandidaten unterstützt auch das Ereignismodell der Visualization API.
Kann ich aus einer Anwendung, die mit dem Google Web Toolkit (GWT)-Compiler erstellt wurde, auf ein Diagramm zugreifen?
Ja. Über die Google-Visualisierungsbibliothek für das Google Web Toolkit (GWT) können Sie auf den API-konformen Java-Code zugreifen, der mit dem GWT-Compiler kompiliert wurde. Außerdem haben Sie die Möglichkeit, mit dem GWT-Complier die Visualization API-konforme Visualisierungen in Java zu schreiben. Die Bibliothek für Releasekandidaten 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 Visualisierungen zu erhalten. Das Google-Visualisierungsteam ist auch Teil dieser Gruppe, um Fragen zu beantworten.

API verwenden

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

Die Chart API bietet eine einfache Möglichkeit zum Erstellen verschiedener Bilddiagramme. Dazu wird eine formatierte URL, die sowohl die Daten- als auch die Diagrammkonfigurationsoptionen enthält, an einen Google-Server gesendet. Die Chart API enthält einen geschlossenen Satz von Diagrammen mit verschiedenen Optionen. Die Chart API-Datasets sind auf die Größe einer URL beschränkt (etwa 2.000).

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

  • Die Visualization API bietet eine JavaScript API für den Zugriff auf Diagramme.
  • Die zugehörige Diagrammgalerie enthält von Google erstellte Diagramme. Es steht aber auch allen Drittanbietern offen, ihre eigenen Visualization-API-kompatiblen Visualisierungen zu erstellen.
  • Diagramme und Diagramme in Visualization API können alle Daten sein, die von einem Browser gerendert werden können. Dazu gehören Bilder, JavaScript, Vektorgrafiken, Flash usw.
  • Auf eine erhebliche Anzahl von Chart API-Diagrammen kann über die Visualization API zugegriffen werden, wobei einige Konfigurationsoptionen möglicherweise nicht verfügbar sind.
  • Die API bietet auch ein dokumentiertes Wire-Protokoll und eine Möglichkeit für alle, ihre Datenquellen für die API-Visualisierungen verfügbar zu machen.
  • Die API verfügt über ein definiertes Ereignismodell, das es Diagrammen ermöglicht, Ereignisse auszulösen und zu empfangen und so mit ihrer Hostseite und/oder anderen Diagrammen auf der Seite zu kommunizieren.
Auf welche Datenquellen kann ich mit der Visualization API zugreifen?
Mit der Visualization API können Sie lokal über Ihren Browser auf Daten zugreifen. Dazu erstellen Sie das DataTable-Standardformat der API oder greifen auf eine beliebige Datenquelle zu, 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 Datenquelle für Diagramme implementieren.
Meine Anwendung erwartet, dass die empfangenen Daten in einem bestimmten Format vorliegen. Wie gehe ich mit Ausnahmen um?
Mit den Methoden getNumberOfColumns() und getColumnType() der Klasse google.visualization.DataTable können Sie testen, ob die abgerufenen Daten Ihren Erwartungen entsprechen, und bei Abweichungen eine Fehlermeldung ausgeben.
Ist es sicher, ein Diagramm in meine Website einzubetten?
Die Ausführung von Drittanbietercode direkt auf Ihrer Website birgt inhärente Risiken. Google gibt keinerlei Versprechen oder Zusicherungen in Bezug auf Anwendungsleistung, Qualität, Sicherheit oder Inhalte ab. 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 nutzen zu können. Das liegt daran, dass die für Ihre Seite erforderlichen Visualisierungsbibliotheken vor der Verwendung dynamisch geladen werden. Der Code zum Laden der entsprechenden Bibliothek ist Teil des enthaltenen Skripts und wird aufgerufen, wenn Sie die Methode google.charts.load() aufrufen. Gemäß unseren Nutzungsbedingungen dürfen Sie die Codes google.charts.load oder google.visualization nicht herunterladen, um sie offline zu verwenden.
Kann ich den Diagrammcode lokal oder in einem Intranet herunterladen und hosten?
Gemäß unseren Nutzungsbedingungen dürfen Sie den google.charts.load- oder google.visualization-Code leider nicht herunterladen, speichern oder hosten. Wenn Sie die Interaktivität von Google Charts nicht benötigen, können Sie Screenshots der Diagramme erstellen und sie nach Bedarf verwenden.

Fehlerbehebung

Warum wird mein Diagramm nicht angezeigt?

Überprüfen Sie zunächst die JavaScript-Konsole. In Chrome können Sie über Chrome->Ansicht->Entwickler->JavaScript-Konsole oder Chrome->Tools->JavaScript-Konsole auf die JavaScript-Konsole zugreifen. Alle modernen Browser verfügen über eine JavaScript-Konsole. Möglicherweise müssen Sie in Menüs mit Namen wie „Erweitert“ oder „Entwicklertools“ suchen, um sie zu finden.

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

  • Möglicherweise verwenden Sie das Ladeprogramm von Google nicht richtig.
    • Laden Sie die Diagramme/loader.js nur einmal. Unabhängig davon, wie viele Diagramme auf Ihrer Webseite vorhanden sind, sollten Sie nur einen Aufruf wie diesen verwenden: 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Das kann im Header oder im Text Ihrer Webseite sein, je nachdem, wann der Ladevorgang stattfinden soll.
    • Rufen Sie google.charts.load im Idealfall nur einmal auf und geben Sie dabei alle Pakete an, die 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 obigen Beispiel).
  • Suchen Sie nach Tippfehlern. Denken Sie daran, dass in JavaScript zwischen Groß- und Kleinschreibung unterschieden wird.

Wenn Sie das hier nicht wissen, durchsuchen Sie die Diskussionsgruppe zur Google Visualization API, um herauszufinden, ob ein ähnliches Problem aufgetreten ist. Wenn Sie keinen Beitrag finden, der Ihre Frage beantwortet, posten Sie Ihre Frage zusammen mit einem Link zu einer Webseite, auf der das Problem dargestellt wird. Fügen Sie nach Möglichkeit jsfiddle hinzu.

Warum sind meine Monate und Tage um eins?
Google Charts verwendet JavaScript, das eine nullbasierte Indexierung nutzt. Der erste Tag des Monats ist 0 und die Monate reichen von 0 (Januar) bis 11 (Dezember). Wenn in deinem Code von einer auf eins basierenden Indexierung ausgegangen wird, entferne 1, bevor du die Daten in ein JavaScript-Datumsobjekt einfügst.
Warum funktionieren meine Diagramme in einigen Browsern, aber nicht in allen?
Wir empfehlen caniuse.com mit einer Fülle von Informationen zu Browser-Inkompatibilitäten. Mit Google Charts können in Internet Explorer 8 und früheren Versionen manchmal Probleme auftreten, und zwar aus zwei Gründen:
  • IE8 unterstützt SVG nicht, sodass Charts zu VML wechselt, das stärker eingeschränkt ist.
  • Beim JavaScript von IE8 sind nachgestellte Kommas in Listen nicht zulässig.
    • Warum wird mein Flash-basiertes Diagramm nicht angezeigt, wenn ich es teste?
    Aufgrund der Flash-Sicherheitseinstellungen funktionieren Flash-basierte Diagramme möglicherweise nicht richtig, wenn sie von einem Dateispeicherort im Browser (z.B. file:///c:/webhost/myhost/myviz.html) statt von einer Webserver-URL (z.B. http://www.myhost.com/myviz.html) aus aufgerufen werden. Dies ist in der Regel nur ein Testproblem. Es tritt nicht auf, wenn Sie über eine http://-Adresse auf das Diagramm zugreifen. Sie können dieses Problem wie auf der Macromedia-Website beschrieben beheben. Im Allgemeinen wird empfohlen, nach Möglichkeit auf die Flash-Entwicklung zu verzichten.

    Programmrichtlinie für Google-Visualisierung

    Was ist die Programmrichtlinie für Google-Visualisierungen?
    Wie in den Nutzungsbedingungen beschrieben, behalten wir uns vor, Inhalte, die gegen unsere Programmrichtlinien verstoßen, abzulehnen und zu zeigen, indem wir Folgendes anzeigen oder verlinken:
    • Illegale Inhalte
    • Verletzungen der Privatsphäre.
    • Pornografie oder Obszönitäten
    • Inhalte, z. B. schädlicher Code, der den Computer eines Nutzers oder die Funktionsweise der Hostwebseite stört oder schädigen kann.
    • Inhalte, die Hass verbreiten oder zu Gewalt anstiften
    • Verletzungen des Urheberrechts. Weitere Informationen hierzu erhalten Sie in unserer Richtlinie zum US-amerikanischen Urheberrechtsgesetz (Digital Millennium Copyright Act).
    • Markenrechtsverletzungen
    • Identitätsdiebstahl

    Entwickler, die Diagramme zur Datenerhebung erstellen, erklären sich damit einverstanden, eine rechtlich angemessene Datenschutzerklärung einzuhalten und mit ihr zu verknüpfen. Darüber hinaus müssen Entwickler dafür sorgen, dass ihr Diagramm sicher ist und ihre Anwendung verwalten muss, solange sie sich im Diagrammverzeichnis befindet.

    Diese Richtlinien können von Zeit zu Zeit ohne Vorankündigung geändert werden.

    Ist die Google Visualization API für die kommerzielle Nutzung verfügbar?
    Ja. Weitere Informationen finden Sie in den Nutzungsbedingungen für die Google Visualization API.
    Kann ich mit der Google Visualization API clientseitige Software erstellen?
    Derzeit erlauben wir Entwicklern nicht, mit der Visualization API clientseitige Software zu erstellen. Sie können die Visualization API nur über die bereitgestellte Schnittstelle verwenden. Weitere Informationen finden Sie in den Nutzungsbedingungen für die Google Visualization API.
    Protokolliert Google alle meine Diagrammdaten?
    Die in der HTTP-Anfrage enthaltenen Diagrammdaten werden zu internen Test- und Fehlerbehebungszwecken maximal zwei Wochen in temporären Logs gespeichert. Natürlich sollten Sie wissen, dass ein 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 zur Deaktivierung oder Entfernung Ihres Diagramms, zur Sperrliste für den Upload zukünftiger Diagramme, zur Kündigung Ihrer Google-Konten und/oder zur Löschung aller Diagramme führen.

    Aktiv in der Community werden

    Wie kann ich meine Chart-Anwendung mit anderen teilen?
    Platzieren Sie das Diagramm zuerst in der Diagrammgalerie. Wenn Sie möchten, können Sie einen Link zu Ihrer Website erstellen und Ihren Quellcode angeben. Beteiligen Sie sich an unserer Diskussionsgruppe, um Feedback von der Community zu erhalten.
    Die Diagrammgalerie enthält eine Liste der Anwendungen, die die Visualization API verwenden. Es bietet einen zentralen Ort, an dem die Entwickler-Community für Visualisierungen Chart-Anwendungen gemeinsam nutzen kann. Wenn Sie Ihre Diagrammbewerbung an die Galerie senden möchten, bewerben Sie sich online.
    Wie kann ich meine Datenquelle für Diagramme hochstufen?
    Posten Sie Ihre Implementierung in der Visualisierungsgruppe. Wenn sie uns gefällt, erwähnen wir sie vielleicht selbst.