Migreren van Google Image Charts

Google Image Charts was de statische grafiek-API op chart.googleapis.com/chart. Eén URL ging erin, één PNG kwam eruit, en elke instelling stond in queryparameters zoals cht, chd en chs. Google heeft de dienst in 2012 afgeschaft en in 2019 uitgeschakeld. Image-Charts leest diezelfde parameters, dus de migratie is een hostwissel.

Hoe vervangt u Google Image Charts?

Verander het domein van chart.googleapis.com naar image-charts.com. De grafiekparameters houden dezelfde namen en dezelfde syntaxis, dus de rest van de querystring gaat ongewijzigd mee over. Voor de meeste URL's is Image-Charts daarmee een directe vervanger, en de tabel hieronder markeert de plekken waar dat niet zo is.

Google Image Charts, geeft 404 terug

https://chart.googleapis.com/chart?cht=bvg&chd=t:60,40,75|30,55,45&chs=700x300&chtt=Requests+per+month

Image-Charts, rendert de grafiek hieronder

https://image-charts.com/chart?cht=bvg&chd=t:60,40,75|30,55,45&chs=700x300&chtt=Requests+per+month

Gegroepeerd staafdiagram met de titel Requests per month, waarin Europa en Noord-Amerika worden vergeleken over 2024, 2025 en 2026
Een werkende Image-Charts-URL, door deze pagina weergegeven als een gewone image-tag. Niet-ondertekende grafieken zijn gratis, hebben een snelheidslimiet en dragen het kleine watermerk dat u in de hoek ziet. Betaalde abonnementen verwijder die.

Waarom uw oude grafiek-URL's niet meer werken

Google kondigde in april 2012 het uitfaseren van Image Charts aan en beloofde de dienst nog drie jaar in de lucht te houden. De uitschakeling kwam in maart 2019.

Sindsdien geeft chart.googleapis.com/chart een HTTP 404 terug, wat u er ook naartoe stuurt. Staafdiagrammen, taartdiagrammen en QR-codes komen allemaal terug als een Google-foutpagina in plaats van een afbeelding.

De storing is stil. Een image-tag in een e-mail, een PDF-rapport, een Confluence-pagina of een dashboard voor klanten geeft geen fout wanneer de bron wegvalt. Er verschijnt een gebroken afbeelding, en u hoort het meestal van een klant in plaats van van een monitor.

Parametercompatibiliteit

Google documenteerde 30 parameters voor Image Charts. 23 werken ongewijzigd op Image-Charts, 1 wordt geaccepteerd en genegeerd, en 6 hebben geen equivalent. De tabel hieronder is opgebouwd uit de Image-Charts-API-specificatie, met elk verschil in gedrag uitgeschreven.

Google Image Charts-parameters en hun gedrag op Image-Charts
ParameterWat het regeltOp Image-Charts
chtGrafiektypeDezelfde waarden. Image-Charts voegt de typen bubbel, polair gebied en donut toe.
chdGegevensreeksenDezelfde coderingen. Daarnaast is er chd=a:, een floating-pointformaat zonder plafond van 0 tot 100 of 0 tot 4095 en met automatische schaling.
chdsAangepaste of automatische gegevensschalingDezelfde syntaxis. De standaard y-as toont uw werkelijke waarden in plaats van het bereik 0 tot 100 dat Google aanhield.
chsGrafiekgrootte in pixelsDezelfde syntaxis. Tot 998.001 pixels in totaal en 999 px per zijde, tegenover 300.000 pixels bij Google.
chlLabels voor staven, segmenten en puntenHetzelfde.
chcoReekskleurenHetzelfde.
chttGrafiektitelHetzelfde.
chtsTitelkleur en lettergrootteHetzelfde.
chxtWelke assen worden getoondHetzelfde.
chxlAangepaste aslabelsHetzelfde.
chxrAsbereikDezelfde syntaxis. Het asbereik wijzigen herschaalt ook de gegevens, wat de meeste mensen van Google verwachtten.
chxsLettertype en kleur van aslabelsOndersteund. Wetenschappelijke notatie, labeluitlijning en lijnkleur per as zijn niet geïmplementeerd.
chxpPosities van aslabelsHetzelfde.
chdlLegendatekstHetzelfde.
chdlpPositie en volgorde van de legendaHetzelfde.
chdlsLettertype en kleur van de legendaHetzelfde.
chfAchtergrond- en reeksvullingenDezelfde syntaxis. Kleurverlopen werken op staaf-, lijn-, taart- en bubbelgrafieken, terwijl Google ze alleen op staafdiagrammen toestond.
chmMarkeringen en samengestelde grafiekenOndersteund. Het optionele z-order-veld wordt genegeerd.
chlsLijndikte en streepjesHetzelfde.
chgRasterlijnenHetzelfde.
chmaGrafiekmargesDezelfde syntaxis, en negatieve marges zijn toegestaan.
chofUitvoerformaatHetzelfde.
chldFoutcorrectie en marge van de QR-codeHetzelfde.
chbhStaafbreedte en -afstandGeaccepteerd en genegeerd. Staafbreedtes worden voor u berekend.
chemDynamische pictogrammarkeringenGeen equivalent.
chfdDoor formules gegenereerde gegevensGeen equivalent.
chpTaartrotatie en nullijn van stavenGeen equivalent.
chstType dynamisch pictogramGeen equivalent.
chtmKaartgebiedGeen equivalent.
chxtcLengte van schaalstreepjesGeen equivalent.

Grafiektypen

Staaf-, lijn-, taart-, radar-, GraphViz- en QR-codegrafieken lezen de cht waarden die u al gebruikt. Spreidingsdiagrammen, venndiagrammen, Google-o-meter-meters, kaartgrafieken en dynamische pictogrammen hebben geen Image-Charts-equivalent, dus die URL's vragen om een ander antwoord.

Parameters die Google nooit had

Een paar parameters bestaan alleen op Image-Charts: chan rendert een geanimeerde GIF, chbr rondt de hoeken van staven af, chli plaatst een label binnen een donut, icff en icfs selecteren een Google Font en de bijbehorende stijl, iclocale formatteert getallen en datums voor een taal, en icretina verdubbelt de pixeldichtheid. De referentiedocumentatie behandelt ze allemaal.

De migratie uitvoeren

  1. Zoek de dode URL's. Grep uw codebase, templates en e-maillayouts op chart.googleapis.com.
  2. Vervang de host door image-charts.com en laat de querystring ongemoeid.
  3. Laad een van de herschreven URL's in een browser. Een 400-respons noemt de parameter die de API weigerde, en de tabel hierboven vertelt of er een vervanger bestaat.
  4. Controleer de 6 parameters zonder equivalent en de grafiektypen die nooit zijn overgezet. Alleen die URL's moeten worden herzien.

Als de grafieken die u herbouwt worden gegenereerd door een geplande taak of een no-codetool in plaats van door uw eigen code, dan bereiken de integraties en de agent-tooling dezelfde API zonder herschrijven.

Richt één URL op Image-Charts

Een grafiek bouwen