このページでは、Charts API を使って色付き地図を作成する方法について説明します。このグラフは改良された新しいバージョンであり、以前のマップグラフ(cht=t
)よりも大きな地図とより多くの機能をサポートしています。
目次
グラフ固有の機能 |
Standard の機能 |
概要
さまざまな国や州をカスタムカラーでハイライト表示した地図を作成できます。選択した国を正しく表示できるよう、地図を適切なレベルまで拡大したり、緯度と経度の値を使用してカスタムレベルまでズームインまたはズームアウトしたりできます。
サポートされているパラメータ
マップグラフは次のパラメータをサポートしています。
パラメータ | 必須または省略可 | 説明 |
---|---|---|
cht=map<opt_zoom_and_center> |
必須 | マップグラフを指定します。 opt_zoom_and_center - 特定の領域でグラフをズームまたは中心に配置できるオプションの文字列。詳細を表示 |
chs |
必須 | 地図のサイズ。地図の最大サイズは、幅 600 ピクセル、高さ 600 ピクセル、合計 300,000 ピクセルです。 |
chd= |
任意 | これを使用すると、データ値は、chco で指定されたカラー グラデーションに沿って、対応する国の色を示します。 |
chld= |
必須 |
|
|
任意 | グラフの色。この文字列の形式は、
|
chtt, chts |
任意 | グラフのタイトルとスタイル |
chm |
任意 | グラフ マーカー |
chma |
任意 | グラフの余白 |
chf=bg... |
任意 | 単色塗りつぶし(背景のみ) |
chdl |
任意 | グラフの凡例 |
例
説明 | 例 | |||
---|---|---|---|---|
この例では、次のようになります。
|
|
|||
2 つの地域がハイライト表示されたフランスの地図:
|
![]() chld=FR-D|FR-B|FR |
|||
この地図では、カラー グラデーションを使用しています。
|
![]() chd=t:0,50,100 |
|||
指定されたグラフサイズの範囲内で、地図を切り抜くことができます。これは、指定されたグラフのサイズ内に収まるように地図が変形することはありませんが、chld で指定した領域に限定されるためです。そのため、グラフの境界内で領域が切り抜かれないようにするには、地図のサイズを手動で調整する必要があります。 |
|
ズームと中央処理
デフォルトでは、選択した領域が中央になるようにグラフがズームされ、中央に配置されます。定義された地図サイズの範囲内で、レンダリングされた領域にできるだけ収まるように配置されます。ただし、次の 2 つの方法で、グラフの中央揃えとズームレベルをカスタマイズできます。
ピクセル別
ピクセルサイズで枠線を調整するには、次の形式を使用します。
cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>
枠線のサイズは、自動的に計算されたズームレベルを超えて表示する追加の枠線(ピクセル単位)です。
縮小(正の値)のみ可能です。ピクセル ズームを使用してデフォルトのズームレベルより近くまで拡大(負の値)することはできません。
例:
これらはすべてロンドン(緯度)を示しています
ズームなし(デフォルト) | 1 辺 30 ピクセルにズームアウト | ズームアウトして右下にズームアウトしました |
---|---|---|
|
![]() cht=map:auto=30,30,30,30 |
![]() cht=map:auto=50,0,80,0 |
緯度と経度を使用
以下の構文を使用して、レンダリングされた地図の正確な上部、下部、左右の境界を緯度と経度で指定できます。
cht=map:fixed=<bottom_border_lat>,<left_border_long>,<top_border_lat>,<right_border_long>
<bottom_border_lat> と <top_border_lat> で上下の枠線の緯度を指定し、<left_border_long> と右枠線の経度を <right_border_long> に指定します。
注: メルカトル図法の歪み(基本的には、曲線地図をフラットな画像に投影します)により、縦長のストリップにフォーカスすると、地図に予期しないサイズ違いが生じることがあります。
例:
次の例はロンドン(青色でハイライト表示)を示しています。経度は 0.1°、緯度は 51.5° です。地図がトリミングされる理由は、地図が(指定されたとおりに)英国のみを表示し、指定されたグラフを歪みなく埋めようとしているためです。
中央揃え | 緯度を +10 移動* | すべての値を減らしてズームしました |
---|---|---|
![]() cht=map:fixed=40,-10,60,10 |
|
![]() cht=map:fixed=48,-3,54,3 |
上と同じ角度だけ移動しましたが、中央の画像のサイズは最初の画像よりも少し小さくなっています。これは、3D の球体を 2D 画像に投影するためです。1 つ目のグラフと同じサイズにするには、2 つ目のグラフの幅を広げる必要があります。
標準の機能
このページの残りの機能は、標準のグラフ機能です。
グラフのタイトル 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 |
グラフのマージン 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 ピクセルです。 |
|
背景塗りつぶし 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% の透明度です)。グラフの上にテーブルセルの背景が表示されます。 |
|
グラフの凡例のテキストとスタイル 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 つ目のグラフは横方向の凡例エントリ( |
|
この例では、フォントサイズを変更する方法を示します。 |
|
シェイプ マーカー 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 |
|
スイスの都市の標高を示す別のアノテーション マーカーの例。 | ![]() |