このページは Cloud Translation API によって翻訳されました。

Class PieChartBuilder

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

以下の例では、円グラフを作成する方法を紹介しています。データが Google スプレッドシートからインポートされます。

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

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

  var chart = chartBuilder.build();

Methods

メソッド	戻り値の型	概要
`build()`	`Chart`	グラフを作成します。
`reverseCategories()`	`PieChartBuilder`	領域軸で系列の描画を逆にします。
`set3D()`	`PieChartBuilder`	グラフを 3 次元に設定します。
`setBackgroundColor(cssValue)`	`PieChartBuilder`	グラフの背景色を設定します。
`setColors(cssValues)`	`PieChartBuilder`	グラフ内の線の色を設定します。
`setDataSourceUrl(url)`	`PieChartBuilder`	Google スプレッドシートなどの外部ソースからデータを取り込むために使用されるデータソースの URL を設定します。
`setDataTable(tableBuilder)`	`PieChartBuilder`	DataTableBuilder を使用して、グラフに使用するデータテーブルを設定します。
`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 - Chart オブジェクト。ドキュメントや UI 要素への埋め込み、静止画像としての使用が可能です。

`reverseCategories()`

領域軸で系列の描画を逆にします。縦範囲のグラフ（折れ線グラフ、面グラフ、縦棒グラフなど）では、横軸は右から左に描画されます。横範囲のグラフ（棒グラフなど）の場合、縦軸は上から下に向かって描画されます。円グラフの場合、スライスは反時計回りに描画されます。

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

リターン

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

`set3D()`

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

リターン

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

`setBackgroundColor(cssValue)`

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

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

パラメータ

名前	型	説明
`cssValue`	`String`	色の 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.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

パラメータ

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

リターン

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

`setDataSourceUrl(url)`

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

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

パラメータ

名前	型	説明
`url`	`String`	データソースの URL（クエリパラメータを含む）。

リターン

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

`setDataTable(tableBuilder)`

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

パラメータ

名前	型	説明
`tableBuilder`	`DataTableBuilder`	データテーブルビルダーこの呼び出しの一環として新しいデータテーブルが直ちに作成されるため、ビルダーを更新してもグラフには反映されません。

リターン

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

`setDataTable(table)`

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

パラメータ

名前	型	説明
`table`	`DataTableSource`	グラフに使用するデータ表です。

リターン

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

`setDataViewDefinition(dataViewDefinition)`

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

パラメータ

名前	型	説明
`dataViewDefinition`	`DataViewDefinition`	グラフ描画用に所定のデータソースから導出されるビューを定義するデータビュー定義オブジェクト。

リターン

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

`setDimensions(width, height)`

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

パラメータ

名前	型	説明
`width`	`Integer`	グラフの幅（ピクセル単位）。
`height`	`Integer`	グラフの高さ（ピクセル単位）。

リターン

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

`setLegendPosition(position)`

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

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

パラメータ

名前	型	説明
`position`	`Position`	凡例の位置。

リターン

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

`setLegendTextStyle(textStyle)`

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

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

パラメータ

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

リターン

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

`setOption(option, value)`

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

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

パラメータ

名前	型	説明
`option`	`String`	設定するオプション。
`value`	`Object`	設定する値。

リターン

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

`setTitle(chartTitle)`

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

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

パラメータ

名前	型	説明
`chartTitle`	`String`	グラフのタイトルが表示されます。

リターン

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

`setTitleTextStyle(textStyle)`

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

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

パラメータ

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

リターン

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