Visualization: Area Chart (Image)

Important: The Image Charts portion of Google Chart Tools has been officially deprecated as of April 20, 2012. It will continue to work as per our deprecation policy.

Overview
Example
Loading
Data Format
Configuration Options
Methods
Events
Data Policy

Overview

An area chart that is rendered as an image using the Google Charts API.

Example

<html>
  <head>
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      google.charts.load("current", {packages:["imageareachart"]});
      google.charts.setOnLoadCallback(drawChart);

      function drawChart() {

        var data = google.visualization.arrayToDataTable([
          ['Year', 'Sales', 'Expenses'],
          ['2004',  1000,      400],
          ['2005',  1170,      460],
          ['2006',  660,       1120],
          ['2007',  1030,      540]
        ]);

        var chart = new google.visualization.ImageAreaChart(document.getElementById('chart_div'));

        chart.draw(data, {width: 400, height: 240, min: 300, max: 1400, title: 'Yearly Expenses and Sales'});
      }
    </script>
  </head>
  <body>
    <div id="chart_div" style="width: 400px; height: 240px;"></div>
  </body>
</html>

Loading

The google.charts.load package name is "imageareachart"

  google.charts.load('current', {packages: ['imageareachart']});

The visualization's class name is google.visualization.ImageAreaChart

  var visualization = new google.visualization.ImageAreaChart(container);

Data Format

Each column represents a line in the chart; each entry is the Y axis value at the same X axis point, and the visualization connects them with a straight line, then fills in the area below the line.

Data is processed by column, starting at column zero and increasing. You shoud write the highest lines first, then the lower lines, because if you painted a lower line first, a higher line would paint over and hide any lower lines. Therefore try to make column 1 have higher points than column 2, column 2 higher than column 3, and so on. If you have one or two points higher on a right column than a left column, it might partially obscure the lower line, but it should still be visible.

All data must be numeric type except for the first, which can be either numeric or string. If the first column is a string type, the first column entries will be displayed as labels on the X; if the first column is a number, no X axis labels will be shown. All columns (except the first) must be numbers. There is no limit to the number of columns.

Configuration Options

Name	Type	Default	Description
backgroundColor	string	'#FFFFFF' (white)	The background color for the chart in the Chart API color format.
colors	Array<string>	Auto	Use this to assign specific colors to each data series. Colors are specified in the Chart API color format. Color i is used for data column i, wrapping around to the beginning if there are more data columns than colors. If variations of a single color is acceptable for all series, use the `color` option instead.
enableEvents	boolean	false	Causes charts to throw user-triggered events such as click or mouse over. Supported only for specific chart types. See Events below.
height	number	Container's height	Height of the chart in pixels.
legend	string	'right'	Position and type of legend. Can be one of the following: 'right' - To the right of the chart. 'left' - To the left of the chart. 'top' - Above the chart. 'bottom' - Below the chart. 'none' - No legend is displayed.
max	number	automatic	The maximal value to show in the Y axis.
min	number	automatic	The minimal value to show in the Y axis.
showCategoryLabels	boolean	true	If set to false, removes the labels of the categories (the X axis labels).
showValueLabels	boolean	true	If set to false, removes the labels of the values (the Y axis labels).
title	string	no title	Text to display above the chart.
valueLabelsInterval	number	Auto	The interval at which to show value axis labels. For example, if `min` is 0, `max` is 100, and `valueLabelsInterval` is 20, the chart will show axis labels at (0, 20, 40, 60, 80 100).
width	number	Container's width	Width of the chart in pixels.

Methods

Method	Return Type	Description
`draw(data, options)`	none	Draws the chart.

Events

You can register to hear the events described on the Generic Image Chart page.

Data Policy

Please refer to the Chart API logging policy.