Questions fréquentes

Premiers pas

Qu'est-ce que l'API Google Visualization ?
L'API Google Visualization vous permet de créer des graphiques et des applications de reporting à partir de données structurées, et vous aide à les intégrer directement à votre site Web.
Que puis-je faire avec l'API de visualisation ?
Avec l'API Google Visualization, vous pouvez accéder à des données structurées créées localement dans votre navigateur ou récupérées à partir de sources de données compatibles dans un format tabulaire simple. Vous pouvez également implémenter votre propre source de données en tant que source de données de l'API Visualization, et autoriser toute visualisation et/ou application compatibles avec la visualisation à accéder à vos données. Ce format peut être utilisé dans des applications de création de rapports, d'analyse ou de création de graphiques. Vous pouvez ainsi visualiser les données et/ou ajouter de nouvelles fonctionnalités à des applications, telles que Google Sheets.
Où puis-je trouver de la documentation sur l'API de visualisation ?
Le guide du développeur et toute la documentation associée sont disponibles à l'adresse https://developers.google.com/chart/interactive/docs.
Comment créer un graphique ?
Le meilleur moyen de commencer est de lire l'introduction et la section Démarrage rapide.
Qu'est-ce qu'une URL de source de données ?
Une URL de source de données est l'identifiant unique d'une source de données de l'API de visualisation. L'URL d'une source de données peut également inclure des paramètres du langage de requête des graphiques. Dans ce cas, une requête (telle que tri, regroupement, etc.) est effectuée sur la source de données avant de récupérer les données.
Où puis-je trouver des exemples de code d'applications de graphique utilisant l'API de visualisation ?
Vous trouverez un exemple de code dans la documentation de l'exemple de code de l'API Visualization.
Une application Flash peut-elle accéder à l'API de visualisation ?
Absolument. L'API Visualization utilise une API JavaScript, mais il existe des bibliothèques qui permettent aux applications Flash de se connecter avec du code JavaScript. Une de ces bibliothèques peut s'avérer utile, disponible à l'adresse http://code.google.com/p/swfobject. Vous trouverez ci-dessous certains problèmes affectant Flash lors du développement.
Comment implémenter une source de données ?
Lisez la section sur l'utilisation et la création d'un graphique pour comprendre son fonctionnement, puis consultez l'article Implémenter une source de données pour savoir comment créer une source de données. Si vous utilisez Java, vous pouvez également utiliser la bibliothèque Java Google Chart Data Source pour démarrer rapidement.
Puis-je accéder à un graphique à partir d'une application Java ?
Oui. La bibliothèque de visualisation Google pour Google Web Toolkit (GWT) vous permet d'accéder aux visualisations compatibles avec l'API à partir du code Java compilé avec le compilateur GWT et d'écrire des visualisations compatibles avec l'API de visualisation en Java à l'aide du compilateur GWT. La bibliothèque candidate pour la version est également compatible avec le modèle d'événement de l'API de visualisation.
Puis-je accéder à un graphique à partir d'une application écrite avec le compilateur Google Web Toolkit (GWT) ?
Oui. La bibliothèque de visualisation Google pour Google Web Toolkit (GWT) vous permet d'accéder aux visualisations compatibles avec l'API à partir du code Java compilé avec le compilateur GWT et d'écrire des visualisations compatibles avec l'API de visualisation en Java à l'aide du compilateur GWT. La bibliothèque candidate pour la version est également compatible avec le modèle d'événement de l'API de visualisation.
J'ai une autre question ou un autre problème. Qui dois-je contacter pour obtenir plus d'informations ?
Veuillez poser votre question dans le groupe de discussion sur l'API Google Visualization pour obtenir de l'aide de la communauté des développeurs de la visualisation. L'équipe de visualisation de Google participe également à ce groupe pour répondre aux questions.

Utiliser l'API

Quelle est la différence entre l'API de création de graphiques Google et l'API de visualisation de Google ?

L'API Chart offre un moyen simple de créer des graphiques au format image de différents types en envoyant à un serveur Google une URL mise en forme incluant à la fois les données et les options de configuration du graphique. L'API Charts inclut un ensemble fermé de graphiques avec diverses options. Les ensembles de données de l'API Chart sont limités à la taille d'une URL (environ 2 Ko).

L'API Visualization permet de connecter des graphiques et des sources de données sur le Web, et de les publier:

  • L'API Visualization fournit une API JavaScript pour accéder aux graphiques.
  • Sa galerie de graphiques inclut des graphiques créés par Google, mais elle est également ouverte à tous les tiers qui souhaitent créer leurs propres visualisations compatibles avec l'API de visualisation.
  • Les graphiques de l'API de visualisation peuvent être n'importe quel élément pouvant être affiché par un navigateur. Il peut s'agir d'images, de JavaScript, de graphiques vectoriels, de fichiers Flash, etc.
  • Un nombre considérable de graphiques de l'API Chart sont accessibles via l'API de visualisation, bien que certaines de leurs options de configuration ne soient pas disponibles.
  • L'API fournit également un protocole de communication documenté et permet à quiconque d'exposer ses sources de données à n'importe quelle visualisation des API.
  • L'API dispose d'un modèle d'événement défini qui permet aux graphiques de générer et de recevoir des événements, et ainsi de communiquer avec leur page hôte et/ou d'autres graphiques de la page.
À quelles sources de données puis-je accéder à l'aide de l'API de visualisation ?
Avec l'API Visualization, vous pouvez accéder aux données localement depuis votre navigateur en créant le format DataTable standard de l'API, ou accéder à n'importe quelle source de données compatible avec l'API. Google Sheets et Salesforce.com sont des applications réputées déjà compatibles avec l'API sur leur plate-forme pour les développeurs Force.com. Vous pouvez également implémenter vos propres données en tant que source de données sous forme de graphique.
Mon application s'attend à ce que les données qu'elle reçoit soient dans un format spécifique. Comment gérer les exceptions ?
Vous pouvez utiliser les méthodes getNumberOfColumns() et getColumnType() de la classe google.visualization.DataTable pour vérifier que les données obtenues correspondent à vos attentes et envoyer un message d'erreur en cas d'incohérence.
Puis-je intégrer un graphique sur mon site Web en toute sécurité ?
L'exécution de code tiers directement sur votre site Web présente des risques inhérents. Google ne fait aucune promesse et ne fait aucune déclaration concernant les performances, la qualité, la sécurité ou le contenu des applications. Les applications de création de graphiques qui ne respectent pas les Conditions d'utilisation de l'API Google Visualization peuvent être supprimées des galeries.
Puis-je utiliser des graphiques hors connexion ?
Les ordinateurs de vos utilisateurs doivent avoir accès à l'adresse https://www.gstatic.com/charts/loader.js pour utiliser les fonctionnalités interactives de Google Charts. En effet, les bibliothèques de visualisation requises par votre page sont chargées de manière dynamique avant que vous ne les utilisiez. Le code permettant de charger la bibliothèque appropriée fait partie du script inclus et est appelé lorsque vous appelez la méthode google.charts.load(). Nos Conditions d'utilisation ne vous autorisent pas à télécharger le code google.charts.load ou google.visualization pour les utiliser hors connexion.
Puis-je télécharger et héberger le code du graphique en local ou sur un intranet ?
Désolé, nos Conditions d'utilisation ne vous autorisent pas à télécharger, enregistrer ni héberger le code google.charts.load ou google.visualization. Toutefois, si vous n'avez pas besoin de l'interactivité des graphiques Google, vous pouvez effectuer une capture d'écran des graphiques et les utiliser comme vous le souhaitez.

Dépannage

Pourquoi mon graphique ne s'affiche-t-il pas ?

Commencez par vérifier votre console JavaScript. Dans Chrome, vous pouvez accéder à la console JavaScript via Chrome > Affichage > Développeur > Console JavaScript, ou via Chrome > Outils > Console JavaScript. Tous les navigateurs récents disposent d'une console JavaScript. Vous devrez peut-être parcourir des menus portant des noms tels que "Avancé" ou "Outils pour les développeurs" pour les trouver.

J'espère que la console vous mène immédiatement au problème. Cependant, il est parfois difficile de traduire le message de la console pour déterminer la cause sous-jacente. Voici quelques pièges courants:

  • Vous utilisez peut-être Google Loader de manière incorrecte.
    • Le fichier charts/loader.js ne doit être chargé qu'une seule fois. Quel que soit le nombre de graphiques présents sur votre page Web, vous ne devez utiliser qu'un seul appel de ce type : 
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Il peut s'agir de l'en-tête ou du corps de votre page Web, selon le moment auquel vous souhaitez que le chargement s'effectue.
    • Idéalement, n'appelez google.charts.load qu'une seule fois, avec tous les packages dont vous avez besoin pour votre page Web. 
      <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>
  • Chaque graphique doit posséder un ID d'élément unique (par exemple, chart1, chart2 dans l'exemple ci-dessus).
  • Vérifiez qu'il ne contient pas de fautes de frappe. Rappelez-vous que le langage JavaScript est sensible à la casse.

Si le problème persiste, effectuez une recherche dans le groupe de discussion de l'API Google Visualization pour voir si quelqu'un a rencontré un problème similaire. Si vous ne trouvez pas de message qui réponde à votre question, posez votre question au groupe en l'accompagnant d'un lien vers une page Web qui illustre le problème. Si possible, incluez un jsfiddle.

Pourquoi mes mois et mes jours de congé sont-ils comptés d'une unité ?
Google Charts utilise JavaScript, qui utilise une indexation basée sur zéro. Le premier jour du mois est 0, et la plage de mois va de 0 (janvier) à 11 (décembre). Si votre code suppose une indexation unique, soustrayez-en une avant de placer vos données dans un objet de date JavaScript.
Pourquoi mes graphiques fonctionnent-ils dans certains navigateurs, mais pas dans tous ?
Nous vous recommandons d'utiliser caniuse.com pour obtenir une mine d'informations sur les incompatibilités des navigateurs. Avec les graphiques Google, des problèmes peuvent parfois survenir dans Internet Explorer 8 et les versions antérieures, pour deux raisons:
  • Étant donné qu'IE8 n'est pas compatible avec le format SVG, les graphiques basculent vers VML, qui est plus limitée.
  • Le code JavaScript d'IE8 n'autorise pas les virgules de fin dans les listes.
    • Pourquoi mon graphique Flash ne s'affiche-t-il pas lorsque je le teste ?
    En raison des paramètres de sécurité de Flash, il est possible que les graphiques Flash ne fonctionnent pas correctement lorsqu'ils sont accessibles depuis un emplacement de fichier dans le navigateur (par exemple, file:///c:/webhost/monhôte/myviz.html) plutôt qu'à partir d'une URL de serveur Web (par exemple, http://www.monhôte.com/myviz.html). Il s'agit généralement d'un problème de test uniquement. Le problème ne se pose pas lorsque vous accédez au graphique à partir d'une adresse http://. Vous pouvez résoudre ce problème comme décrit sur le site Web de Macromedia. En général, nous recommandons d'éviter le développement Flash dans la mesure du possible.

    Règlement du programme de visualisation Google

    Quel est le règlement du programme de visualisation Google ?
    Comme indiqué dans les Conditions d'utilisation, nous pouvons refuser d'inclure ou d'afficher des contenus qui ne respectent pas le règlement de notre programme en affichant ou en redirigeant vers :
    • Contenu illégal.
    • Non-respect de la vie privée.
    • Pornographie ou obscénité
    • Contenu, tel que du code malveillant, qui interfère avec l'ordinateur de l'utilisateur ou le fonctionnement de la page Web hôte, ou qui est préjudiciable à celui-ci.
    • des incitations à la haine ou à la violence ;
    • le non-respect des droits d'auteur. Pour en savoir plus, consultez la réglementation DMCA.
    • Non-respect des marques.
    • Usurpation d'identité de tiers

    Les développeurs qui créent des graphiques qui collectent des données acceptent de maintenir des règles de confidentialité juridiquement adéquates et d'ajouter des liens vers celles-ci. En outre, nous demandons aux développeurs de s'assurer que leur graphique est sécurisé et de gérer leur application tant qu'elle se trouve dans le répertoire des graphiques.

    Ces règles peuvent être modifiées de temps en temps sans préavis.

    L'API Google Visualization est-elle disponible pour une utilisation commerciale ?
    Oui. Pour en savoir plus, veuillez consulter les Conditions d'utilisation de l'API Google Visualization.
    Puis-je utiliser l'API Google Visualization pour créer des logiciels côté client ?
    À l'heure actuelle, nous n'autorisons pas les développeurs à utiliser l'API Visualization pour créer des logiciels côté client. Vous ne pouvez utiliser l'API Visualization que via l'interface fournie. Pour en savoir plus, veuillez consulter les Conditions d'utilisation de l'API Google Visualization.
    Toutes les données de mes graphiques sont-elles consignées par Google ?
    Les données du graphique incluses dans la requête HTTP sont enregistrées dans des journaux temporaires pendant une durée maximale de deux semaines à des fins de test et de débogage internes. Bien entendu, vous devez comprendre que si votre graphique apparaît dans un tag d'image sur une page Web publique, il pourrait être exploré.
    Non-respect du règlement du programme.
    Le non-respect du règlement du programme peut entraîner la désactivation ou la suppression de votre graphique, l'inscription sur une liste noire interdisant l'importation de futurs graphiques, la clôture de vos comptes Google et/ou la suppression de tous vos graphiques.

    Rester actif dans la communauté

    Comment partager mon application Charte avec d'autres utilisateurs ?
    Commencez par placer votre graphique dans la galerie de graphiques. Si vous le souhaitez, vous pouvez rediriger les internautes vers votre site et fournir votre code source. Rejoignez notre groupe de discussion pour obtenir les commentaires de la communauté.
    La galerie de graphiques est une liste d'applications qui utilisent l'API de visualisation. Il permet à la communauté des développeurs de visualisations de partager des applications graphiques de façon centralisée. Pour envoyer votre application de création de graphiques à la galerie, inscrivez-vous en ligne.
    Comment promouvoir ma source de données de graphique ?
    Publiez votre implémentation dans le groupe de visualisation. Si cela nous plaît, nous pouvons même le mentionner nous-mêmes.