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 sur des données structurées, et de les intégrer directement à votre site Web.
Que puis-je faire avec l'API de visualisation ?
L'API Google Visualization vous permet d'accéder à des données structurées, créées localement dans votre navigateur ou extraites de sources de données compatibles, sous forme de tableau simple. Vous pouvez également implémenter votre propre source de données en tant que source de données de l'API Visualisation, et permettre à toute application et/ou visualisation conforme à la visualisation d'accéder à vos données. Ce format peut être utilisé par les applications de création de rapports, d'analyse ou de graphique. Vous pouvez ainsi visualiser les données et/ou ajouter de nouvelles fonctionnalités aux applications telles que les feuilles de calcul Google.
Où puis-je trouver de la documentation sur l'API de visualisation ?
Vous trouverez le guide du développeur et toute autre documentation associée à l'adresse https://developers.google.com/chart/interactive/docs.
Comment créer un graphique ?
Le meilleur moyen de vous lancer 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. Une URL de source de données peut également inclure des paramètres de langage de requête de graphique. Dans ce cas, une requête (telle que le tri, le 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 pour les applications Chart à l'aide de l'API de visualisation ?
Vous trouverez un exemple de code dans la documentation sur l'exemple de code de l'API de visualisation.
Une application Flash peut-elle accéder à l'API de visualisation ?
Absolument. L'API de visualisation utilise une API JavaScript, mais certaines bibliothèques permettent aux applications Flash de se connecter au code JavaScript. Vous trouverez une bibliothèque de ce type utile à l'adresse suivante : http://code.google.com/p/swfobject. Pour en savoir plus sur les problèmes de développement affectant Flash, consultez la section ci-dessous.
Comment implémenter une source de données ?
Lisez la section sur l'utilisation et la création d'un graphique pour découvrir le fonctionnement des graphiques, puis consultez la page Implémenter une source de données pour apprendre à créer une source de données. Vous pouvez également utiliser la bibliothèque Java de source de données de graphique Google pour commencer rapidement si vous utilisez Java.
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 conformes à 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 complice GWT. La bibliothèque des versions éligibles 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 à l'aide du compilateur Google Web Toolkit (GWT) ?
Oui. La bibliothèque de visualisation Google pour Google Web Toolkit (GWT) vous permet d'accéder aux visualisations conformes à 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 complice GWT. La bibliothèque des versions éligibles 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. L'équipe Google Visualization participe également à ce groupe pour répondre aux questions.

Utiliser l'API

Quelle est la différence entre l'API Google Chart et l'API Google Visualization ?

L'API Chart offre un moyen simple de créer différents types de graphiques d'images en envoyant à un serveur Google une URL formatée comprenant les données et les options de configuration du graphique. L'API Chart comprend un ensemble fermé de graphiques avec différentes options. Les ensembles de données de l'API Chart sont limités à la taille d'une URL (environ 2 K).

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

  • L'API de visualisation fournit une API JavaScript pour accéder aux graphiques.
  • Sa galerie de graphiques comprend des graphiques créés par Google, mais est également ouverte à tous les tiers pour la création de visualisations conformes aux API de visualisation.
  • Vous pouvez utiliser n'importe quel graphique ou graphique de l'API de visualisation dans un navigateur. Cela inclut les images, JavaScript, les graphiques vectoriels, Flash, etc.
  • Un nombre considérable de graphiques de l'API Chart est accessible via l'API de visualisation, même si certaines de leurs options de configuration peuvent ne pas être disponibles.
  • L'API fournit également un protocole filaire documenté et un moyen pour toute personne d'exposer ses sources de données à n'importe quelle visualisation d'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 sur la page.
À quelles sources de données puis-je accéder via l'API de visualisation ?
Avec l'API de visualisation, vous pouvez accéder aux données localement à partir de votre navigateur en créant le format DataTable standard ou accéder à toute source de données compatible avec l'API. Les feuilles de calcul Google et Salesforce.com, disponibles sur la plate-forme de développement Force.com, sont déjà compatibles avec l'API. Vous pouvez également implémenter vos propres données en tant que source de données de graphique.
Mon application s'attend à ce que les données reçues 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 émettre un message d'erreur pour les incohérences.
Est-il possible d'intégrer un graphique à 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 n'émet aucune garantie quant aux performances, à la qualité, à la sécurité ou au contenu des applications. Les applications 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 à https://www.gstatic.com/charts/loader.js pour pouvoir utiliser les fonctionnalités interactives de Google Charts. En effet, les bibliothèques de visualisation requises pour 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 l'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 et à 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 des captures d'écran et les utiliser à votre guise.

Dépannage

Pourquoi mon graphique n'apparaî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 Chrome->Outils->Console JavaScript. Tous les navigateurs récents disposent d'une console JavaScript. Vous devrez peut-être parcourir des menus avec des noms tels que "Avancé" ou "Outils de développement".

Nous espérons que la console vous mènera immédiatement au problème. Cependant, il peut être difficile de traduire le message de la console dans la cause sous-jacente. Voici quelques pièges courants:

  • Vous utilisez peut-être Google Loader de façon incorrecte.
    • Chargez le fichier charts/loader.js une seule fois. Quel que soit le nombre de graphiques présents sur votre page Web, vous ne devez avoir qu'un seul appel semblable à celui-ci :
      <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> // Do this ONCE.
      Il peut s'agir du titre ou du corps de votre page Web, en fonction du moment auquel vous souhaitez que la charge se produise.
    • 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 avoir 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 vous n'avez toujours pas résolu le problème, 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 la réponse à votre question, publiez-la dans le groupe, accompagnée d'un lien vers une page Web illustrant le problème. Si possible, ajoutez un code jsfiddle.

Pourquoi mes mois et mes jours sont-ils décalés d'un mois ?
Google Charts utilise JavaScript, qui repose sur une indexation basée sur zéro. Le premier jour du mois est 0, et les mois vont de 0 (janvier) au 11 (décembre). Si votre code suppose une indexation basée sur une seule valeur, soustrayez une indexation 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'accéder au site caniuse.com pour obtenir de nombreuses informations sur les incompatibilités de navigateurs. Avec Google Charts, il arrive que des problèmes surviennent dans Internet Explorer 8 ou version antérieure pour deux raisons:
  • IE8 n'étant pas compatible avec le format SVG, Charts bascule vers VML, qui est plus limité.
  • Le code JavaScript d'IE8 n'autorise pas les virgules de fin dans les listes.
  • Pourquoi mon graphique basé sur Flash ne s'affiche-t-il pas lorsque je le teste ?
    En raison des paramètres de sécurité Flash, les graphiques Flash peuvent ne pas fonctionner correctement lorsqu'ils sont accessibles depuis un emplacement de fichier dans le navigateur (par exemple, file:///c:/webhost/myhost/myviz.html) plutôt que depuis une URL de serveur Web (par exemple, http://www.myhost.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 depuis une adresse http://. Vous pouvez résoudre ce problème comme décrit sur le site Web Macromedia. En général, nous recommandons d'éviter le développement Flash lorsque cela est 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 les contenus qui ne respectent pas le règlement de notre programme en affichant des liens ou en affichant des liens vers :
    • Contenu illégal.
    • une violation de la vie privée ;
    • Pornographie ou obscénité.
    • Contenu, tel qu'un code malveillant, qui interfère avec l'ordinateur d'un utilisateur ou le fonctionnement de la page Web hôte, ou qui est dangereux pour lui.
    • Incitation à 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 gérer et de créer un lien vers des règles de confidentialité légalement appropriées. En outre, nous demandons aux développeurs de s'assurer que leur graphique est sécurisé et de gérer leur application tant qu'il se trouve dans le répertoire des graphiques.

    Ces règles sont susceptibles d'être modifiées sans préavis.

    L'API Google Visualization est-elle disponible à des fins commerciales ?
    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 un logiciel côté client ?
    Actuellement, nous n'autorisons pas les développeurs à utiliser l'API de visualisation pour créer des logiciels côté client. Vous ne pouvez utiliser l'API de visualisation que via l'interface fournie. Pour en savoir plus à ce sujet, veuillez consulter les Conditions d'utilisation de l'API Google Visualization.
    Toutes les données de mon graphique sont-elles consignées par Google ?
    Les données du graphique incluses dans la requête HTTP sont conservées dans des journaux temporaires pendant deux semaines maximum, à des fins de test interne et de débogage. Bien entendu, 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 de ce programme peut entraîner la désactivation ou l'annulation de votre graphique, l'ajout à une liste noire de l'importation de graphiques futurs, la clôture de vos comptes Google et/ou la suppression de tous vos graphiques.

    Devenir actif dans la communauté

    Comment partager mon application Chart avec d'autres utilisateurs ?
    Commencez par placer votre graphique dans la galerie de graphiques. Vous pouvez revenir à votre site et fournir votre code source si vous le souhaitez. Participez à notre groupe de discussion pour recueillir les commentaires de la communauté.
    La Galerie de graphiques répertorie les applications qui utilisent l'API de visualisation. Elle permet à la communauté de développeurs de visualisation de centraliser le partage d'applications de graphique. Pour envoyer votre demande de création d'un graphique à la galerie, envoyez une demande en ligne.
    Comment promouvoir ma source de données de graphique ?
    Publiez votre implémentation sur le groupe de visualisation. Si cela nous plaît, nous pouvons même le mentionner nous-mêmes.