![cht=bvs&chs=75x50&chd=t:10,50,60,80,40|50,60,100,40,20&chco=4d89f9,c6d9fd&chds=0,160&chbh=a](https://developers-dot-devsite-v2-prod.appspot.com/static/chart/image/images/chart_137.png?authuser=3&hl=ja)
このドキュメントでは、Chart API を使用して作成できるさまざまなタイプの棒グラフについて説明します。
目次
グラフ固有の機能 |
Standard の機能
|
概要
縦棒グラフ、横棒グラフ、グループ化グラフ、積み上げ棒グラフ、重ね合わせグラフなど、さまざまな棒グラフを作成できます。
棒グラフは、少数の個別のデータポイントを並べて比較し、傾向を特定するのに適しています。折れ線グラフは、系列のデータポイントの数が少ない場合に有用です。
棒グラフで複数の系列を表示するには、一般的に次の 3 つの方法があります。
グループ化 |
積み上げ |
重複 |
![]() |
![]() |
![]() |
cht=bvg |
cht=bvs |
cht=bvo |
バーの幅とスペースは、chbh
パラメータを使用して制御できます。chbh
を指定しないと、一部のバーがトリミングされることがあります。
デフォルトでは、すべての系列が同じ色で表示されます。系列ごとに異なる色を指定しないと、グラフに複数の系列があることを区別するのが難しくなります。詳しくは、系列の色をご覧ください。
棒グラフには、デフォルトで 1 つ以上の軸が表示されます。デフォルトの軸を非表示にするには、chxs
パラメータを使用して、<axis_or_tick> の値にアンダースコアを指定します。
積み上げグラフで単純なテキスト形式を使用する場合は、以下に示すようにカスタム スケーリングを追加しない限り、スタックの合計の高さとして 100 を超える分が切り抜かれることに注意してください。
スケーリングしないと、中央の 3 本の棒が 100 を超えると、単純なテキスト形式のデータグラフでは切り抜かれます。 | ![]() cht=bhs |
スタックされたバー全体の長さを表示するには、別のエンコード スキームを使用するか、カスタム スケーリングを適用したテキスト形式を使用する必要があります。スケールの最大値は、積み上げられた棒の合計の高さを基準とします。この例では、最大 160(合計の最大値)になります。 | ![]() cht=bhs |
グラフの種類(cht
)
作成できる棒グラフにはさまざまな種類があります。棒グラフを指定するには、次の構文を使用します。
構文
cht=<chart_type>
ここで、<chart_type>
は次のいずれかの型です。
グラフの種類 | 説明 | 例 |
---|---|---|
|
積み上げ棒付きの横棒グラフ。 最初の例では(すべての棒が濃い青色の棒)、1 つのデータ系列があります。 2 番目の例(濃い青色の棒と薄い青色の棒)には 2 つのシリーズがあります。(また、バーの合計値を示すようにスケーリングされ、100 を超える値になります)。 ご覧のとおり、複数のシリーズが積み重ねられています。異なる系列色を指定しない場合、すべての色が同じになります(棒は積み上げられて表示されません)。1 つのシリーズ内の各棒に色を指定することもできます。 |
![]() cht=bhs |
|
積み上げ棒付きの縦棒グラフ。 この例には 2 つのシリーズがあり、カスタム スケーリングのテキスト形式を使用して、スタックされたすべての値が完全に表示されるようにしています。
|
|
bvo |
棒が互いに重なり合うのではなく、重なり合った縦棒グラフ。各棒の高さは合計値ではなく、個々の値です。すべてのバーが表示されるように、バーが高さで並べ替えられています。 |
|
|
グループ棒グラフ付きの横棒グラフ。 上のグラフでは、デフォルトのグループの間隔値が使用されています。下のグラフでは、chbh パラメータを使用してデフォルトの棒の幅とグループの間隔を変更して、グループがわかりやすいようにしています。 |
|
|
グループ棒グラフ付きの縦棒グラフ。 |
|
系列の色 chco
chco
パラメータを使用して、個々の棒、個々のシリーズ、または複数のシリーズの色を指定できます。系列ごとに異なる色を指定しない場合、系列はすべて同じ色になります。
構文
chco=<series_1_color>, ..., <series_n_color> or chco=<series_1_bar_1>|<series_1_bar_2>|...|<series_1_bar_n>,<series_2>,...,<series_n>
<color>
- 系列または個々の棒に適用する RRGGBB 形式の 16 進数。シリーズ全体に色を適用するには、カンマ区切りにする必要があります。個々の棒に色を適用するには、パイプ文字で区切ります。これら 2 つの形式を混在させることができます。下の表で例をご覧ください。色の値がデータポイントまたは系列より少ない場合、色はグループ内の最初の色から順に再循環されます。
例
説明 | 例 |
---|---|
シリーズごとに 1 色、カンマ区切り色で指定します。 |
|
値ごとに 1 つの色を、パイプ文字で区切った色で指定します。 |
|
系列の色と個々の棒の色の組み合わせです。 この例は、2 つの系列がある棒グラフを示しています。最初のシリーズはすべて黒( |
|
この例では、複数系列グラフの棒ごとに異なる色を設定しています。 | ![]() chco= |
塗りつぶしを指定して、単色、ストライプ、グラデーション カラーで系列の色を設定することもできます。単色塗りつぶしは chco を使用した場合と同じように見えますが、ストライプやグラデーションでは独自の効果を作り出します。 |
![]() chd=
![]() chd=t: |
バーラベル
棒グラフは標準の軸ラベルをサポートしていますが、棒の基部に沿ったラベルは、棒グラフに沿って広げるのではなく、個々の棒に割り当てられます。(ラベルを均等に分散させるには、以下で説明するように chxp
パラメータを使用します)。軸ラベルを指定しても、棒軸上のカスタムラベルを指定しない場合、棒ラベルは各棒または棒のグループのインデックス番号になります。軸ラベルは、chxl
パラメータを使用してカスタマイズできます。
説明 | 例 |
---|---|
デフォルトの X 軸ラベルを使用した棒グラフ。 | ![]() chxt=x,y |
カスタムの X 軸ラベルを使用した棒グラフ。 |
|
ラベルとバーの数が異なり、ラベルを(各棒の下ではなく)均等に間隔を空ける場合は、
|
|
バーの幅と間隔 chbh
必要に応じて、棒の幅と棒とグループの間隔のカスタム値を指定できます。すべての棒に対して指定できる幅の値のセットは 1 つのみです。chbh
を指定しない場合、すべてのバーの幅が 23 ピクセルになります。つまり、バーとスペースの幅の合計がグラフの幅よりも広い場合、終了バーがクリップされます。
構文
chbh= <bar_width_or_scale>,<space_between_bars>,<space_between_groups>
- <bar_width_or_scale>
- 棒の幅。次のいずれかの値を入力して、幅と間隔を絶対値または相対値で指定できます。デフォルト値は 23 ピクセル(絶対値)です。
- width - バーの幅(ピクセル単位)。間隔値もすべてピクセル単位の絶対値です。グラフの幅が十分でないと棒が切り取られることがあります。
a
- space_between_bars と space_between_groups は絶対単位(指定しない場合はデフォルトの絶対値)で指定します。すべての棒がグラフに収まるように、棒のサイズが変更されます。r
- space_between_bars と space_between_groups は、相対単位(指定しない場合はデフォルトの相対値)で指定します。相対単位はバーの幅と比較した浮動小数点値です。この場合、バーの幅は 1.0 です。たとえば、0.5 はバーの幅の半分、2.0 はバーの幅の 2 倍です。グラフの幅が十分でないと棒が切り取られることがあります。
- <space_between_bars>
- (省略可)同じグループ内のバー間のスペース。サイズが絶対値の場合、幅はピクセル単位になります。サイズが相対値の場合は、浮動小数点値(1.0 がバーの幅)になります。デフォルト値は、絶対値では 4 ピクセル、相対値では 4/23 です。
- <space_between_groups>
- (省略可)同じグループ内のバーグループ間のスペース。サイズが絶対値の場合、幅はピクセル単位になります。サイズが相対値の場合は、浮動小数点値(1.0 がバーの幅)になります。デフォルト値は、絶対値では 8 ピクセル、相対値では 8/23 です。
中間のオプション パラメータを省略することはできません。指定された値で終了する必要があります。たとえば、chbh=10,5,10
は有効ですが、chbh=10,,10
は有効ではなく、chbh=10,5,
は無効です。
説明 | 例 |
---|---|
このグラフでは、 最初のグラフではグループの間隔が指定されていないため、グループが明確ではありません。2 つ目のグラフでは、グループ間にスペース(15 ピクセル)を空けています。 |
![]()
|
このグラフでは、 |
|
最初のグラフでは各系列に 5 つの値がありますが、グラフが小さすぎるため、デフォルト値を持つすべての棒を保持できません。 10* 23 ピクセル(棒)+ ...一部のバーが途切れています。 2 つ目のグラフでは、グラフ内のすべての棒に収まるように絶対的な棒とスペースの値を指定しています。 |
|
ゼロライン chp
chp
パラメータを使用するか、データ スケーリングによるテキスト エンコードを使用して、グラフのカスタム基準線を指定できます。このゼロラインの動作は 2 種類あります。
- データのスケーリング - スケーリング パラメータ
chds
でテキスト形式のデータを使用すると、すべての負の値を表示するために必要なだけ、ゼロ行が押し上げられます。 chp
パラメータ -chp
パラメータを使用すると、ゼロ線を任意のデータ形式の任意の場所に手動で移動できます。これにより、実際にはゼロ線が人工的に作成されて、データ値と任意のゼロ値の差としてバーが再描画されます(つまり、バーはゼロ線からバー値まで引かれます)。chds
と組み合わせて使用することはできません。
構文
chp= <zero_value_series_1>, ..., <zero_value_series_n>
- <zero_value_series_1>
- 0.0 ~ 1.0 の浮動小数点値。0.0 は軸の下部、1.0 は軸の上端です。この値と値の差を示すため、棒が再描画されます。
説明 | 例 |
---|---|
以下に、同じデータを含む棒グラフのコピーを 3 つ示します。
|
|
この例では、カスタム スケーリング( この例には、-60 ~ 120 の範囲の値があります。棒の上と下にスペースが残るように、スケールは -80 ~ 140 に設定されています。 |
![]() chd=t:30,-60,50,120,80 |
複合グラフ
折れ線マーカー、ローソク足マーカー、シェイプ マーカーを棒グラフに追加して、複合グラフを作成できます。詳しくは、複合グラフをご覧ください。
特定の棒のマーカー(cht=bvg
のみ)
デフォルトでは、グループ化された縦棒グラフに chm
マーカーを描画すると、データの取得元と同じ系列上にマーカーが描画されます。データが非表示の系列の場合、デフォルトの動作では、バーグループの中央にマーカーが配置されます。
ただし、縦にグループ化された棒グラフ(bvg
タイプ)では、マーカーのデータ系列とは異なるプレースメント シリーズを指定できます。これを行うには、<data_series_index>:<placement_series_index>
構文を使用して <series_index>
パラメータ(3 番目のパラメータ)を指定します。
非表示または存在しないプレースメントのシリーズを指定した場合、マーカーはグループ上で水平方向に中央揃えされます。
この機能の最適な使用方法は、マーカー データには非表示のシリーズを使用し、表示されるシリーズにマーカーを配置することです。
次の例は、データ系列とプレースメント系列が同じ場合のデフォルトの動作と、高度な構文で異なるデータ系列とプレースメント シリーズを指定しています。
非表示のデータ系列、デフォルトのマーカーの配置 | 非表示のデータ系列、高度なマーカーの配置 |
---|---|
![]() |
![]() |
この例では、基本的な構文により、マーカー データとプレースメントが同じシリーズ上にある必要があることが指定されています。これは非表示のシリーズであるため、デフォルトのプレースメントは各グループの垂直方向の中央に配置されます。 |
このサンプルでは、高度な構文で、マーカーごとに異なるデータソースとプレースメント シリーズを指定しています。円は非表示の系列 2 のデータを使用して系列 0 に配置されます。正方形は非表示の系列 3 のデータを使用しており、系列 1 に配置されます。 |
以下の例は、グループ棒グラフの個々の棒に複数の異なるタイプのマーカーを追加する方法を示しています。グループの中央に黒い円があることに注意してください。これは、非表示のシリーズをプレースメント シリーズとして指定しているからです。
chd=t4: // First four series are rendered as bars. Remaining data is hidden.
5,10,15,20,25,30 // Purple bar
10,20,30,40,50,60 // Blue bar
30,40,50,60,70,80 // Olive bar
5,5,5,5,5,5 // Black bar
0,15,25,30,45,55 // Hidden data: Purple circle, blue error bar start
15,30,40,45,55,65 // Hidden data: Blue error bar end
20,35,45,50,55,65 // Hidden data: Yellow error bar start
40,45,55,80,75,85 // Hidden data: Yellow error bar end
chm= // Markers:
o,D000D0,4:0,,10 // Purple circle: data series 4, placement series 0 (purple)
E,00D0D0,4:1,,1:10 // Blue error bars: data series 4, placement series 1 (blue)
E,D0D000,6:2,,1:10 // Yellow error bars: data series 6, placement series 2 (olive)
o,000000,3:4,,10 // Black circle: data series 3, placement 4 (hidden placement series, centered in group)
標準の機能
このページの残りの機能は、標準の画像グラフの機能です。
グラフのタイトル chtt
、chts
[すべてのグラフ]
グラフのタイトルのテキスト、色、フォントサイズを指定できます。
構文
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
- グラフのタイトルを指定します。
- <chart_titlechart_title>
- グラフに表示するタイトル。表示位置を指定することはできませんが、必要に応じてフォントサイズと色を指定できます。スペースを示すには + 記号を、改行はパイプ文字(
|
)で表します。
chts
(省略可)- chtt
パラメータの色とフォントサイズ。
- <color>
- タイトルの色(RRGGBB の 16 進数形式)。デフォルトの色は黒です。
- <font_size>
- タイトルのフォントサイズ(ポイント単位)。
- <opt_alignment>
- (省略可)タイトルの配置。「l」(左)、「c」(中央)、「r」(右)の文字列値(大文字と小文字を区別)から 1 つを選択します。デフォルトは「c」です。
例
説明 | 例 |
---|---|
デフォルトの色とフォントサイズを使用したタイトル付きのグラフ。 プラス記号( 改行を強制するには、パイプ文字(
|
![]() chtt=Site+visitors+by+month| |
20 ポイントの青色の右揃えのタイトルグラフ。 |
![]() chtt=Site+visitors |
グラフの凡例のテキストとスタイル chdl
、chdlp
、chdls
(すべてのグラフ)
凡例はチャートのサイド セクションで、各系列に関する簡単な説明が表示されます。この凡例の各系列に関連付けるテキストを指定し、グラフ上でそのテキストを表示する場所を指定できます。
凡例の周囲にマージンを設定する方法については、chma
もご覧ください。
文字列値に関する注意: ラベルの文字列には URL セーフ文字のみを使用できます。安全のために、文字セット 0-9a-zA-Z
にない文字を含む文字列はすべて URL エンコードする必要があります。URL エンコーダについては、Google の可視化に関するドキュメントをご覧ください。
構文
chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>
chdl
- 凡例に表示する各系列のテキスト。
- <data_series_label>
- 凡例のエントリのテキスト。各ラベルは、
chd
配列内の対応するシリーズに適用されます。スペースには + 記号を使用します。このパラメータを指定しない場合、グラフに凡例は表示されません。ラベル内の改行を指定する方法はありません。凡例は通常、凡例のテキストが保持されるように拡大され、グラフ領域は凡例に合わせて縮小されます。
chdlp
- [省略可] 凡例の位置と凡例のエントリの順序。<position> と <label_order> のいずれかまたは両方を指定できます。両方を指定する場合は、バー文字で区切ります。凡例で chdl
内の空の凡例エントリをスキップする場合は、任意の値に「s」を追加できます。例: chdlp=bv
、chdlp=r
、chdlp=bv|r
、chdlp=bvs|r
- <opt_position>
- (省略可): グラフ上の凡例の位置を指定します。凡例とグラフ領域または画像の境界の間に追加のパディングを指定するには、
chma
パラメータを使用します。次のいずれかの値を選択します。b
- 凡例。グラフの下部に表示されます。凡例のエントリは横一列に並べられます。bv
- 凡例はグラフの下部に配置し、凡例のエントリは縦一列に並べます。t
- 凡例をグラフの一番上に配置し、凡例のエントリを横一列に並べます。tv
- 凡例をグラフの一番上に配置し、凡例のエントリを縦一列に並べます。r
- [デフォルト] 凡例はグラフの右側に、凡例のエントリは縦一列に並べられます。l
- 凡例をグラフの左側に配置し、凡例のエントリを縦一列に並べます。
- <opt_label_order>
- (省略可)凡例に表示されるラベルの順序。次のいずれかの値を選択します。
l
- [縦長の凡例のデフォルト]chdl
で指定された順序でラベルを表示します。r
-chdl
と逆の順序でラベルを表示します。これは、積み上げ棒グラフで棒が表示されるのと同じ順序で凡例を表示する場合に便利です。a
- [水平凡例のデフォルト] 自動順序付け: おおよそ、10 ピクセル ブロックで測定して、長さの短い順に並べ替えます。2 つの要素が同じ長さ(10 ピクセル ブロックに分割)の場合、リストにある要素が最初に表示されます。0,1,2...
- カスタムラベルの順序。これは、chdl
のゼロベースのラベル インデックスをカンマで区切ったリストです。
chdls
- (省略可): 凡例のテキストの色とフォントサイズを指定します。
- <color>
- 凡例のテキストの色(RRGGBB の 16 進数形式)。
- <size>
- 凡例テキストのポイントサイズ。
例
説明 | 例 |
---|---|
凡例の 2 つの例。凡例のテキストはデータ系列と同じ順序で指定します。 |
chdl=NASDAQ|FTSE100|DOW
chdl=First|Second|Third |
1 つ目のグラフは横方向の凡例エントリ( |
|
この例では、フォントサイズを変更する方法を示します。 |
|
グラフのマージン chma
[すべてのグラフ]
グラフの余白のサイズをピクセル単位で指定できます。マージンは、指定されたグラフサイズ(chs
)から内側に計算されます。マージンサイズを大きくしても、グラフの合計サイズは拡大せず、必要に応じてグラフ領域を縮小します。
デフォルトでは、グラフサイズが計算された後の余白が余白になります。このデフォルト値は、グラフの種類によって異なります。指定する余白は最小値です。グラフ領域に余白がある場合は、余白のサイズがそのまま適用されます。凡例やラベルに必要な余白よりも小さくすることはできません。次の図は、グラフの基本部分を示しています。
![]() |
グラフのマージンには、軸ラベルと凡例領域が含まれます。凡例の領域は、テキストがぴったり収まるように自動的にサイズ変更されます。ただし、 ヒント: 棒グラフでは、棒のサイズが固定されている場合(デフォルト)、グラフ領域の幅を減らすことはできません。 |
構文
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- <left_margin>、<right_margin>、<top_margin>、<bottom_margin>
- グラフ領域の周囲の最小マージンサイズ(ピクセル単位)。軸ラベルがグラフの境界と重ならないように、この値を大きくしてパディングを追加します。
- <opt_legend_width>、<opt_legend_height>
- (省略可)凡例の周囲のマージンの幅(ピクセル単位)。 これを使用して、凡例がグラフ領域や画像の端に接触しないようにします。
例
説明 | 例 |
---|---|
この例では、グラフの各辺の最小余白は 30 ピクセルです。グラフの凡例の幅が 30 ピクセルを超えているため、右側のマージンはグラフの凡例の幅に設定され、他のマージンとは異なります。 軸ラベルはプロット領域の外側にあるため、マージン空間内に描画されます。 |
|
凡例の周囲にマージンを追加するには、 この例では、凡例の幅は約 60 ピクセルです。 |
|
軸のスタイルとラベル [線、棒、Google メーター、レーダー、散布図]
グラフに表示する軸を指定し、カスタムラベル、位置、範囲、スタイルを設定できます。
デフォルトでは、すべてのグラフに軸線が表示されるわけではありません。chxt
パラメータを使用して、グラフに表示する軸を正確に指定できます。デフォルトの軸の線には数値は表示されません。数値を表示するには、chxt
パラメータで軸を指定する必要があります。
データ値を反映した数値を軸に表示することも、カスタム軸を指定することもできます。デフォルトでは、0 ~ 100 の範囲にスケーリングされた数値が表示されます。ただし、chxr
を使用して範囲を変更し、任意の範囲を表示できます。また、chxs
を使用して値のスタイルを設定できます(通貨記号や小数点以下の桁数など)。
カスタム値(「Mon, Tues, Wed」など)を使用する場合は、chxl
パラメータを使用できます。これらのラベルを軸の特定の位置に配置するには、chxp
パラメータを使用します。
最後に、chxs
パラメータと chxtc
パラメータを使用して、カスタム軸ラベルと数値軸ラベルの両方について、色、サイズ、配置などのプロパティを指定できます。
文字列値に関する注意: ラベルの文字列には URL セーフ文字のみを使用できます。安全のために、文字セット 0-9a-zA-Z
にない文字を含む文字列はすべて URL エンコードする必要があります。URL エンコーダについては、Google の可視化に関するドキュメントをご覧ください。
このセクションでは、次のトピックについて説明します。
- 可視軸(
chxt
)- 表示する軸。 - 軸の範囲(
chxr
)- 各軸の値の範囲。 - カスタムの軸ラベル(
chxl
)- 軸に表示するカスタム値。 - 軸ラベルの位置(
chxp
)- 各軸上のカスタムラベルの配置。 - 軸ラベルのスタイル(
chxs
) - 軸ラベルの色、サイズ、配置、形式。 - 軸の目盛りのスタイル(
chxtc
)- 特定の軸の目盛りの長さ。
軸の表示 chxt
棒グラフ、折れ線グラフ、レーダー チャート、散布図には、デフォルトで 1 本または 2 本の軸線が表示されますが、これらの線に値は含まれません。軸線に値を表示する、または表示する軸を変更するには、chxt
パラメータを使用する必要があります。デフォルトでは、chxr
プロパティを使用して明示的にスケーリングしない限り、軸の値の範囲は 0 ~ 100 です。折れ線グラフのすべての軸線を非表示にするには、cht
パラメータのグラフタイプの値の後に :nda
を指定します(例: cht=lc:nda
)。
デフォルトでは、上下の軸には値の目盛りが表示されず、左右の軸には目盛りが表示されます。この動作を変更するには、chxs
パラメータを使用します。
構文
chxt= <axis_1> ,..., <axis_n>
- <axis>
- グラフに表示する軸。使用できる軸は次のとおりです。
x
- 下の X 軸t
- 上部の X 軸 [Google-o-Meter ではサポートされていません]y
- 左 Y 軸r
- 右 Y 軸 [Google-o-Meter ではサポートされていません]
同じタイプの複数の軸を指定できます(例: cht=x,x,y
)。これにより、グラフの下部に沿って 2 組の X 軸が積み重ねられます。これは、数値を示す軸に沿ってカスタムラベルを追加する場合に便利です(以下の例を参照)。軸は内側から外側に描画されるため、x,x
とすると、最初の x は最も内側のコピーを参照し、次の x は次の外側コピーを参照するというように続きます。
例
説明 | 例 |
---|---|
この例は、X 軸、Y 軸、上軸(t)、右軸(r)を持つ折れ線グラフを示しています。 ラベルが指定されていないため、グラフではすべての軸でデフォルトで 0 ~ 100 の範囲に設定されます。 デフォルトでは、上下の軸にはラベルの目盛りは表示されません。 |
|
同じ値を複数回指定することで、各軸に複数のラベルセットを含めることができます。この例では、2 組の x と 2 組の Y 軸が示されています。ここに示すように、デフォルトの軸ラベルのみを使用する場合、これは特に有用ではありません。ただし、chxl パラメータを使用すると、各軸のコピーごとにカスタムラベルを指定できます。 |
<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x1" />5"t=xy,x1" <img <code="" dir="7 "x-H = 0,000,000,000,000 |
この例では、X 軸、Y 軸、上 T 軸、右の R 軸がある横棒グラフを示しています。 軸ラベルは省略されているため、Chart API では X 軸と T 軸に 0 ~ 100 の範囲が表示されます。 Y 軸と R 軸の範囲はバーの数で決まります。この例では、5 本の棒があるので、Chart API によって 0 ~ 4 の範囲が表示されます。最初のラベルは最初の棒の底部に中央揃えされ、2 番目のラベルは 2 番目の棒の底部に中央揃えされます。 |
|
折れ線グラフのデフォルトの軸を非表示にするには、グラフの種類の後に :nda を指定します。 |
![]() cht=lc:nda |
軸の範囲 chxr
chxr パラメータを使用すると、各軸に表示される値の範囲を個別に指定できます。この操作によって変更されるのは、グラフ要素のスケールではなく 、軸ラベルのスケールのみです。軸番号が実際のデータ値を表すようにするには、<start_val> と <end_val> をそれぞれデータ形式の範囲の最小値と最大値に設定します。詳しくは、軸のスケーリングをご覧ください。
軸の範囲を指定する場合は、chxt
パラメータを使用して軸を表示させる必要があります。
カスタム軸の値を指定するには、chxl
パラメータを使用します。
構文
複数の軸ラベルの範囲は、パイプ文字(|
)を使用して区切ります。
chxr= <axis_index>,<start_val>,<end_val>,<opt_step> |...| <axis_index>,<start_val>,<end_val>,<opt_step>
- <軸番号>
- ラベルを適用する軸。
chxt
で指定された軸配列に対するゼロベースのインデックスです。たとえばchxt=x,r,y
では R 軸は 1 になります。 - <start_val>
- この軸の下限を定義する数値。
- <end_val>
- この軸の最大値を定義する数値。
- <opt_step>
- (省略可): 軸の目盛りの歩数をカウントします。デフォルトのステップ値はありません。ステップは、間隔を空けた一連のラベルを表示するように計算されます。
例
説明 | 例 |
---|---|
この例では、左右の Y 軸( 各軸には定義された範囲があります。ラベルや位置が指定されていないため、値は指定された範囲から取得され、その範囲内で均等に配置されます。折れ線グラフでは、値は X 軸に沿って均等に分散されます。 最初の値( |
|
この例では、X 軸に値が指定されています。 軸ラベルは、軸に沿って均等に配置されます。<opt_step> パラメータには値 5( |
|
カスタムの軸ラベルchxl
chxl
パラメータを使用して、任意の軸にカスタム文字列の軸ラベルを指定できます。ラベルはいくつでも指定できます。chxt
パラメータを使用して軸を表示し、カスタムラベルを指定しない場合、標準の数値ラベルが適用されます。カスタムの数値範囲を指定するには、代わりに chxr
パラメータを使用します。
ラベルの軸に沿った特定の位置を設定するには、chxp
パラメータを使用します。
構文
ラベルを付ける軸ごとに 1 つのパラメータ セットを指定します。パイプ文字(|
)を使用して、複数のラベルセットを区切ります。
chxl= <axis_index>:|<label_1>|...|<label_n> |...| <axis_index>:|<label_1>|...|<label_n>
- <軸番号>
- ラベルを適用する軸。これは、
chxt
パラメータ配列に対するインデックスです。たとえば、chxt=x,x,y,y
の場合、インデックス 0 が最初の X 軸、1 が 2 番目の X 軸になります。 - <ラベル 1>| ... |<ラベル_n>
- この軸に沿って配置する 1 つ以上のラベル。値には文字列または数値を指定できます。文字列を引用符で囲む必要はありません。label_1 は軸の最下部に、label_n は最上部に表示されます。追加のラベルは等間隔に配置されます。スペースには + 記号を付けます。ラベル内の改行を指定する方法はありません。ラベルはパイプ文字で区切ります。注:
chxl
パラメータの最後のラベルの後にパイプを配置しないでください。
例
説明 | 例 |
---|---|
このグラフは、2 つの軸にカスタムラベルを追加する方法を示しています。値が均等に配置され、最後の |
![]() chxt=x,y |
この例では、左右の Y 軸( |
|
この例では、左右の Y 軸( この例では、左側の Y 軸の軸ラベルにデフォルト値を使用します。 |
|
汎用のラベルを追加して軸全体を説明する場合(たとえば、ある軸に「費用」と別の「生徒」というラベルを付ける場合は、 |
![]() chxt=x,x,y,y |
軸ラベルの位置 chxp
表示する軸ラベルを指定できます。デフォルトのラベルを使用することも、chxl
を使用して指定したカスタムラベルを使用することもできます。このパラメータで正確な位置を指定しない場合、ラベルは軸に沿って均等に、デフォルトのステップ値で配置されます。chxl
を指定しない場合、目盛りのラベルはデフォルト値(通常はデータ値、または棒グラフの棒番号)になります。
構文
複数のポジショニング セットは、パイプ文字(|
)を使用して区切ります。
chxp= <axis_1_index>,<label_1_position>,...,<label_n_position> |...| <axis_m_index>,<label_1_position>,...,<label_n_position>
- <軸番号>
- 位置を指定する軸。これは、
chxt
パラメータ配列に対するインデックスです。たとえば、chxt=x,x,y,y
の場合、インデックス 0 が最初の X 軸、1 が 2 番目の X 軸、というように続きます。 - <label_1_position>,...,<label_n_position>
- : 軸に沿ったラベルの位置。これは数値のカンマ区切りリストです。各値は
chxl
配列内の対応するラベルの位置を設定します。最初のエントリが最初のラベルに適用されるというように続きます。位置は、その軸の範囲内の値です。chxr
を使用してカスタム範囲を指定しない限り、これは常に 0 ~ 100 になります。その軸のラベルと同じ数の位置を指定する必要があります。
例
説明 | 例 |
---|---|
この例では、グラフ上の指定された位置に R 軸のラベルが含まれています。ラベルのテキストは、 位置が 位置が |
|
この例では、デフォルトのラベル値を示していますが、指定した位置にのみ表示されます。
|
chxt=x,y
![]() chxt=x,y chxp が指定されていません |
軸ラベルのスタイル chxs
軸ラベルには、カスタムラベルとデフォルトのラベル値の両方に、フォントサイズ、色、配置を指定できます。同じ軸上のラベルはすべて同じ形式になります。軸のコピーが複数ある場合は、それぞれを異なる形式にできます。通貨記号や末尾のゼロの表示など、ラベル文字列の形式を指定することもできます。
デフォルトでは、上下の軸には値の目盛りが表示されず、左右の軸には目盛りが表示されます。
構文
複数の軸の値は、パイプ文字(|
)で区切る必要があります。
chxs= <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color> |...| <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
- <軸インデックスaxis_index>
- これが適用される軸。これは、
chxt
パラメータに対するゼロベースのインデックスです。 - <opt_format_stringopt_format_string>
- (省略可)これは省略可能な形式文字列です。使用する場合は、軸のインデックス番号の直後に指定します。カンマを間に入れません。リテラル文字 N で始まり、その後に次の値が続きます。
N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
各要素の意味は次のとおりです。<preceding_text>
- 各値の前にあるリテラル テキスト。*...*
- リテラル アスタリスクで囲まれたオプションのブロック。ここで数値の書式設定の詳細を指定できます。次の値を使用できます(すべて省略可能)。<number_type>
- 数値の形式。次のいずれかを選択します。f
- [デフォルト] 浮動小数点形式。<decimal_places> 値でも精度を指定することを検討してください。p
- 割合の形式。% 記号が自動的に付加されます。注: この形式を使用する場合、0.0 ~ 1.0 のデータ値は 0 ~ 100% にマッピングされます(たとえば、0.43 は 43% と表示されます)。e
- 科学的記数の形式。c<CUR>
- 適切な通貨マーカーを使用して、指定された通貨で数値を書式設定します。<CUR>
は、3 文字の通貨コードに置き換えます。例: ユーロの場合はcEUR
。コードのリストは ISO のウェブサイトで確認できますが、すべての記号がサポートされているわけではありません。
<decimal_places>
- 表示する小数点以下の桁数を指定する整数。値はこの長さに丸められます(切り捨てられない)。デフォルトは 2 です。z
- 末尾のゼロを表示します。デフォルトは no です。s
- グループ セパレータを表示します。デフォルトは no です。x
またはy
- 指定された x 座標または y 座標のデータを表示します。x データの意味はグラフの種類によって異なります。グラフを試して、その意味を判断します。デフォルトは「y」です。
<following_text>
- 各値に続くリテラル テキスト。
- <opt_label_color>
- 軸のテキスト(軸線ではない)に適用する色。RRGGBB の 16 進形式で指定します。軸の線の色は、opt_axis_color を使用して別途指定します。デフォルトはグレーです。
- <opt_font_size>
- (省略可): フォントサイズをピクセル単位で指定します。このパラメータは省略可能です。
- <opt_alignment>
- (省略可): ラベルの配置。上下の軸の場合は、その上下の目盛りにラベルを合わせる方法を示し、左右の軸の場合は、境界ボックス内で軸に接触する位置揃えを示します。次のいずれかの数値を指定します。
-1
- 上または下: ラベルは目盛りの右側に配置されます。左または右: ラベルは領域内で左揃えに配置されます。R 軸のラベルのデフォルト。0
- 上または下: ラベルは目盛りの中央に配置されます。左または右: ラベルは領域内で中央に配置されます。X 軸と T 軸のラベルのデフォルト。1
- 上または下: ラベルは目盛りの左側にあります。左または右: ラベルは領域内で右揃えになります。Y 軸のラベルのデフォルトです。
- <opt_axis_or_tick>
- [省略可。Google メーターでサポートされていません] この軸の目盛りや軸線を表示するかどうかを指定します。目盛りと軸線は最も内側の軸でのみ使用できます(たとえば、2 つの X 軸のうち外側の軸ではサポートされていません)。次のいずれかの値を使用します。
l
(小文字の「L」) - 軸線のみを描画します。t
- 目盛りのみを描画します。目盛りは軸ラベルの横にある小さな線です。lt
- [デフォルト] すべてのラベルについて、軸線と目盛りの両方を描画します。_
- (アンダースコア)軸線も目盛りも描画しません。軸線を非表示にする場合は、この値を使用します。
- <tick_color>
- [省略可。Google メーターでサポートされていません] 目盛りの色(RRGGBB の 16 進数形式)。デフォルトはグレーです。
- <opt_axis_color>
- (省略可)この軸線の色。RRGGBB の 16 進数形式で指定します。デフォルトはグレーです。
例
説明 | 例 |
---|---|
2 番目の X 軸(1 月、2 月、3 月)のフォントサイズと色が指定されています。 |
|
右側の Y 軸のフォントサイズ、色、配置が指定されています。目盛りは描画されますが、軸線は描画されません。 |
|
このグラフには 3 つのデータセットがあり、系列ごとに 1 つずつ、3 セットの軸ラベルが表示されています。ラベルの各セットは、カスタム書式設定文字列を使用して書式設定されます。
軸ラベルの範囲は、 |
![]() chd=s: |
軸の目盛りのスタイル chxtc
特定の軸に対して長い目盛りを指定できます。通常、これはグラフの長さ全体に目盛りを延長するために使用されます。目盛りの色を変更するには、chxs
パラメータを使用します。
複数の軸の値は、パイプ文字(|
)を使用して区切ります。系列内の値はカンマで区切る必要があります。
構文
chxtc= <axis_index_1>,<tick_length_1>,...,<tick_length_n> |...| <axis_index_m>,<tick_length_1>,...,<tick_length_n>
- <軸インデックスaxis_index>
- これが適用される軸。これは、
chxt
パラメータに対するゼロベースのインデックスです。複数の軸の値は、バー区切り文字を使用して区切ります。 - <tick_length_1>,...,<tick_length_n>
- 軸上の目盛りの長さ(ピクセル単位)。単一の値を指定すると、その値がすべての値に適用されます。複数の値が指定されている場合、軸の目盛りは、その軸の値のリストの中で順繰りに表示します。正の値はグラフ領域の外側に描画され、グラフの枠線で切り抜かれます。正の最大値は 25 です。負の値はグラフ領域内に描画され、グラフ領域の枠線で切り抜かれます。
例
説明 | 例 |
---|---|
|
|
このグラフは、目盛りの長さを交互に示しています。chxtc は、y 軸の 2 つの目盛りの長さ値(5 と 15)を指定します。グラフに描画される目盛りはその 2 つの値を交互に表示します。 |
![]() chxt=x,y |
背景塗りつぶし chf
[すべてのグラフ]
グラフのデータ領域やグラフの背景全体の塗りつぶしの色とスタイルを指定できます。塗りつぶしタイプには、単色塗りつぶし、ストライプ塗りつぶし、グラデーションがあります。
領域ごとに異なる塗りつぶしを指定できます(たとえば、グラフ領域全体やデータ領域のみなど)。グラフ領域の塗りつぶしは、背景の塗りつぶしを上書きします。すべての塗りつぶしは chf
パラメータを使用して指定します。パイプ文字(|)で値を区切ることで、同じグラフ内にさまざまな塗りつぶしタイプ(単色、ストライプ、グラデーション)を混在させることができます。グラフ領域の塗りつぶしは、グラフの背景の塗りつぶしを上書きします。
ソリッド塗りつぶし chf
[すべてのグラフ]
背景やグラフ領域の単色塗りつぶしを指定するか、グラフ全体に透明度値を割り当てることができます。パイプ文字(|
)を使用して複数の塗りつぶしを指定できます(マップ: 背景のみ)。
構文
chf=<fill_type>,s,<color>|...
- <fill_typefill_type>
- グラフの塗りつぶし部分。次のいずれかの値を指定します。
bg
- 背景塗りつぶしc
- グラフ領域の塗りつぶし。マップグラフではサポートされていません。a
- グラフ全体(背景を含む)を透明にします。<color>
の最初の 6 桁は無視され、最後の 2 桁(透明度の値)のみがグラフ全体とすべての塗りつぶしに適用されます。b<index>
- 棒無地塗りつぶし(棒グラフのみ)。<index> をバーのシリーズ インデックスに置き換えて、単色で塗りつぶします。これは、棒グラフでchco
を指定する場合と同様です。例については、棒グラフの系列の色をご覧ください。
- s
- 塗りつぶし(塗りつぶし)を指定します。
- <color>
- 塗りつぶしの色(RRGGBB の 16 進数形式)。透明性を確保するため、最初の 6 桁は無視されますが、含めて含めてください。
例
説明 | 例 |
---|---|
この例では、グラフの背景が淡いグレー( |
|
この例では、グラフの背景を淡いグレー( |
|
この例では、グラフ全体に 50% の透明度を適用します(16 進数の 80 は 128、つまり約 50% の透明度です)。グラフの上にテーブルセルの背景が表示されます。 |
|
グラデーション塗りつぶし chf
[線、棒、Google メーター、レーダー、散布図、ベン]
グラフ領域や背景に、1 つ以上のグラデーション塗りつぶしを適用できます。グラデーション塗りつぶしは、ある色から別の色にフェードします。(円グラフ、Google メーターグラフ: 背景のみ)。
グラデーションの塗りつぶしごとに角度を指定し、指定された位置に固定された 2 つ以上の色を指定します。アンカーから別のアンカーに移動すると、色が変化します。一方がもう一方にフェードインできるように、異なる <color_centerpoint> 値を持つ色が少なくとも 2 つ必要です。追加のグラデーションはそれぞれ <color>、<color_centerpoint> のペアで指定されます。
構文
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- <fill_typefill_type>
- 塗りつぶしするグラフ領域。次のいずれかです。
bg
- 背景塗りつぶしc
- グラフ領域の塗りつぶし。b<index>
- 棒グラデーションの塗りつぶし(棒グラフのみ)。<index> は、グラデーションで塗りつぶすバーのシリーズ インデックスに置き換えます。例については、棒グラフの系列の色をご覧ください。
- lg
- グラデーション塗りつぶしを指定します。
- <angle>
- グラデーションの角度を 0(水平)~ 90(垂直)の範囲で指定する数値。
- <color>
- 塗りつぶしの色(RRGGBB の 16 進数形式)。
- <color_centerpoint>
- 色のアンカー ポイントを指定します。別のアンカーに近づくにつれて、この地点から色が徐々に消えていきます。値の範囲は 0.0(下端または左端)~ 1.0(上端または右端)で、<angle> で指定された角度で傾けられます。
例
説明 | 例 |
---|---|
グラフ領域には水平の線形グラデーションがあり、角度 0 度( 色は桃色( グラフの背景はグレー( |
|
グラフ領域には、45 度( 最初に指定された色は桃色( 青( グラフの背景はグレー( |
|
グラフ領域には、90 度( 最初に指定された色は青( 2 番目に指定されている色は桃色( グラフの背景はグレー( |
|
ストライプ塗りつぶし chf
[折れ線、棒、Google メーター、レーダー、散布図、ベン]
グラフ領域またはグラフ全体に、ストライプの背景塗りつぶしを指定できます。(円グラフ、Google メーターグラフ: 背景のみ)。
構文
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- <fill_typefill_type>
- 塗りつぶしするグラフ領域。次のいずれかです。
bg
- 背景塗りつぶしc
- グラフ領域の塗りつぶしb<index>
- 棒ストライプ塗りつぶし(棒グラフのみ)。<index> は、ストライプで塗りつぶすバーのシリーズ インデックスに置き換えます。例については、棒グラフの系列の色をご覧ください。
- ls
- 線形ストライプ塗りつぶしを指定します。
- <angle>
- すべてのストライプの角度(Y 軸を基準とする相対角度)。縦方向のストライプには
0
、横方向のストライプには90
を使用します。 - <color>
- このストライプの色。RRGGBB の 16 進形式で指定します。ストライプごとに <color> と <width> を繰り返します。ストライプが少なくとも 2 つ必要です。グラフが塗りつぶされるまでストライプが交互に表示されます。
- <width>
- このストライプの幅(
0
~1
)。1
はグラフ全体の幅です。ストライプは、グラフが塗りつぶされるまで繰り返されます。ストライプごとに <color> と <width> を繰り返します。ストライプが少なくとも 2 つ必要です。グラフが塗りつぶされるまでストライプが交互に表示されます。
例
説明 | 例 |
---|---|
|
![]() chf= |
|
![]() chf= |
線塗りつぶし chm
[線、レーダー]
データ線の下の領域を単色で塗りつぶすことができます。
パイプ文字(|
)を使って chm
パラメータを区切ることで、線塗りつぶしを他の chm
パラメータと組み合わせることができます。
構文
chm= <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0> |...| <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
- <b_or_B>
- グラフの一番下まで塗りつぶすか、下の線だけまで塗りつぶすかを指定します。
- B -
<start_line_index>
からグラフの下部まで塗りつぶします。<end_line_index>
は、グラフのセグメントを塗りつぶすための特別な構文をサポートしています。塗りつぶししたい線が 1 本のグラフの場合、この方法が最も簡単です。 - b - 複数折れ線グラフで 2 本の線の間に塗りつぶします。開始線と終了線は
<start_line_index>
と<end_line_index>
で示されます。
- B -
- <color>
- 塗りつぶしの色を表す RRGGBB 形式の 16 進数。
- <start_line_indexstart_line_index>
- 塗りつぶしを開始する線のインデックス。
chd
で指定された最初のデータ系列にはゼロ(0
)のインデックス、2 番目のデータ系列には1
というインデックスが付きます。 - <end_line_indexend_line_index>
-
- 塗りつぶしタイプ「b」 - 塗りつぶしを終了する線。この行は、現在の行より下である必要があります。
- 入力タイプ
「B」 - 次のいずれかを選択します。
- 任意の値 - このパラメータ内の数値は無視され、指定した線からグラフの底辺まで塗りつぶされます。
- start:end - グラフの下の垂直スライスを塗りつぶすには、start:end を指定します。これは、塗りつぶしの開始位置と終了位置を示すデータポイント インデックスです。どちらの値もオプションで、デフォルトは first_point:last_point です。(下記の例をご覧ください)。
- <0>
- 予約済み - ゼロにする必要があります。
例
説明 | 例 |
---|---|
シリーズが 1 つの場合は、 レーダー チャートで使用できる塗りつぶしエリアのタイプは、これだけです。 |
|
2 つの線と 2 つの塗りつぶしがあるグラフを以下に示します。最下線より下の領域と一番上の線より上の領域を塗りつぶすには、特別な手法が必要です。これについては、次に説明します。 |
|
複数系列グラフでグラフの上部から最初の線までを塗りつぶすには、そのデータ形式の最大データ値の 2 つのコピーを含む系列を含めます。たとえば、拡張エンコードの場合は「 最後の線からグラフの下部までを塗りつぶすには、そのデータ形式の最小データ値の 2 つのコピーを含む系列を含めます。たとえば、拡張エンコードの場合は AAAA、基本テキスト形式の場合は 0,0 などです。 線自体は、 |
![]() chd=e: (最大値) (ゼロ値)chm= (水色) b,224499,1,2,0| (青) b,FF0000,2,3,0| (赤) b,80C65A,3,4,0 (緑)chco=000000 |
これは、垂直方向の塗りつぶしスライスを使用した折れ線グラフです。そのためには、<end_line_index> に線塗りつぶしタイプ「B」の start:end ペアを指定します。
|
![]() chm= |
レーダー チャートで折れ線の塗りつぶしを使用する例を次に示します。 |
![]() chm= |
グリッド線 chg
[線、棒、レーダー、散布図]
chg
パラメータを使用して、グラフに実線または点線のグリッド線を指定できます。
このパラメータでは、線の太さや色を指定することはできません。グラフ全体に線を引くその他の方法については、シェイプ マーカー(chm
で h、H、V、V をタイプする)や、範囲マーカー(chm
)、軸の目盛り(chxtc
)をご覧ください。
構文
chg= <x_axis_step_size>,<y_axis_step_size>,<opt_dash_length>,<opt_space_length>,<opt_x_offset>,<opt_y_offset>
- <x_axis_step_size>、<x_axis_step_size>
- グラフに表示する X または Y のグリッド線の数を計算するために使用します。100 / step_size = グラフ上のグリッド線の数したがって、20,25 は垂直グリッド線 5 本と水平グリッド線 4 本を意味します。
- <opt_dash_length>、<opt_space_length>
- (省略可): 破線のグリッド線を定義するために使用します。最初のパラメータは、各線の破線の長さ(ピクセル単位)です。2 つ目のパラメータは、ダッシュの間隔(ピクセル単位)です。実線の場合、<opt_space_length> に 0 を指定します。デフォルト値は 4、1 です。
- <opt_x_offset>,<opt_y_offset>
- (省略可)x グリッド線と y グリッド線をオフセットする、グラフのスケールに応じた単位数。正または負の値を指定できます。この値を指定する場合は、先行する値もすべて指定する必要があります。デフォルト値は 0,0 です。
例
説明 | 例 |
---|---|
これらの例では、 |
![]() chg=20,50 ![]() chg=20,50 |
この例では、大きなスペースを使用して、より明るいグリッド線( |
![]()
|
実線のグリッド線を表示するには、 また、このグラフでは X 軸のオフセットを 10 に指定しています。 |
![]() chg=20,50,1,0,10 |
このグラフは、X 軸のオフセットが 10、Y 軸のオフセットが 20 を示しています。 |
![]() chg=20,50,3,3,10,20 |
ダイナミック アイコン マーカー chem
[棒、線、レーダー、散布図]
グラフを作成し、1 つ以上の動的アイコンを chem 値として指定します。chem
の構文は次のとおりです。セミコロンで区切られた紫色の項目はすべて省略可能で、URL 内でその項目を完全に省略できます。複数のマーカーを指定する場合は、「|」文字で区切って複数の構文文字列を指定します。動的アイコンの詳細については、動的アイコンのページをご覧ください。
また、グラフを動的なアイコンとして別のグラフに埋め込むこともできます。以下の埋め込みグラフのサブセクションをご覧ください。
chem= y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
|...| y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
- s=<アイコンの文字列定数icon_string_constant>
- 動的アイコンのページにある動的アイコンの文字列マーカー定数。この定数は、独立型アイコンの
chst
パラメータとほぼ同じです。ただし、独立型アイコン文字列が「d_」で始まる場合は、同等の動的アイコン マーカーを取得するためにこの接頭辞を削除する必要があります。例: 独立型アイコン:d_bubble_icon_text_small
、同等の動的アイコン マーカー:bubble_icon_text_small
- d=<マーカーデータの文字列marker_data_string>
- このマーカー タイプに必要なデータ。この文字列は、同等の独立アイコンの
chld
パラメータで使用されるものと同じ文字列を保持します。ただし、 すべての区切り文字はカンマに置き換える必要があります(複数行のテキストにはパイプ マーカーの代わりにカンマを使用することに注意してください)。データ文字列内では、パイプ(|)、アットマーク(@)、イコール(=)、カンマ(,)、セミコロン(;)(例:hello@,+world
、5@@10+cents+each
)。 - ds=<which_series>
- (省略可): このマーカーが属するデータ系列のゼロベースのインデックス。デフォルト値は 0 です。
- dp=<which_points>
- (省略可): マーカーの描画に使用するデータポイントを指定します。デフォルト値は 0(シリーズの最初の点)です。次のいずれかの形式で指定してください。
n.d
- マーカーを描画するデータポイント。n.d は系列内のゼロベースのインデックスです。整数以外の値を指定した場合、小数は計算された中間点を示します。たとえば、3.5 はポイント 3 とポイント 4 の中間を意味します。range,<start>,<end>,<step>
- start から end までの範囲(両端を含む)のすべての step データポイントにマーカーを描画します。start と end はインデックス値で、中間値を示す浮動小数点数にすることもできます。値はすべて省略可能で、デフォルトは start=0、end=last item、step=1 です。値をスキップする場合も中間のカンマを含める必要がありますが、末尾の空のカンマを含める必要はありません。例:dp=range,0,4
は、要素 0 ~ 4 にマーカーを描画します。dp=range,5,10,2
は、要素 5、7、9 にマーカーを描画します。dp=range,2
は、3 番目の点以降にポイントを描画します。dp=range,3,,1.5
は、4 番目のアイテムから最後のアイテムまで 1.5 データポイントごとにマーカーを描画します。all
- すべての要素にマーカーを描画します。これはrange,0,end_index
と同じです。例:dp=all
every,n
- n 番目のマーカーごとにマーカーを描画します。例:dp=every,2
は、アイテム 0、2、4 にマーカーを描画します。
- py=<z_order>
- (省略可)マーカーを描画するレイヤ(他のマーカーおよび他のすべてのグラフ要素との比較)。これは -1.0 から 1.0 までの浮動小数点数です。-1.0 は底、1.0 は上です。グラフ要素(線と棒)はゼロのすぐ下に表示されます。2 つのマーカーが同じ値を持つ場合、URL で指定された順序で描画されます。デフォルト値は 0.0(グラフ要素のすぐ上)です。
- po=<x,y>
- (省略可)マーカーを描画するグラフ上の絶対位置。x と y は 2 つの浮動小数点数で、0.0,0.0 は左下隅、1.0,1.0 は右上隅です。
- of=<x_offset,y_offset>
- (省略可)アイコンを通常の位置からオフセットするピクセル数。x_offset と y_offset は、正または負の整数です。埋め込みダイナミック アイコンではこの値を指定することが重要です。マーカーはポイントの垂直方向および水平方向の中央に配置されます。つまり、ポイントはデータマーカーと位置が合わない可能性があります。直立したピンの適切なオフセットは
of=0,22
です。傾斜したピンの適切なオフセットは、傾斜の方向に応じてof=-12,20
またはof=12,20
ですが、テストが必要になる場合があります。デフォルト値は 0,0 です。
例
説明 | 例 |
---|---|
同じダイナミック アイコンを独立した画像として作成し、折れ線グラフでマーカーとして使用する例を次に示します。 グラフ 1: グラフ 2: |
|
動的アイコン マーカーは、ポイントを水平方向と垂直方向に中央揃えで配置します。そのため、テールがある動的アイコンを使用する場合、テールはグラフ ポイント上ではなく、マーカーの中心に配置されます。 最初のグラフでは、データポイント 3 をマークの中心にして、テールが線上のマークの少し右側に配置されています。 2 つ目のグラフでは、 |
![]() chem=y;
chem=y; |
複数の動的アイコンを含めるには、| 文字で区切って構文文字列を繰り返します。 この例では、範囲と 2 つの個別のマーカーを示しています。 垂直方向のピンのオフセットは 0,22 で、傾斜したピンのオフセットは 12,20 です。これにより、ピンのポイントと対象の系列が揃います。 |
![]() chem= |
これは複数行のテキスト マーカーを示しています。マーカーはテキストを追加した後にオフセットする必要があります。これは、バブルがテキストに合わせてサイズ変更され、グラフの中心が再表示されるためです。テキスト内の改行は、d データ文字列ではカンマによってどのように示されるかに注意してください。 |
![]() chem=y; |
埋め込みグラフ
動的アイコンの構文を使用すると、グラフを別のグラフの中に埋め込むことができます。
埋め込みグラフのマーカーには、バブル内の埋め込みグラフと、バブルなしの埋め込みグラフの 2 つのスタイルがあります。以下に例を示します。
![]() |
![]() |
グラフとバブル |
バブルなしのグラフ |
バブル以外のグラフと埋め込みグラフの両方について、s=<icon_string_constant>;d=<marker_data_string>
パラメータの詳細を以下に示します(上記のパラメータはここでは説明しません)。
構文
Non-bubble: chem=y;s=ec;d=<alignment_string>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset> Bubble: chem=y;s=ecb;d=<frame_type>,<padding>,<frame_color>,<fill_color>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>
- alignment_string
- [バブル以外の場合] バブルなしの埋め込みグラフのどの部分がデータポイントに固定されるか。次の図の 2 文字の文字列定数のいずれかを選択します。
- chart_data
- 埋め込みグラフのデータ。埋め込むグラフの URL の
https://chart.googleapis.com/chart?
より後のすべての部分です。以下のツールを使用するか、ツールの下のルールに従ってください。 - frame_type
- [バブルのみ] ダイナミック アイコンのフレーム スタイル定数のいずれか。
- パディング
- [バブルのみ] バブル内のパディング(ピクセル単位)。
- frame_color
- [バブルのみ] フレームの色。6 桁の HTML カラー文字列で、# 記号は付けません。例:
FF00FF
- fill_color
- [バブルのみ] バブルの塗りつぶしの色。# 記号なしの 6 桁の HTML カラー文字列で指定します。例:
FF00FF
埋め込みグラフデータ
次の変換ツールを使用して、グラフの文字列を生成するか、ツールの後に指定したルールに従って、グラフの文字列を手動で生成します。
手動変換のルール
1. まず、パラメータと値のペアの次の文字をすべて次の値に置き換えます。
次のように置き換えます。 | こちらの |
---|---|
%7C または %7c |
| |
@ |
@@ |
% |
%25 |
, |
@, |
| |
@| |
; |
@; |
& |
%26 |
= |
%3D |
2. 次に、parameter1=value1¶meter2=value2...
ペアのすべての &
値と =
値をカンマに置き換えます。
シェイプ マーカー chm
[棒、線、レーダー、散布図]
グラフ上のすべてまたは個々のデータポイントに、グラフィカル マーカーを指定できます。同じ点を占有する複数のマーカーがある場合、マーカーは chm
パラメータに指定される順序で描画されます。データポイントにテキスト マーカーを作成することもできます。これについては、データポイント マーカーをご覧ください。
パイプ文字(|
)を使用して、シェイプ マーカーを他の chm
パラメータと組み合わせることで、chm
パラメータを区切ることができます。
構文
マークするシリーズごとに、次のパラメータ セットのいずれかを指定します。複数のシリーズをマークするには、追加のパラメータ セットをパイプ文字で区切って作成します。すべてのシリーズをマークアップする必要はありません。データ系列にマーカーを割り当てなければ、マーカーは作成されません。
散布図では、シェイプ マーカーの動作が若干異なります。詳細については、該当するドキュメントをご覧ください。
chm= [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset> |...| [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
- @
- (省略可): マーカータイプの前にオプションの @ 記号を付ける場合、<opt_that_points> には x:y 形式を使用します。
- <marker_type>
- 使用するマーカーのタイプ。次のいずれかのタイプを指定します。
a
- 矢印c
- クロスC
- 長方形。長方形マーカーの場合は、少なくとも 2 つのデータ系列が必要です。系列 0 は下端、シリーズ 1 は上端を指定します。<size> は長方形の幅をピクセル単位で指定します。d
- ひし形E
- エラーバー マーカー() このマーカーを作成するには、2 つのデータ系列が必要です。1 つ目のデータは下部に、2 つ目の系列は上部に対応する点です。また、拡張された <size> 構文、line_thickness[:top_and_bottom_width] も公開されています。top_and_bottom_width は省略可能です。以下の例をご覧ください。
h
- 指定した高さにおけるグラフ上の水平線。(<opt_which_points> パラメータで有効な形式は opt_which_points のみです)。H
- 指定されたデータ マーカーを通る水平線。これにより、拡張された <size> 構文を使用して正確な線の長さを指定できます: line_thickness[:length] ここで :length は省略可能で、デフォルトはグラフ領域全体の幅です。o
- 円s
- 正方形v
- X 軸からデータポイントまでの垂直線V
- 長さを調整できる垂直線。これにより、拡張された <size> 値の構文を使用して、正確な線の長さを指定できます: line_thickness[:length] ここで、:length は省略可能で、デフォルトはグラフ領域全体の高さです。 マーカーは、データポイントの中央に配置されます。x
- X
- <color>
- : このシリーズのマーカーの色(RRGGBB の 16 進数形式)。
- <series_indexseries_index>
- : マーカーを描画するデータ シリーズのインデックス(ゼロベース)です。
h
マーカーや、x/y 位置(「@」で始まる)で位置を指定するマーカーでは無視されます。非表示のデータ系列をマーカーのソースとして使用できます。詳しくは、複合グラフをご覧ください。グループ化された縦棒グラフでは、マーカーを特定の棒に揃えるための特別な拡張構文がサポートされています。 - <opt_which_points>
- (省略可): マーカーを描画するポイント。デフォルトはすべてのマーカーです。次のいずれかの値を使用します。
n.d
- マーカーを描画する場所。意味は、マーカーのタイプによって異なります。- h を除くすべての型 - マーカーを描画するデータポイント。n.d は系列内のゼロベースのインデックスです。整数以外の値を指定した場合、小数は計算された中間点を示します。たとえば、3.5 はポイント 3 とポイント 4 の中間を意味します。
h
- 0.0 ~ 1.0 の数値。0.0 はグラフの最下部、1.0 はグラフの上部です。
-1
- すべてのデータポイントにマーカーを描画します。このパラメータを空のままにして、すべてのデータポイントの上に描画することもできます。-n
- n 番目のデータポイントごとにマーカーを描画します。浮動小数点値。n が 1 未満の場合、グラフによって追加の中点が計算されます。たとえば、-0.5 では、データポイントの 2 倍のマーカーを配置します。start:end:n
- start から end までのインデックス値(両端を含む)内の n 番目のデータポイントごとにマーカーを描画します。パラメータはすべて省略可能(存在しない場合もあります)であるため、3::1 は 4 番目の要素から最後のステップ 1 までとなります。このパラメータを完全に省略すると、デフォルトの first:last:1 になります。すべての値に浮動小数点数を指定できます。start と end は負の値にし、最後の値から後方にカウントします。start と end の両方が負の値の場合は、大きい方の値で列挙します(例: -6:-1:1)。n ステップの値が 1 未満の場合、与えられたデータ値を補間して追加のデータポイントを計算します。デフォルト値は first:last:1 ですx:y
- グラフ上の特定の x/y 点にマーカーを描画します。この点は直線上にある必要はありません。このオプションを使用するには、マーカータイプの前に @ 文字を追加します。座標を浮動小数点値として指定します。0:0
はグラフの左下隅、1:1
はグラフの右上隅です。たとえば、15 ピクセルの赤いひし形をグラフの中央に追加するには、@d,FF0000,0,0.5:0.5,15
を使用します。
- <size>
- : マーカーのサイズ(ピクセル単位)。ほとんどの場合、このパラメータは 1 つの数値を取ります。V、H、S マーカーは構文 <size>[:width] をサポートしています。2 番目の部分では、線またはマーカーの長さを指定します(省略可)。
- <opt_z_order>
- (省略可): マーカーを描画するレイヤ(他のマーカーおよび他のすべてのグラフ要素との比較)。これは -1.0 から 1.0 までの浮動小数点数です。-1.0 は底、1.0 は上です。グラフ要素(折れ線と棒)は 0 よりも小さいほどです。2 つのマーカーが同じ値を持つ場合、URL で指定された順序で描画されます。デフォルト値は 0.0(グラフ要素のすぐ上)です。
- <opt_offset>
- (省略可)指定した場所からの水平方向と垂直方向のオフセットを指定できます。構文は次のとおりです。区切り文字は「
reserved:<horizontal_offset>:<vertical_offset>
」を使用しています。指定すると、<opt_z_order> のchm
パラメータ文字列に空の値を含めることができます。例:o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
- reserved - 空白のままにします。
<horizontal_offset>
- 水平オフセットをピクセル単位で指定する正または負の数値。省略可。使用しない場合は空白のままにします。<vertical_offset>
- 垂直オフセットを指定する正または負の数値(ピクセル単位)。省略可。使用しない場合は空白のままにします。
例
説明 | 例 |
---|---|
シェイプとラインのマーカーの例をいくつか示します。
|
![]() chm= |
1 つのデータ系列でひし形を使用し、もう 1 つのデータ系列で円を使用する例を次に示します。 同じ点を占有する複数のマーカーがある場合、マーカーは |
![]() chm= |
次の折れ線グラフでは、データポイントごとにマーカーが配置されています(-2 は 1 日おきを意味します)。 |
![]() chd=t: |
次の折れ線グラフでは、マーカーの数がデータポイントの 2 倍になっています(-0.5 は半点ごとを意味します)。 | ![]() chd=t: |
この例では、h マーカーと v マーカーを使用して、カスタムの色と太さのグリッド線を作成する方法を示します。Z オーダーの値(最後の値)を -1 に設定して、グリッド線がデータ線の下に描画されるようにします。 |
![]() chm= |
次のグラフは、折れ線グラフに垂直方向の塗りつぶし線を追加します。
|
![]() chm= |
この例では、正確な座標を使用して矢印とテキスト マーカーをグラフに追加します。最初の D マーカーは棒の下にあるトレース線です。2 つ目のマーカーは矢印、3 つ目のマーカーは矢印のテキストです。 | ![]() chm= |
特定のデータポイント(H )に固定された水平線は、相対値を表示したり、グラフ上でデータ値の高さを強調したりする場合に役立ちます。 |
![]() chm=H,FF0000,0,18,1 |
このグラフは、<size> パラメータで線の太さと長さを指定できるマーカーを示しています。
|
title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,92,5,3,5,990066,09008033chm= |
テキストおよびデータ値マーカー chm
[棒、折れ線、レーダー、散布図]
グラフ上の特定のポイントに、カスタム テキスト、またはその時点でのデータの書式設定バージョンを使用してラベルを付けることができます。
パイプ文字(|
)を使って chm
マーカーを組み合わせると、chm
パラメータ セットを区切ることができます。
文字列値に関する注意: ラベルの文字列には URL セーフ文字のみを使用できます。安全のために、文字セット 0-9a-zA-Z
にない文字を含む文字列はすべて URL エンコードする必要があります。URL エンコーダについては、Google の可視化に関するドキュメントをご覧ください。
構文
マークするシリーズごとに、次のパラメータ セットのいずれかを指定します。複数のシリーズをマークするには、追加のパラメータ セットをパイプ文字で区切って作成します。すべてのシリーズをマークアップする必要はありません。データ系列にマーカーを割り当てなければ、マーカーは作成されません。
chm= <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement> |...| <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
- <marker_type>
- 使用するマーカーのタイプ。以下のタイプから選択できます。
f<text>
- テキストを含むフラグ。文字「f」に続けてカスタムの URL エンコード テキストを指定します。テキスト マーカーのカンマをエスケープするには、カンマの前に \ 記号を付けます。例:fHello\,+World!
t<text>
- 単純なテキスト マーカー。文字「t」に続けてカスタム URL エンコード テキストを指定します。テキスト マーカーのカンマをエスケープするには、カンマの前に \ 記号を付けます。例:tHello\,+World!
A<text>
- アノテーション マーカー。これは旗のマーカーに似ていますが、マーカーが重ならないように位置を調整します。<opt_which_points> は opt_which_points のみが有効で、系列内の点のインデックスを指定します。N<formatting_string>
- この時点でのデータの値。オプションで書式設定が可能です。chds
パラメータを使用しない場合(カスタム スケーリング)は、エンコードされた正確な値が提供されます。任意のフォーマット タイプでそのパラメータを使用すると、値は指定した範囲にスケーリングされます。数値マーカー付きのchds
の例を以下に示します。このマーカータイプを積み上げ棒グラフで使用する場合、<series_index> に -1 を指定すると、この積み上げ棒グラフのすべての値の合計を示すマーカーが表示されます。書式設定文字列の構文は次のとおりです。
<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
.
これらの要素はすべて省略可能です。各要素の意味は次のとおりです。<preceding_text>
- 各値の前にあるテキスト。*...*
- リテラル アスタリスクで囲まれたオプションのブロック。ここで数値の書式設定の詳細を指定できます。次の値を使用できます(すべて省略可能)。<number_type>
- 数値の形式。次のいずれかを選択します。f
- [デフォルト] 浮動小数点形式。<decimal_places> 値でも精度を指定することを検討してください。p
- 割合の形式。% 記号が自動的に付加されます。注: この形式を使用する場合、0.0 ~ 1.0 のデータ値は 0 ~ 100% にマッピングされます(たとえば、0.43 は 43% と表示されます)。e
- 科学的記数の形式。c<CUR>
- 適切な通貨マーカーを使用して、指定された通貨で数値を書式設定します。<CUR>
は、3 文字の通貨コードに置き換えます。例: ユーロの場合はcEUR
。コードのリストは ISO のウェブサイトで確認できますが、すべての記号がサポートされているわけではありません。
<decimal_places>
- 表示する小数点以下の桁数を指定する整数。値はこの長さに丸められます(切り捨てられない)。デフォルトは 2 です。z
- 末尾のゼロを表示します。デフォルトは no です。s
- グループ セパレータを表示します。デフォルトは no です。x
またはy
- 指定された x 座標または y 座標のデータを表示します。x データの意味はグラフの種類によって異なります。グラフを試して、その意味を判断します。デフォルトは「y」です。
<following_text>
- 各値に続くテキスト。
- <color>
- : このセットのマーカーの色(RRGGBB の 16 進数形式)。
- <series_indexseries_index>
- : マーカーを描画するデータ シリーズのインデックス(ゼロベース)です。これが積み上げ棒グラフで、マーカーの種類が N(データポイント値)の場合、-1 を指定すると、棒の積み重ねごとに合計値のマーカーを作成できます。以下の例をご覧ください。
- <opt_which_points>
- (省略可): マーカーを描画するポイント。デフォルトはすべてのマーカーです。次のいずれかの値を使用します。
n.d
- マーカーを描画するデータポイント。n.d は系列内のゼロベースのインデックスです。整数以外の値を指定した場合、小数は計算された中間点を示します。たとえば、3.5 はポイント 3 とポイント 4 の中間を意味します。-1
- すべてのデータポイントにマーカーを描画します。このパラメータを空のままにして、すべてのデータポイントの上に描画することもできます。-n
- n 番目のデータポイントごとにマーカーを描画します。start:end:n
- start から end までのインデックス値(両端を含む)内の n 番目のデータポイントごとにマーカーを描画します。すべてのパラメータは省略可能です(存在しない場合もあります)。3::1 は、ステップ 1 の 4 番目の要素から最後までの要素です。このパラメータを完全に省略すると、デフォルトの first:last:1 になります。すべての値に浮動小数点数を指定できます。start と end は負の値にし、最後の値から後方にカウントします。start と end の両方が負の値の場合は、大きい方の値で列挙します(例: -6:-1:1)。n ステップの値が 1 未満の場合、与えられたデータ値を補間して追加のデータポイントを計算します。デフォルト値は first:last:1 ですx:y
- [N 型のマーカーには対応していません] グラフ上の特定の x/y ポイントにマーカーを描画します。この点は直線上にある必要はありません。このオプションを使用するには、マーカータイプの前にアットマーク(@
)を追加します。座標を浮動小数点値として指定します。0:0
はグラフの左下隅、0.5:0.5
はグラフの中心、1:1
はグラフの右上隅です。たとえば、15 ピクセルの赤いひし形をグラフの中央に追加するには、@d,FF0000,0,0.5:0.5,15
を使用します。
- <size>
- : マーカーのサイズ(ピクセル単位)。3 つ目のデータ系列(ポイントサイズの指定に使用)を含む散布図の場合、この値はデータ範囲によってスケーリングされます。たとえば、データ範囲が 0 ~ 100、<size> が 30 の場合、データ値 100 は幅 30 ピクセル、データ値 50 は幅 15 ピクセルになります。
- <opt_z_order>
- (省略可): マーカーを描画するレイヤ(他のマーカーおよび他のすべてのグラフ要素との比較)。これは -1.0 から 1.0 までの浮動小数点数です。-1.0 は底、1.0 は上です。グラフ要素(折れ線と棒)は 0 よりも小さいほどです。2 つのマーカーが同じ値を持つ場合、URL で指定された順序で描画されます。デフォルト値は 0.0(グラフ要素のすぐ上)です。
- <opt_placement>
- (省略可)データポイントを基準として、このマーカーを配置する場所を示す追加のプレースメントの詳細。水平または垂直の相対位置とオフセットを指定できます。プレースメント構文は、次に示すように、「:」区切り文字を使用した文字列です。すべての要素は省略可能です(
<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>
)。指定すると、<opt_z_order> のchm
パラメータ文字列に空の値を含めることができます(例:N,000000,0,1,10,,b
、N,000000,0,1,10,,lv
、N,000000,0,1,10,,r::10
)。- horizontal_and_vertical_justification
- マーカーのアンカー ポイント。これは両端揃えとは逆に動作するため、左アンカーの場合、実際にはマーカーがデータポイントの右に配置されます。次のリストから、水平方向や垂直方向の位置揃えを選択できます。
- 横配置: 「l」、「h」、「r」 - 横方向の左揃え、中央揃え、右固定。デフォルトは「l」です。
- 縦方向の配置: 「b」、「v」、「t」 - 縦方向の下部、中央、上部に固定。デフォルトは「b」です。
- 棒に連動したプレースメント [棒グラフのみ]: s、c、e - 棒の底部、中央、上部。積み上げグラフの場合、棒全体ではなく、各系列の棒のセクションからの相対値です。指定された系列インデックスが -1(スタック合計)の場合は、棒全体に対する比率になります。縦方向の配置値(「be」や「vs」など)と組み合わせて使用できます。デフォルト値は「e」です。
- horizontal_offset
- このマーカーの水平オフセット(ピクセル単位)。デフォルトは 0 です。
- vertical_offset
- このマーカーの垂直オフセット(ピクセル単位)。棒グラフ以外のデフォルトは 15、棒グラフのデフォルト: 2。
説明 | 例 | |
---|---|---|
こちらは、棒グラフでの値のラベルの例です。 最初のグラフ( 2 番目のグラフ( |
|
|
この例は、シンプル エンコードされた値が 46、39、29、30、43、41 のグラフを示しています。単純なエンコード範囲は 0 ~ 61 です。 |
![]() chd=s:underp |
|
最小値にテキストラベル、最大値にフラグラベルがあるグラフの例を次に示します。 |
|
|
この例は、個々の系列の値と系列の合計値を含む積み上げグラフです。積み上げ系列の値を表示するには、「c」配置オプションを使用する必要があります。そうしないと、上部のバーの値が各バーの上部にある合計値と重なってしまいます。 | ![]() chm= |
|
縦方向と横方向の配置の仕組みを示すその他のデモこの例では、棒グラフのアンカー値(縦方向の配置に s、c、e を使用)のさまざまな組み合わせを示しています。右側のアンカーを動かすとマーカーが左に動き、上部のアンカーでマーカーが下に移動します。その逆も同様です。赤い点は、各バーのベース、中央、上部を示しています。 数値はデータの値で、棒ごとに異なるアンカー値で固定されています。 | ![]() chm= |
|
アノテーション マーカーでは、ラベルの位置が重ならないように自動的に調整されます。最初の chm 値は線の塗りつぶし用で、次の値はすべてアノテーション マーカーです。 |
![]() chm=B,C5D4B5BB,0,0,0 |
|
スイスの都市の標高を示す別のアノテーション マーカーの例。 | ![]() |
範囲マーカー chm
[棒、ローソク足、折れ線、レーダー、散布図]
水平または垂直方向の背景の帯に色を付けて、グラフの特定の領域を目立たせることができます。
パイプ文字(|
)を使って chm
マーカーを組み合わせると、chm
パラメータ セットを区切ることができます。
構文
描画する帯域ごとに、次のパラメータ セットのいずれかを指定します。複数の帯域を描画するには、追加のパラメータ セットをパイプ文字で区切って作成します。範囲は指定された順序で描画されるため、最後に描画された範囲は前の範囲の上に描画されます。
chm= <direction>,<color>,0,<start_point>,<end_point> |...| <direction>,<color>,0,<start_point>,<end_point>
- <direction>
- 水平または垂直のシェーディングを指定します。水平範囲には
r
、垂直範囲にはR
を使用します。 - <color>
- 範囲の色。RRGGBB 形式の 16 進数で指定します。
- 0
- 予約済み - ゼロにする必要があります。
- <start_point>
- 範囲の開始位置。
- 水平範囲マーカーの場合、これは Y 軸上の位置です。
0.00
はグラフの最下部、1.00
はグラフの上部です。 - 垂直範囲マーカーの場合、これは X 軸上の位置です。
0.00
はグラフの左側、1.00
はグラフの右側です。
- <end_point>
- 範囲の終了位置。
- 水平範囲マーカーの場合、これは Y 軸上の位置です。
0.00
はグラフの最下部、1.00
はグラフの上部です。 - 垂直範囲マーカーの場合、これは X 軸上の位置です。
0.00
はグラフの左側、1.00
はグラフの右側です。
例
説明 | 例 |
---|---|
範囲マーカーには、細い線または色の帯を使用できます。
|
![]()
|
この例は、垂直範囲マーカーを示しています。1 つ目のマーカーは赤い線( |
![]()
|
マーカーは指定された順序で描画されます。この例では、縦型の赤いマーカーが、薄い青色の横方向マーカーの前に描画されていることがわかります。 |
![]() chm= |
範囲マーカーを使用してグラフ上の基準線、中点線、上部に薄い水平線を描画する折れ線グラフの例を次に示します。 |
![]()
|
ローソク足マーカー chm=F
[棒、線]
ローソク足マーカーは、データ系列の分散と方向の変化を示します。多くの場合、1 日の株価を表示するために使用されます。マーカーには、高値と低値、特定の期間(通常は 1 日)の開始値と終了値を示すセグメントが含まれます。ローソク足マーカーについて詳しくは、こちらをご覧ください。
ローソク足マーカーは、垂直線で二等分された長方形として描画されます。ローソク足マーカーを描画するには、4 つのデータ系列が必要です。各系列で指定する内容は次のとおりです。
- Series 1 と 4 は、それぞれ縦線の下部と上部を指定します。これらは通常、その日の最低値と最高値を表します。
- Series 2 と 3 は、長方形の垂直境界を指定します。系列 2 は始値、系列 3 は終値を表します。長方形の色はどちらが高いかによって異なります。始値(シリーズ 2)が終値(シリーズ 3)より低い場合、価格は上昇し、長方形はデフォルトで緑色で塗りつぶされます。始値(シリーズ 2)が終値値(シリーズ 3)より高い場合、価格は下がり、長方形はデフォルトで赤色で塗りつぶされます。長方形の塗りつぶしの色は、値が小さいほど指定できます。この値を指定すると、値が増加する長方形は塗りつぶされません(空になります)。シリーズ 2 は、価格の上昇または下落に応じて、長方形の上部または下部のいずれかになります。
ローソク足マーカーと他の chm
パラメータを組み合わせるには、パイプ文字(|
)を使用して chm
パラメータを区切ります。
注: マーカーの描画に使用したデータの線をグラフに表示したくない場合は、表示形式の後に 0 を含める必要があります。たとえば、テキスト形式のデータ文字列内の chd=t0:10,20,30,40
。詳しくは、複合グラフをご覧ください。
次の例では、各系列の行を示しています。
構文
chm= F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>
- F
- ローソク足マーカーであることを示します。
- <opt_declining_color>
- (省略可): 値が減少している場合(系列 2 の値 > 対応する系列 3 の値の場合)長方形の塗りつぶしの色。これは RRGGBB 形式の 16 進数です。値が増えると、長方形は空になります。デフォルトは、増加する場合は緑で点灯し、減少する場合は赤で点灯します(値を増やす場合はカスタムの塗りつぶしの色を指定できません)。
- <data_series_index>
- ローソク足マーカーの最初のシリーズとして使用するデータシリーズのインデックス。これはゼロベースのインデックスです。そのため、ここで 1 を指定し、6 つのシリーズがある場合、2 番目、3 番目、4 番目、5 番目のシリーズがローソク足マーカーの描画に使用されます。
- <opt_選択するポイント>
- (省略可): マーカーの描画に使用するデータポイントを指定します。デフォルトはすべてのマーカーです。次のいずれかの形式で指定してください。
n.d
- 系列内の 1 つの点にマーカーを描画します。ここで、n.dn.d は系列内の点のインデックスです。整数以外の値を指定した場合、小数は計算された中間点を示します。たとえば、3.5 はポイント 3 とポイント 4 の中間を意味します。-1
- すべてのデータポイントにマーカーを描画します。このパラメータを空のままにして、すべてのマーカーの上に描画することもできます。-n
- n 番目のデータポイントごとにマーカーを描画します。start:end:n
- start から end までのインデックス値(両端を含む)内の n 番目のデータポイントごとにマーカーを描画します。パラメータはすべて省略可能(存在しない場合もあります)であるため、3::1 は 4 番目の要素から最後のステップ 1 までとなります。このパラメータを完全に省略すると、デフォルトの first:last:1 になります。すべての値に浮動小数点数を指定できます。start と end は負の値にし、最後の値から後方にカウントします。start と end の両方が負の値の場合は、大きい方の値で列挙します(例: -6:-1:1)。n ステップの値が 1 未満の場合、与えられたデータ値を補間して追加のデータポイントを計算します。デフォルト値は first:last:1 です
- <幅>
- すべての長方形の幅(ピクセル単位)。
- <opt_z_order>
- (省略可): マーカーを描画するレイヤ(他のマーカーおよび他のすべてのグラフ要素との比較)。これは -1.0 から 1.0 までの浮動小数点数です。-1.0 は底、1.0 は上です。グラフ要素(折れ線と棒)は 0 よりも小さいほどです。2 つのマーカーが同じ値を持つ場合、URL で指定された順序で描画されます。デフォルト値は 0.0(グラフ要素のすぐ上)です。
例
説明 | 例 |
---|---|
4 つの系列を持つ折れ線グラフに表示されたローソク足マーカーの例です。カスタムの塗りつぶし色 最初と最後の長方形はグラフによってトリミングされます。これらの値を除外するには、chm の 4 番目のパラメータに 1:4 を指定します。 系列の線( <which_point> パラメータは空白で、すべてのデータポイントにローソク足が描画されます。 |
chd=t0: |
同じグラフの例を以下に示します。ここでは、デフォルトの色を使用し、最初と最後のアイテムを削除しています。 これは複合グラフで、折れ線グラフ(基本グラフの種類)とローソク足マーカーを組み合わせたものです。 |
|
線マーカー chm=D
[棒、ローソク足、折れ線、レーダー、散布図]
グラフ内のデータをトレースする線を追加できます。通常は複合グラフで使用されます。
複数の行を追加する(または他の chm
マーカーと組み合わせる)には、パイプ(|
)区切り文字を使用して chm パラメータ セットを区切ります。このパラメータを使用して破線のマーカーを作成することはできません。
構文
chm= D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
- D
- 線マーカーであることを示します。
- <color>
- 線の色。RRGGBB の 16 進形式で指定します。
- <series_indexseries_index>
- 線の描画に使用されるデータ系列のインデックス。データ系列インデックスは、最初のデータ系列は
0
、2 番目のデータ系列は1
となります(以下同様)。 - <which_points>
- 系列のどの点を使用して線を描画するか。次のいずれかの値を使用します。
0
- 一連の点をすべて使用します。start:end
- 開始から終了までの一連のポイント(ゼロベースのインデックス)を使用します。浮動小数点値を使用して中間点を指定することもできます。また、start または end を空白のままにして、それぞれ最初または最後のデータポイントを示すこともできます。start と end は負の値にでき、最後の値からの逆インデックスになります。start と end の両方が負の数である場合は、大きい方の値で書き込んでください(-6:-1 など)。
- <size>
- 線の幅(ピクセル単位)。
- <opt_z_order>
- (省略可): マーカーを描画するレイヤ(他のマーカーおよび他のすべてのグラフ要素との比較)。これは -1.0 から 1.0 までの浮動小数点数です。-1.0 は底、1.0 は上です。グラフ要素(折れ線と棒)は 0 よりも小さいほどです。2 つのマーカーが同じ値を持つ場合、URL で指定された順序で描画されます。デフォルト値は 0.0(グラフ要素のすぐ上)です。
例
説明 | 例 |
---|---|
これは、棒グラフ上にマーカー線を描画する例です。Z オーダーは |
![]() chm=D,0033FF,0,0,5,1 |
これは同じ棒グラフですが、折れ線のデータ系列が追加されています。これは複合グラフの例です。複合グラフを描画するには、 詳しくは、複合グラフをご覧ください。 |
![]() chm=D,0033FF,1,0,5,1 |
データ関数 chfd
[すべての chd
グラフ]
muParser 関数の構文を使用して、グラフデータに対して実行するカスタム関数を指定できます。関数で使用されるデータは、次の 2 つのソースのいずれかから取得されます。
chd
のデータ系列 - データはchd
で指定された系列から取得されます。chfd
パラメータ自体で宣言された値の範囲 - 任意のデータ範囲の開始、停止、ステップの値を宣言します。
いずれの場合も、chd
の既存のシリーズに出力を割り当てる必要があることに注意してください。このシリーズは、関数の出力によって上書きされます。グラフは、すべての関数が処理された後にのみレンダリングされます。そのため、出力に複数の関数を同じデータ系列に割り当てると、関数は指定された順序で実行されますが、グラフには最終的な関数の出力のみがプロットされます。関数を連鎖させることで、前の関数で出力された一連のデータを 1 つの関数で入力として受け取ることができます。
色または chm
マーカーを関数行に割り当てるには、色またはマーカーを関数のシリーズ インデックスに割り当てます。マーカーは、関数でデータを操作した後、そのデータに応じて配置されます。
構文
chfd= <output_series_index>,<function_data>,<function_string> |...| <output_series_index>,<function_data>,<function_string>
- <output_series_indexoutput_series_index>
- 関数の出力が書き込まれる
chd
内のデータ系列のゼロベースのインデックス。既存のデータは、関数の出力によって完全に上書きされます。シリーズが関数の入力として使用されない場合は、そのシリーズに単一のダミー値を割り当てることをおすすめします。 - <function_data>
- プロットする変数とデータ。データは、定義した範囲または
chd
データ系列のいずれかから取得されます。関数ごとに複数の変数を指定できます。複数の変数を指定する場合は、区切り文字として ;(セミコロン)を使用します。1 つの関数に複数の変数を定義し、これらの変数のポイント数が異なる場合、関数は最初のエンドポイントに到達すると停止します。たとえば、関数が x=1 ~ 5 ステップ 1 と y=1 ~ 10 ステップ 1 の両方を定義している場合、関数は 5 番目の点に達すると終了します。
<variable_name>,<input_series_index>
または
<variable_name>,<start>,<end>,<step>
- variable_name - 変数の任意の文字列名。これは、function_string で定義されている関数で使用します。
- input_series_index - 入力データとして使用する
chd
データシリーズのインデックス。 - 開始 - 範囲の開始値(数値)。
- 終了 - 範囲の終了数値です。
- step - start から end までのステップの数値。正または負の値を指定できますが、ゼロにはできません。
x,0,100,1
は、値が 0、1、2、... 100 のx
という名前の変数を宣言します。x,0,100,1;r,0,3.1,.1
は、同じx
変数に加えて、値が 0、0.1、0.2、...、3.0、3.1 のr
という名前の変数を宣言します。x,0
は、最初のchd
シリーズのデータを使用する x という名前の変数を宣言します。これらの変数は function_string で使用されます。function_string で指定しない限り、グラフにプロットされません。 ステップが小さいほど、グラフは滑らかになります。 - <関数文字列function_string>
- muParser 構文で記述された関数。この関数は、variable_data で指定された変数とデータに適用されます。参照できるのは、このローカル関数セットで宣言された変数のみです。別のパイプ文字セットの
chfd
パラメータで参照することはできません。muParser 関数の概要(最小、最大合計、平均)はサポートされていません。重要: 関数では、+
ではなく%2B
を使用してください。
例
説明 | 例 |
---|---|
単純な正弦波。注意点:
|
![]() cht=lc |
この線は、chd パラメータのデータを使用しています。 |
![]() chd=t:5,10 |
関数行と非関数行が混在している。 色が系列の色パラメータ 関数の出力では、マーカーの配置に注目してください。データポイントは start、end、step から計算されます。つまり、範囲が 0 ~ 11 ステップ 0.1 の場合、ポイント 0 は 0、ポイント 1 は 0.1、というようにポイント 110 までは 11 となり、その値は 11 になります。 |
![]() chd=t: |
2 つの次元で関数を定義するには、
|
![]() cht=lxy |
これらの画像をクリックして開き、チャート プレイグラウンドで遊んでみましょう。きっと夢中になります。 |