このドキュメントでは、Google メーターグラフと呼ばれるダイヤル型のグラフの作成方法について説明します。
目次
グラフ固有の機能
|
標準機能
|
概要
Google メーターは、範囲内の単一の値を指すゲージです。範囲には、必要に応じて指定できるカラー グラデーションがあります。ポインタの上にカスタム テキストを指定することもできます。ダイヤル範囲は、データ形式の最小値から最大値までです。矢印が指すデータ値を chd
パラメータに 1 つ指定します。
同じグラフ上に複数の矢印を指定して、矢印の本体とポイントのサイズをそれぞれ異なるスタイルに設定できます。すべての矢印に同じスタイルを適用する場合は、データポイントを同じシリーズの値として指定します。矢印ごとに異なるスタイルを適用する場合は、同じスタイルのすべての矢印を同じシリーズにグループ化します。
Google-O-Meter グラフは、次の構文で指定します。
構文
cht=gom
例
説明 | 例 |
---|---|
|
|
複数のデータポイントを持つ複数の矢印を指定できます。 | chd=t:20,40,60 |
矢印にスタイルを適用するには、
このグラフの
|
chd=t:20,40|60 |
系列の色 chco
必要に応じて、chco
パラメータを使用してダイヤルの色を指定できます。指定しない場合は、デフォルトのグラデーションが使用されます。
構文
chco=<color_1>,...,<color_n>
- <color>
- 2 つ以上の色を RRGGBB の 16 進形式で指定します。色は左から右のグラデーションで適用されます。最初の色が左、最後の色が右になります。
説明 | 例 |
---|---|
このグラフは、白(FFFFFF)から黒(000000)への単純なグラデーションを示しています。 | chco=FFFFFF,000000 |
このグラフでは、ダイヤルに複数の色が割り当てられています。 | chco=FF0000,FF8040,FFFF00, |
Google メーターのラベル chl
必要に応じて、矢印の上に表示するカスタムラベルを指定できます。
文字列値に関する注意: ラベルの文字列には、URL セーフな文字のみを使用できます。安全のためには、文字セット 0-9a-zA-Z
にない文字を含む文字列は URL エンコードする必要があります。URL エンコーダについては、こちらをご覧ください。
構文
chl=<label>
- <ラベル>
- ラベルのテキスト。
例
説明 | 例 |
---|---|
ラベル付きの Google メーターの例を以下に示します。 |
|
標準の機能
このページの残りの機能は、標準のグラフ機能です。
RRGGBB[AA]
の形式で、6 文字の 16 進数文字列と 2 つのオプションの透明度値を使用して、色を指定します。例:
FF0000
= 赤00FF00
= 緑0000FF
= 青000000
= 黒FFFFFF
= 白
AA
はオプションの透明度値です。00
は完全に透明、FF
は完全に不透明です。例:
0000FFFF
= 青色で点灯0000FF66
= 透明な青
グラフのタイトル chtt
、chts
[すべてのグラフ]
グラフのタイトルのテキスト、色、フォントサイズを指定できます。
構文
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
- グラフのタイトルを指定します。
- <チャートのタイトルchart_title>
- グラフに表示するタイトル。このテキストが表示される場所は指定できませんが、フォントサイズと色は任意で指定できます。スペースは + 記号、改行の場合はパイプ文字(
|
)を使用します。
chts
(省略可) - chtt
パラメータの色とフォントサイズ。
- <color>
- タイトルの色(RRGGBB の 16 進形式)。デフォルトの色は黒です。
- <font_size>
- タイトルのフォントサイズ(ポイント単位)。
- <opt_alignment>
- (省略可): タイトルの配置。次のいずれかの文字列値(大文字と小文字を区別)を選択します。「l」(左)、「c」(中央)、「r」(右)デフォルトは "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_labeldata_series_label>
- 凡例のエントリのテキスト。各ラベルは、
chd
配列内の対応するシリーズに適用されます。スペースには + 記号を使用します。このパラメータを指定しないと、グラフに凡例は表示されません。ラベル内の改行を指定する方法はありません。通常、凡例は凡例テキストが入るように拡張され、グラフ領域は凡例に合わせて縮小されます。
chdlp
- (省略可)凡例の位置と凡例のエントリの順序。<position> と <label_order> のいずれかまたは両方を指定できます。両方を指定する場合は、バー文字で区切ります。凡例で chdl
の空の凡例エントリをスキップする場合は、任意の値に「s」を追加できます。例: chdlp=bv
、chdlp=r
、chdlp=bv|r
、chdlp=bvs|r
- <opt_position>
- (省略可): グラフ上の凡例の位置を指定します。凡例とグラフ領域または画像の枠線との間に追加のパディングを指定するには、
chma
パラメータを使用します。 次のいずれかの値を選択します。b
- グラフの下部にある凡例。凡例のエントリは 1 行に並んでいます。bv
- グラフの下部に凡例があり、凡例のエントリは縦一列に並んでいます。t
- グラフの上部にある凡例。凡例のエントリは 1 行に並んでいます。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
を使用して値のスタイルを設定できます(通貨記号や小数点を表示するなど)。
カスタム値(「月、火、水」など)を使用する場合は、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 <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x1 |
この例は、X 軸、Y 軸、上部の T 軸、右側の R 軸を持つ横棒グラフを示しています。 軸ラベルが省略されているため、Chart API は X 軸と T 軸に 0 ~ 100 の範囲を表示します。 Y 軸と R 軸の範囲は、バーの数によって決まります。この場合、棒は 5 本なので、Chart API は 0 ~ 4 の範囲を表示します。1 つ目のラベルは 1 つ目の棒の底部の中央に配置され、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 軸になります。 - <label_1>| ... |<label_n>
- この軸に沿って配置する 1 つ以上のラベル。値は文字列または数値になります。文字列を引用符で囲む必要はありません。label_1 は軸の最下位の位置に表示され、label_n は最上位に表示されます。追加のラベルはそれらの間に均等に配置されます。スペースは + 記号で示します。ラベル内の改行を指定する方法はありません。ラベルはパイプ文字で区切ります。注:
chxl
パラメータの最終ラベルの後にパイプを入れないでください。
例
説明 | 例 |
---|---|
このグラフは、2 つの軸にカスタムラベルを追加する方法を示しています。値が等間隔で配置されていること、最後の |
chxt=x,y |
この例では、左右の Y 軸( |
|
この例では、左右の Y 軸( この例では、左側の Y 軸の軸ラベルにデフォルト値を使用します。 |
|
軸全体を記述する汎用ラベルを追加する場合(たとえば、ある軸に「cost」と別の「student」のラベルを付ける)、 |
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_coloropt_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 |
線のスタイル chls
[線、レーダー]
chls
パラメータで線の太さと実線/破線スタイルを指定できます。このパラメータを使用できるのは、折れ線グラフまたはレーダーグラフの線のスタイルを設定する場合のみです。複合グラフの基本タイプが折れ線グラフである場合を除き、複合グラフの線の線のスタイル設定には使用できません。
構文
複数の線のスタイルはパイプ文字(|
)で区切ります。最初のスタイルが最初の行に適用され、2 番目のスタイルが次の行に適用されるというように続きます。スタイルの数が線より少ない場合は、指定されていないすべての線にデフォルトのスタイルが適用されます。
chls= <line_1_thickness>,<opt_dash_length>,<opt_space_length> |...| <line_n_thickness>,<opt_dash_length>,<opt_space_length>
- <line_1_thickness>
- 線の太さ(ピクセル単位)。
- <opt_dash_length>、<opt_space_length>
- (省略可): 点線のグリッド線を定義するために使用します。1 つ目のパラメータは、各線の長さ(ピクセル単位)です。2 つ目のパラメータは、ダッシュの間隔(ピクセル単位)です。実線の場合は、どちらの値も指定しません。<opt_dash_length> のみを指定した場合、<opt_space_length> は <opt_dash_length> に設定されます。デフォルトは 1,0(実線)です。
例
説明 | 例 |
---|---|
ここでは、破線は |
chls=3,6,3|5 |
背景の塗りつぶし 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
[Line, Bar, Google-o-meter, Radar, Scatter,Venn]
グラフ領域や背景に 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 度( 最初に指定した色はピーチ( 2 番目に指定する色は青( グラフの背景はグレー( |
|
グラフ領域には、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= |