概要
SVG または VML を使用してブラウザ内にレンダリングされるバブルチャート。 バブルにカーソルを合わせるとヒントが表示されます。
バブルチャートは、2 ～ 4 次元のデータセットを可視化するために使用します。最初の 2 つのディメンションは座標として可視化されます。3 つ目のディメンションは色として、4 つ目のディメンションはサイズとして可視化されます。
例
<html>
<head>
<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(drawSeriesChart);
function drawSeriesChart() {
var data = google.visualization.arrayToDataTable([
['ID', 'Life Expectancy', 'Fertility Rate', 'Region', 'Population'],
['CAN', 80.66, 1.67, 'North America', 33739900],
['DEU', 79.84, 1.36, 'Europe', 81902307],
['DNK', 78.6, 1.84, 'Europe', 5523095],
['EGY', 72.73, 2.78, 'Middle East', 79716203],
['GBR', 80.05, 2, 'Europe', 61801570],
['IRN', 72.49, 1.7, 'Middle East', 73137148],
['IRQ', 68.09, 4.77, 'Middle East', 31090763],
['ISR', 81.55, 2.96, 'Middle East', 7485600],
['RUS', 68.6, 1.54, 'Europe', 141850000],
['USA', 78.09, 2.05, 'North America', 307007000]
]);
var options = {
title: 'Fertility rate vs life expectancy in selected countries (2010).' +
' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region',
hAxis: {title: 'Life Expectancy'},
vAxis: {title: 'Fertility Rate'},
bubble: {textStyle: {fontSize: 11}}
};
var chart = new google.visualization.BubbleChart(document.getElementById('series_chart_div'));
chart.draw(data, options);
}
</script>
</head>
<body>
<div id="series_chart_div" style="width: 900px; height: 500px;"></div>
</body>
</html>
数字で色分け
以下の例に示すように、colorAxis オプションを使用すると、値に比例してバブルに色を付けることができます。
<html>
<head>
<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);
function drawChart() {
var data = google.visualization.arrayToDataTable([
['ID', 'X', 'Y', 'Temperature'],
['', 80, 167, 120],
['', 79, 136, 130],
['', 78, 184, 50],
['', 72, 278, 230],
['', 81, 200, 210],
['', 72, 170, 100],
['', 68, 477, 80]
]);
var options = {
colorAxis: {colors: ['yellow', 'red']}
};
var chart = new google.visualization.BubbleChart(document.getElementById('chart_div'));
chart.draw(data, options);
}
</script>
</head>
<body>
<div id="chart_div" style="width: 900px; height: 500px;"></div>
</body>
</html>
ラベルのカスタマイズ
bubble.textStyle オプションを使用して、ふきだしの書体、フォント、色を制御できます。
var options = {
title: 'Fertility rate vs life expectancy in selected countries (2010).' +
' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region',
hAxis: {title: 'Life Expectancy'},
vAxis: {title: 'Fertility Rate'},
bubble: {
textStyle: {
fontSize: 12,
fontName: 'Times-Roman',
color: 'green',
bold: true,
italic: true
}
}
};
<head>
<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);
function drawChart() {
var data = google.visualization.arrayToDataTable([
['ID', 'Life Expectancy', 'Fertility Rate', 'Region', 'Population'],
['CAN', 80.66, 1.67, 'North America', 33739900],
['DEU', 79.84, 1.36, 'Europe', 81902307],
['DNK', 78.6, 1.84, 'Europe', 5523095],
['EGY', 72.73, 2.78, 'Middle East', 79716203],
['GBR', 80.05, 2, 'Europe', 61801570],
['IRN', 72.49, 1.7, 'Middle East', 73137148],
['IRQ', 68.09, 4.77, 'Middle East', 31090763],
['ISR', 81.55, 2.96, 'Middle East', 7485600],
['RUS', 68.6, 1.54, 'Europe', 141850000],
['USA', 78.09, 2.05, 'North America', 307007000]
]);
var options = {
title: 'Fertility rate vs life expectancy in selected countries (2010).' +
' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region',
hAxis: {title: 'Life Expectancy'},
vAxis: {title: 'Fertility Rate'},
bubble: {
textStyle: {
fontSize: 12,
fontName: 'Times-Roman',
color: 'green',
bold: true,
italic: true
}
}
};
var chart = new google.visualization.BubbleChart(document.getElementById('textstyle'));
chart.draw(data, options);
}
</script>
</head>
<body>
<div id="textstyle" style="width: 900px; height: 500px;"></div>
</body>
</html>
上のグラフではラベルが読みにくくなっています。その原因の一つは、ラベルの周囲に空白があることです。これはオーラと呼ばれます。オーラなしでグラフに表示したい場合は、bubble.textStyle.auraColor を 'none' に設定します。
var options = {
title: 'Fertility rate vs life expectancy in selected countries (2010).' +
' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region',
hAxis: {title: 'Life Expectancy'},
vAxis: {title: 'Fertility Rate'},
bubble: {
textStyle: {
auraColor: 'none'
}
}
};
<head>
<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);
function drawChart() {
var data = google.visualization.arrayToDataTable([
['ID', 'Life Expectancy', 'Fertility Rate', 'Region', 'Population'],
['CAN', 80.66, 1.67, 'North America', 33739900],
['DEU', 79.84, 1.36, 'Europe', 81902307],
['DNK', 78.6, 1.84, 'Europe', 5523095],
['EGY', 72.73, 2.78, 'Middle East', 79716203],
['GBR', 80.05, 2, 'Europe', 61801570],
['IRN', 72.49, 1.7, 'Middle East', 73137148],
['IRQ', 68.09, 4.77, 'Middle East', 31090763],
['ISR', 81.55, 2.96, 'Middle East', 7485600],
['RUS', 68.6, 1.54, 'Europe', 141850000],
['USA', 78.09, 2.05, 'North America', 307007000]
]);
var options = {
title: 'Fertility rate vs life expectancy in selected countries (2010).' +
' X=Life Expectancy, Y=Fertility, Bubble size=Population, Bubble color=Region',
hAxis: {title: 'Life Expectancy'},
vAxis: {title: 'Fertility Rate'},
bubble: {
textStyle: {
auraColor: 'none',
}
}
};
var chart = new google.visualization.BubbleChart(document.getElementById('noAura'));
chart.draw(data, options);
}
</script>
</head>
<body>
<div id="noAura" style="width: 900px; height: 500px;"></div>
</body>
</html>
読み込んでいます
google.charts.load パッケージ名は "corechart" です。
google.charts.load("current", {packages: ["corechart"]});
ビジュアリゼーションのクラス名は google.visualization.BubbleChart です。
var visualization = new google.visualization.BubbleChart(container);
データ形式
行: 表の各行は 1 つのバブルを表します。
Columns:
| 列 0 | 列 1 | 列 2 | 列 3（省略可） | 列 4（省略可） | |
|---|---|---|---|---|---|
| 目的: | バブルの ID（名前） | X 座標 | Y 座標 | 列の種類に応じて、シリーズ ID またはグラデーション スケールの色を表す値。
|
サイズ。この列の値は、sizeAxis オプションを使用して実際のピクセル値にマッピングされます。 |
| データ型: | string | 数値 | 数値 | 文字列または数値 | 数値 |
構成オプション
| 名前 | |
|---|---|
| animation.duration |
アニメーションの再生時間（ミリ秒単位）。詳細については、アニメーションのドキュメントをご覧ください。 タイプ: 数値
デフォルト: 0
|
| animation.easing |
アニメーションに適用されるイージング関数。以下のオプションを使用できます。
型: string
デフォルト: 「linear」
|
| animation.startup |
最初の描画でグラフをアニメーション表示するかどうかを指定します。 型: boolean
デフォルト: false
|
| axisTitlesPosition |
軸のタイトルを配置する場所（グラフ領域と比較）。サポートされている値:
型: string
デフォルト: 「out」
|
| backgroundColor |
グラフのメイン領域の背景色。単純な HTML カラー文字列（ タイプ: 文字列またはオブジェクト
デフォルト: 「white」
|
| backgroundColor.stroke |
グラフの枠線の色。HTML のカラー文字列で指定します。 型: string
デフォルト: 「#666」
|
| backgroundColor.strokeWidth |
枠線の幅（ピクセル単位）。 タイプ: 数値
デフォルト: 0
|
| backgroundColor.fill |
グラフの塗りつぶしの色。HTML の色文字列で指定します。 型: string
デフォルト: 「white」
|
| bubble |
バブルの視覚的プロパティを設定するメンバーを持つオブジェクト。 タイプ: オブジェクト
デフォルト: null
|
| bubble.opacity |
バブルの不透明度。0 は完全な透明、1 は完全な不透明です。 タイプ: 0.0 ～ 1.0 の数値
デフォルト: 0.8
|
| bubble.stroke |
バブルのストロークの色。 型: string
デフォルト: 「#ccc」
|
| bubble.textStyle |
ふきだしのテキスト スタイルを指定するオブジェクト。オブジェクトの形式は次のとおりです。 {color: <string>, fontName: <string>, fontSize: <number>}
タイプ: オブジェクト
デフォルト:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| chartArea |
グラフ領域（グラフ自体が描画される場所。軸と凡例を除く）の配置とサイズを構成するメンバーを持つオブジェクト。サポートされている形式は、数字、または数字の後に % が続く形式です。単純な数字はピクセル単位の値で、数字の後に % を続けるとパーセンテージになります。例: タイプ: オブジェクト
デフォルト: null
|
| chartArea.backgroundColor |
グラフ領域の背景色。文字列を使用する場合は、16 進数文字列（例:「#fdc」）、英語の色の名前）を使用できます。オブジェクトを使用する場合は、次のプロパティを指定できます。
タイプ: 文字列またはオブジェクト
デフォルト: 「white」
|
| chartArea.left |
左の枠線からグラフを描画する距離。 タイプ: 数値または文字列
デフォルト: auto
|
| chartArea.top |
上枠線からグラフを描画する距離。 タイプ: 数値または文字列
デフォルト: auto
|
| chartArea.width |
グラフ領域の幅。 タイプ: 数値または文字列
デフォルト: auto
|
| chartArea.height |
グラフ領域の高さ。 タイプ: 数値または文字列
デフォルト: auto
|
| 色 |
グラフの要素に使用する色。文字列の配列。各要素は HTML カラー文字列です（例: 型: 文字列の配列
デフォルト: デフォルトの色
|
| colorAxis |
カラー列の値と、色またはグラデーション スケールのマッピングを指定するオブジェクト。このオブジェクトのプロパティを指定するには、次に示すようにオブジェクト リテラル表記を使用できます。 {minValue: 0, colors: ['#FF0000', '#00FF00']}
タイプ: オブジェクト
デフォルト: null
|
| colorAxis.minValue |
存在する場合、グラフの色データの最小値を指定します。この値以下のカラーデータ値は、 タイプ: 数値
デフォルト: グラフデータの色列の最小値
|
| colorAxis.maxValue |
存在する場合、グラフの色データの最大値を指定します。この値以上のカラーデータ値は、 タイプ: 数値
デフォルト: グラフデータの色列の最大値
|
| colorAxis.values |
指定する場合は、値を色に関連付ける方法を制御します。各値は、 型: 数値の配列
デフォルト: null
|
| colorAxis.colors |
ビジュアリゼーション内の値に割り当てる色。文字列の配列。各要素は HTML カラー文字列です（例: 型: 色文字列の配列
デフォルト: null
|
| colorAxis.legend |
グラデーション カラーの凡例のスタイルを指定するオブジェクト。 タイプ: オブジェクト
デフォルト: null
|
| colorAxis.legend.position |
凡例の位置。次のいずれか 1 つを指定できます。
タイプ: オブジェクト
デフォルト: 「top」
|
| colorAxis.legend.textStyle |
凡例のテキスト スタイルを指定するオブジェクト。オブジェクトの形式は次のとおりです。 {color: <string>, fontName: <string>, fontSize: <number>}
タイプ: オブジェクト
デフォルト:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| colorAxis.legend.numberFormat |
数値ラベルの形式文字列。これは、
ICU パターンセット
のサブセットです。
たとえば、 型: string
デフォルト: auto
|
| enableInteractivity |
グラフがユーザーベースのイベントをスローするか、ユーザー操作に反応するかを示します。false の場合、グラフは「select」などのインタラクション ベースのイベントをスローしません（ただし、Ready イベントや error イベントはスローされます）。また、ホバーテキストを表示したり、ユーザー入力に応じて変化したりしません。 型: boolean
デフォルト: true
|
| explorer |
この機能は試験運用版であり、今後のリリースで変更される可能性があります。 注: エクスプローラでは、連続した軸（数値や日付など）しか使用できません。 タイプ: オブジェクト
デフォルト: null
|
| explorer.actions |
Google グラフ エクスプローラでは、次の 3 つの操作がサポートされています。
型: 文字列の配列
デフォルト: ['dragToPan', 'rightClickToReset']
|
| explorer.axis |
デフォルトでは、 型: string
デフォルト: 水平方向と垂直方向の両方へのパン
|
| explorer.keepInBounds |
デフォルトでは、データの場所に関係なく、ユーザーは全体をパンできます。ユーザーが元のグラフを超えてパンしないようにするには、 型: boolean
デフォルト: false
|
| explorer.maxZoomIn |
エクスプローラーがズームインできる最大値です。デフォルトでは、元のビューの 25% のみが表示されるようにズームインできます。 タイプ: 数値
デフォルト: 0.25
|
| explorer.maxZoomOut |
エクスプローラーがズームアウトできる最大値です。デフォルトでは、グラフが利用可能なスペースの 4 分の 1 を占める程度にズームアウトできます。 タイプ: 数値
デフォルト: 4
|
| explorer.zoomDelta |
ユーザーがズームインまたはズームアウトするときに、 タイプ: 数値
デフォルト: 1.5
|
| fontSize |
グラフ内のすべてのテキストのデフォルトのフォントサイズ（ピクセル単位）。この設定は、特定のグラフ要素のプロパティを使用してオーバーライドできます。 タイプ: 数値
デフォルト: 自動
|
| fontName |
グラフのすべてのテキストに使用されるデフォルトのフォントです。この設定は、特定のグラフ要素のプロパティを使用してオーバーライドできます。 型: string
デフォルト: 「Arial」
|
| forceIFrame |
インライン フレーム内にグラフを描画します。（IE8 ではこのオプションは無視されます。IE8 グラフはすべて i フレームに描画されます）。 型: boolean
デフォルト: false
|
| hAxis |
さまざまな横軸の要素を構成するメンバーを持つオブジェクト。このオブジェクトのプロパティを指定するには、次に示すようにオブジェクト リテラル表記を使用できます。
{
title: 'Hello',
titleTextStyle: {
color: '#FF0000'
}
}
タイプ: オブジェクト
デフォルト: null
|
| hAxis.baseline |
横軸のベースライン。 タイプ: 数値
デフォルト: 自動
|
| hAxis.baselineColor |
横軸のベースラインの色。任意の HTML カラー文字列（例: タイプ: 数値
デフォルト: 「black」
|
| hAxis.direction |
横軸での値の増加の方向。値の順序を逆にするには、 タイプ: 1 または -1
デフォルト: 1
|
| hAxis.format |
数値軸のラベルの形式文字列。これは、
ICU パターンセット
のサブセットです。たとえば、
ラベルに適用される実際の書式は、API を読み込んだ際の言語 / 地域に基づきます。詳しくは、 特定のロケールでのグラフの読み込み をご覧ください。
目盛り値とグリッド線の計算では、関連するすべてのグリッド線オプションの代替の組み合わせが検討され、フォーマットされた目盛りラベルが重複または重複する場合は、代替案は拒否されます。そのため、整数の目盛り値のみを表示する場合は 型: string
デフォルト: auto
|
| hAxis.gridlines |
横軸のグリッド線を構成するプロパティを持つオブジェクト。 横軸のグリッド線は垂直方向に描画されます。このオブジェクトのプロパティを指定するには、次に示すようにオブジェクト リテラル表記を使用できます。 {color: '#333', minSpacing: 20}
タイプ: オブジェクト
デフォルト: null
|
| hAxis.gridlines.color |
グラフ領域内の水平グリッド線の色。有効な HTML カラー文字列を指定します。 型: string
デフォルト: 「#CCC」
|
| hAxis.gridlines.count |
グラフ領域内の水平グリッド線のおおよその数。
タイプ: 数値
デフォルト: -1
|
| hAxis.gridlines.units |
グラフで計算されたグリッド線で使用する場合、日付/日時/timeofday データ型のさまざまな側面のデフォルトの形式をオーバーライドします。年、月、日、時、分、秒、ミリ秒の書式設定を許可します。 一般的な形式は次のとおりです。
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]}
hours: {format: [/*format strings here*/]}
minutes: {format: [/*format strings here*/]}
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]},
}
}
詳細については、日付と時刻をご覧ください。 タイプ: オブジェクト
デフォルト: null
|
| hAxis.minorGridlines |
hAxis.gridlines オプションと同様に、横軸の副グリッド線を設定するメンバーを持つオブジェクト。 タイプ: オブジェクト
デフォルト: null
|
| hAxis.minorGridlines.color |
グラフ領域内の水平の副グリッド線の色。有効な HTML カラー文字列を指定します。 型: string
デフォルト: グリッド線と背景色の組み合わせ
|
| hAxis.minorGridlines.count |
カウントを 0 に設定してマイナー グリッドラインを無効にする場合を除き、 タイプ: 数値
デフォルト: 1
|
| hAxis.minorGridlines.units |
グラフで計算されたマイナー グリッドラインで使用される場合、日付/日時/timeofday データ型のさまざまな側面のデフォルトの形式をオーバーライドします。年、月、日、時、分、秒、ミリ秒の書式設定を許可します。 一般的な形式は次のとおりです。
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]}
hours: {format: [/*format strings here*/]}
minutes: {format: [/*format strings here*/]}
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]},
}
}
詳細については、日付と時刻をご覧ください。 タイプ: オブジェクト
デフォルト: null
|
| hAxis.logScale |
型: boolean
デフォルト: false
|
| hAxis.scaleType |
型: string
デフォルト: null
|
| hAxis.textPosition |
グラフ領域に対する横軸のテキストの位置。サポートされている値: out、in、none。 型: string
デフォルト: 「out」
|
| hAxis.textStyle |
横軸のテキスト スタイルを指定するオブジェクト。オブジェクトの形式は次のとおりです。
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
タイプ: オブジェクト
デフォルト:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| hAxis.ticks |
自動生成された X 軸の目盛りを、指定した配列に置き換えます。配列の各要素は、有効な目盛り値（数値、日付、日時、timeofday など）またはオブジェクトである必要があります。オブジェクトの場合は、目盛り値の
例:
型: 要素の配列
デフォルト: auto
|
| hAxis.title |
横軸のタイトルを指定する 型: string
デフォルト: null
|
| hAxis.titleTextStyle |
横軸のタイトルのテキスト スタイルを指定するオブジェクト。オブジェクトの形式は次のとおりです。
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
タイプ: オブジェクト
デフォルト:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| hAxis.maxValue |
横軸の最大値を指定の値に移動します。ほとんどのグラフでは右になります。データの最大 x 値より小さい値を設定した場合は無視されます。 タイプ: 数値
デフォルト: 自動
|
| hAxis.minValue |
横軸の最小値を指定された値に移動します。ほとんどのグラフでは左方向になります。データの最小値 x 値より大きい値を設定した場合は無視されます。 タイプ: 数値
デフォルト: 自動
|
| hAxis.viewWindowMode |
グラフ領域内に値をレンダリングするために横軸をスケーリングする方法を指定します。次の文字列値がサポートされています。
型: string
デフォルト: 「pretty」と同じですが、使用した場合、
haxis.viewWindow.min と haxis.viewWindow.max が優先されます。
|
| hAxis.viewWindow |
横軸の切り抜き範囲を指定します。 タイプ: オブジェクト
デフォルト: null
|
| hAxis.viewWindow.max |
レンダリングする水平方向データの最大値。
タイプ: 数値
デフォルト: auto
|
| hAxis.viewWindow.min |
レンダリングする水平データの最小値。
タイプ: 数値
デフォルト: auto
|
| 身長 |
グラフの高さ（ピクセル単位）。 タイプ: 数値
デフォルト: 含まれる要素の高さ
|
| 凡例 |
凡例のさまざまな要素を構成するメンバーを含むオブジェクト。このオブジェクトのプロパティを指定するには、次に示すようにオブジェクト リテラル表記を使用できます。 {position: 'top', textStyle: {color: 'blue', fontSize: 16}}
タイプ: オブジェクト
デフォルト: null
|
| legend.alignment |
凡例の配置。次のいずれか 1 つを指定できます。
開始、中央、終了は、凡例のスタイル（垂直または水平）に関連します。たとえば、「right」の凡例では「start」と「end」がそれぞれ上下に配置されます。「top」の凡例では、「start」と「end」はそれぞれ領域の左右にあります。 デフォルト値は、凡例の位置によって異なります。「ボトム」の凡例のデフォルトは「center」です。その他の凡例のデフォルトは「start」です。 型: string
デフォルト: 自動
|
| legend.maxLines |
凡例の最大行数。凡例に線を追加するには、1 より大きい数値に設定します。注: 実際にレンダリングされる線の数を決定するために使用される正確なロジックは、現在も随時決定されます。 現在このオプションは、legend.position が top の場合にのみ機能します。 タイプ: 数値
デフォルト: 1
|
| legend.pageIndex |
凡例の最初に選択されたゼロベースのページ インデックス。 タイプ: 数値
デフォルト: 0
|
| legend.position |
凡例の位置。次のいずれか 1 つを指定できます。
型: string
デフォルト: 「right」
|
| legend.textStyle |
凡例のテキスト スタイルを指定するオブジェクト。オブジェクトの形式は次のとおりです。
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
タイプ: オブジェクト
デフォルト:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| selectionMode |
型: string
デフォルト: 「single」
|
| シリーズ |
オブジェクトのオブジェクト。キーは系列名（[色] 列の値）と、グラフ内の対応する系列の形式を記述する各オブジェクトです。シリーズまたは値が指定されていない場合は、グローバル値が使用されます。各オブジェクトは次のプロパティをサポートしています。
series: {'Europe': {color: 'green'}}
タイプ: ネストされたオブジェクトを持つオブジェクト
デフォルト: {}
|
| sizeAxis |
バブルのサイズに値を関連付ける方法を構成するメンバーを含むオブジェクト。このオブジェクトのプロパティを指定するには、次に示すようにオブジェクト リテラル表記を使用できます。 {minValue: 0, maxSize: 20}
タイプ: オブジェクト
デフォルト: null
|
| sizeAxis.maxSize |
バブルの最大半径（ピクセル単位）。 タイプ: 数値
デフォルト: 30
|
| sizeAxis.maxValue |
タイプ: 数値
デフォルト: グラフデータにおける列のサイズの最大値
|
| sizeAxis.minSize |
できる限り小さいバブルの最小半径（ピクセル単位）。 タイプ: 数値
デフォルト: 5
|
| sizeAxis.minValue |
タイプ: 数値
デフォルト: グラフデータの列の最小値
|
| sortBubblesBySize |
true の場合、小さいバブルが大きなバブルの上に表示されるようにバブルをサイズで並べ替えます。false の場合、バブルは DataTable 内の順序で並べ替えられます。 型: boolean
デフォルト: true
|
| テーマ |
テーマとは、グラフの特定の動作や視覚効果を実現するために連携して機能する、事前定義されたオプション値のセットです。現時点で使用できるテーマは 1 つのみです。
型: string
デフォルト: null
|
| title |
グラフの上部に表示するテキストです。 型: string
デフォルト: タイトルなし
|
| titlePosition |
グラフ領域に対するグラフのタイトルの配置場所。サポートされている値:
型: string
デフォルト: 「out」
|
| titleTextStyle |
タイトルのテキスト スタイルを指定するオブジェクト。オブジェクトの形式は次のとおりです。
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
タイプ: オブジェクト
デフォルト:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| ツールチップ |
さまざまなツールチップ要素を構成するメンバーを持つオブジェクト。このオブジェクトのプロパティを指定するには、次に示すようにオブジェクト リテラル表記を使用できます。 {textStyle: {color: '#FF0000'}, showColorCode: true}
タイプ: オブジェクト
デフォルト: null
|
| tooltip.isHtml |
true に設定した場合、SVG 表示ではなく HTML 表示のツールチップが使用されます。詳細については、ツールチップのコンテンツのカスタマイズをご覧ください。 注: ツールチップ列のデータロールによる HTML ツールチップ コンテンツのカスタマイズは、バブルチャートの可視化ではサポートされていません。 型: boolean
デフォルト: false
|
| tooltip.textStyle |
ツールチップのテキスト スタイルを指定するオブジェクト。オブジェクトの形式は次のとおりです。
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
タイプ: オブジェクト
デフォルト:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| tooltip.trigger |
ツールチップを表示するユーザー操作:
型: string
デフォルト: 「focus」
|
| vAxis |
さまざまな縦軸の要素を構成するメンバーを持つオブジェクト。このオブジェクトのプロパティを指定するには、次に示すようにオブジェクト リテラル表記を使用できます。 {title: 'Hello', titleTextStyle: {color: '#FF0000'}}
タイプ: オブジェクト
デフォルト: null
|
| vAxis.baseline |
タイプ: 数値
デフォルト: 自動
|
| vAxis.baselineColor |
縦軸のベースラインの色を指定します。任意の HTML カラー文字列（例: タイプ: 数値
デフォルト: 「black」
|
| vAxis.direction |
縦軸での値の増加の方向。デフォルトでは、低い値はグラフの下部に表示されます。値の順序を逆にするには、 タイプ: 1 または -1
デフォルト: 1
|
| vAxis.format |
数値軸のラベルの形式文字列。これは、
ICU パターンセット
のサブセットです。
たとえば、
ラベルに適用される実際の書式は、API を読み込んだ際の言語 / 地域に基づきます。詳しくは、 特定のロケールでのグラフの読み込み をご覧ください。
目盛り値とグリッド線の計算では、関連するすべてのグリッド線オプションの代替の組み合わせが検討され、フォーマットされた目盛りラベルが重複または重複する場合は、代替案は拒否されます。そのため、整数の目盛り値のみを表示する場合は 型: string
デフォルト: auto
|
| vAxis.gridlines |
縦軸のグリッド線を構成するメンバーを持つオブジェクト。 縦軸のグリッド線は横方向に描画されます。このオブジェクトのプロパティを指定するには、次に示すようにオブジェクト リテラル表記を使用できます。 {color: '#333', minSpacing: 20}
タイプ: オブジェクト
デフォルト: null
|
| vAxis.gridlines.color |
グラフ領域内の垂直グリッド線の色。有効な HTML カラー文字列を指定します。 型: string
デフォルト: 「#CCC」
|
| vAxis.gridlines.count |
グラフ領域内の水平グリッド線のおおよその数。
タイプ: 数値
デフォルト: -1
|
| vAxis.gridlines.units |
グラフで計算されたグリッド線で使用する場合、日付/日時/timeofday データ型のさまざまな側面のデフォルトの形式をオーバーライドします。年、月、日、時、分、秒、ミリ秒の書式設定を許可します。 一般的な形式は次のとおりです。
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]},
hours: {format: [/*format strings here*/]},
minutes: {format: [/*format strings here*/]},
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]}
}
}
詳細については、日付と時刻をご覧ください。 タイプ: オブジェクト
デフォルト: null
|
| vAxis.minorGridlines |
vAxis.gridlines オプションと同様に、縦軸の副グリッド線を構成するメンバーを持つオブジェクト。 タイプ: オブジェクト
デフォルト: null
|
| vAxis.minorGridlines.color |
グラフ領域内の縦方向の副グリッド線の色。有効な HTML カラー文字列を指定します。 型: string
デフォルト: グリッド線と背景色の組み合わせ
|
| vAxis.minorGridlines.count |
minimumGridlines.count オプションは、count を 0 に設定してマイナー グリッドラインを無効にする場合を除き、ほぼ非推奨となりました。マイナー グリッド線の数は、主要グリッド線の間隔（vAxis.gridlines.interval を参照）と必要最小限のスペース（vAxis.minorGridlines.minSpacing を参照）によって異なります。 タイプ: 数値
デフォルト: 1
|
| vAxis.minorGridlines.units |
グラフで計算されたマイナー グリッドラインで使用される場合、日付/日時/timeofday データ型のさまざまな側面のデフォルトの形式をオーバーライドします。年、月、日、時、分、秒、ミリ秒の書式設定を許可します。 一般的な形式は次のとおりです。
gridlines: {
units: {
years: {format: [/*format strings here*/]},
months: {format: [/*format strings here*/]},
days: {format: [/*format strings here*/]}
hours: {format: [/*format strings here*/]}
minutes: {format: [/*format strings here*/]}
seconds: {format: [/*format strings here*/]},
milliseconds: {format: [/*format strings here*/]},
}
}
詳細については、日付と時刻をご覧ください。 タイプ: オブジェクト
デフォルト: null
|
| vAxis.logScale |
true の場合、縦軸を対数スケールにします。注: 値はすべて正数で指定する必要があります。 型: boolean
デフォルト: false
|
| vAxis.scaleType |
型: string
デフォルト: null
|
| vAxis.textPosition |
グラフ領域に対する縦軸のテキストの位置。サポートされている値: out、in、none。 型: string
デフォルト: 「out」
|
| vAxis.textStyle |
縦軸のテキスト スタイルを指定するオブジェクト。オブジェクトの形式は次のとおりです。
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
タイプ: オブジェクト
デフォルト:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| vAxis.ticks |
自動生成された Y 軸の目盛りを、指定した配列に置き換えます。配列の各要素は、有効な目盛り値（数値、日付、日時、timeofday など）またはオブジェクトである必要があります。オブジェクトの場合は、目盛り値の
例:
型: 要素の配列
デフォルト: auto
|
| vAxis.title |
縦軸のタイトルを指定する 型: string
デフォルト: タイトルなし
|
| vAxis.titleTextStyle |
縦軸のタイトルのテキスト スタイルを指定するオブジェクト。オブジェクトの形式は次のとおりです。
{ color: <string>,
fontName: <string>,
fontSize: <number>,
bold: <boolean>,
italic: <boolean> }
タイプ: オブジェクト
デフォルト:
{color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
|
| vAxis.maxValue |
縦軸の最大値を指定の値に移動します。ほとんどのグラフでは上に移動します。データの最大 y 値より小さい値を設定した場合は無視されます。 タイプ: 数値
デフォルト: 自動
|
| vAxis.minValue |
縦軸の最小値を指定された値に移動します。ほとんどのグラフでは下降します。データの最小値である y 値より大きい値を設定した場合は無視されます。 タイプ: 数値
デフォルト: null
|
| vAxis.viewWindowMode |
グラフ領域内に値をレンダリングするために縦軸をスケーリングする方法を指定します。次の文字列値がサポートされています。
型: string
デフォルト: 「pretty」と同じですが、使用した場合、
vaxis.viewWindow.min と vaxis.viewWindow.max が優先されます。
|
| vAxis.viewWindow |
縦軸の切り抜き範囲を指定します。 タイプ: オブジェクト
デフォルト: null
|
| vAxis.viewWindow.max |
レンダリングする垂直データの最大値。
タイプ: 数値
デフォルト: auto
|
| vAxis.viewWindow.min |
レンダリングする垂直データの最小値。
タイプ: 数値
デフォルト: auto
|
| 幅 |
グラフの幅（ピクセル単位）。 タイプ: 数値
デフォルト: 含まれる要素の幅
|
メソッド
| メソッド | |
|---|---|
draw(data, options) |
グラフを描画します。グラフは、 戻り値の型: none
|
getAction(actionID) |
リクエストされた 戻り値の型: オブジェクト
|
getBoundingBox(id) |
グラフ要素
値はグラフのコンテナを基準とします。グラフが描画された後に呼び出されます。 戻り値の型: オブジェクト
|
getChartAreaBoundingBox() |
グラフ コンテンツの左、上、幅、高さを含むオブジェクトを返します（ラベルと凡例を除く）。
値はグラフのコンテナを基準とします。グラフが描画された後に呼び出されます。 戻り値の型: オブジェクト
|
getChartLayoutInterface() |
グラフの画面上の位置とその要素に関する情報を含むオブジェクトを返します。 返されたオブジェクトに対して、次のメソッドを呼び出すことができます。
グラフが描画された後に呼び出されます。 戻り値の型: オブジェクト
|
getHAxisValue(xPosition, optional_axis_index) |
例: グラフが描画された後に呼び出されます。 戻り値の型: number
|
getImageURI() |
画像の URI としてシリアル化されたグラフを返します。 グラフが描画された後に呼び出されます。 PNG チャートの印刷をご覧ください。 戻り値の型: string
|
getSelection() |
選択したグラフ エンティティの配列を返します。
選択可能なエンティティはバブルです。
このグラフでは、任意の時点で選択できるエンティティは 1 つのみです。
戻り値の型: 選択要素の配列
|
getVAxisValue(yPosition, optional_axis_index) |
例: グラフが描画された後に呼び出されます。 戻り値の型: number
|
getXLocation(dataValue, optional_axis_index) |
グラフのコンテナの左端を基準とする 例: グラフが描画された後に呼び出されます。 戻り値の型: number
|
getYLocation(dataValue, optional_axis_index) |
グラフのコンテナの上端を基準とする 例: グラフが描画された後に呼び出されます。 戻り値の型: number
|
removeAction(actionID) |
リクエストされた 戻り値の型:
none |
setAction(action) |
ユーザーがアクション テキストをクリックしたときに実行されるツールチップ アクションを設定します。
すべてのツールチップ アクションは、グラフの 戻り値の型:
none |
setSelection() |
指定したグラフ エンティティを選択します。前の選択をキャンセルします。
選択可能なエンティティはバブルです。
このグラフでは、一度に 1 つのエンティティしか選択できません。
戻り値の型: none
|
clearChart() |
チャートを消去し、割り当て済みリソースをすべて解放します。 戻り値の型: none
|
イベント
これらのイベントの使用方法について詳しくは、基本的なインタラクティビティ、イベントの処理、イベントを発生させるをご覧ください。
| 名前 | |
|---|---|
animationfinish |
遷移アニメーションの完了時に呼び出されます。 Properties（プロパティ）: なし
|
click |
ユーザーがグラフ内をクリックすると呼び出されます。タイトル、データ要素、凡例のエントリ、軸、グリッド線、ラベルがクリックされたタイミングを識別するために使用できます。 プロパティ: targetID
|
error |
グラフのレンダリング中にエラーが発生したときに呼び出されます。 プロパティ: id、message
|
legendpagination |
ユーザーが凡例のページ分け用の矢印をクリックすると呼び出されます。現在の凡例のゼロベースのページ インデックスと総ページ数を返します。 プロパティ: currentPageIndex、totalPages
|
onmouseover |
ユーザーがビジュアル エンティティにカーソルを合わせたときに呼び出されます。対応するデータテーブル要素の行インデックスと列インデックスを渡します。 バブルはデータテーブルの行に対応しています（列インデックスが null）。 プロパティ: row、column
|
onmouseout |
ユーザーがビジュアル エンティティからマウス離れたときに呼び出されます。対応するデータテーブル要素の行インデックスと列インデックスを渡します。 バブルはデータテーブルの行に対応しています（列インデックスが null）。 プロパティ: row、column
|
ready |
グラフで外部メソッド呼び出しの準備が整いました。グラフを操作し、描画後にメソッドを呼び出す場合は、 Properties（プロパティ）: なし
|
select |
ユーザーがビジュアル エンティティをクリックしたときに呼び出されます。選択された内容を確認するには、 Properties（プロパティ）: なし
|
データポリシー
すべてのコードとデータはブラウザで処理されてレンダリングされます。データはどのサーバーにも送信されません。