Class PieChartBuilder

円グラフビルダー

円グラフのビルダー。詳細については、Google グラフのドキュメントをご覧ください。

円グラフを作成する方法の例を次に示します。データは Google スプレッドシートからインポートされます。

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AB8' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1';

const chartBuilder = Charts.newPieChart()
                         .setTitle('World Population by Continent')
                         .setDimensions(600, 500)
                         .set3D()
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

メソッド

メソッド戻り値の型概要
build()Chartグラフを作成します。
reverseCategories()PieChartBuilderドメイン軸での系列の描画を反転します。
set3D()PieChartBuilderグラフを 3 次元に設定します。
setBackgroundColor(cssValue)PieChartBuilderグラフの背景色を設定します。
setColors(cssValues)PieChartBuilderグラフの線の色を設定します。
setDataSourceUrl(url)PieChartBuilderGoogle スプレッドシートなどの外部ソースからデータを取得するために使用されるデータソースの URL を設定します。
setDataTable(tableBuilder)PieChartBuilderDataTableBuilder を使用して、グラフに使用するデータテーブルを設定します。
setDataTable(table)PieChartBuilderグラフの線と X 軸ラベルを含むデータ表を設定します。
setDataViewDefinition(dataViewDefinition)PieChartBuilderグラフに使用するデータビュー定義を設定します。
setDimensions(width, height)PieChartBuilderグラフのディメンションを設定します。
setLegendPosition(position)PieChartBuilderグラフに対する凡例の位置を設定します。
setLegendTextStyle(textStyle)PieChartBuilderグラフの凡例のテキスト スタイルを設定します。
setOption(option, value)PieChartBuilderこのグラフの詳細オプションを設定します。
setTitle(chartTitle)PieChartBuilderグラフのタイトルを設定します。
setTitleTextStyle(textStyle)PieChartBuilderグラフのタイトルのテキスト スタイルを設定します。

詳細なドキュメント

build()

グラフを作成します。

戻る

Chart - ドキュメントや UI 要素に埋め込んだり、静的画像として使用したりできるグラフ オブジェクト。

reverseCategories()

ドメイン軸での系列の描画を反転します。縦方向の範囲グラフ（折れ線グラフ、面グラフ、棒グラフなど）の場合、水平軸は右から左に描画されます。横方向の範囲のグラフ（棒グラフなど）の場合、垂直軸は上から下に描画されます。円グラフの場合、スライスは反時計回りに描画されます。

// Creates a pie chart builder and sets drawing of the slices in a
// counter-clockwise manner.
const builder = Charts.newPieChart();
builder.reverseCategories();

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

set3D()

グラフを 3 次元に設定します。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setBackgroundColor(cssValue)

グラフの背景色を設定します。 

// Creates a line chart builder and sets the background color to gray
const builder = Charts.newLineChart();
builder.setBackgroundColor('gray');

パラメータ

名前型説明
cssValueString色の CSS 値（"blue" や "#00f" など）。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setColors(cssValues)

グラフの線の色を設定します。

// Creates a line chart builder and sets the first two lines to be drawn in
// green and red, respectively.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

パラメータ

名前型説明
cssValuesString[]色の CSS 値の配列（["red", "#acf"] など）。配列の n 番目の要素は、グラフの n 番目の線の色を表します。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setDataSourceUrl(url)

Google スプレッドシートなどの外部ソースからデータを取得するために使用されるデータソースの URL を設定します。データソースの URL と DataTable が指定されている場合、データソースの URL は無視されます。

データソースへのクエリについて詳しくは、Google グラフのドキュメントをご覧ください。

パラメータ

名前型説明
urlStringクエリ パラメータを含むデータソースの URL。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setDataTable(tableBuilder)

DataTableBuilder を使用して、グラフに使用するデータテーブルを設定します。これは、build() を呼び出さずにデータテーブルを設定するための便利なメソッドです。

パラメータ

名前型説明
tableBuilderDataTableBuilderデータテーブル ビルダー。この呼び出しの一部として新しいデータ表が即座に作成されるため、ビルダーの更新はグラフに反映されません。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setDataTable(table)

グラフの線と X 軸ラベルを含むデータ表を設定します。最初の列は文字列で、横軸のラベルを含める必要があります。その後に任意の数の列を追加できます。すべての列は数値にする必要があります。各列が個別の行として表示されます。

パラメータ

名前型説明
tableDataTableSourceグラフに使用するデータ表。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setDataViewDefinition(dataViewDefinition)

グラフに使用するデータビュー定義を設定します。

パラメータ

名前型説明
dataViewDefinitionDataViewDefinitionグラフの描画に使用するデータソースから派生させるビューを定義するデータビュー定義オブジェクト。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setDimensions(width, height)

グラフのディメンションを設定します。

パラメータ

名前型説明
widthIntegerグラフの幅（ピクセル単位）。
heightIntegerグラフの高さ（ピクセル単位）。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setLegendPosition(position)

グラフに対する凡例の位置を設定します。デフォルトでは、凡例はありません。

// Creates a line chart builder and sets the legend position to right.
const builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

パラメータ

名前型説明
positionPosition凡例の位置。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setLegendTextStyle(textStyle)

グラフの凡例のテキスト スタイルを設定します。 

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

パラメータ

名前型説明
textStyleTextStyleグラフの凡例に使用するテキスト スタイル。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setOption(option, value)

このグラフの詳細オプションを設定します。このグラフで使用可能なオプションをご覧ください。指定されたオプションが無効な場合、このメソッドは効果を生じさせません。

// Build a pie chart with a pretty legend.
const builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
const chart = builder.build();

パラメータ

名前型説明
optionString設定するオプション。
valueObject設定する値。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setTitle(chartTitle)

グラフのタイトルを設定します。タイトルはグラフの上に中央に表示されます。 

// Creates a line chart builder and title to 'My Line Chart'.
const builder = Charts.newLineChart();
builder.setTitle('My Line Chart');

パラメータ

名前型説明
chartTitleStringグラフのタイトル。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。

setTitleTextStyle(textStyle)

グラフのタイトルのテキスト スタイルを設定します。 

// Creates a line chart builder and sets it up for a  blue, 26-point title.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

パラメータ

名前型説明
textStyleTextStyleグラフのタイトルに使用するテキスト スタイル。TextStyleBuilder オブジェクトを作成するには、Charts.newTextStyle() を呼び出します。

戻る

PieChartBuilder - このビルダーはチェーンに役立ちます。