این صفحه روند انتشار نمودارهای Google را شرح می دهد. همچنین شامل یادداشتهای انتشار برای نسخههای فعلی و قبلی نمودارهای Google، و همچنین نکات برجستهای از موارد جدید است.
جدیدترین نسخه Google Charts که به عنوان نسخه رسمی
current
نیز شناخته می شود ، به همراه خلاصه تغییرات همه نسخه های قبلی در زیر فهرست شده است.برای توضیح در مورد معنای
current
بودن نسخه به بارگیری کتابخانه مراجعه کنید.همه درخواستهای 'jsapi' اکنون به لودر جدید هدایت میشوند. اگر نسخه '1' یا '1.0' را بارگیری می کردید، اکنون 'current' را بارگیری می کنید. نزدیکترین مطابقت با آخرین نسخه ای که قبلاً از طریق بارگذار jsapi در دسترس بود، '45.2' است.
لطفا از این به بعد از لودر جدید gstatic استفاده کنید. دستورالعملهای نحوه بهروزرسانی کد لودر خود را ببینید.
Google Visualization API Process Release and Release Candidates
ما Visualization API را در دو مرحله منتشر می کنیم:
- حداقل دو هفته قبل از انتشار نسخه رسمی جدید Visualization API، یک نسخه اولیه به نام Release Candidate (RC) را منتشر خواهیم کرد که می توانید آن را به عنوان نسخه "آینده" بارگیری کنید. این برای آزمایش هرگونه تغییر قطعی در نسخه است. ما یک اعلان به گروه بحث توسعهدهنده Visualization API ارسال میکنیم و آن گروه را برای مشکلات گزارششده رصد میکنیم و سعی میکنیم مشکلات مربوط به سازگاری عقبافتاده گزارششده را برطرف کنیم.
- دو هفته پس از انتشار RC، اگر بتوانیم تمام مشکلات مربوط به سازگاری عقبافتاده گزارششده را حل کنیم، بهعنوان نسخه جدید و رسمی «جاری» منتشر خواهد شد.
ما شما را تشویق میکنیم تا در اسرع وقت برنامههای خود را در برابر هر RC آزمایش کنید و مشکلاتی را که دارید گزارش دهید تا به ما کمک کنید محصولی پایدار ارائه کنیم.
در حالی که تیم Visualization API به طور کامل هر نسخه جدید را آزمایش میکند، متوجه میشویم که ممکن است در هر نسخه جدید باگهایی وجود داشته باشد. بنابراین هدف از این فرآیند دو مرحله ای بهبود قابلیت اطمینان API برای سیستم های تولید است.
انتشار اطلاعیه های نامزدها
ما هر نامزد انتشار جدید را با ارسال ایمیل به گروه بحث توسعهدهنده Visualization API اعلام خواهیم کرد. اگر از Visualization API برای برنامههای کاربردی جدی استفاده میکنید، اکیداً توصیه میکنیم که به این گروه بحث بپیوندید.
برای کمک به شما در یافتن یا فیلتر کردن این ایمیلها، هر اعلامیه انتشار دارای موضوعی مشابه است: "انتشار نامزد آزاد: <DATE>" ، که در آن <DATE> تاریخ ارسال است. این ایمیل شامل این دستورالعملهای استفاده خواهد بود. ویژگیهای جدید با جزئیات مستند نمیشوند، زیرا هدف کاندیدای انتشار، آزمایش ویژگیهای جدید نیست، بلکه آزمایش این است که نسخه، ویژگیهای موجود را خراب نکند. مستندات دقیق تمام ویژگی های جدید همراه با نسخه تولیدی منتشر خواهد شد.
نحوه استفاده از Release Candidate
نسخه بسته کاندید انتشار "آینده" است، برخلاف نسخه تولیدی که "در حال حاضر" است. (توجه داشته باشید که این نام ها با نسخه های بعدی تغییر نخواهند کرد.)
بسته به پارامتر نسخه خود، همانطور که در اینجا نشان داده شده است، میتوانید تولید یا نامزد انتشار (اما نه هر دو را به یکباره) بارگیری کنید:
// To load the production version, call this: google.charts.load('current', {'packages':['corechart']}); OR // To load the release candidate, call this: google.charts.load('upcoming', {'packages':['corechart']});
گزارش اشکالات
اگر در نمودارهای گوگل با اشکال احتمالی مواجه شدید، از صفحه مشکلات شناخته شده ما دیدن کنید. قبل از ثبت یک اشکال، لطفاً کد خود را بررسی کنید تا مطمئن شوید که واقعاً یک اشکال است (برای راهنمایی بیشتر سؤالات را به لیست پستی ارسال کنید)، سپس صفحه مشکلات شناخته شده را جستجو کنید تا ببینید آیا قبلاً ثبت شده است یا حل شده است.
اگر مشکلی در کاندید انتشار پیدا کردید، باید پیامی را با جزئیات مشکل به گروه بحث توسعهدهنده Visualization API ارسال کنید. تیم Visualization API این گروه را در طول دوره نامزد انتشار نظارت می کند تا در آن زمان پاسخگوی بیشتری باشد.
انتشارات رسمی
وقتی نمودارهای گوگل را بارگیری می کنید، چند گزینه دارید. به طور معمول، این کار به این صورت انجام می شود:
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load('current', {packages: ['corechart']}); google.charts.setOnLoadCallback(drawChart); </script>
رشته 'current'
به این معنی است که نسخه پایدار فعلی نمودارهای Google بارگیری می شود. اگر میخواهید قبل از تبدیل شدن به نسخه 'current'
بعدی، نسخه جدید و پیشنهادی را دریافت کنید، به جای آن از 'upcoming'
استفاده کنید. هر کدام از این نسخهها را که مشخص کنید، در طول زمان با بهروزرسانی آنها، شاهد پیشرفتهایی خواهید بود.
در 28 ژوئیه 2015 نسخه های فریز شده را اعلام کردیم. اینها نسخههایی از نمودارهای Google هستند که برای همیشه بدون تغییر باقی میمانند (اصلاح گاه به گاه بحرانی را مدول کنید). اولین نسخه یخ زده 41
بود که مربوط به انتشار ما در 23 فوریه 2015 بود.
شما یک نسخه فریز شده را بارگذاری می کنید مانند:
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load('46', {packages: ['corechart']}); google.charts.setOnLoadCallback(drawChart); </script>
اطلاعات بیشتر در اسناد Load Version موجود است.
تاریخچه نسخه
فعلی: آوریل 2023
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 52 موجود استاین نسخه شامل تغییرات داخلی و مهاجرت های بیشتری به ES6 و TypeScript می شود تا برای مرحله اول نمودارهای منبع باز گوگل آماده شود.
- ژئوچارت
- geochartVersion به 11 و regioncoderVersion به 1 به روز شد.
- نمودارهای دیگراف
- نمودارهای گانت، جدول زمانی و مواد: نوار، خط، پراکندگی
- دیگر کتابخانه Dygraph را به صورت پویا بارگیری نمی کند، زیرا در آن کامپایل شده است.
- جدول
- رفع برجسته کردن شماره صفحه فعلی برای بیش از 11 صفحه.
- چارت سازمانی
- گزینه "compactRows" را اضافه کنید. پیش فرض نادرست است.
- از الگوریتم Reingold-Tilford برای درختان لایه ای استفاده می کند. مزیت اصلی آن استفاده موثرتر از فضای افقی با قرار دادن زیردرختان نزدیک به هم است تا زمانی که گره های یک لایه روی هم قرار نگیرند.
ژوئن 2021
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 51 موجود استاین نسخه شامل تغییرات داخلی و مهاجرت های بیشتری به ES6 و TypeScript می شود تا برای مرحله اول نمودارهای منبع باز گوگل آماده شود.
- VegaChart
- رفتار قبلی در رابطه با اندازه پیشفرض یا صریح نمودارها را از طریق گزینههای «ارتفاع»، «عرض»، «بالشتک» و «اندازه خودکار» بازیابی کنید.
- Vega به نسخه 5.20.1 آپدیت شد
- Vega-lite به نسخه 5.1.0 به روز شده است
- Vega-embed به نسخه 6.17.0 به روز شده است
- جدول زمانی
- جدول دسترسی پنهان را به Timeline اضافه کنید.
- گزینه
alternatingRowStyle
جدید برای فعال کردن تنظیم سبک پسزمینه ردیفهای متناوب به رنگهای روشنتر و تیرهتر. پیش فرض درست است.
- پرس و جو
- اجازه دادن به دنباله ";" در پاسخ های پرس و جو وجود ندارد.
آوریل 2021
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 50 موجود استاین نسخه شامل بسیاری از بازسازیها و مهاجرتهای داخلی به ES6 و TypeScript برای آمادهسازی برای مرحله اول نمودارهای منبع باز Google است.
- VegaChart
- پشتیبانی از Vega-lite و Vega-Embed اضافه شده است.
- نقشه درختی
- گزینه جدید
enableHighlight
برجسته کردن عناصر را فعال می کند. نحوه راه اندازی برجسته سازی باید با eventsConfig پیکربندی شود. (highlightOnMouseOver
منسوخ شده است) - گزینه
eventsConfig
جدید برای پیکربندی چگونگی ایجاد تعاملات Treemap توسط رویدادها. پیکربندی پیش فرض این است:{ highlight: ['mouseover'], unhighlight: ['mouseout'], rollup: ['contextmenu'], // right-click drilldown: ['click'] }
- رویدادهای جدید:
'highlight'
،'unhighlight'
،'drilldown'
- گزینه جدید
- پرس و جو
- راهحل عدم پشتیبانی در نسخههای قدیمیتر صفحهگستردهها برای مدیریت پاسخ ایمنتر جدید JSON (که منجر به خطاهای CORS شد).
جولای 2020
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 49 موجود استاین نسخه شامل چندین بازسازی داخلی دیگر نیز می شود، بنابراین مراقب شکستگی های ناخواسته باشید. کدی که تحت تأثیر قرار گرفته است شامل تمام کلاسهای قالببندی، رویدادها، خطاها، بخشهای ChartEditor، ChartWrapper، ControlWrapper، Corecharts، تیکهای محور Corechart، GeoChart و Query میشود.
- VegaChart
- نوع نمودار جدید، اکنون در نسخه بتا منتشر شده است.
- VegaChart پوششی برای تمام تجسمهای ممکن است که ممکن است با استفاده از گرامر تجسم Vega مشخص شوند و با استفاده از دادههای DataTables مانند نمودارهای دیگر ترسیم شوند. در نسخههای بعدی، ویژگیهای Google Charts و Vega را بیشتر ادغام خواهیم کرد.
- از مترجم وگا برای مطابقت با محدودیتهای خطمشی امنیت محتوا استفاده میکند.
- ژئوچارت
- گزینه
geochartVersion
، نسخه داده مرزی را مشخص می کند. پیش فرض 10 است، اما 11 اکنون در دسترس است. - گزینه
regioncoderVersion
، نسخه داده کدگذار منطقه را مشخص می کند. پیش فرض 0 است، اما 1 اکنون در دسترس است. - رفع اشکال که به طور تصادفی بسته "geochart" را در "corechart" گنجانده بود. در حال حاضر به عنوان مستند کار می کند. به عنوان مثال، مطمئن شوید که بستهها را بارگیری میکنید: ['geochart'].
- گزینه
- نمودار گانت
- گزینه
sortTasks
اضافه شد، مقدار پیش فرض true، برای مرتب کردن وظایف به طور معمول، یا اگر نادرست است، از همان ترتیب ردیف ها در DataTable استفاده کنید.
- گزینه
- پرس و جو
- اکنون گزینه پاسخ JSON مستلزم آن است که سرور JSON سختگیرانه را برگرداند و سرور باید درخواستهای متقاطع را اجازه دهد.
- لودر
- اگر
google.charts.load()
بیش از یک بار با نسخه های مختلف یا زبان های مختلف فراخوانی شود، از تنظیمات بارگیری اول استفاده می شود. - به شماره نسخه اجازه می دهد، نه فقط یک رشته نسخه.
- ترفندهای سازگاری با عقب بیشتر برای پشتیبانی از تغییر مسیرها از بارگذار قدیمی jsapi.
- پارامتر URL بارگیری خودکار اکنون باید به صورت JSON سخت قالببندی شود و URL کدگذاری شود.
- فراخوانی
google.charts.load()
اکنون یک وعده جاوا اسکریپت را برمیگرداند، بنابراین علاوه بر مکانیسمهای دیگر پاسخ به تماس، میتوانید تابع ترسیم نمودار خود را به این شکل فراخوانی کنید:google.charts.load('upcoming', {packages: ['corechart']}).then(drawChart);
- اگر
می 2020
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 48 موجود است- رفع اشکال در پارامتر بارگذاری خودکار هنگامی که با تنظیم پاسخ به تماس خود ترکیب می شود.
- رفع اشکال با boxStyle برای حاشیه نویسی زمانی که چندین سری وجود دارد.
- دکمه های بزرگنمایی AnnotationChart را برطرف کنید.
- از استفاده از array.entries() و Object.entries() خودداری کنید. این برای جلوگیری از نیاز به polyfill برای IE11 است که ممکن است در تضاد باشد.
- GeoChart اکنون دادهها را با استفاده از xhr بارگیری میکند، به این معنی که روش setMapsSource دوباره با دو شرط کار میکند: (1) بخش داده محتوا نباید هیچ نظری داشته باشد (به عنوان مثال فرمت سخت JSON) و (2) سرور باید مبدا متقابل را مجاز کند. درخواست برای داده ها
فوریه 2020
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 47 موجود است- بازسازی قابل توجه ابزارهای اصلی برای DataTable، DataView و پردازش گزینه ها.
- تقویم
- افزودن گزینه برای
legend.position
، مقدار پیشفرض'right'
. برای پنهان کردن افسانه می توانید از'none'
استفاده کنید.
- افزودن گزینه برای
- جدول زمانی
- فواصل زمانی زیر ثانیه را ثابت کنید (اما هنوز بدون تیک).
- مشکلات عملکرد را با فواصل زمانی همپوشانی برطرف کنید.
- کنترل - رفع NumberRangeFilter. اکنون از
fractionDigits
روی 0 پشتیبانی می کند. - برای فعال کردن "safeMode" تنظیمات لودر را اضافه کنید. وقتی روی true تنظیم شود، همه نمودارها و نکات ابزاری که HTML را از داده های ارائه شده توسط کاربر تولید می کنند، با حذف عناصر و ویژگی های ناامن، آن را پاکسازی می کنند.
- پشتیبانی از پارامترهای "autoload" و "callback" را روی لودر اضافه کنید تا با بارکننده قدیمی JSAPI سازگار باشد. پارامتر بارگذاری خودکار باید JSON سختگیرانه و دارای کد urlencod باشد.
- برای نمودارهای اصلی
- مقادیر
"zoomDelta"
زیر 1.0 را مدیریت کنید -
"maxTextLines"
به عنوان یک گزینه محور عمودی اضافه کنید.
1 اکتبر 2018
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 46 موجود است- نمودارهای اصلی
- تیک ها و خطوط شبکه
- تغییرات متعددی در تولید تیک محور و خط شبکه ایجاد شد تا امکان بستهبندی محکمتر کنهها را فراهم کند که همپوشانی ندارند.
- خطوط شبکه کوچک در حال حاضر حتی پویاتر هستند زیرا تعداد مناسب خطوط شبکه فرعی به فاصله بین خطوط شبکه اصلی و فضای موجود بستگی دارد. پیشفرض در حال حاضر این است که همیشه خطوط شبکهای جزئی نشان داده شود، اگر مناسب باشند.
{ minorGridlines: { count: 0 }}
تعیین کنید تا خطوط شبکه کوچکی وجود نداشته باشد، یا{ minorGridlines: { count: 1 }}
برای فعال کردن خطوط شبکه جزئی. در غیر این صورت گزینهminorGridlines.count
معنایی ندارد. - اگر رنگ خطوط شبکه اصلی "هیچ" باشد، رنگ خطوط شبکه کوچک به طور پیش فرض روی "هیچ" خواهد بود.
- بسیاری از پیشرفتها در خطوط شبکه و تیک برچسبها برای مقیاسهای
log
وmirrorLog
. - اجازه دهید زاویه مایل منفی به سمت «دیگر» قرار گیرد.
- پرش و متناوب (یعنی چندین خط پلکانی) را برای تاریخ و زمان به طور پیش فرض غیرفعال کنید.
- اکنون تولید خطوط شبکه، خطوط جزئی و تیک تعداد و فاصله خطوط شبکه را بر اساس گزینههای دیگر غیر از شمارش تعیین میکند. اگر عددی را برای
gridlines.count
مشخص کنید، فقط به عنوان یک تقریب تقریبی استفاده می شود. - گزینه های جدید
gridlines.minSpacing
وminorGridlines.minSpacing
به شما امکان می دهند حداقل فضای صفحه را بین خطوط شبکه اصلی بر حسب پیکسل مشخص کنید. پیشفرض برای خطوط شبکه اصلی 40 برای مقیاسهای خطی، 20 برای مقیاسهای گزارشی است. برای minorGridlines، minSpacing پیشفرض 1/2 minSpacing خطوط شبکه اصلی برای مقیاسهای خطی، و 1/5 minSpacing برای مقیاسهای log است. اگر تعداد و نه minSpacing را مشخص کنید، minSpacing از count محاسبه می شود. و برعکس، اگر minSpacing و نه count را مشخص کنید، count از minSpacing محاسبه می شود. - گزینه
gridlines.interval
جدید به شما امکان می دهد آرایه ای از اندازه ها (به عنوان مقادیر داده، نه پیکسل) از خطوط شبکه و minorGridlines را مشخص کنید. این گزینه در حال حاضر فقط برای محورهای عددی است، اما مشابه گزینه هایgridlines.units.<unit>.interval
است که فقط برای تاریخ ها و زمان ها استفاده می شود.- برای مقیاسهای خطی، پیشفرض
{ gridlines: { interval: [1, 2, 2.5, 5] } }
است که به این معنی است که مقادیر خط شبکه میتوانند روی هر واحد (1)، روی واحدهای زوج (2)، یا مضربهای 2.5 قرار گیرند. یا 5. هر توان 10 از این مقادیر نیز در نظر گرفته می شود (مثلاً 10، 20، 25، یا 50). برای خطوط شبکه کوچک، پیشفرض{ minorGridlines: { interval: [1, 1.5, 2, 2.5, 5] } }
است. فاصله خط شبکه فرعی که انتخاب می شود همیشه مقسوم علیه فاصله خط شبکه اصلی انتخابی خواهد بود. - برای مقیاسهای گزارش، پیشفرض
{ gridlines: { interval: [1, 2, 5] } }
و{ minorGridlines: { interval: [1, 2, 5] } }
است.
- برای مقیاسهای خطی، پیشفرض
- گزینه های جدید برای
gridlines.multiple
وminorGridlines.multiple
، که مشخص می کند که مقادیر gridline و تیک باید مضربی از مقدار این گزینه باشد. بنابراین می توانید با تعیینgridlines.multiple = 1
تیک ها را مجبور کنید که اعداد صحیح باشند. - اگر برچسبهای تیک قالببندی شده برای اعداد تکراری شوند، اکنون خطوط شبکه رد میشوند، بنابراین اگر میخواهید فقط تیکهای عدد صحیح را نشان دهید، میتوانید
format:"#"
مشخص کنید. - هنگامی که از گزینه "تیک" صریح استفاده می شود، اکنون viewWindow را گسترش می دهیم تا اگر خارج از محدوده داده باشد، تیک های واضح را نیز شامل شود.
viewWindow
صریح گزینههایmin
یاmax
میتوانند لغو شوند. این تغییری در رفتار قبلی است که بیشتر شبیه حالت'maximized'
با تیک های صریح عمل می کرد. - وقتی
viewWindowMode
pretty
است، که پیشفرض برای محورهای هدف است، ViewWindow اکنون به نزدیکترین خط شبکه اصلی برای اعداد یا نزدیکترین خط شبکه فرعی برای تاریخها و زمانها گسترش مییابد.
- قالب بندی
- قالب اعداد برای الگوهای "کوتاه" و "بلند" اکنون از 3 رقم قابل توجه استفاده می کند.
- اکنون مقادیر Timeofday با استفاده از مقادیر 24 ساعته ('HH') به طور پیش فرض به جای مقادیر 12 ساعته ('hh') قالب بندی می شوند.
- قالبهای صریح برای تاریخها و زمانها اکنون قالبهای «واحد» را لغو میکنند.
- رفع حالت کاوشگر، که پس از ترسیم مجدد نمودار خراب شد.
- تیک ها و خطوط شبکه
- نمودار هیستوگرام
- خطوط شبکه محور دامنه و رنگ پیشفرض خط پایه "هیچ" است.
- فرمت پیشفرض تیکهای محور هدف اکنون '#' است، فقط برای نمایش اعداد صحیح.
- ایجاد سطل با استفاده از الگوریتم تولید تیک. تعداد پیش فرض سطل ها با استفاده از گزینه
histogram.numBucketsRule
جدید محاسبه می شود. مقادیر ممکن عبارتند از 'sqrt'، 'sturges' و 'rice'. به https://en.wikipedia.org/wiki/Histogram#Number_of_bins_and_width مراجعه کنید
- ColumnChart و BarChart
- تشخیص ثابت حداقل اندازه نوار (تفاوت بین مقادیر مجاور) برای کار با تاریخ و زمان.
- جدول
- پشتیبانی از ویژگی 'className' برای ردیف ها.
- ویژگی های ستون و سلول className مشخص شده توسط کاربر را به ویژگی های پیش فرض اضافه کنید (به جای جایگزینی آنها)، شبیه به ویژگی های ردیف.
- داده ها
- عملکرد data.group را اصلاح کنید تا به چندین تجمع اجازه دهید از یک ستون استفاده کنند.
- مطابقت با خط مشی امنیت محتوا (CSP).
- استفاده از eval را برای deserialization JSON حذف کنید.
26 ژوئن 2017
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 45.2 موجود است- نمودارهای اصلی
- بسیاری از تغییرات داخلی که بر نحوه پردازش گزینه ها تأثیر می گذارد. (این باعث ایجاد برخی اشکالات مربوط به حالت "کاوشگر" شده است.)
- اضافه شده گزینه های
tooltip.boxStyle
: به عنوان مثال'tooltip': { 'boxStyle': { 'stroke': '#b2b2b2', 'strokeOpacity': 1, 'strokeWidth': 1.5, 'fill': 'white', 'fillOpacity': 1, 'shadow': { 'radius': 1, 'opacity': 0.2, 'xOffset': 0, 'yOffset': 2 } }}
- موارد افسانه AreaChart را برای استفاده از گزینه
areaOpacity
رفع کنید. - هنگامی که مقادیر دامنه فرمت شده عددی (نادرست) هستند، حلقه بی نهایت را برطرف کنید.
- نمودار جدول
- رفع دکمه های صفحه بندی
- نوع ستون را به ویژگی
class
سلول هدر اضافه کنید. - به خصوصیات در ستون های جدول داده احترام بگذارید.
- وقتی مرتبسازی فعال است، برچسبهای دسترسپذیری را برطرف کنید.
- نمودار گانت
- شیء انتخاب را برای گنجاندن شاخص ردیف ثابت کنید.
6 ژانویه 2017
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 45.1 موجود است- نمودارهای اصلی
- برای جلوگیری از خرابی زمانی که گزینههای
chartArea.bottom
و.right
خیلی بزرگ هستند، رفع کنید.
- برای جلوگیری از خرابی زمانی که گزینههای
- نمودار گانت
- اکنون ویژگی
row
را برای موارد انتخاب شده برمی گرداند.
- اکنون ویژگی
12 سپتامبر 2016
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 45 موجود است.- تغییرات لودر:
- پشتیبانی از تماس های متعدد
google.charts.load
- نمونه های ChartWrapper را می توان با یک
chartType
بارگذاری شده به صورت پویا فراخوانی کرد. - نمودار GeoChart و Map دیگر نیازی به اضافه کردن بارگذار JSAPI ندارد. یک تنظیم جدید بارگذار
mapsApiKey
وجود دارد که به شما امکان میدهد کلید خود را مشخص کنید، نه اینکه رفتار پیشفرض را دریافت کنید که ممکن است منجر به کاهش گاه به گاه سرویس شود.
- پشتیبانی از تماس های متعدد
- نمودارهای مبتنی بر فلش:
- برای GeoMap و MotionChart، swfobject.js برای استفاده از آخرین نسخه 2.2 به روز شده است. به دلیل این به روز رسانی نباید هیچ تغییر قابل مشاهده ای در ویژگی های نمودار ایجاد شود.
- برای AnnotatedTimeline، اکنون آن را با نمودار حاشیهنویسی جایگزین میکنیم، که چند سالی است در دست توسعه بوده و به نظر ثابت میرسد. تقریباً تمام ویژگیهای AnnotatedTimeline باید در AnnotationChart بدون نیاز به تغییر در کد شما اعمال شود، اگرچه ظاهر و احساس متفاوت است. AnnotationChart از هیچ کد فلش استفاده نمی کند و در بالای نمودار Corecharts، ChartRangeFilter و Table ساخته شده است.
- نمودارهای اصلی:
- نقش
certainty
ثابت شد، بنابراین با سبک های سفارشی به درستی کار می کند. - جدول دسترسی را به درستی در ظروف rtl پنهان کنید.
- هنگام استفاده با ChartWrapper، انیمیشن راه اندازی را برطرف کنید.
- تصحیح انیمیشن مقادیر گسسته ای که مکان ها را عوض می کنند.
- بدون در نظر گرفتن اینکه چه روزی از ماه است، تاریخ ها را بسازید.
- رنگ های نمودار منطقه انباشته نسبی را برطرف کنید.
- ColumnChart را با مقیاس ورود به سیستم و 0 یا مقادیر منفی برطرف کنید.
- نقش
- PieChart : اجرای ناسازگار گزینه
reverseCategories
را رفع کنید. - تقویم : اکنون از بیش از دو رنگ از گزینه آرایه
colorAxis.colors
زمانی کهcolorAxis.values
نامشخص است استفاده می کند. این رفتار باید بیشتر شبیه آنچه در GeoChart اتفاق می افتد باشد، جایی که نقاط عطف به طور مساوی در سراسر گرادیان پخش می شوند. - نمودارهای مواد: برای استفاده درست از رنگ پسزمینه، گزینههای تبدیل برای نمودارهای مواد را ثابت کرد.
- اکنون نمودار نقشه ها متن عنوان نشانگر را از پنجره اطلاعات جدا می کند:
- گزینه جدید "showInfoWindow" برای کنترل ویژه پنجره اطلاعات اضافه شده است.
- گزینه جدید "showTooltip" اضافه شد تا به طور خاص متن عنوان نشانگر را کنترل کند.
- هر دو گزینه در صورت تنظیم نشدن از "showTip" ارث می برند.
- رفع اشکال: وقتی روی یک نقطه انتخاب شده کلیک می کنید، اکنون پنجره اطلاعات از بین می رود.
23 فوریه 2016
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 44 موجود است.- نمودارهای اصلی:
- اکنون مقادیر Timeofday به صورت داخلی از UTC استفاده میکنند که مشکلات محورهای کوتاهشده timeofday را برطرف میکند.
- گزینه هایی برای تعیین
bar.width
،bar.gap
،bar.group.width
( wasbar.groupWidth
) وbar.group.gap
اضافه شده است. - فواصل میله مانند (میله ها و جعبه ها) را تغییر داد تا با نمودارهای میله مانند سازگار باشد.
- هیستوگرام :
- قالب بندی موارد راهنمای ابزار برای استفاده از مقادیر قالب بندی شده ثابت شد.
- سطل ثابت با مقادیر بسیار کوچک و بسیار بزرگ.
- گزینه های عرض نوار و شکاف برای هیستوگرام ها نیز اعمال می شود.
-
histogram.minValue
وhistogram.maxValue
برای گسترش دامنه سطل ها اضافه شد. - اجازه استفاده از گزینه تیک صریح در محور دامنه.
- PieChart :
- هنگامی که هر برش برای نمایش خیلی کوچک است، خطا با راهنمای ابزار برطرف شد.
- تقویم :
- رفع مشکلات مربوط به مناطق زمانی و ساعت تابستانی.
- ژئوچارت :
- برای داده های Geo در اتصالات کند بیشتر صبر کنید.
- گانت :
- رفع برخی از مشکلات مربوط به ترتیب اقلام.
- نمودارهای مواد
- قالب بندی موارد راهنمای ابزار برای استفاده از مقادیر قالب بندی شده ثابت شد.
2 اکتبر 2015
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 43 موجود است.- نمودارها اکنون رسماً از مایکروسافت اج پشتیبانی می کنند.
- نمودارهای اصلی:
-
focusTarget
اکنون می تواند آرایه ای برای تعیین چندین هدف فوکوس باشد. - اکنون می توان فواصل زمانی را با استفاده از نقش استایل استایل کرد.
- مشکل ویژگی
visible
برای اقدامات راهنمای ابزار رفع شد. - موقعیتیابی راهنمای ابزار HTML اکنون بیشتر با موقعیتیابی راهنمای ابزار SVG مطابقت دارد.
- گزینه
chartArea
اکنون از'right'
و'bottom'
پشتیبانی می کند. - تیکهای محور عمودی همپوشانی حذف خواهند شد.
- اندازه فلش های اسکرول افسانه ثابت است.
- هنگامی که
orientation
نمودار'vertical'
است یا زمانی که محورها دارایdirection
-1
هستند، حاشیه نویسی ها به درستی قرار می گیرند. - اکنون وقتی تنظیم میکنید، از عرض متغیر در نمودارهای میلهای، ستونی و ناحیه پلهای پشتیبانی میکند
bars { variableWidth: true }
.
-
- نمودار حباب : برچسبهای پیشفرض اکنون برای راهنمایی ابزار استفاده میشوند.
- نمودار سانکی :
- کنترل رنگ بهتر
- تعامل پیوند اکنون پشتیبانی می شود.
- جدول زمانی :
- مدتزمانها اکنون محلی شدهاند.
- اکنون از
minValue
وmaxValue
برای محور افقی پشتیبانی می کند.
- نمودار جغرافیایی :
- هنگامی که یک مقدار null برای یک راهنمای ابزار سفارشی مشخص می شود، به جای آن، راهنمای ابزار پیش فرض ساخته می شود.
- اکنون می توانید تعامل را برای نشانگرها غیرفعال کنید.
- درخت کلمه :
- کنترل رنگ بهتر
- ستون رنگ رشته منسوخ شد و برای جایگزینی ستونهای سبک، پشتیبانی اضافه شد.
- خطوط روند : تعدادی از مقیاس ورود به سیستم و اشکالات مربوط به تاریخ را رفع کرد.
- نمودار جدول : گزینه
pagingButtons
اکنون در ترکیب های بیشتری با گزینه هایpage
،pageSize
وstartPage
کار می کند. - نمودارهای مواد (نوار، خط و پراکندگی، تا کنون): تعدادی از اشکالات را با ترسیم مجدد نمودارها و نمودارهای متعدد در یک صفحه برطرف کرد.
- نمودار حاشیه نویسی : قالب تاریخ و زمان برای انتخاب محدوده اکنون مانند نمودار اصلی است.
30 آوریل 2015
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 42 موجود است.- نمودارهای اصلی
- ColumnChart، BarChart، AreaChart، و StepppedAreaChart اکنون
isStacked: 'percent'
(برای مقیاسبندی تا 100 درصد دادهها برای هر دسته) وisStacked: 'relative'
(برای مقیاسبندی تا محدوده 0..1) پشتیبانی میکنند. - برای همه نمودارهای مرکزی، خط پایه پیش فرض برای محورها دیگر در لبه نمودار نخواهد بود. مقدار پایه پیشفرض 0 برای محورهای عددی استفاده میشود، اما برای سازگاری با نمودارهای موجود، به طور خودکار در نمودار گنجانده نمیشود مگر اینکه به اندازه کافی به دادهها نزدیک باشد. فقط با افزودن
baseline: 0
به گزینه های خود، می توانید درج خط مبنا را اجبار کنید. برای محورهای تاریخ و زمان، هیچ خط پایه پیشفرضی وجود ندارد، اما در صورت تمایل میتوانید یکی را مشخص کنید. - افسانه های Corechart از سبک خط، ناحیه و نقطه مربوط به هر سری استفاده می کنند.
- اکنون همه گزینه های متنی برای نمودارهای اصلی از گزینه
opacity
پشتیبانی می کنند. - بارگذار وب فونت برای بارگیری فونت های ناشناخته استفاده می شود، که می تواند باعث تاخیر در ترسیم نمودار شما شود. نام فونت ها به حروف بزرگ و کوچک حساس نیستند.
- انیمیشن راهاندازی اکنون با DataViews کار میکند و وقتی با حالت ترسیم همگام ترکیب شود.
- روش
clearChart
را زمانی که قبل از ترسیم نمودار مورد استفاده قرار میگرفت، رفع کنید. - یک گزینه
pointsVisible
برای سطوح بالا، سری و خطوط روند اضافه شده است. این گزینه کنترل می کند که آیا نقاط باید به طور پیش فرض قابل مشاهده باشند. این به شما این امکان را می دهد که در حالی که نقاط را مخفی نگه می دارید،pointSize
تغییر دهید. - موقعیت راهنمای ابزار HTML ثابت شده است.
- نمودار پراکندگی اکنون با یک محور دامنه گسسته کار می کند و از حاشیه نویسی پشتیبانی می کند.
- نمودار دایره ای اکنون از راهنمایی های ابزار سفارشی پشتیبانی می کند.
- سانکی
- اکنون می توانید گره ها را انتخاب کنید. این را می توان با تنظیم
sankey.node.interactivity
رویtrue
فعال کرد. - افزودن قابلیت تعیین تعامل Sankey از طریق گزینه های نمودار. گزینهها معمولاً تحت سبک هر چیزی که مشخص میشود، با افزودن یک شی با ویژگیهای سبک تغییر یافته در یکی از کلیدهای زیر مشخص میشوند:
'selected'
،'focused'
،'unselected'
،'unfocused'
. - رنگ ها
- Sankey اکنون از نقش
'style'
پشتیبانی می کند - اکنون می توان گره ها را با تنظیم گزینه
sankey.node.colorMode
روی'unique'
به طور منحصر به فرد رنگ آمیزی کرد. - اکنون پیوندها می توانند رنگی شوند. حالت رنگ آمیزی را می توان با گزینه
sankey.link.colorMode
تغییر داد. مقادیر معتبر عبارتند از:-
'unique'
: هر پیوند رنگ خاص خود را دارد. -
'source'
: هر پیوند از رنگ گره منبع خود استفاده می کند. -
'target'
: هر پیوند از رنگ گره هدف خود استفاده می کند. -
'gradient'
: هر پیوند با یک گرادیان رنگ می شود که از رنگ گره منبع خود به رنگ گره هدف خود می رود. - توجه: اگر رنگآمیزی گره روی پیشفرض تنظیم شده باشد یا پالتهای گرهها و پیوندها متفاوت باشد،
'source'
،'target'
و'gradient'
از رنگهایی استفاده میکنند که اگرcolorMode
'unique'
بود به گرهها اختصاص داده میشد. و پیوندها و گره ها یک پالت را به اشتراک گذاشتند.
-
- پالت رنگ گره ها اکنون می تواند از طریق
sankey.node.colors
تغییر کند. - پالت رنگ پیوندها اکنون از طریق
sankey.link.colors
قابل تغییر است.
- Sankey اکنون از نقش
- راهنمای ابزار پیشفرض (هم HTML و هم SVG) اکنون میتواند توسط پیوندها تولید شود و نکات ابزار سفارشی از طریق نقش
'tooltip'
پشتیبانی میشوند. - جدول زمانی
- راهنمای ابزار SVG اکنون پشتیبانی می شود.
- راهنمای ابزار سفارشی اکنون پشتیبانی می شود.
- اگر بیشتر از مقدار موجود مورد نیاز باشد، رنگها چرخه میشوند.
- تقویم
- راهنمای ابزار SVG اکنون پشتیبانی می شود.
- راهنمای ابزار سفارشی اکنون پشتیبانی می شود.
- خطوط روند
- اکنون گزینه
pointsVisible
پشتیبانی می شود.
- اکنون گزینه
- نمودار جدول
- گزینههای
'width'
و'height'
ممکن است نامشخص باشند، به این معنی که جدول باید تا حد امکان کوچک شود، یا'100%'
، به این معنی که جدول باید تا حد امکان گسترش یابد. - جدول تکراری مورد استفاده برای سرصفحه جدول ثابت حذف شد.
- ستونهای ثابت، زمانی مفید است که تعداد ستونهای شما بیشتر از عرض موجود باشد. برای مثال، 2 ستون سمت چپ ممکن است با
'frozenColumns': 2
. - تعداد دکمه های صفحه بندی را با گزینه
'pagingButtons': #
مشخص کنید. تعداد ردیف ها در هر صفحه بر اساس آن خواهد بود، مگر اینکه گزینه'pageSize'
را نیز مشخص کنید. - گزینه
'rtlTable'
اکنون با صفحهبندی یا پیمایش کار میکند، اما (هنوز) باfrozenColumns
کار نمیکند. - برای جلوگیری از تضاد، نام برخی از کلاسهای css (مثلاً
'content'
) را تغییر داد. - اکنون سرصفحههای ستون بهطور پیشفرض بسته نمیشوند.
- گزینههای
- نمودارهای مواد
(در حال حاضر نسخه های Material نمودارهای نوار، خط و پراکندگی وجود دارد.)- پشتیبانی بهتر از محورهای تاریخ، تاریخ و زمان روز.
- مشکلات اندازه گیری را با نمودارهای متعدد در همان صفحه برطرف کنید.
- اکنون می توان با ChartWrapper استفاده کرد.
- نمودار حاشیه نویسی
- رفع اشکال برای انتخاب حاشیه نویسی و رنگ انتخابگر محدوده.
- به نمودار حاشیه نویسی اجازه دهید با استفاده از گزینه
table.sortAscending
ترتیب جدول حاشیه نویسی را مشخص کند.
- نقشه
- اگر مقادیر طول و عرض جغرافیایی 0 باشد، مجموعه ای از مختصات دیگر نادیده گرفته نمی شود.
23 فوریه 2015
به صورت شبه ابدی به عنوان نمودارهای منجمد نسخه 41 موجود است.- نمودارهای اصلی
- انیمیشن های راه اندازی برای اکثر نمودارهای اصلی: گزینه
startup:true
toanimation
اضافه کنید. -
clearChart()
به نمودارهایی که این تابع را ندارند اضافه کنید. - تیک های محور عمودی که در داخل ناحیه نمودار قرار گرفته اند اکنون می توانند از کل
chartArea.width
استفاده کنند. - بهویژه برای جداول فرمتشده JSON، مقادیر null را بهطور پیوستهتر مدیریت کنید.
- گزینه
allowAsync
را برای ترسیم ناهمزمان اضافه کنید. - به مقادیر
timeofday
اجازه دهید 1 تا 7 عنصر داشته باشند. - ستون ها ممکن است با شناسه یا برچسب، علاوه بر شماره فهرست، ارجاع داده شوند.
- تعمیم نقش
style
- پشتیبانی از راهنمای ابزار برای زبان های راست به چپ.
- تم لایت مواد اضافه شد (افزودن موضوع: گزینه
material
). - نکات ابزار HTML
- موقعیت نویسی ابزار HTML را طوری اصلاح کنید که نسبت به کانتینر باشد.
-
tooltip tag is undefined
. - از ویژگی رنگ سبک متن استفاده کنید.
- خطوط روند
- برای مقیاس ورود به سیستم رفع کنید.
- اجازه دهید راهنمای ابزار در هر خط روند غیرفعال شود.
- با چندین محور عمودی کار کنید.
- کار با انیمیشن
- حاشیه نویسی : از پوشاندن حاشیه نویسی با راهنمای ابزار حاشیه نویسی خودداری کنید.
- انیمیشن های راه اندازی برای اکثر نمودارهای اصلی: گزینه
- نمودارهای مواد
- قابلیت سفارشی کردن رنگ های سری را از طریق گزینه
colors
اضافه کنید. - نمودار خط مواد را اضافه کنید.
- نمودار پراکندگی مواد را اضافه کنید.
- اکنون هنگام استفاده از
convertOptions()
زیرنویس پشتیبانی میشود.
- قابلیت سفارشی کردن رنگ های سری را از طریق گزینه
- هیستوگرام : به طور خودکار تعداد سطل ها را محدود می کند تا از کوچک بودن بیش از حد جلوگیری شود.
- نمودار تقویم : از مقادیر صفر پشتیبانی می کند.
- تجسم نقشه
- رفع سطح زوم.
- پشتیبانی از نقشه های سبک
- پشتیبانی از چندین نوع نشانگر سفارشی
- نمودار کندل استیک : اکنون با جهت عمودی کار می کند.
- نمودار جدول
- هنگامی که
draw()
فراخوانی می شود، انتخاب قبلی را حذف کنید. - از عناصر
THEAD
وTH
برای هدر جدول استفاده کنید. - برای کار با ابزارهای دسترسی، هدر را بین فراخوانی
draw()
حفظ کنید.
- هنگامی که
- AnnotationChart
- ترتیب معکوس حاشیه نویسی ها در جدول.
- رنگ های سری را هنگام پنهان کردن و نمایش سریال حفظ کنید.
- وقتی مشخص نیست عرض و ارتفاع را به حالت پیش فرض بازگردانید.
- پنجره نمای نمودار را بر اساس موقعیت انتخابگر محدوده تنظیم کنید.
- نمودار سنج : رفع کوچک شدن در فراخوانی های بعدی
draw()
. - داشبوردها : متد
getSelection()
را اضافه کنید که اتحادی از تمام انتخابهای موجود در داشبورد را برمیگرداند. - پارامترهای ChartWrapper و ControlWrapper اکنون به یک عنصر
container
به عنوان جایگزینcontainerId
اجازه می دهند. - بهبود عملکرد برای ChartRangeFilter ، و برای نمودارهایی که از نکات ابزار فوکوس دسته استفاده می کنند.
- ویرایشگر نمودار
- مواردی را که مرتبط نیستند پنهان کنید (مثلاً منوی افسانه زمانی که آیتم های افسانه ای وجود ندارد).
- مخفی کردن تقسیم کننده های آیتم سطل هیستوگرام (به طور پیش فرض).
- رفع رنگ Piechart
- پشتیبانی از تم ها
- پشتیبانی از خط روند چند جمله ای
- خطوط روند را برای محورهای مبتنی بر تاریخ و نمودارهای منطقه فعال کنید.
- روی پشتیبانی ویرایشگر برای مقادیر حداقل/حداکثر کلیک کنید.
- پشتیبانی از نمودار میله ای برای محورهای پیوسته و خطوط روند.
6 اکتبر 2014
- درختان کلمه
- دسترسی
- اضافه کردن جدول با داده ها برای صفحه خوان.
- رفع متن با هاله.
- اصلاحات/ترفندهای دسترسی بیشتر.
- نمودار حاشیه نویسی
- وقتی اندازه تغییر می کند، انیمیشن رفع می شود
- اصلاحات افسانه
- رفع اشکالات متعدد برای ChartWrapper .
- جدول زمانی
- قالب تاریخ اکنون در راهنمای ابزار موجود است
- برچسبهای نوار اکنون به اجبار در نوار وظیفه قرار میگیرند
- متفرقه
- تیک لاین و رفع تیک
- گزینه های بیشتر قالب بندی راهنمای ابزار
- بهبودهای رندر داخلی متعدد
- بهبود در کاوشگر داده
- بهبود خط روند
- بهبود در پردازش محوری
- نمودارهای نوار و ستون مواد ، مطابق با سبک بصری جدید Google
25 ژوئن 2014
- نمودارهای اصلی (خط، میله، ستون، ناحیه، ترکیب، پای، پراکندگی، کندل، حباب، هیستوگرام، ناحیه پلکانی):
- اکنون 0 خط شبکه و 1 خط شبکه پشتیبانی می شود.
- انیمیشن سریعتر تعداد زیادی از مقادیر محور گسسته.
- انیمیشن ثابت با مقادیر تهی یا تکراری.
- گزینه جدید
highContrast
annotations به شما امکان می دهد دوباره توانایی سفارشی کردن رنگ متن را در یک نوار به دست آورید. - رفع خطا هنگام ایجاد یک راهنمای ابزار برای مبدأ null یا NaN.
- حالت Explorer ممکن است در شرایط غیرعادی خراب شود. دیگر نه.
- چاپ نمودارها
- نکات ابزار اکنون در بالای طرحهای سری ارائه شده است.
- حاشیه نویسی ها دیگر بریده نمی شوند.
- رفع کدورت.
- رفع انواع فایرفاکس و IE.
- نوشتار زیرخط دار را کنترل می کند.
- طراحی نمودار به ناحیه نمودار بریده می شود و نکات ابزار اینطور نیست.
- نمودارهای دایره ای سه بعدی به درستی رسم می شوند.
- نمودارهای میله ای و ستونی
- گزینه ای اضافه شد تا یادداشت ها همیشه خارج از نوار کشیده شوند.
- نمودارهای دایره ای
- نمودارهای دایره ای معکوس سه بعدی ثابت.
- مشکل Pie Chart در کروم برطرف شد که باعث میشد تقریباً کل حلقهها نادرست ارائه شوند.
- هیستوگرام ها
- انتخاب چندگانه و جمعآوری راهنمای ابزار ثابت شد.
- نمودارهای جغرافیایی
- پشتیبانی از tooltip.trigger = 'انتخاب'.
- جدول زمانی
- با "تاریخ" و همچنین "تاریخ" کار می کند.
- اکنون می توان شروع < 1970 و پایان == null را کنترل کرد.
- اکنون دارای نکات ابزار و تعاملی است که در IE10 کار می کند.
- رفع خرابی در IE10.
- نمودارهای حاشیه نویسی
- هنگامی که بیش از 26 حاشیه نویسی وجود دارد، برچسب ها ثابت می شوند.
- رویدادهای
rangechange
،ready
وselect
اکنون پشتیبانی می شوند. - پشتیبانی ثابت از DataView.
- اشکال نقطه ای
- گزینه
dent
جدید به شما امکان می دهد ظاهر ستاره ها را سفارشی کنید.
- گزینه
- دسترسی
- به هم ریختگی از DOM حذف شد و برچسب های توصیفی ARIA اضافه شد.
25 مارس 2014
- اشکال نقطه ای
- یک گزینه سطح بالای
pointShape
جدید اضافه شد. - یک گزینه جدید
strokeDashStyle
برای براش ها اضافه شده است.
- یک گزینه سطح بالای
- انیمیشن: اصلاح اضافه شده برای انیمیشن حاشیه نویسی و فواصل.
- حالت کاوشگر
- محورهای تاریخ، تاریخ و زمان روز را برطرف کنید.
- برای جلوگیری از شکست با محورهای گسسته رفع کنید.
- ویرایشگر نمودار Google Docs
- بهبودهای مختلفی برای تغییر برگه ها ایجاد کرد.
- برچسبهای ARIA برای بهبود دسترسی اضافه شد.
- گزینه خط شبکه "خودکار" اضافه شد.
- جدول زمانی
- پشتیبانی از سبک ها اضافه شده است.
- گزینه ای برای خاموش کردن راهنمای ابزار اضافه شده است.
- اضافه شدن قابلیت انتخاب آیتم ها
- سانکی
- بررسی چرخه ها در داده ها اضافه شد.
- گره ها را نازک تر و پیوندها را سبک تر می کند.
- تقویم
- پشتیبانی برای انتخاب اضافه شده است.
- پشتیبانی از زمان تاریخ اضافه شده است.
- پشتیبانی از سبک ها اضافه شده است.
- زیبایی های جزئی به رنگ و سبک اضافه شده است.
- نمودار حاشیه نویسی
- اصلاح برای محورهای تاریخ و زمان با برد بسیار کوتاه اضافه شده است.
- رنگ خط انتخابگر محدوده برای مطابقت با رنگ نمودار تغییر کرد.
- هیستوگرام ها: اصلاح اضافه شده برای نکات ابزار.
- متفرقه
- برای بهبود قالببندی پیشفرض، اصلاحی برای تیکهای صریح اضافه شد.
- اکنون Logscale همیشه از تعداد متغیر خطوط شبکه استفاده می کند.
- Added new method of tick generation for date, datetime, and timeofday when used with a variable number of gridlines.
- Treat NaN values as null, and handle isolated values (surrounded by nulls) for Line Charts and Area Charts.
- Added new option for Table Charts:
keepScrollPosition
. - Added support for
labeled
legends in Area Charts. - Added fix for Combo Charts when bars are mixed with other types resulting in gaps.
- Added ability to customize marker icons on map charts .
January 29, 2014
- New chart: Annotation , a flash-free version of the Annotated Timeline
- New chart: Sankey .
- New chart: Calendar .
- New feature: crosshairs for scatter charts, line charts, and combo charts.
- New feature: convert charts to PNGs .
- New method:
addOneTimeListener()
, used to listen for the first occurrence of an event. - Timeline: added 'style' role support.
- Timeline: Selections now supported.
- Pie charts: fixed behavior when there's only one row of data.
- Improved date behavior for variable numbers of gridlines.
- Animations: maxFramesPerSecond is now configurable.
- A set of
boxStyle
options for annotations. - String to number conversion in datatables: they'll now be automatically converted when the column type is numeric.
- Column chart: tooltips now show null values.
- Histogram speed improvement: they now render like column charts for large datasets.
- Histogram: fix for tooltips with categories.
- Explorer: fix for non-numeric data.
- Calls to google.load now serialized.
- Fixed IE7, IE8 error when using annotations and stacked columns.
November 26, 2013
- Now possible to show persistent values next to bars, columns, points, etc.
- Markers now drawn with correct size when min value > max data value.
- Drag to pan/zoom implemented
- Fixed date formats for Japan
- Fixed: Follower scale overlaps world map
- When doing a mouse drag, and the mouse cursor end up over the chart, don't do any hover effect
- Fixed: When setting the viewWindow to do panning, the gridlines don't provide meaningful indication to target-axis scale changes.
- Fixed: [Firefox] Description pop up is not coming up when user hovers mouse over the graph bars under posts tab
- Fixed: getSelection returns selection objects with undefined column properties
- Fixed: join() & group() functions no longer empty column ids
- Fixed: Afghanistan marker appears in Pakistan in Mac Safari
- Fixed memory Leaks in various charts
- GeoChart now supports all the tooltip features that corecharts support
- CoreCharts click on value now selects or deselects correct data value when reverseCategories is true
- DefaultColor is now an option
- Fixed: Animations that change the axis type from/to a date axis will error out
- Fix leaking listeners issue with native event targets
- Data opacity for points now supported
- Fixed: ColumnChart, BarChart, and CandlestickChart with continuous domain axis splits bars in half on low and high ends of axis
- vAxis:{logScale:true} no longer errors when there are NaNs in the data
- Fixed: When vAxis.logScale is true, vAxis.maxValue seems to act like vAxis.gridlines.count
- Fixed: minValue and maxValue set to 0 are ignored, with variable number of gridlines (when gridlines.count == -1)
- Allow viewWindow.max and viewWindow.min to work with ticks
- Fixed axis date formatting
- "Move & Resize" option now responds appropriately
- Horizontal axis with slantedText now offsets text to keep it centered under tick value
- Changing baseline with min max view window does not behave properly for some of the charts
- Added support for createTextOnLineByAngle
- Timeline chart now shows daily data
- Geochart markers size does not change when Min axis value is set
- Fixed missing tooltip title when there is no bar label
- Added some events (but not the full set) to Timeline
- Added enableInteractivity for Timeline
- Formatted explicit tick values no longer ignored in compiled mode
- Single row of data no longer causes errors with bar-like charts
- arrayToDataTable now allows first row headers to specify objects
- Support dataTableFromCsv
- Candlestick chart no longer fails when the number of rows exceeds the available width to display all the candlesticks
- Axis charts with zero rows of data and variable number of gridlines no longer cause infinite loop
- Timelines no longer error out on reasonable data
- Math.floor(x) === x no longer has nondeterministic result
- Trendline now works for Spark chart
- Fixed error display for Bar chart
- Made an option for Z order for Series
- Fixed SansSerif font bug
- Fixed exceptions caused by current corechart code
- Image-after-next now animates smoothly, instead of appearing abruptly at the end of swipe animation
- Left Vertical axis options now shown for the Inline charts
- Chart options no longer disturbed in "change chart" drop down for inline chart
- Array of strings/numbers passed to arrayToDataTable no longer turned into array of objects
- Fixed obscure memory leak in Line Chart
- Legend options no longer missing in the histogram "customize" tab.
- Histogram, Tree chart previews now show properly.
- Histogram no longer shows error on a "compare mode" selection
- Fixed: Dual axis mode is supported for Histogram chart even though there are no axis options in the Sheets chart editor.
- Axis tab options now shown for Histogram
- Fixed animation for diff charts
- Enabled "plot null values" option for histogram
- ChartRangeFilter error fixed
- Tooltips now take length of "null" into account
August 27, 2013
- Timeline Charts A timeline is a chart that depicts how a set of resources are used over time. If you're managing a software project and want to illustrate who is doing what and when, or if you're organizing a conference and need to schedule meeting rooms, a timeline is often a reasonable visualization choice. One popular type of timeline is the Gantt chart:
https://developers.google.com/chart/interactive/docs/gallery/timeline - Donut Charts
We now let you create a donut chart by removing a hole from the center of a pie chart:
https://developers.google.com/chart/interactive/docs/gallery/piechart#donut - Map Data Refresh for GeoChart
As Google improves its geographic data through projects like Ground Truth , we periodically regenerate our static map data to integrate these improvements.
- Explicit Ticks
We now provide "explicit ticks", which enable you to fine-tune where ticks appear and how they're labeled. See the
hAxis.ticks
andvAxis.ticks
options at, for example, https://developers.google.com/chart/interactive/docs/gallery/linechart#Configuration_Options . - Bounding Boxes
We've documented
getBoundingBox()
and several related methods that let you extract information about where chart elements are drawn on the screen. See the chart gallery documentation pages for details. - Geocoding Improvements
We've made a number of improvements to our geocoding library to better cache requests across multiple GeoCharts on the same page.
- Miscellaneous Improvements
- DateFormatting improvements for certain locales
- JSON serialization fixes
- Trendline line width fixes
- Fix for logScale on vAxis when NaNs occur in the data
May 15, 2013
- Trendlines - Support for Linear and Exponential trendlines in most core charts.
- Actions - Now you can add more interactivity to your tooltips. This is an open-ended feature which allows you to add JavaScript callbacks to a menu in tooltips.
- Automatic Gridline Selection - use our algorithm to automatically select the number of gridlines. You can use this by setting the
gridlines.count
option to-1
. This works for bothhAxis
orvAxis
. - Improvements in ChartWrapper performance.
September 24, 2012
- HTML Tooltip - Support for custom HTML tooltip content for data points, categories and annotations (certain core charts only)
- Look Mom, No IFrame! - With the exception of IE 8, charts are no longer drawn inside an IFrame by default. If you're feelin' retro you can bring it back by setting the option
forceIFrame: true
- Removed the
strictFirstColumnType
option. As you recall this was a temporary remedy for backward compatibility. Please refer to this help section for proper solutions - GeoChart : New option, tooltip.trigger, which works the same way as in the core charts
- GeoChart : Improved border colors
- ChartRangeFilter : You can now leave the control area while panning/zooming
- ChartRangeFilter : Fixed occasional crash when moving one handles over another
- Significant performance improvements when drawing charts with a domain axis of type date
June 18, 2012
- CandlestickChart: Allow more control over the candlesticks colors (see the
candlestick
option group) - ComboChart: Support candlesticks and steppedArea series (see the
series
/seriesType
options) - ColumnChart/BarChart/CandlestickChart: Support continuous domain axis (see the relevant data format sections)
- All corechart charts: Support legend alignment (see the
legend.alignment
option) - All corechart axis charts: Support minor gridlines (see the
minorGridlines
option)
May 2, 2012
- Added a configuration option to control the width of bars in a ColumnChart/BarChart and candlesticks in CandlestickChart
- Fixed crash when calling clearChart() twice in a row for charts in the corechart package
- Fixed malfunctioning interactivity when calling draw() after clearChart() for charts in the corechart package
- GeoChart: New province maps for Estonia, Finland, Lithuania, Latvia, Somalia and South Sudan
- Gauge: Fixed crash when calling draw() twice in Firefox.
April 2, 2012
- Annotations:
- Simple visual effect for selection of annotations (make text bold).
- Better handling of annotation bundles (ie, multiple annotations on the same data point / domain value).
- Allow interaction with annotations in 'category' focus target.
- TreeMap chart:
- Added an option to use weighted averages in the treemap.
February 22, 2012
- Added gradient color mode to bubble chart.
- Geo chart :
- Region interactivity in marker mode is now disabled by default. How to keep the old behavior? Set the
enableRegionInteractivity
option to true. - Markers are now opaque by default. How to keep the old behavior? Set the
markerOpacity
option to 0.5. - Marker size is now between 3 and 12 pixels by default. How to keep the old behavior? Set the
sizeAxis
option to {minSize: 2, maxSize: 30}. - A magnifying glass is now opened when the user hovers over cluttered markers (excluding IE<=8). How to keep the old behavior? Set the
magnifyingGlass
option to {enable: false}. - We don't stretch the maps by default anymore, but rather keep the original aspect ratio. How to keep the old behavior? Set the
keepAspectRatio
option to false.
- Region interactivity in marker mode is now disabled by default. How to keep the old behavior? Set the
- A new control - ChartRangeFilter .
- A new experimental option
forceIFrame
whose default is true (the current behavior), but can be set to false. When set to false, corechart charts, geo chart, treemap and gauge will not render the chart in a iframe (for all browsers excluding IE<=8). This is still very experimental, and undocumented. We would like you to try it out and give us your input!
January 18, 2012
- Changed the default of
strictFirstColumnType
to true. If this causes issues with your charts please refer to the help section. - Added a new chart - bubble chart .
- A new chart editor design with a revamped customize panel.
- Added clearChart method to all visualizations in the main gallery.
- Table: Fixed memory leak.
- CandlestickChart: Performance improvement in all browsers.
- GeoChart: Performance improvement in IE 8.
- SteppedAreaChart: Support combination of connectSteps and isStacked options.
December 7, 2011
- Transition animation .
- New visual effects for focus and selection of chart elements in scatter, line, area, and other charts.
- New column role feature , enabling annotations, error bars, custom tool tips, out-of-scope indication, certainty level and emphasis in the core chart types.
- Marker mode in Geochart .
- New chart: Stepped Area .
- New UI for ChartEditor
- Geo chart: new maps for US states, improved visualization of disputed areas.
- New option for maximizing chart size:
{theme: 'maximized'}
.
October 30, 2011
- Bug fixes and infrastructure work.
September 26, 2011
- Improving rendering efficiency in corechart and GeoChart.
- Localization support.
- CoreChart: Visual effect for selection of points in LineChart/AreaChart/ScatterChart.
- GeoChart/Treemap: Fix color scale in IE8.
August 17, 2011
- Improving rendering efficiency in the GeoChart.
- Supporting iOS and IE8 in the Gauge visualization.
- CoreChart: improving the visual effect of focus on mouse over.
July 13, 2011
Many new properties, including:
-
viewWindow
, to specify vertical data zooming/cropping -
pieChartTooltip
- to specify what information should be in the tooltip -
series
properties:visibleInLegend
,enableInteractivity
,areaOpacity
- Many new override properties on the
vAxis
/hAxis
objects.
- Dual Y axes now supported, using the
series.targetAxisIndex
andvAxes
/hAxes
properties - GeoChart performance improved
May 9, 2011
- GeoChart - New GeoChart (replacing the current Flash GeoMap)
- Candlestick - New CandlestickChart
- ComboChart - Enables combinations of bars, lines, and area charts on the same axis.
- Enable customization of independent series in the corechart package (eg explore the series option in the ComboChart )
- ChartWrapper - New ChartWrapper class for encapsulating chart creation and serialization.
- ChartEditor - New ChartEditor that can be embedded in your own site.
- Changes to the TreeMap look-and-feel.
- New controls package and ControlWrapper.
- Fusion Tables are now a Google Visualization compliant data source.
- Moved image charts to use https.
March 21, 2011
- Treemap - New rollup event
- ImageCandlestick - Added padding for the first and last candles
- Gauge - Changed default colors, and allowed users to change them. Fixed some memory leaks
- Bar, line, area, column, and scatter charts - Updated the gridline appearance.
February 24, 2011
- New image candlestick chart .
January 17, 2011
- Bar, column, line, and scatter charts: added
gridlineColor
option. - Various charts: Added two new options for formatting tick mark text:
-
hAxis.format
(bar, scatter charts) -
vAxis.format
(line, area, column, scatter charts)
-
- Line chart:
- Added
interpolateNulls
option. - Points are now invisible by default unless hovered over.
- Added
- Pie chart:
- A slice is now emphasized when hovering over a slice or slice legend.
- Selecting pie slices now replaces the previous selection rather than adding to it.
- Added pieResidueSliceColor option to change the color of the composite slice.
- Treemap:
- Fixed a bug that prevented a three-column data model from rendering
- Fixed sorting
- Area, bar, column, line, pie, scatter, treemap, and gauge charts now use SVG on IE9, rather than VML.
- New function,
google.visualiation.arrayToDataTable()
.
November 7, 2010
- Added following properties to area, bar, column, line, and scatter charts:
- chartArea, to specify the size and positioning of the chart area within the chart boundaries.
- titlePosition and axisTitlesPosition, to specify positioning of the chart and axes titles.
- backgroundColor, to specify the color of the chart area background and border.
- vAxis/hAxis.textPosition, to specify the position of the labels for the tick marks on the vertical and horizontal axes.
- Added following features to pie chart:
- chartArea, to specify the size and positioning of the chart area within the chart boundaries.
- backgroundColor, to specify the color of the chart area background and border.
- pieResidueSliceLabel, to specify the label for the slice that represents the accumulated values of all slices below a specified threshold value.
August 11, 2010
- Updated core charts package :
- Enabled top and bottom positioning of the legend.
- Improved label layout when charts are textually overloaded (automatically switching to alternating labels and slanted text when necessary).
- Improved Pie Chart by exposing an option for 3D and for formatting the texts on the slices and the tooltips.
- Improved handling of error notifications across all charts.
- Fixed several bugs, including addressing the memory leak that occurred when redrawing charts.
- Fixed bug in Geomap where two letter codes where wrongly assumed to be region codes.
June 16, 2010
- Added onmouseover/onmouseout events to treemap
- Generic image charts, type radar:
- Both r and rs chart types now supported
- showValueLabels is now true by default
- Area, bar, column, line, pie, and scatter charts:
- Fixed some layout and ordering bugs.
- Improved error handling of bad data values.
- Additional small bug fixes.
- Geomap - Now supports internationalized tool tip strings.
May 18, 2010
- New Core Charts (see below) - Several common chart types have been redesigned, and combined into a single package called
corechart
. We will no longer fix bugs or add new features in the older versions but rather encourage users to migrate to the new charts. - Image charts now support interactivity
- New tree map visualization
- Multi-select now supported on the Mac for the Table visualization.
- Map now provides the Terrain type.
More About Core Charts
We have created new versions of several common chart types, including area, bar, column, line, pie, and scatter charts. The new versions are in a common package called corechart. The older versions will continue to exist, in their previous packages, but we encourage you to start using these new versions.
How to migrate to the new charts :
- Change your package name
Load the newcorechart
package rather than the older packages. This new package includes the code for the new versions of the area, bar, column, line, pie, and scatter visualizations, which were previously loaded by separate packages.google.charts.load("current", {packages:["corechart"]});
- Adjust your chart options
Although many of the options have remained the same, some have been renamed or are not yet supported.
Renamed Options:- reverseAxis - Now called
reverseCategories
. - lineSize - Now called
lineWidth
. - smoothLine - Now called
curveType
and instead of the value true, the user should specify the value 'function'. - titleX/titleY - These options are now called
title
and are part of the newhAxis
orvAxis
objects. - logScale/logScaleX - These options are now called
logScale
and are part of the newhAxis
orvAxis
objects. - min/max - These options are now called
minValue
/maxValue
and are part of the newhAxis
orvAxis
objects.
Unsupported Options:- Legend positions - We currently support only the right legend position (or not displaying a legend).
- 3D - Pie charts do not support a 3D version at the moment.
- Tooltip - In the current version, tooltips open automatically on mouse hover; you cannot open or close them using the API.
- reverseAxis - Now called
April 22, 2010
Mostly internal changes.
February 5, 2010
- Map and Geomap now dynamically load maps API V3 . If you currently load the maps API V2 script, you should remove it.
Note: You can not use the maps API V2 together with gviz Map/Geomap charts. - Map chart
- Returns proper ready event .
- Tooltip column may be of any type (and not only string as before).
- Image chart - Now provides two new options backgroundColor and valueLabelsInterval.
- Table chart - Paging buttons now properly respect user height.
November 10, 2009
- Annotated Timeline - Chart zero values now displays accurately.
- Area , Bar , Column , Line , Pie , and Scatter Charts - Internet Explorer 8 events and tooltips now handled properly.
- Table chart - Custom "Next" button text now displayed properly.
- Motion chart - Now supports animated line charts. New locales supported: "ru", "tr", "cs", and "hu".
- Geomap - Now supports metro area codes.
- Image Pie Chart - Now supports options to set the legend and labels.
September 29, 2009
- DataTable - New
toJSON()
method that returns JSON string that can be used inDataTable
constructor. - Wire protocol - JSON response format now supports true JSON-valid date strings.
- imagechart - New method
getImageUrl()
returns image URL used by Charts API. - Annotated Timeline :
- Bug fix - Legends now support commas properly
- You can now specify a null starting or ending date in
setVisibleChartRange()
to start from the beginning or ending range.
- Area Chart , Bar Chart , Column Chart - Bug fix: legends now displayed in same order as series in stacked versions of these charts
- Scatter chart - Bug fix: null values caused row index count to be off for succeeding rows in the data table.
- Area , Bar , Column , Line , Pie , Scatter charts:
- Calling
setSelection()
with both no parameters, null, or an empty array will deselect all selected items. - Added new options: tooltipWidth , tooltipHeight , tooltipFontSize to enable setting tooltip font size, width, and height respectively.
- New options to change the axis (axes) to a logarithmic scale: logScale , logScale X
- Calling
- Bar formatter - Now shows formatted value if present, rather than actual data value.
- Grouping and joining now enabled on
DataTable
. Details with the production release. - Calculated columns now enabled on
DataView
. Details with the production release. -
DataView
- Added newgetProperties()
method. - Pie Chart - Fixed a bug with drawing some small slices in Internet Explorer.
- Org Chart - Improved the look of the org chart.
July 20, 2009
- Arrow Formatter - Small bug fix: Add missing cell border when Arrow Formatter is used
- Motion chart - Add statechange event
- DataTable - Bug fix: getDistinctValues() on an empty data table (used to throw an exception)
- Annotated timeline chart
- New appearance to the annotation list
- Fix double escaping in labels (for example when Euro symbol was in number format)
- Bug fix: Small changes in the range now fire range change event
- Changing the zoom with arrows now fires range change event
- Fill color is the same as line color
- Allow annotation columns even when displayAnnotations option is set to false (but columns are ignored)
- Bug fix: Wrong timezones when selecting the visible range
- Do not change mouse to hand when clicking a maximized chart
- New option (now default) to highlight the nearest dot, not the last
- New option to hide the bar date separator at the top right hand corner
- New option to hide the dots at the top legend
- New option to hide the values at the top legend
- Image chart
- Bug fix: some parameters were being dropped
- Support for hidden columns
- Org chart - Bug fix: Handle 'style' and 'selectedStyle' correctly.
- Interactive Charts (all) - Fix a bug with selection, when there are null values in the middle of a series
- ToolBar - Added an option "style" in the toolbar visualization, in the htmlcode component
- Pattern format - Added an option to output the result into a custom property of cells in a given column
- Table visualization - Changed paging symbols to use an image by default instead of unicode characters, and added a parameter to specify prev/next paging keyboard shortcuts for accessibility.
May 26, 2009
- A complete data source implementation , including full support of the Visualization Query Language in an open-source Java library.
- A new version (0.6) of the Google Visualization API wire protocol with the following features:
- Additional query options with enhanced security.
- Custom properties now supported in DataTables at the cell, row, column, and table level.
- New output features:
- Support for new output format ( tab-separated values ).
- Ability to request a custom output file name for CSV or TSV files (see the
outFileName
parameter).
- A new version (0.7) of the Google Visualization API query language with the following features:
- Support for calculated columns.
- Support for scalar functions.
- A new Generic Image Chart visualization that wraps the functionality of the Google Chart API:
- Exposes all the charts provided by the Chart API
- Not restricted by the 2K data limit when using the Chart API directly using URLs.
- Improved google.visualization.ColorFormat now supports all data types except boolean.
- Legends have been temporarily disabled in image pie chart , image scatter chart, and image line chart. (Image scatter and image line charts are created using the Generic Image Chart , by setting option 'cht' to 's' (scatter chart) or 'lxy' (line chart)).
- Organizational Chart
- Added mouseover and mouseout events
- Added support for custom style properties
- Geomap - Google Maps
<script>
include no longer needed if you use the lat/long format with markers. - New options added to google.visualization.Query to support different data sending methods.
- Area , Bar , Column , Line , Pie , and Scatter Charts support new options: titleFontSize, legendFontSize and AxisFontSize .
- Fixed an image pie chart bug. Previously, i f you passed multiple colors to your options object it create a gradient based only on the first color, ignoring all additional colors. N ow it uses all colors as documented.
- Fixed an annotated timeline labeling bug. Previously, labels were truncated to any % markers in the legend; this has been fixed to allow % characters.
April 6, 2009
- New toolbar helper element that enables you to export your data in a variety of formats, or embed the visualization in another page.
- Interactive charts ( area , bar , column , line , pie , and scatter charts)
- Added
onmouseover
andonmouseout
events. - Added a
showCategories
option to hide the category labels. (Does not apply to pie chart). - Fixed an axis scale bug: If the min value was just above zero and the max value was large, the chart legend was expanded to below zero.
- Added
- Table visualization
- Table customization
- Enable the user to supply css class names for:
headerRow, tableRow, oddTableRow, selectedTableRow, hoverTableRow, headerCell, tableCell, rowNumberCell.
- Enable the user to supply css class names for:
- Fixed a bug in cell property 'className'.
- Added
ready
event. - Basic right-to-left language support for table.
-
sort
event, and a methodgetSortInfo
, returns an array of indexes which is a mapping of the current sort.
- Table customization
- Map
- Added
zoomLevel
option.
- Added
- Motion chart
- Added
ready
event. - Fixed a bug to enable
getState
method.
- Added
- Org chart
- Added column for tooltips, implemented as a third optional column. If set, the value in the third column is the tool-tip that will be displayed when hovering over the node.
- Formatters
- Added a whitespace margin around the bar formatter.
- Added an option to display a black line at the zero value of the bar formatter.
- Annotated Time Line chart
- New option to hide the range selector area.
- Added number formatters to columns
- Added date formatter to the date at the top right of the chart.
- DataView
- Improved performance of a DataView when used only for manipulating columns, and not rows.
- Fixed a bug: When using a DataView only for manipulating columns, and adding rows to the table only after creating the view, these rows were not accessible through the view.
- DataTable
- Filter columns by value range. Each of the filters passed to
getFilteredRows
can be a range filter containing properties ofminValue
andmaxValue
- Filter columns by value range. Each of the filters passed to
February 23, 2009
New Features
Here is a summary of the most interesting new features of the API.
- Significant additions to the motion chart , including zoom, bars, and an option to save and restore the state.
- Added new options to the Interactive Pie Chart :
pieJoinAngle
andpieMinimalAngle
, to control the behavior of the 'other' slice. - Added control over the
min
andmax
y values of the axis based Interactive Charts (Line Chart, Bar Chart, Area Chart,etc.). - Added 'ready' event support for all Interactive Charts.
- Added collapse option for the Org Chart (
allowCollapse
). - Added new Date Formatter .
- Made formatters available for all visualizations (not only Table).
- Added methods to programatically hide and display specific data series on Annotated Time Line Chart.
Fixed Bugs
No major bug fixes.
Known Bugs
- The dates in the top right corner of the annotated time line chart are corrupted in some locales (es, po).
- After clicking on a legend of a line in line chart , the line width is set back to the default value, even if another value was specified.
- Default bubble size in motion chart is different.
- In the Bar Chart, the font can get too large. We should limit the maximum font size.
January 20, 2009
New Features
Here is a summary of the most interesting new features of the API. For the complete list, see Full Details below.
- New generic
ready
event which is fired when a particular visualization is ready for methods to be called. - New options for the annotated time line chart :
-
fill
configuration option to control the trasparency of the area below the lines. -
thickness
configuration option to control the thickness of the lines. -
max
configuration option to control the max value displayed in the Y-axis. - If
date
type time is used, limit the x-axis resolution to days. -
ready
event is fired when the chart is ready for methods to be called. -
select
event is fired when flags are clicked by the user.
-
- New
ready
event implemented for Organizational Chart and Intensity Map . The event is fired when the charts are ready for methods to be called. - Added functions to set and get row properties on
DataTable
andDataView
. - Added functions to set and get table properties on
DataTable
andDataView
.
Fixed Bugs
- The gauge visualization's setInterval() method was fixed and is now working well also with Internet Explorer.
- The annotated time line chart failed to zoom-in to less than one day. This issue was fixed.
- The bar chart labels were drawn in a reverse order.
- Unselection of cells in interactive charts now close the tooltips.
- Refresh was not working in some of the gadgets of interactive visualizations.
Known Bugs
- The dates in the top right corner of the annotated time line chart are corrupted in some locales (es, po).
- After clicking on a legend of a line in line chart , the line width is set back to the default value, even if another value was specified.
Full Details
In addition to the new features, we introduced the following changes in this release:
- Improved latency issues in motion chart (especially on IE).
- Table
- No paging buttons when there is only one page.
- Make sortable headers fixed width.
- Small improvements in the look and feel.
December 9, 2008
New Features
Here is a summary of the most interesting new features of the API. For the complete list, see Full Details below.
- Google Web Toolkit now has a library for creating and manipulating visualizations.
- New options for the table visualization.
- Motion charts now support multiple charts, more locales, and speed slider.
- Annotated timeline now supports 10 locales.
- New geomap visualization.
Fixed Bugs
- Spreadsheet authentication errors have been fixed, and error messages clarified.
Known Bugs
- The gauge visualization's setInterval() method does not work with Internet Explorer.
Full Details
In addition to the new features, we introduced the following changes in this release:
- New Google Web Toolkit (GWT) library with support for the following:
- Using Google visualizations from GWT code,
- Wrapping your own visualization in a GWT wrapper, and
- Writing visualizations using GWT.
- Table
- New properties: firstRowNumber, startPage, width, height, alternatingRowStyle, scrollLeftStartPosition.
- Motion chart
- Now more than one table visualization can be hosted on a page.
- 20 locales now supported.
- Annotated timeline:
- 20 locales now supported.
November 3, 2008
New Features
Here is a summary of the most interesting new features of the API. For the complete list, see Full Details below.
- Released the format of version 0.5 of the GViz data source protocol . Now you can expose your own data source to visualizations!
- Big reorganization of the documentation. We hope you like it.
- Release of an open source Python library that helps data source providers wrap data in an appropriate object to respond to data requests.
Known Bugs
- The gauge visualization's setInterval() method does not work with Internet Explorer.
Full Details
In addition to the new features, we introduced the following changes in this release:
- New get/setSelection() events added to Google's area, bar, column, line, pie, and table charts.
This page describes the Google Charts release process. It also includes the release notes for the current and previous versions of Google Charts, as well as a highlight of what's new.
The most recent version of Google Charts, also known as the official
current
release , is listed below along with the summary of changes for all previous releases.See library loading for an explanation of what it means for a release to be
current
.All 'jsapi' requests are now being redirected to the new loader. If you were loading version '1' or '1.0', you will now be loading 'current'. The closest match to the last version that was previously available via the jsapi loader is '45.2'.
Please use the new gstatic loader from now on. See the instructions on how to up update your loader code .
The Google Visualization API Release Process and Release Candidates
We release the Visualization API in two steps:
- At least two weeks before we release a new official version of the Visualization API, we will release a preliminary version, called a Release Candidate (RC), which you may load as version "upcoming". This is to test for any breaking changes in the release. We will post a notification to the Visualization API developer discussion group and monitor that group for reported issues, attempting to fix any backward compatibility problems reported.
- Two weeks after the RC release, if we are able to resolve all reported backward compatibility problems, it will be released as the new, official "current" release.
We encourage you to test your applications against each RC as soon as possible, and report any issues you have, to help us release a stable product.
While the Visualization API team thoroughly tests each new version, we realize that bugs may still exist in any new release. The objective of this two-step process is therefore to improve the reliability of the API for production systems.
Release Candidate Announcements
We will announce each new release candidate by emailing the Visualization API developer discussion group . If you're using the Visualization API for any serious applications, we highly recommend that you join this discussion group.
To help you find or filter these emails, each release announcement will have the same subject: "Release Candidate Pushed: <DATE>" , where <DATE> is the push date. This email will include these usage instructions. New features will not be documented in detail, because the target of the release candidate is not to test the new features, but rather to test that the release does not break existing features. Detailed documentation of all the new features will be released with the production version.
How to Use the Release Candidate
The release candidate package version is "upcoming", in contrast to the production version which is "current". (Note that these names will not change with future releases.)
You can load either the production or the release candidate (but not both at once), depending on your version parameter, as shown here:
// To load the production version, call this: google.charts.load('current', {'packages':['corechart']}); OR // To load the release candidate, call this: google.charts.load('upcoming', {'packages':['corechart']});
Reporting Bugs
Visit our Known Issues page if you encounter a possible bug in Google Charts. Before filing a bug, please check your code to be sure that it's really a bug (post questions to the mailing list for additional help), then search the known issues page to see whether it has already been filed, or resolved.
If you discover any issues in the release candidate, you should send a message to the Visualization API developer discussion group with the details of the problem. The Visualization API team monitors this group during the release candidate period in order to be extra responsive during that time.
Official Releases
When you load Google Charts, you have a few options. Normally, it's done like so:
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load('current', {packages: ['corechart']}); google.charts.setOnLoadCallback(drawChart); </script>
The 'current'
string means that the current stable version of Google Charts will be loaded. If you want to get the cutting-edge, proposed candidate release version before it becomes the next 'current'
version, use 'upcoming'
instead. Whichever of these versions you specify, you will see improvements over time as we update them.
On July 28, 2015, we announced frozen versions. These are releases of Google Charts that will remain unchanged forever (modulo the occasional critical fix). The first frozen release was 41
corresponding to our February 23, 2015 release.
You load a frozen version like so:
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> google.charts.load('46', {packages: ['corechart']}); google.charts.setOnLoadCallback(drawChart); </script>
More info is available in the Load Version documentation.
Version History
Current: April 2023
Available in quasi-perpetuity as Frozen Charts Version 52This release includes many more internal refactorings and migrations to ES6 and TypeScript, in preparation for the first phase of open-sourcing Google Charts.
- GeoChart
- Updated geochartVersion to 11, and regioncoderVersion to 1.
- Dygraph charts
- Gantt, Timeline, and the Material charts: Bar, Line, Scatter
- No longer loads the Dygraph library dynamically since it is compiled in.
- Table
- Fix highlighting of current page number for more than 11 pages.
- OrgChart
- Add 'compactRows' option. Default is false.
- Uses the Reingold-Tilford algorithm for layered trees. Its main advantage is a more effective use of horizontal space by placing subtrees close together as long as nodes in the same layer do not overlap.
June 2021
Available in quasi-perpetuity as Frozen Charts Version 51This release includes many more internal refactorings and migrations to ES6 and TypeScript, in preparation for the first phase of open-sourcing Google Charts.
- VegaChart
- Timeline
- Add the hidden accessibility table to Timeline.
- New
alternatingRowStyle
option to enable setting the background style of alternating rows to lighter and darker colors. Default is true.
- Query
- Allow trailing ';' to be missing on Query responses.
April 2021
Available in quasi-perpetuity as Frozen Charts Version 50This release includes many internal refactorings and migrations to ES6 and TypeScript, in preparation for the first phase of open-sourcing Google Charts.
- VegaChart
- Added support for Vega-lite, and Vega-embed.
- Treemap
- New
enableHighlight
option enables highlighting of elements. How the highlighting is triggered should be configured with eventsConfig. (highlightOnMouseOver
is deprecated) - New
eventsConfig
option for configuring how events trigger Treemap interactions. The default configuration is:{ highlight: ['mouseover'], unhighlight: ['mouseout'], rollup: ['contextmenu'], // right-click drilldown: ['click'] }
- New events:
'highlight'
,'unhighlight'
,'drilldown'
- New
- Query
- Workaround lack of support in older versions of spreadsheets for the new more secure JSON response handling (which resulted in CORS errors).
July 2020
Available in quasi-perpetuity as Frozen Charts Version 49This release includes several more internal refactorings, so be aware of unintentional breakages. Code that has been affected includes all formatting classes, events, errors, parts of ChartEditor, ChartWrapper, ControlWrapper, Corecharts, Corechart axis ticks, GeoChart, and Query.
- VegaChart
- New chart type, now released in beta.
- A VegaChart is a wrapper for all of the many possible visualizations that may be specified using the Vega Visualization Grammar and drawn using data from DataTables like other charts. In future releases, we will further integrate the features of Google Charts and Vega.
- Uses the vega-interpreter to remain compliant with Content Security Policy restrictions.
- GeoChart
-
geochartVersion
option, specifies the border data version; default is 10, but 11 is now available. -
regioncoderVersion
option, specifies the region coder data version; default is 0, but 1 is now available. - Fixed bug which accidentally included package 'geochart' in 'corechart'. Now works as documented. Ie, make sure you load packages: ['geochart'].
-
- Gantt Chart
- Added
sortTasks
option, default value true, to sort the tasks normally, or if false, use the same order as the rows in the DataTable.
- Added
- Query
- The JSON response option now requires that the server returns strict JSON, and the server must allow cross-origin requests.
- Loader
- If
google.charts.load()
is called more than one time with different versions or different languages, the settings from the first load are used. - Allows a version number, not just a version string.
- More backward compatibility tweaks to support redirects from the old jsapi loader.
- The autoload URL parameter must now be formatted as strict JSON, and URL encoded.
- The
google.charts.load()
call now returns a JavaScript Promise, so in addition to the other callback mechanisms, you can call your chart drawing function like this:google.charts.load('upcoming', {packages: ['corechart']}).then(drawChart);
- If
May 2020
Available in quasi-perpetuity as Frozen Charts Version 48- Fix bug in autoload parameter when combined with its own callback setting.
- Fix a bug with boxStyle for annotations when there are multiple series.
- Fix AnnotationChart zoom buttons.
- Avoid use of array.entries() and Object.entries(). This is to avoid requiring polyfills for IE11 which may conflict.
- GeoChart now loads data using xhr, which means the setMapsSource method will work again, with two conditions: (1)The data portion of the content must have no comments (ie strict JSON format) and (2) the server must allow cross-origin requests for the data.
February 2020
Available in quasi-perpetuity as Frozen Charts Version 47- Significant refactoring of core utilities for DataTable, DataView, and options processing.
- Calendar
- Add option for
legend.position
, default value'right'
. You can use'none'
to hide the legend.
- Add option for
- Timeline
- Fix sub-second time intervals (but still without ticks).
- Fix performance issues with overlapping time intervals.
- Controls - Fixes to NumberRangeFilter. Now supports
fractionDigits
set to 0. - Add loader setting to enable "safeMode". When set to true, all charts and tooltips that generate HTML from user-supplied data will sanitize it by stripping out unsafe elements and attributes.
- Add support for the "autoload" and "callback" parameters on the loader, to be backward compatible with the old JSAPI loader. The autoload parameter MUST be strict JSON, and urlencoded.
- For corecharts
- Handle
"zoomDelta"
values below 1.0 - Add
"maxTextLines"
as a vertical axis option.
October 1, 2018
Available in quasi-perpetuity as Frozen Charts Version 46- Corecharts
- Ticks and Gridlines
- Several changes were made to the axis tick and gridline generation to allow tighter packing of ticks that don't overlap.
- Minor gridlines are even more dynamic now since the appropriate number of minor gridlines depends on the interval between the major gridlines and available space. The default now is to always show minor gridlines, if they fit. Specify
{ minorGridlines: { count: 0 }}
to force no minor gridlines, or{ minorGridlines: { count: 1 }}
to enable minor gridlines. TheminorGridlines.count
option otherwise has no meaning. - The color of minor gridlines will default to 'none' if the major gridlines color is 'none'.
- Many improvements to gridlines and tick labels for the
log
andmirrorLog
scales. - Allow negative slanted angle, to slant the 'other' way.
- Disable skipping and alternating (ie multiple staggered lines) for dates and times, by default.
- Generation of gridlines, minorGridlines, and ticks now determines the number and spacing of gridlines based on other options besides the count. If you specify a number for
gridlines.count
, it will be used only as a rough approximation. - New
gridlines.minSpacing
andminorGridlines.minSpacing
options let you specify the minimum screen space between major gridlines in pixels. Default for major gridlines is 40 for linear scales, 20 for log scales. For minorGridlines, the default minSpacing is 1/2 the minSpacing of major gridlines for linear scales, and 1/5 the minSpacing for log scales. If you specify the count and not minSpacing, the minSpacing is computed from the count. And conversely, if you specify the minSpacing and not the count, the count is computed from the minSpacing. - New
gridlines.interval
option lets you specify an array of sizes (as data values, not pixels) of the gridlines and minorGridlines. This option is only for numeric axes at this time, but it is analogous to thegridlines.units.<unit>.interval
options which are used only for dates and times.- For linear scales, the default is
{ gridlines: { interval: [1, 2, 2.5, 5] } }
which means the gridline values can fall on every unit (1), on even units (2), or on multiples of 2.5 or 5. Any power of 10 of these values is also considered (eg 10, 20, 25, or 50). For minor gridlines, the default is{ minorGridlines: { interval: [1, 1.5, 2, 2.5, 5] } }
. The minor gridline interval that is chosen will always be an even divisor of the chosen major gridline interval. - For log scales, the default is
{ gridlines: { interval: [1, 2, 5] } }
and{ minorGridlines: { interval: [1, 2, 5] } }
.
- For linear scales, the default is
- New options for
gridlines.multiple
andminorGridlines.multiple
, which specify that gridline and tick values must be a multiple of this option's value. So you can force ticks to be integers by specifyinggridlines.multiple = 1
. - Gridlines will now be rejected if formatted tick labels for numbers would be duplicated, so you can specify
format:"#"
if you want to only show integer ticks. - When the explicit 'ticks' option is used, we now expand the viewWindow to include explicit ticks, if outside the data range. Explicit
viewWindow
min
ormax
options can override. This is a change to the previous behavior which acted more like'maximized'
mode with explicit ticks. - When the
viewWindowMode
ispretty
, which is the default for target axes, the viewWindow is now expanded to the nearest major gridline for numbers, or the nearest minor gridline for dates and times.
- Formatting
- Number format for 'short' and 'long' patterns now use 3 significant digits.
- Timeofday values will now be formatted using 24 hour ('HH') values by default instead of 12 hour ('hh') values.
- Explicit formats for dates and times will now override 'unit' formats.
- Fix for explorer mode, which broke after redrawing the chart.
- Ticks and Gridlines
- Histogram chart
- Domain axis gridlines and baseline default color is 'none'.
- Target axis ticks default format is now '#', to display integers only.
- Generate buckets using tick generation algorithm. Default number of buckets is computed using a new
histogram.numBucketsRule
option. Possible values are 'sqrt', 'sturges', and 'rice'. See https://en.wikipedia.org/wiki/Histogram#Number_of_bins_and_width
- ColumnChart and BarChart
- Fixed detection of minimum bar size (the difference between adjacent values) to work with dates and times.
- Table
- Support 'className' property for rows.
- Add user specified column and cell className properties to default properties (rather than replace them), similar to row properties.
- Data
- Fix the data.group function to allow multiple aggregations to use the same column.
- Content Security Policy (CSP) compliance
- Remove uses of eval for JSON deserialization.
June 26, 2017
Available in quasi-perpetuity as Frozen Charts Version 45.2- Corecharts
- Many internal changes affecting how options are processed. (This has caused some bugs involving the 'explorer' mode.)
- Added
tooltip.boxStyle
options: eg'tooltip': { 'boxStyle': { 'stroke': '#b2b2b2', 'strokeOpacity': 1, 'strokeWidth': 1.5, 'fill': 'white', 'fillOpacity': 1, 'shadow': { 'radius': 1, 'opacity': 0.2, 'xOffset': 0, 'yOffset': 2 } }}
- Fix AreaChart legend items to use
areaOpacity
option. - Fix infinite loop when formatted domain values are (incorrectly) numeric.
- Table Chart
- Fix paging buttons.
- Add column type to header cell's
class
attribute. - Respect properties in datatable columns.
- Fix accessibility labels when sorting is enabled.
- Gantt Chart
- Fix selection object to include row index.
January 6, 2017
Available in quasi-perpetuity as Frozen Charts Version 45.1- Corecharts
- Fix to avoid failures when
chartArea.bottom
and.right
options are too large.
- Fix to avoid failures when
- Gantt Chart
- Now returns
row
property for selected items.
- Now returns
September 12, 2016
Available in quasi-perpetuity as Frozen Charts Version 45.- Loader changes:
- Support multiple calls of
google.charts.load
- ChartWrapper instances can be called with a dynamically loaded
chartType
. - The GeoChart and Map chart no longer require you to include the JSAPI loader. There is a new
mapsApiKey
loader setting to let you specify your own key, rather than get the default behavior which may result in occassional throttling of service.
- Support multiple calls of
- Flash-based charts:
- For GeoMap and MotionChart, the swfobject.js has been updated to use the latest version 2.2. There should be no visible changes in chart features due to this update.
- For AnnotatedTimeline, we are now replacing it with the Annotation Chart , which has been under development for a couple years, and appears stable. Almost all the features of the AnnotatedTimeline should apply to the AnnotationChart with no changes required in your code, although the look and feel is different. The AnnotationChart uses no flash code, and is built on top of the Corecharts, ChartRangeFilter, and Table chart.
- Corecharts:
- Fixed
certainty
role so it works correctly with custom styles. - Make accessibility table hide properly in rtl containers.
- Fix startup animation when used with ChartWrapper.
- Fix animation of discrete values that swap places.
- Construct Dates regardless what day of the month it is.
- Fix relative stacked area chart colors.
- Fix ColumnChart with log scale and 0 or negative values.
- Fixed
- PieChart : Fix inconsistent implementation of
reverseCategories
option. - Calendar : Now uses more than two colors from the
colorAxis.colors
array option whencolorAxis.values
is unspecified. The behavior should be more like what happens in the GeoChart, where the inflection points are spread evenly throughout the gradient. - Material Charts: Fixed convertOptions for Material charts to use the background color correctly.
- Map Charts now decouple the marker title text from the info window:
- Added new option 'showInfoWindow' to specifically control the info window.
- Added new option 'showTooltip' to specifically control the marker title text.
- Both options inherit from 'showTip' when not set.
- Bug fix: when clicking on a selected point, the info window will now go away.
February 23, 2016
Available in quasi-perpetuity as Frozen Charts Version 44.- Corecharts:
- Timeofday values now use UTC internally, which fixes problems with truncated timeofday axes.
- Added options to specify
bar.width
,bar.gap
,bar.group.width
(wasbar.groupWidth
) andbar.group.gap
. - Changed bar-like (bars and boxes) intervals to be consistent with bar-like charts.
- Histogram :
- Fixed formatting of tooltip items to use formatted values.
- Fixed bucketing with very small and very large values.
- Bar width and gap options apply to Histograms also.
- Added
histogram.minValue
andhistogram.maxValue
to expand range of buckets. - Allow use of explicit ticks option on domain axis.
- PieChart :
- Fixed error with tooltips when any slices are too small to display.
- Calendar :
- Fixed problems with time zones and daylight savings time.
- GeoChart :
- Wait longer on slow connections for Geo data.
- Gantt :
- Fixed some problems with order of items.
- Material Charts
- Fixed formatting of tooltip items to use formatted values.
October 2, 2015
Available in quasi-perpetuity as Frozen Charts Version 43.- Charts now officially support Microsoft Edge.
- Corecharts:
-
focusTarget
can now be an array to specify multiple focus targets. - Intervals can now be styled using the style role .
- Fixed issue with the
visible
property for tooltip actions. - HTML tooltip positioning now more closely matches SVG tooltip positioning.
-
chartArea
option now supports'right'
and'bottom'
. - Overlapping vertical axis ticks will be dropped.
- The size of legend scrolling arrows is fixed.
- Annotations are now correctly positioned when the chart
orientation
is'vertical'
or when the axes have adirection
of-1
. - Now supports variable-width in bar, column, and stepped area charts, when you set
bars { variableWidth: true }
.
-
- Bubble Chart : Default labels now used for tooltips.
- Sankey Diagram :
- Better color handling.
- Link interactivity is now supported.
- Timeline :
- Durations are now localized.
- Now supports
minValue
andmaxValue
for the horizontal axis.
- Geo Chart :
- When a null value is specified for a custom tooltip, the default tooltip will be constructed instead.
- You can now disable interactivity for markers.
- Word Tree :
- Better color handling.
- Deprecated string color column and added support for style columns to replace it.
- Trendlines : Fixed a number of log scale and date-related bugs.
- Table Chart : The
pagingButtons
option now works in more combinations withpage
,pageSize
, andstartPage
options. - Material charts (Bar, Line, and Scatter, so far): Fixed a number of bugs with redrawing charts and multiple charts on a page.
- Annotation Chart : The date and time format for range selector is now the same as for the main chart.
April 30, 2015
Available in quasi-perpetuity as Frozen Charts Version 42.- Corecharts
- ColumnChart, BarChart, AreaChart, and SteppedAreaChart now support
isStacked: 'percent'
(for scaling to 100% of data for each category) andisStacked: 'relative'
(for scaling to the range 0..1) - For all corecharts, the default baseline for axes will no longer be at the edge of the chart. The default baseline value of 0 will be used for numeric axes, but for backward compatibility with existing charts, it won't automatically be included in the chart unless it is "close enough" to the data. You can force inclusion of the baseline just by adding
baseline: 0
to your options. For date and datetime axes, there is no default baseline, but you can specify one if you would like. - Corechart legends use line, area, and point style corresponding to each series.
- All text options for corecharts now support the
opacity
option. - The webfont loader will be used to load unknown fonts, which could cause your chart drawing to be delayed. Font names are case-insensitive.
- Startup animation now works with DataViews, and when combined with the async drawing mode.
- Fix the
clearChart
method when used before the chart was first drawn. - Added a
pointsVisible
option for top-level, series, and trendlines. This option controls whether points should be visible by default. This allows you to change thepointSize
while keeping the points hidden. - HTML tooltip position is fixed.
- The Scatter Chart now works with a discrete domain axis, and supports annotations.
- The Pie Chart now supports custom tooltips.
- Sankey
- You can now select nodes. This can be enabled by setting
sankey.node.interactivity
totrue
. - Adding the ability to specify Sankey interactivity via the chart options. Options are generally specified under the style of whatever is being specified, by adding an object with modified style attributes at one of the following keys:
'selected'
,'focused'
,'unselected'
,'unfocused'
. - Colors
- Sankey now supports the
'style'
role - Nodes can now be colored uniquely by setting the option
sankey.node.colorMode
to'unique'
- Links can now be colored. The coloring mode can be changed with the
sankey.link.colorMode
option. Valid values are:-
'unique'
: each link gets its own color. -
'source'
: each link uses the color of its source node. -
'target'
: each link uses the color of its target node. -
'gradient'
: each link is colored by a gradient that goes from the color of its source node to the color of its target node. - NOTE: If node coloring is set to the default or the palettes for nodes and links are different,
'source'
,'target'
, and'gradient'
will use the colors that would be assigned to the nodes if thecolorMode
was'unique'
and links and nodes shared a palette.
-
- The color palette for the nodes may now be changed via
sankey.node.colors
. - The color palette for the links may now be changed via
sankey.link.colors
.
- Sankey now supports the
- Default tooltips (both HTML and SVG) can now be generated by links and custom tooltips are supported via the
'tooltip'
role. - Timeline
- SVG tooltips are now supported.
- Custom tooltips are now supported.
- Colors will cycle if more are required than available.
- Calendar
- SVG tooltips are now supported.
- Custom tooltips are now supported.
- Trendlines
- The
pointsVisible
option is now supported.
- The
- Table chart
-
'width'
and'height'
options may either be unspecified, meaning the table should shrink as much as possible, or'100%'
, meaning the table should expand as much as possible. - Removed duplicate table used for frozen table header.
- Frozen columns, useful when you have more columns than will fit within available width. For example, the leftmost 2 columns may be frozen with
'frozenColumns': 2
. - Specify the number of paging buttons with the
'pagingButtons': #
option. The number of rows per page will be based on that, unless you also specify the'pageSize'
option. - The
'rtlTable'
option now works with paging or scrolling, but not (yet) withfrozenColumns
. - Renamed some css classes (eg
'content'
) to avoid conflicts. - Column headers now do not wrap by default.
-
- Material charts
(At the moment there are Material versions of the Bar, Line, and Scatter Charts.)- Better support for date, datetime, and timeofday axes.
- Fix sizing problems with multiple charts on the same page.
- May now be used with ChartWrapper.
- Annotation Chart
- Fixes for selecting annotations and color of range selector.
- Allow the Annotation Chart to specify the order of annotations table, using the
table.sortAscending
option.
- Map
- A set of coordinates is no longer ignored if the latitude/longitude values are 0.
February 23, 2015
Available in quasi-perpetuity as Frozen Charts Version 41.- Core charts
- Startup animations for most corecharts: add
startup:true
toanimation
option. - Add
clearChart()
to several charts that were missing this function. - Vertical axis ticks positioned inside the chart area can now use entire
chartArea.width
. - Handle null values more consistently, especially for JSON formatted tables.
- Add
allowAsync
option to draw asynchronously. - Allow
timeofday
values to have 1 to 7 elements. - Columns may be referenced by ID or label, in addition to index number.
- Generalize
style
role. - Tooltip support for right-to-left languages.
- Material light theme added (add theme:
material
option). - HTML tooltips
- Fix the positioning of HTML tooltips such that they're relative to the container.
- Fix
tooltip tag is undefined
bug. - Use color property of text style.
- Trendlines
- Fix for log scale.
- Allow tooltips to be disabled per trendline.
- Work with multiple vertical axes.
- Work with animation.
- Annotations : avoid covering annotation with annotation tooltip.
- Startup animations for most corecharts: add
- Material charts
- Add ability to customize series colors via the
colors
option. - Add Material line chart .
- Add Material scatter chart .
- Subtitle is now supported when using
convertOptions()
.
- Add ability to customize series colors via the
- Histogram : automatically constrain number of buckets to avoid being too small.
- Calendar chart : support zero values.
- Map Visualization
- Zoom level fix.
- Support styled maps.
- Support multiple types of custom markers.
- Candlestick chart : now works with vertical orientation.
- Table chart
- Remove prior selection when
draw()
is called. - Use
THEAD
andTH
elements for table header. - Preserve header between
draw()
calls to work with accessibility tools.
- Remove prior selection when
- AnnotationChart
- Reverse order of annotations in table.
- Preserve series colors when hiding and showing series.
- Restore width and height to default when not specified.
- Set chart view window based on the range selector position.
- Gauge chart : fix shrinking on subsequent
draw()
calls. - Dashboards : add
getSelection()
method that returns a union of all selections in the dashboard. - ChartWrapper and ControlWrapper parameters now allow a
container
element, as alternative tocontainerId
. - Performance improvements for ChartRangeFilter , and for charts that use category focus tooltips.
- Chart editor
- Hide things that are not relevant (eg the legend menu when there are no legend items).
- Hide histogram bucket item dividers (by default).
- Piechart color fixes.
- Themes support.
- Polynomial trendline support.
- Enable trendlines for date-based axes, and for area charts.
- Click editor support for min/max values.
- Bar chart support for continuous axes and trendlines.
October 6, 2014
- Word Trees
- Accessibility
- Adding table with data for screen readers.
- Fix for text with auras.
- More accessibility fixes/tweaks.
- Annotation chart
- Animation fixes when size changes
- Legend fixes
- Numerous bug fixes for ChartWrapper .
- Timeline
- Date format now available in tooltips
- Bar labels now forced inside task bar
- Miscellaneous
- Ticklines and tick fixes
- More tooltip formatting options
- Numerous internal rendering improvements
- Improvements to the data explorer
- Trendline improvments
- Improvements to axis processing
- Material Bar and Column Charts , comporting to the new Google visual style
June 25, 2014
- Core charts (line, bar, column, area, combo, pie, scatter, candlestick, bubble, histogram, stepped area):
- 0 gridlines and 1 gridline now supported.
- Faster animation of large number of discrete axis values.
- Fixed animation with null or duplicate values.
- The new
highContrast
annotations option lets you regain the ability to customize the colors of text within a bar. - Fixed error when generating a tooltip for null or NaN datum.
- Explorer mode could crash in unusual circumstances; no longer.
- Printing Charts
- Tooltips now rendered on top of series plots.
- Annotations no longer clipped.
- Fixes to opacity.
- Assorted Firefox and IE fixes.
- Handles underlined text.
- Chart drawing is clipped to the chart's area, and tooltips aren't.
- 3D pie charts draw correctly.
- Bar and Column Charts
- Added an option to make annotations always be drawn outside the bar.
- Pie charts
- Fixed 3D reversed pie charts.
- Fixed Pie Chart issue in Chrome causing nearly whole circles to render incorrectly.
- Histograms
- Multiple selection and tooltip aggregation fixed.
- Geo Charts
- Support for tooltip.trigger = 'selection'.
- Timelines
- Works with 'datetime' as well as 'date'.
- Can now handle start < 1970 and end == null.
- Now has tooltips and interactivity that work in IE10.
- Fix for crash in IE10.
- Annotation Charts
- Fixed labels when there are more than 26 annotations.
-
rangechange
,ready
, andselect
events are now supported. - Fixed support for DataView.
- Point shapes
- New
dent
option lets you customize the look of stars.
- New
- Accessibility
- Removed clutter from DOM and added descriptive ARIA tags.
March 25, 2014
- Point shapes
- Added a new top-level
pointShape
option. - Added a new
strokeDashStyle
option for brushes.
- Added a new top-level
- Animation: added fix for animation of annotations and intervals.
- Explorer mode
- Fix for date, datetime, and timeofday axes.
- Fix to avoid failure with discrete axes.
- Google Docs Chart Editor
- Made various improvements to switching tabs.
- Added ARIA labels to improve accessibility.
- Added 'auto' gridline option.
- Timeline
- Added support for styles.
- Added option to turn off tooltips.
- Added ability to select items.
- Sankey
- Added check for cycles in data.
- Made nodes thinner and links lighter.
- Calendar
- Added support for selections.
- Added support for datetimes.
- Added support for styles.
- Added minor beautifications to color and style.
- Annotation Chart
- Added fix for extremely short range date and time axes.
- Changed color of range selector line to match chart color.
- Histograms: added fix for tooltips.
- Miscellany
- Added fix for explicit ticks to improve default formatting.
- Logscale now always uses variable number of gridlines.
- Added new method of tick generation for date, datetime, and timeofday when used with a variable number of gridlines.
- Treat NaN values as null, and handle isolated values (surrounded by nulls) for Line Charts and Area Charts.
- Added new option for Table Charts:
keepScrollPosition
. - Added support for
labeled
legends in Area Charts. - Added fix for Combo Charts when bars are mixed with other types resulting in gaps.
- Added ability to customize marker icons on map charts .
January 29, 2014
- New chart: Annotation , a flash-free version of the Annotated Timeline
- New chart: Sankey .
- New chart: Calendar .
- New feature: crosshairs for scatter charts, line charts, and combo charts.
- New feature: convert charts to PNGs .
- New method:
addOneTimeListener()
, used to listen for the first occurrence of an event. - Timeline: added 'style' role support.
- Timeline: Selections now supported.
- Pie charts: fixed behavior when there's only one row of data.
- Improved date behavior for variable numbers of gridlines.
- Animations: maxFramesPerSecond is now configurable.
- A set of
boxStyle
options for annotations. - String to number conversion in datatables: they'll now be automatically converted when the column type is numeric.
- Column chart: tooltips now show null values.
- Histogram speed improvement: they now render like column charts for large datasets.
- Histogram: fix for tooltips with categories.
- Explorer: fix for non-numeric data.
- Calls to google.load now serialized.
- Fixed IE7, IE8 error when using annotations and stacked columns.
November 26, 2013
- Now possible to show persistent values next to bars, columns, points, etc.
- Markers now drawn with correct size when min value > max data value.
- Drag to pan/zoom implemented
- Fixed date formats for Japan
- Fixed: Follower scale overlaps world map
- When doing a mouse drag, and the mouse cursor end up over the chart, don't do any hover effect
- Fixed: When setting the viewWindow to do panning, the gridlines don't provide meaningful indication to target-axis scale changes.
- Fixed: [Firefox] Description pop up is not coming up when user hovers mouse over the graph bars under posts tab
- Fixed: getSelection returns selection objects with undefined column properties
- Fixed: join() & group() functions no longer empty column ids
- Fixed: Afghanistan marker appears in Pakistan in Mac Safari
- Fixed memory Leaks in various charts
- GeoChart now supports all the tooltip features that corecharts support
- CoreCharts click on value now selects or deselects correct data value when reverseCategories is true
- DefaultColor is now an option
- Fixed: Animations that change the axis type from/to a date axis will error out
- Fix leaking listeners issue with native event targets
- Data opacity for points now supported
- Fixed: ColumnChart, BarChart, and CandlestickChart with continuous domain axis splits bars in half on low and high ends of axis
- vAxis:{logScale:true} no longer errors when there are NaNs in the data
- Fixed: When vAxis.logScale is true, vAxis.maxValue seems to act like vAxis.gridlines.count
- Fixed: minValue and maxValue set to 0 are ignored, with variable number of gridlines (when gridlines.count == -1)
- Allow viewWindow.max and viewWindow.min to work with ticks
- Fixed axis date formatting
- "Move & Resize" option now responds appropriately
- Horizontal axis with slantedText now offsets text to keep it centered under tick value
- Changing baseline with min max view window does not behave properly for some of the charts
- Added support for createTextOnLineByAngle
- Timeline chart now shows daily data
- Geochart markers size does not change when Min axis value is set
- Fixed missing tooltip title when there is no bar label
- Added some events (but not the full set) to Timeline
- Added enableInteractivity for Timeline
- Formatted explicit tick values no longer ignored in compiled mode
- Single row of data no longer causes errors with bar-like charts
- arrayToDataTable now allows first row headers to specify objects
- Support dataTableFromCsv
- Candlestick chart no longer fails when the number of rows exceeds the available width to display all the candlesticks
- Axis charts with zero rows of data and variable number of gridlines no longer cause infinite loop
- Timelines no longer error out on reasonable data
- Math.floor(x) === x no longer has nondeterministic result
- Trendline now works for Spark chart
- Fixed error display for Bar chart
- Made an option for Z order for Series
- Fixed SansSerif font bug
- Fixed exceptions caused by current corechart code
- Image-after-next now animates smoothly, instead of appearing abruptly at the end of swipe animation
- Left Vertical axis options now shown for the Inline charts
- Chart options no longer disturbed in "change chart" drop down for inline chart
- Array of strings/numbers passed to arrayToDataTable no longer turned into array of objects
- Fixed obscure memory leak in Line Chart
- Legend options no longer missing in the histogram "customize" tab.
- Histogram, Tree chart previews now show properly.
- Histogram no longer shows error on a "compare mode" selection
- Fixed: Dual axis mode is supported for Histogram chart even though there are no axis options in the Sheets chart editor.
- Axis tab options now shown for Histogram
- Fixed animation for diff charts
- Enabled "plot null values" option for histogram
- ChartRangeFilter error fixed
- Tooltips now take length of "null" into account
August 27, 2013
- Timeline Charts A timeline is a chart that depicts how a set of resources are used over time. If you're managing a software project and want to illustrate who is doing what and when, or if you're organizing a conference and need to schedule meeting rooms, a timeline is often a reasonable visualization choice. One popular type of timeline is the Gantt chart:
https://developers.google.com/chart/interactive/docs/gallery/timeline - Donut Charts
We now let you create a donut chart by removing a hole from the center of a pie chart:
https://developers.google.com/chart/interactive/docs/gallery/piechart#donut - Map Data Refresh for GeoChart
As Google improves its geographic data through projects like Ground Truth , we periodically regenerate our static map data to integrate these improvements.
- Explicit Ticks
We now provide "explicit ticks", which enable you to fine-tune where ticks appear and how they're labeled. See the
hAxis.ticks
andvAxis.ticks
options at, for example, https://developers.google.com/chart/interactive/docs/gallery/linechart#Configuration_Options . - Bounding Boxes
We've documented
getBoundingBox()
and several related methods that let you extract information about where chart elements are drawn on the screen. See the chart gallery documentation pages for details. - Geocoding Improvements
We've made a number of improvements to our geocoding library to better cache requests across multiple GeoCharts on the same page.
- Miscellaneous Improvements
- DateFormatting improvements for certain locales
- JSON serialization fixes
- Trendline line width fixes
- Fix for logScale on vAxis when NaNs occur in the data
May 15, 2013
- Trendlines - Support for Linear and Exponential trendlines in most core charts.
- Actions - Now you can add more interactivity to your tooltips. This is an open-ended feature which allows you to add JavaScript callbacks to a menu in tooltips.
- Automatic Gridline Selection - use our algorithm to automatically select the number of gridlines. You can use this by setting the
gridlines.count
option to-1
. This works for bothhAxis
orvAxis
. - Improvements in ChartWrapper performance.
September 24, 2012
- HTML Tooltip - Support for custom HTML tooltip content for data points, categories and annotations (certain core charts only)
- Look Mom, No IFrame! - With the exception of IE 8, charts are no longer drawn inside an IFrame by default. If you're feelin' retro you can bring it back by setting the option
forceIFrame: true
- Removed the
strictFirstColumnType
option. As you recall this was a temporary remedy for backward compatibility. Please refer to this help section for proper solutions - GeoChart : New option, tooltip.trigger, which works the same way as in the core charts
- GeoChart : Improved border colors
- ChartRangeFilter : You can now leave the control area while panning/zooming
- ChartRangeFilter : Fixed occasional crash when moving one handles over another
- Significant performance improvements when drawing charts with a domain axis of type date
June 18, 2012
- CandlestickChart: Allow more control over the candlesticks colors (see the
candlestick
option group) - ComboChart: Support candlesticks and steppedArea series (see the
series
/seriesType
options) - ColumnChart/BarChart/CandlestickChart: Support continuous domain axis (see the relevant data format sections)
- All corechart charts: Support legend alignment (see the
legend.alignment
option) - All corechart axis charts: Support minor gridlines (see the
minorGridlines
option)
May 2, 2012
- Added a configuration option to control the width of bars in a ColumnChart/BarChart and candlesticks in CandlestickChart
- Fixed crash when calling clearChart() twice in a row for charts in the corechart package
- Fixed malfunctioning interactivity when calling draw() after clearChart() for charts in the corechart package
- GeoChart: New province maps for Estonia, Finland, Lithuania, Latvia, Somalia and South Sudan
- Gauge: Fixed crash when calling draw() twice in Firefox.
April 2, 2012
- Annotations:
- Simple visual effect for selection of annotations (make text bold).
- Better handling of annotation bundles (ie, multiple annotations on the same data point / domain value).
- Allow interaction with annotations in 'category' focus target.
- TreeMap chart:
- Added an option to use weighted averages in the treemap.
February 22, 2012
- Added gradient color mode to bubble chart.
- Geo chart :
- Region interactivity in marker mode is now disabled by default. How to keep the old behavior? Set the
enableRegionInteractivity
option to true. - Markers are now opaque by default. How to keep the old behavior? Set the
markerOpacity
option to 0.5. - Marker size is now between 3 and 12 pixels by default. How to keep the old behavior? Set the
sizeAxis
option to {minSize: 2, maxSize: 30}. - A magnifying glass is now opened when the user hovers over cluttered markers (excluding IE<=8). How to keep the old behavior? Set the
magnifyingGlass
option to {enable: false}. - We don't stretch the maps by default anymore, but rather keep the original aspect ratio. How to keep the old behavior? Set the
keepAspectRatio
option to false.
- Region interactivity in marker mode is now disabled by default. How to keep the old behavior? Set the
- A new control - ChartRangeFilter .
- A new experimental option
forceIFrame
whose default is true (the current behavior), but can be set to false. When set to false, corechart charts, geo chart, treemap and gauge will not render the chart in a iframe (for all browsers excluding IE<=8). This is still very experimental, and undocumented. We would like you to try it out and give us your input!
January 18, 2012
- Changed the default of
strictFirstColumnType
to true. If this causes issues with your charts please refer to the help section. - Added a new chart - bubble chart .
- A new chart editor design with a revamped customize panel.
- Added clearChart method to all visualizations in the main gallery.
- Table: Fixed memory leak.
- CandlestickChart: Performance improvement in all browsers.
- GeoChart: Performance improvement in IE 8.
- SteppedAreaChart: Support combination of connectSteps and isStacked options.
December 7, 2011
- Transition animation .
- New visual effects for focus and selection of chart elements in scatter, line, area, and other charts.
- New column role feature , enabling annotations, error bars, custom tool tips, out-of-scope indication, certainty level and emphasis in the core chart types.
- Marker mode in Geochart .
- New chart: Stepped Area .
- New UI for ChartEditor
- Geo chart: new maps for US states, improved visualization of disputed areas.
- New option for maximizing chart size:
{theme: 'maximized'}
.
October 30, 2011
- Bug fixes and infrastructure work.
September 26, 2011
- Improving rendering efficiency in corechart and GeoChart.
- Localization support.
- CoreChart: Visual effect for selection of points in LineChart/AreaChart/ScatterChart.
- GeoChart/Treemap: Fix color scale in IE8.
August 17, 2011
- Improving rendering efficiency in the GeoChart.
- Supporting iOS and IE8 in the Gauge visualization.
- CoreChart: improving the visual effect of focus on mouse over.
July 13, 2011
Many new properties, including:
-
viewWindow
, to specify vertical data zooming/cropping -
pieChartTooltip
- to specify what information should be in the tooltip -
series
properties:visibleInLegend
,enableInteractivity
,areaOpacity
- Many new override properties on the
vAxis
/hAxis
objects.
- Dual Y axes now supported, using the
series.targetAxisIndex
andvAxes
/hAxes
properties - GeoChart performance improved
May 9, 2011
- GeoChart - New GeoChart (replacing the current Flash GeoMap)
- Candlestick - New CandlestickChart
- ComboChart - Enables combinations of bars, lines, and area charts on the same axis.
- Enable customization of independent series in the corechart package (eg explore the series option in the ComboChart )
- ChartWrapper - New ChartWrapper class for encapsulating chart creation and serialization.
- ChartEditor - New ChartEditor that can be embedded in your own site.
- Changes to the TreeMap look-and-feel.
- New controls package and ControlWrapper.
- Fusion Tables are now a Google Visualization compliant data source.
- Moved image charts to use https.
March 21, 2011
- Treemap - New rollup event
- ImageCandlestick - Added padding for the first and last candles
- Gauge - Changed default colors, and allowed users to change them. Fixed some memory leaks
- Bar, line, area, column, and scatter charts - Updated the gridline appearance.
February 24, 2011
- New image candlestick chart .
January 17, 2011
- Bar, column, line, and scatter charts: added
gridlineColor
option. - Various charts: Added two new options for formatting tick mark text:
-
hAxis.format
(bar, scatter charts) -
vAxis.format
(line, area, column, scatter charts)
-
- Line chart:
- Added
interpolateNulls
option. - Points are now invisible by default unless hovered over.
- Added
- Pie chart:
- A slice is now emphasized when hovering over a slice or slice legend.
- Selecting pie slices now replaces the previous selection rather than adding to it.
- Added pieResidueSliceColor option to change the color of the composite slice.
- Treemap:
- Fixed a bug that prevented a three-column data model from rendering
- Fixed sorting
- Area, bar, column, line, pie, scatter, treemap, and gauge charts now use SVG on IE9, rather than VML.
- New function,
google.visualiation.arrayToDataTable()
.
November 7, 2010
- Added following properties to area, bar, column, line, and scatter charts:
- chartArea, to specify the size and positioning of the chart area within the chart boundaries.
- titlePosition and axisTitlesPosition, to specify positioning of the chart and axes titles.
- backgroundColor, to specify the color of the chart area background and border.
- vAxis/hAxis.textPosition, to specify the position of the labels for the tick marks on the vertical and horizontal axes.
- Added following features to pie chart:
- chartArea, to specify the size and positioning of the chart area within the chart boundaries.
- backgroundColor, to specify the color of the chart area background and border.
- pieResidueSliceLabel, to specify the label for the slice that represents the accumulated values of all slices below a specified threshold value.
August 11, 2010
- Updated core charts package :
- Enabled top and bottom positioning of the legend.
- Improved label layout when charts are textually overloaded (automatically switching to alternating labels and slanted text when necessary).
- Improved Pie Chart by exposing an option for 3D and for formatting the texts on the slices and the tooltips.
- Improved handling of error notifications across all charts.
- Fixed several bugs, including addressing the memory leak that occurred when redrawing charts.
- Fixed bug in Geomap where two letter codes where wrongly assumed to be region codes.
June 16, 2010
- Added onmouseover/onmouseout events to treemap
- Generic image charts, type radar:
- Both r and rs chart types now supported
- showValueLabels is now true by default
- Area, bar, column, line, pie, and scatter charts:
- Fixed some layout and ordering bugs.
- Improved error handling of bad data values.
- Additional small bug fixes.
- Geomap - Now supports internationalized tool tip strings.
May 18, 2010
- New Core Charts (see below) - Several common chart types have been redesigned, and combined into a single package called
corechart
. We will no longer fix bugs or add new features in the older versions but rather encourage users to migrate to the new charts. - Image charts now support interactivity
- New tree map visualization
- Multi-select now supported on the Mac for the Table visualization.
- Map now provides the Terrain type.
More About Core Charts
We have created new versions of several common chart types, including area, bar, column, line, pie, and scatter charts. The new versions are in a common package called corechart. The older versions will continue to exist, in their previous packages, but we encourage you to start using these new versions.
How to migrate to the new charts :
- Change your package name
Load the newcorechart
package rather than the older packages. This new package includes the code for the new versions of the area, bar, column, line, pie, and scatter visualizations, which were previously loaded by separate packages.google.charts.load("current", {packages:["corechart"]});
- Adjust your chart options
Although many of the options have remained the same, some have been renamed or are not yet supported.
Renamed Options:- reverseAxis - Now called
reverseCategories
. - lineSize - Now called
lineWidth
. - smoothLine - Now called
curveType
and instead of the value true, the user should specify the value 'function'. - titleX/titleY - These options are now called
title
and are part of the newhAxis
orvAxis
objects. - logScale/logScaleX - These options are now called
logScale
and are part of the newhAxis
orvAxis
objects. - min/max - These options are now called
minValue
/maxValue
and are part of the newhAxis
orvAxis
objects.
Unsupported Options:- Legend positions - We currently support only the right legend position (or not displaying a legend).
- 3D - Pie charts do not support a 3D version at the moment.
- Tooltip - In the current version, tooltips open automatically on mouse hover; you cannot open or close them using the API.
- reverseAxis - Now called
April 22, 2010
Mostly internal changes.
February 5, 2010
- Map and Geomap now dynamically load maps API V3 . If you currently load the maps API V2 script, you should remove it.
Note: You can not use the maps API V2 together with gviz Map/Geomap charts. - Map chart
- Returns proper ready event .
- Tooltip column may be of any type (and not only string as before).
- Image chart - Now provides two new options backgroundColor and valueLabelsInterval.
- Table chart - Paging buttons now properly respect user height.
November 10, 2009
- Annotated Timeline - Chart zero values now displays accurately.
- Area , Bar , Column , Line , Pie , and Scatter Charts - Internet Explorer 8 events and tooltips now handled properly.
- Table chart - Custom "Next" button text now displayed properly.
- Motion chart - Now supports animated line charts. New locales supported: "ru", "tr", "cs", and "hu".
- Geomap - Now supports metro area codes.
- Image Pie Chart - Now supports options to set the legend and labels.
September 29, 2009
- DataTable - New
toJSON()
method that returns JSON string that can be used inDataTable
constructor. - Wire protocol - JSON response format now supports true JSON-valid date strings.
- imagechart - New method
getImageUrl()
returns image URL used by Charts API. - Annotated Timeline :
- Bug fix - Legends now support commas properly
- You can now specify a null starting or ending date in
setVisibleChartRange()
to start from the beginning or ending range.
- Area Chart , Bar Chart , Column Chart - Bug fix: legends now displayed in same order as series in stacked versions of these charts
- Scatter chart - Bug fix: null values caused row index count to be off for succeeding rows in the data table.
- Area , Bar , Column , Line , Pie , Scatter charts:
- Calling
setSelection()
with both no parameters, null, or an empty array will deselect all selected items. - Added new options: tooltipWidth , tooltipHeight , tooltipFontSize to enable setting tooltip font size, width, and height respectively.
- New options to change the axis (axes) to a logarithmic scale: logScale , logScale X
- Calling
- Bar formatter - Now shows formatted value if present, rather than actual data value.
- Grouping and joining now enabled on
DataTable
. Details with the production release. - Calculated columns now enabled on
DataView
. Details with the production release. -
DataView
- Added newgetProperties()
method. - Pie Chart - Fixed a bug with drawing some small slices in Internet Explorer.
- Org Chart - Improved the look of the org chart.
July 20, 2009
- Arrow Formatter - Small bug fix: Add missing cell border when Arrow Formatter is used
- Motion chart - Add statechange event
- DataTable - Bug fix: getDistinctValues() on an empty data table (used to throw an exception)
- Annotated timeline chart
- New appearance to the annotation list
- Fix double escaping in labels (for example when Euro symbol was in number format)
- Bug fix: Small changes in the range now fire range change event
- Changing the zoom with arrows now fires range change event
- Fill color is the same as line color
- Allow annotation columns even when displayAnnotations option is set to false (but columns are ignored)
- Bug fix: Wrong timezones when selecting the visible range
- Do not change mouse to hand when clicking a maximized chart
- New option (now default) to highlight the nearest dot, not the last
- New option to hide the bar date separator at the top right hand corner
- New option to hide the dots at the top legend
- New option to hide the values at the top legend
- Image chart
- Bug fix: some parameters were being dropped
- Support for hidden columns
- Org chart - Bug fix: Handle 'style' and 'selectedStyle' correctly.
- Interactive Charts (all) - Fix a bug with selection, when there are null values in the middle of a series
- ToolBar - Added an option "style" in the toolbar visualization, in the htmlcode component
- Pattern format - Added an option to output the result into a custom property of cells in a given column
- Table visualization - Changed paging symbols to use an image by default instead of unicode characters, and added a parameter to specify prev/next paging keyboard shortcuts for accessibility.
May 26, 2009
- A complete data source implementation , including full support of the Visualization Query Language in an open-source Java library.
- A new version (0.6) of the Google Visualization API wire protocol with the following features:
- Additional query options with enhanced security.
- Custom properties now supported in DataTables at the cell, row, column, and table level.
- New output features:
- Support for new output format ( tab-separated values ).
- Ability to request a custom output file name for CSV or TSV files (see the
outFileName
parameter).
- A new version (0.7) of the Google Visualization API query language with the following features:
- Support for calculated columns.
- Support for scalar functions.
- A new Generic Image Chart visualization that wraps the functionality of the Google Chart API:
- Exposes all the charts provided by the Chart API
- Not restricted by the 2K data limit when using the Chart API directly using URLs.
- Improved google.visualization.ColorFormat now supports all data types except boolean.
- Legends have been temporarily disabled in image pie chart , image scatter chart, and image line chart. (Image scatter and image line charts are created using the Generic Image Chart , by setting option 'cht' to 's' (scatter chart) or 'lxy' (line chart)).
- Organizational Chart
- Added mouseover and mouseout events
- Added support for custom style properties
- Geomap - Google Maps
<script>
include no longer needed if you use the lat/long format with markers. - New options added to google.visualization.Query to support different data sending methods.
- Area , Bar , Column , Line , Pie , and Scatter Charts support new options: titleFontSize, legendFontSize and AxisFontSize .
- Fixed an image pie chart bug. Previously, i f you passed multiple colors to your options object it create a gradient based only on the first color, ignoring all additional colors. N ow it uses all colors as documented.
- Fixed an annotated timeline labeling bug. Previously, labels were truncated to any % markers in the legend; this has been fixed to allow % characters.
April 6, 2009
- New toolbar helper element that enables you to export your data in a variety of formats, or embed the visualization in another page.
- Interactive charts ( area , bar , column , line , pie , and scatter charts)
- Added
onmouseover
andonmouseout
events. - Added a
showCategories
option to hide the category labels. (Does not apply to pie chart). - Fixed an axis scale bug: If the min value was just above zero and the max value was large, the chart legend was expanded to below zero.
- Added
- Table visualization
- Table customization
- Enable the user to supply css class names for:
headerRow, tableRow, oddTableRow, selectedTableRow, hoverTableRow, headerCell, tableCell, rowNumberCell.
- Enable the user to supply css class names for:
- Fixed a bug in cell property 'className'.
- Added
ready
event. - Basic right-to-left language support for table.
-
sort
event, and a methodgetSortInfo
, returns an array of indexes which is a mapping of the current sort.
- Table customization
- Map
- Added
zoomLevel
option.
- Added
- Motion chart
- Added
ready
event. - Fixed a bug to enable
getState
method.
- Added
- Org chart
- Added column for tooltips, implemented as a third optional column. If set, the value in the third column is the tool-tip that will be displayed when hovering over the node.
- Formatters
- Added a whitespace margin around the bar formatter.
- Added an option to display a black line at the zero value of the bar formatter.
- Annotated Time Line chart
- New option to hide the range selector area.
- Added number formatters to columns
- Added date formatter to the date at the top right of the chart.
- DataView
- Improved performance of a DataView when used only for manipulating columns, and not rows.
- Fixed a bug: When using a DataView only for manipulating columns, and adding rows to the table only after creating the view, these rows were not accessible through the view.
- DataTable
- Filter columns by value range. Each of the filters passed to
getFilteredRows
can be a range filter containing properties ofminValue
andmaxValue
- Filter columns by value range. Each of the filters passed to
February 23, 2009
New Features
Here is a summary of the most interesting new features of the API.
- Significant additions to the motion chart , including zoom, bars, and an option to save and restore the state.
- Added new options to the Interactive Pie Chart :
pieJoinAngle
andpieMinimalAngle
, to control the behavior of the 'other' slice. - Added control over the
min
andmax
y values of the axis based Interactive Charts (Line Chart, Bar Chart, Area Chart,etc.). - Added 'ready' event support for all Interactive Charts.
- Added collapse option for the Org Chart (
allowCollapse
). - Added new Date Formatter .
- Made formatters available for all visualizations (not only Table).
- Added methods to programatically hide and display specific data series on Annotated Time Line Chart.
Fixed Bugs
No major bug fixes.
Known Bugs
- The dates in the top right corner of the annotated time line chart are corrupted in some locales (es, po).
- After clicking on a legend of a line in line chart , the line width is set back to the default value, even if another value was specified.
- Default bubble size in motion chart is different.
- In the Bar Chart, the font can get too large. We should limit the maximum font size.
January 20, 2009
New Features
Here is a summary of the most interesting new features of the API. For the complete list, see Full Details below.
- New generic
ready
event which is fired when a particular visualization is ready for methods to be called. - New options for the annotated time line chart :
-
fill
configuration option to control the trasparency of the area below the lines. -
thickness
configuration option to control the thickness of the lines. -
max
configuration option to control the max value displayed in the Y-axis. - If
date
type time is used, limit the x-axis resolution to days. -
ready
event is fired when the chart is ready for methods to be called. -
select
event is fired when flags are clicked by the user.
-
- New
ready
event implemented for Organizational Chart and Intensity Map . The event is fired when the charts are ready for methods to be called. - Added functions to set and get row properties on
DataTable
andDataView
. - Added functions to set and get table properties on
DataTable
andDataView
.
Fixed Bugs
- The gauge visualization's setInterval() method was fixed and is now working well also with Internet Explorer.
- The annotated time line chart failed to zoom-in to less than one day. This issue was fixed.
- The bar chart labels were drawn in a reverse order.
- Unselection of cells in interactive charts now close the tooltips.
- Refresh was not working in some of the gadgets of interactive visualizations.
Known Bugs
- The dates in the top right corner of the annotated time line chart are corrupted in some locales (es, po).
- After clicking on a legend of a line in line chart , the line width is set back to the default value, even if another value was specified.
Full Details
In addition to the new features, we introduced the following changes in this release:
- Improved latency issues in motion chart (especially on IE).
- Table
- No paging buttons when there is only one page.
- Make sortable headers fixed width.
- Small improvements in the look and feel.
December 9, 2008
New Features
Here is a summary of the most interesting new features of the API. For the complete list, see Full Details below.
- Google Web Toolkit now has a library for creating and manipulating visualizations.
- New options for the table visualization.
- Motion charts now support multiple charts, more locales, and speed slider.
- Annotated timeline now supports 10 locales.
- New geomap visualization.
Fixed Bugs
- Spreadsheet authentication errors have been fixed, and error messages clarified.
Known Bugs
- The gauge visualization's setInterval() method does not work with Internet Explorer.
Full Details
In addition to the new features, we introduced the following changes in this release:
- New Google Web Toolkit (GWT) library with support for the following:
- Using Google visualizations from GWT code,
- Wrapping your own visualization in a GWT wrapper, and
- Writing visualizations using GWT.
- Table
- New properties: firstRowNumber, startPage, width, height, alternatingRowStyle, scrollLeftStartPosition.
- Motion chart
- Now more than one table visualization can be hosted on a page.
- 20 locales now supported.
- Annotated timeline:
- 20 locales now supported.
November 3, 2008
New Features
Here is a summary of the most interesting new features of the API. For the complete list, see Full Details below.
- Released the format of version 0.5 of the GViz data source protocol . Now you can expose your own data source to visualizations!
- Big reorganization of the documentation. We hope you like it.
- Release of an open source Python library that helps data source providers wrap data in an appropriate object to respond to data requests.
Known Bugs
- The gauge visualization's setInterval() method does not work with Internet Explorer.
Full Details
In addition to the new features, we introduced the following changes in this release:
- New get/setSelection() events added to Google's area, bar, column, line, pie, and table charts.