Google Image Charts était l'API de graphiques statiques à l'adresse chart.googleapis.com/chart. Une URL entrait, un PNG revenait, et chaque réglage vivait dans des paramètres de requête comme cht, chd et chs. Google l'a déprécié en 2012 et l'a coupé en 2019. Image-Charts lit ces mêmes paramètres, la migration se résume donc à un changement d'hôte.
Changez le domaine de chart.googleapis.com vers image-charts.com. Les paramètres de graphique conservent les mêmes noms et la même syntaxe, si bien que le reste de la chaîne de requête passe tel quel. Pour la plupart des URL, Image-Charts est donc un remplacement direct, et le tableau ci-dessous signale les cas où il ne l'est pas.
Google Image Charts, renvoie 404
https://chart.googleapis.com/chart?cht=bvg&chd=t:60,40,75|30,55,45&chs=700x300&chtt=Requests+per+month
Image-Charts, affiche le graphique ci-dessous
https://image-charts.com/chart?cht=bvg&chd=t:60,40,75|30,55,45&chs=700x300&chtt=Requests+per+month
Google a annoncé la dépréciation d'Image Charts en avril 2012 et s'est engagé à maintenir le service pendant trois ans de plus. L'arrêt est finalement intervenu en mars 2019.
Depuis lors, chart.googleapis.com/chart répond par un HTTP 404 quoi que vous lui envoyiez. Les graphiques à barres, les graphiques circulaires et les QR codes reviennent tous sous forme de page d'erreur Google plutôt que d'image.
La panne est silencieuse. Une balise image dans un e-mail, un rapport PDF, une page Confluence ou un tableau de bord client ne lève aucune erreur quand la source meurt. Elle affiche une image cassée, et c'est en général un client qui vous prévient, pas une sonde de supervision.
Google documentait 30 paramètres pour Image Charts. 23 fonctionnent tels quels sur Image-Charts, 1 est accepté et ignoré, et 6 n'ont pas d'équivalent. Le tableau ci-dessous est construit à partir de la spécification de l'API Image-Charts, avec chaque différence de comportement détaillée.
| Paramètre | Ce qu'il contrôle | Sur Image-Charts |
|---|---|---|
| cht | Type de graphique | Mêmes valeurs. Image-Charts ajoute les types à bulles, aire polaire et anneau. |
| chd | Séries de données | Mêmes encodages. Ajoute chd=a:, un format à virgule flottante sans plafond de 0 à 100 ni de 0 à 4095, avec mise à l'échelle automatique. |
| chds | Mise à l'échelle des données personnalisée ou automatique | Même syntaxe. L'axe y par défaut affiche vos vraies valeurs au lieu de la plage 0 à 100 conservée par Google. |
| chs | Taille du graphique en pixels | Même syntaxe. Jusqu'à 998 001 pixels au total et 999 px par côté, contre 300 000 pixels chez Google. |
| chl | Étiquettes de barres, de parts et de points | Identique. |
| chco | Couleurs des séries | Identique. |
| chtt | Titre du graphique | Identique. |
| chts | Couleur du titre et taille de police | Identique. |
| chxt | Quels axes sont affichés | Identique. |
| chxl | Étiquettes d'axe personnalisées | Identique. |
| chxr | Plage de l'axe | Même syntaxe. Changer la plage de l'axe remet aussi les données à l'échelle, ce que la plupart des gens attendaient de Google. |
| chxs | Police et couleur des étiquettes d'axe | Pris en charge. La notation scientifique, l'alignement des étiquettes et la couleur de ligne par axe ne sont pas implémentés. |
| chxp | Positions des étiquettes d'axe | Identique. |
| chdl | Texte de la légende | Identique. |
| chdlp | Position et ordre de la légende | Identique. |
| chdls | Police et couleur de la légende | Identique. |
| chf | Remplissages d'arrière-plan et de séries | Même syntaxe. Les dégradés fonctionnent sur les graphiques à barres, en courbes, circulaires et à bulles, là où Google ne les autorisait que sur les graphiques à barres. |
| chm | Marqueurs et graphiques composés | Pris en charge. Le champ optionnel z-order est ignoré. |
| chls | Épaisseur et tirets de courbe | Identique. |
| chg | Lignes de quadrillage | Identique. |
| chma | Marges du graphique | Même syntaxe, et les marges négatives sont autorisées. |
| chof | Format de sortie | Identique. |
| chld | Correction d'erreur et marge du QR code | Identique. |
| chbh | Largeur et espacement des barres | Accepté et ignoré. Les largeurs de barres sont calculées pour vous. |
| chem | Marqueurs d'icônes dynamiques | Aucun équivalent. |
| chfd | Données générées par formule | Aucun équivalent. |
| chp | Rotation du graphique circulaire et ligne zéro des barres | Aucun équivalent. |
| chst | Type d'icône dynamique | Aucun équivalent. |
| chtm | Zone de la carte | Aucun équivalent. |
| chxtc | Longueur des graduations d'axe | Aucun équivalent. |
Les graphiques à barres, en courbes, circulaires, radar, GraphViz et QR code lisent les valeurs cht que vous utilisez déjà. Les nuages de points, les diagrammes de Venn, les jauges Google-o-meter, les cartes géographiques et les icônes dynamiques n'ont pas d'équivalent Image-Charts, ces URL demandent donc une autre réponse.
Quelques paramètres n'existent que sur Image-Charts : chan produit un GIF animé, chbr arrondit les coins des barres, chli place une étiquette à l'intérieur d'un anneau, icff et icfs sélectionnent une Google Font et son style, iclocale formate les nombres et les dates pour une langue, et icretina double la densité de pixels. La documentation de référence les décrit tous.
Si les graphiques que vous reconstruisez sont générés par une tâche planifiée ou un outil no-code plutôt que par votre propre code, les intégrations et notre outillage pour agents atteignent la même API sans réécriture.
