警告: この API は 2012 年に非推奨となり、2019 年 3 月 18 日に無効になりました。代わりに、積極的にメンテナンスされている Google Charts API を使用してください。

マップチャート

このページでは、Charts API を使用して色付きの地図を作成する方法について説明します。このグラフは、古い地図グラフcht=t)よりも大きな地図とより多くの機能をサポートする、改善された新しいバージョンです。

目次

概要

さまざまな色や国をカスタムカラーでハイライト表示した地図を作成できます。地図を適切なレベルにズームインして選択した国を適切に表示したり、緯度と経度の値を使用してカスタムレベルをズームインまたはズームアウトしたりできます。

サポートされるパラメータ

マップチャートは次のパラメータをサポートしています。

パラメータ 必須または省略可 説明
cht=map<opt_zoom_and_center> 必須

地図グラフを指定します。

opt_zoom_and_center - グラフを特定のエリアにズームまたは中央揃えできるオプションの文字列。詳細を表示

chs 必須 地図のサイズ。地図の最大サイズは、幅 600 ピクセル、高さ 600 ピクセル、合計 300,000 ピクセルです。
chd=
 <first_country_value>,
 ...,
 <last_country_value>
任意 使用する場合、データ値は chco で指定されたカラー グラデーションに沿って、対応する国の色を示します。
chld=
 <country_or_region_codes>|...|
必須

chco で指定された色でハイライト表示される国または州のパイプ区切りリスト。カスタムのズームやセンタリングを行わない限り、指定された国がすべて含まれるように自動的に地図がズームされます。コードは大文字にする必要があります。コードは ISO 3166-1-alpha-2 コードで、2 文字の大文字と、その後にダッシュとリージョンまたは都市の 2 つ目の ID を追加します。例: GB(英国)、GB-LND(ロンドン)、US-NJ(米国、ニュージャージー州)

chco

  • chd が使用されていない場合は、次の手順を行います。
    chco=
     <unselected_land_color>|
     <first_region_color>|
       ...|
     <last_region_color>
  • chd使用されている場合:
    chco=
     <unselected_land_color>,
     <color_range_start>,
       ...,
     <color_range_end>
任意

グラフの色。この文字列の形式は、chd を使用するかどうかによって異なります。どちらの構文でも、<unselected_land_color>chld で指定されていないリージョンの色です。分割線は、構文によって異なることに注意してください(一方はカンマ、もう一方はパイプ)。使用しない場合、領域の枠線は付けられますが、色は付けられません。

  • chd中古品 - 2 番目以降の色は、色範囲を表します。chld では、国ごとに 1 つの chd 値が必要です。それぞれの国に対応する色は、<first_region_color>(最小データ範囲値)~<last_region_color>(最大データ範囲値)の範囲で示されます。以下の表の例をご覧ください。
  • chd未使用 - 2 番目以降の色は、chld 内の対応する領域に、上記の順序で適用されます。色よりも多くの国がある場合、最後の色がリスト内の余分な国すべてに適用されます。
chtt, chts 任意 グラフのタイトルとスタイル
chm 任意 グラフ マーカー
chma 任意 グラフの余白
chf=bg... 任意 単色塗りつぶし(バックグラウンドのみ)
chdl 任意 グラフの凡例

 

説明

この場合のルールの仕組みは次のようになります。

  • cht=map:fixed=-60,0,80,-35 - グラフのズーム領域は緯度 -60 ~ 80、経度 0 ~ 35 です。
  • chld=CA-BC|CN|IT|GR|US-UT - 主な地域は、ブリティッシュ コロンビア、中国、イタリア、ギリシャ、ユタです。
  • chm - フラグのグラフを作成します。
  • chma=0,110,0,0 - 凡例の右側の境界線を 110 ピクセルに拡大しました。
  • chtt=Last+Five+Olympic+Hosts - グラフのタイトル。スペースを表す場合は + を使用します。

オリンピック開催地の 5 か国の地図。旗のマーカーが表示されている。
cht=map:fixed=-60,0,80,-35
chs=600x350
chld=CA-BC|CN|IT|GR|US-UT
chdl=Vancouver|Beijing|Torino|Athens|Salt+Lake+City
chco=B3BCC0|5781AE|FF0000|FFC726|885E80|518274
chtt=Last+Five+Olympic+Hosts
chm=f2010+Winter,000000,0,0,10
f2008+Summer,000000,0,1,10
f2008+Winter,000000,0,2,10,1,:-5:10
f2004+Summer,000000,0,3,10
f2004+Summer,000000,0,4,10
chma=0,110,0,0

フランスの地図。2 つの地域がハイライト表示されている。

  • chld=FR-D|FR-B|FR - 地域は、ブルゴーニュ(東)、アキテーヌ(南西)、フランスの 3 つです。
  • chco=676767|FF4444|44FF44|4444FF - この地図では chd パラメータが指定されていないため、最初の色以降の各値は対応する国の指定に使用されます。赤はブルゴニュ、赤はアキテーヌ、青はフランスを示しています。後の色ではそれより前の色がマスキングされていないことがわかります。
フランスの地図。2 つの州がハイライト表示されている。
chld=FR-D|FR-B|FR
chco=676767|FF4444|44FF44|4444FF

この地図では、カラー グラデーションを使用しています。

  • chd=t:0,50,100 - chd パラメータは色のグラデーションを示します。ここでは、0 ~ 100 の範囲でテキスト エンコードを指定します。
  • chco=CCCCCC,FF0000,000000 - 背景色は明るい灰色(CCCCCC)で、色の範囲は赤(FF0000)から黒(000000)です。示されている中央国は、そのグラデーションの中間色です。
カラー グラデーションが描かれた地図
chd=t:0,50,100
chco=CCCCCC,FF0000,000000
指定したグラフサイズ内で地図を切り抜くことができます。これは、指定したグラフサイズに収まるようにマップが歪まないものの、地図が chld で指定したリージョンに制限されるためです。そのため、グラフの境界内の領域が切り抜かれないようにするには、地図のサイズを手動で調整する必要があります。
長い国の正方形の地図

cht=map
chs=300x300
chld=GB

イングランドは細長い地域なので、正方形のマップを指定すると、右側に切り抜き領域が表示されます。

長い国の正方形の地図

cht=map
chs=180x300
chld=GB

グラフの幅を調整して、余分な部分を切り取ります。下部はトリミングされますが、地図の高さを下げて修正する必要があります。

長い国の正方形の地図

cht=map
chs=180x300
chld=GB

フランスはかなり形状が定型であるため、正方形の地図に自然にフィットします。

トップへ戻る

ズームと中央揃え

デフォルトでは、グラフはズームされて中央に配置され、選択された領域の中心に配置され、指定した地図サイズの範囲内で、レンダリング領域にできる限り近い位置に表示されます。ただし、次の 2 つの方法で、グラフの中心レベルとズームレベルをカスタマイズできます。

ピクセル単位

ピクセルサイズで枠線を調整するには、次の形式を使用します。

cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>

各枠線のサイズは、自動的に計算されたズームレベルを超える追加境界(ピクセル単位)になります。

ズームアウト(正の値)のみが可能です。ピクセル ズームを使用してデフォルトのズームレベルよりも近くズームイン(負の値)することはできません。

例:

これらすべてがロンドン(Lat)を示しています。

ズームなし(デフォルト) 片側 30 ピクセルのズームアウト 右下にズームアウト

下部に余分な空の地図が表示されている。
cht=map

下部の過剰な地図
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=50,-10,70,10


cht=map:fixed=48,-3,54,3

中央の画像のサイズは同じ角度で上に移動していても、最初の画像よりも少し小さくなります。これは、3D 球を 2D 画像に投影するためです。2 つ目のグラフの幅を、最初のグラフと同じにするには拡大する必要があります。

トップへ戻る

標準の機能

このページの残りの機能は、標準的なグラフ機能です。

グラフのタイトル chttchts [すべてのグラフ]

グラフのタイトルのテキスト、色、フォントサイズを指定できます。

構文

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt - グラフのタイトルを指定します。

<グラフのタイトル>
グラフに表示するタイトル。テキストが表示される場所は指定できませんが、必要に応じてフォントサイズと色を指定できます。スペースは + 記号で、改行はパイプ文字(|)で示します。

 

chts(省略可)- chtt パラメータの色とフォントサイズ。

<color>
タイトルの色。RRGGBB の 16 進数形式で指定します。デフォルトの色は黒です。
<font_size>
タイトルのフォントサイズ(ポイント数)。
<opt_alignment>
(省略可): タイトルの配置。大文字と小文字を区別する次のいずれかの文字列値を選択します: "l" (左) "c" (中央揃え) "r" (right)デフォルトは &ct;c" です。

 

説明

タイトルとグラフ(デフォルトの色とフォントサイズを使用)。

スペースはプラス記号(+)で指定します。

パイプ文字(|)を使用して改行します。

chts は指定されていません。

タイトル付きの縦棒グラフ
chtt=Site+visitors+by+month|
January+to+July

20 ポイントの右揃えの青いタイトルのグラフ。

青色、20 ピクセル、タイトルの縦棒グラフ
chtt=Site+visitors
chts=FF0000,20,r

トップへ戻る

グラフのマージン chma [すべてのグラフ]

グラフの余白のサイズをピクセル単位で指定できます。マージンは、指定されたグラフサイズ(chs)から内側に計算されます。マージンサイズを増やしてもグラフの合計サイズは増加しませんが、必要に応じてグラフ領域が縮小されます。

余白は、グラフのサイズが算出された後、デフォルトでは残りすべてとなります。 このデフォルト値はグラフのタイプによって異なります。指定する余白は最小値です。グラフの余白により余白が作られる場合は、いくらの余白も残ることになります。余白や余白を凡例やラベルの値よりも小さくすることはできません。グラフの基本的な部分を示す図を以下に示します。

グラフの余白、凡例、グラフの領域

グラフの余白には、軸ラベルと凡例領域が含まれます。凡例領域のサイズはテキストに合わせて自動的に変更されます。ただし、chma を使用して幅を広く指定した場合は、マージンサイズが大きくなり、グラフ領域が縮小されます。小さすぎるサイズを指定して凡例を切り抜くことはできませんが、必要以上にスペースを占有することは可能です。

ヒント: 棒グラフでは、棒が固定サイズ(デフォルト)になっている場合、グラフ領域の幅を縮小することはできません。chbh を使用して、より小さいまたはサイズ変更可能なバーサイズを指定する必要があります。

 

構文

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 ピクセルを超えているため、右側の余白はグラフの凡例の幅に設定され、他のマージンとは異なります。

軸ラベルはプロット領域の外側にあるため、マージン空間内に描画されます。

両側に灰色の背景と余白を付けた折れ線グラフ
chma=30,30,30,30

凡例の周囲に余白を追加するには、<opt_legend_width> パラメータと <opt_legend_height> パラメータの値を設定します。

この例では、凡例の幅が約 60 ピクセルになっています。<opt_legend_width> を 80 ピクセルに設定した場合、マージンは凡例の外側 20 ピクセルまで拡大されます。

両側に灰色の背景と余白を付けた折れ線グラフ
chma=20,20,20,30|80,20

トップへ戻る

背景の塗りつぶしchf [すべてのグラフ]

グラフのデータ領域やグラフ全体に対して、塗りつぶしの色やスタイルを指定できます。塗りつぶしタイプには、単色塗りつぶし、ストライプ塗りつぶし、グラデーションなどがあります。さまざまな領域(グラフ領域全体、またはデータ領域のみなど)に対して、異なる塗りつぶしを指定できます。グラフ領域を塗りつぶすと、背景の塗りつぶしは上書きされます。すべての塗りつぶしは chf パラメータを使用して指定され、同じチャート内でさまざまな塗りつぶしタイプ(実線、ストライプ、グラデーション)を混在させる場合は、値をパイプ文字(|)で区切ってください。グラフの塗りつぶしはグラフの背景の塗りつぶしを上書きします。

塗りつぶしchf [すべてのグラフ]

背景やグラフ領域に単色塗りつぶしを指定するか、グラフ全体に透明度の値を割り当てることができます。パイプ文字(|)を使用して複数の塗りつぶしを指定できます(マップ: 背景のみ)。

構文

chf=<fill_type>,s,<color>|...
<fill_type>
グラフの塗りつぶしの部分。次のいずれかの値を指定します。
  • bg - 背景の塗りつぶし
  • c - グラフの塗りつぶしエリア。マップチャートではサポートされていません。
  • a - グラフ全体(背景を含む)を透明にします。 <color> の最初の 6 桁は無視され、最後の 2 桁(透明値)のみがグラフ全体とすべての塗りつぶしに適用されます。
  • b<index> - 棒グラフの塗りつぶし(棒グラフのみ)。 <index> を棒グラフの系列インデックスに書き換えて、単色で塗りつぶす。作用は、棒グラフで chco を指定することに似ています。例については、棒グラフの系列の色をご覧ください。
s
塗りつぶし効果(透明または塗りつぶし)を示します。
<>
塗りつぶし色(RRGGBB の 16 進数形式)。透明度の場合、最初の 6 桁は無視されますが、必ず含める必要があります。

 

説明

この例では、グラフの背景を淡いグレー(EFEFEF)で塗りつぶしています。

黒い領域に塗りつぶされた赤い折れ線グラフ

chf=bg,s,EFEFEF

この例では、グラフの背景を淡いグレー(EFEFEF)で塗りつぶし、グラフ領域を黒(000000)で塗りつぶしています。

黒いチャートエリアと淡いグレーの背景を持つ赤い折れ線グラフ

chf=c,s,000000|
bg,s,EFEFEF

この例では、グラフ全体に 50% の透明度を適用します(16 進数で 80、つまり約 50% の透明度)。テーブルセルの背景がグラフで表示されます。

青色の点で散布図。透明度 50%。

chf=a,s,00000080

トップへ戻る

グラフの凡例のテキストとスタイル chdlchdlpchdls [すべてのグラフ]

凡例は、各時系列の簡単な説明をグラフに示した側面セクションです。この凡例の各シリーズに関連付けられたテキストと、グラフ内の表示位置を指定できます。

凡例の余白を設定する方法については、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=bvchdlp=rchdlp=bv|rchdlp=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 - (省略可)凡例のテキストの色とフォントサイズを指定します。

<>
RRGGBB の 16 進数形式の凡例のテキストの色です。
<size>
凡例テキストの点のサイズ。

 

説明

凡例の 2 つの例。凡例は、データ系列と同じ順序で指定します。

凡例が一致する赤、青、緑の折れ線グラフ

chdl=NASDAQ|FTSE100|DOW
chco=FF0000,00FF00,0000FF

大きな円で囲まれた 2 つの小さい円のベン図


chdl=First|Second|Third
chco=ff0000,00ff00,0000ff

1 つ目のグラフは凡例の横方向のエントリ(chdlp=t、デフォルトのレイアウトは横方向)を示し、2 つ目のグラフは下部の縦方向の凡例項目(chdlp=bv)を示しています。

大きな円で囲まれた 2 つの小さい円のベン図
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=t


大きな円で囲まれた 2 つの小さい円のベン図
chdl=First|Second|Third
chco=ff0000,00ff00,0000ff
chdlp=bv

この例では、フォントサイズを変更しています。

大きな円で囲まれた 2 つの小さい円のベン図
chdls=0000CC,14

トップへ戻る

シェイプ マーカー chm [Bar、Line、Radar、Scatter]

グラフ上のすべてまたは個々のデータポイントにグラフィカル マーカーを指定できます。2 つ以上のマーカーが同じポイントを占有している場合、マーカーは 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_Which_points> で x:y 形式を使用します。
<マーカータイプ>
使用するマーカーのタイプ。次のいずれかのタイプを指定します。
  • a - 矢印
  • c - クロス
  • C - 長方形。長方形のマーカーの場合は、少なくとも 2 つのデータ系列が必要です。系列 0 は下端を指定し、系列 1 は上端を指定します。<size> は、長方形の幅をピクセル単位で指定します。
  • d - ダイヤモンド
  • E - エラーバー マーカー()このマーカーを作成するには、2 つのデータ系列(最下部は値、上は 2 番目の系列)が必要です。また、<size> 拡張構文: line_thickness[:top_and_Bottom_width] も公開されます。top_and_Bottom_width は任意です。以下の例をご覧ください。
  • h - グラフを横方向に指定した高さの線。( <opt_Which_points> パラメータで有効な形式は n.d のみです)。
  • H - 指定されたデータマーカーを通る水平線。これは、拡張された <lt;size> 構文をサポートしており、正確なライン長を指定できます。line_thickness[:length] :length はオプションで、デフォルトはグラフの全幅です。
  • o - 円
  • s - スクエア
  • v - X 軸からデータポイントへの垂直線。
  • V - 調整可能な長さの垂直線。これは、拡張された< size> 値構文をサポートしています。構文では、正確な線の長さを指定できます。line_thickness[:length] :length はオプションで、デフォルトはグラフの全高です。 マーカーはデータポイントの中心に配置されます。
  • x - X
<>
: このシリーズのマーカーの色。RRGGBB の 16 進数形式で指定します。
<series_index>
: マーカーを描画するデータ系列(0 から始まるインデックス)。h マーカーと、位置情報を x/y 位置(@ 文字で始める)で指定するマーカーでは無視されます。非表示のデータ系列は、マーカーのソースとして使用できます。詳細については、複合グラフをご覧ください。グループ化された縦棒グラフでは、マーカーを特定の棒に揃えるために、特別な拡張構文がサポートされています。
<opt_what_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 - 開始終了のインデックス値の範囲(n 個)のすべてのデータポイントにマーカーを描画します。すべてのパラメータは省略可能であるため(存在しない場合もあります)、3::1 は 4 つ目の要素から最後のステップ 1 までのステップ 1 になります。このパラメータを完全に省略すると、デフォルトで first:last:1 になります。すべての値を浮動小数点数で指定できます。startend を負の値に指定すると、最後の値から逆方向にカウントできます。開始終了の両方が負の場合は、値が増加している値(-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> - 垂直オフセットを指定する正または負の数値(ピクセル単位)。省略可。使用しない場合は空白のままにします。

 

説明

ここでは、複数の図形と線マーカーの例を示しています。

  • a,990066,0,0.0,9.0 - 紫色の矢印、最初の系列、最初の点、サイズ 9。
  • c,FF0000,0,1.0,20.0 - 赤十字、最初の系列、2 つ目の点、サイズ 9。
  • d,80C65A,0,2,20.0 - 緑色のひし形、最初のシリーズ、3 つ目の点、サイズ 9。
  • H,000000,0,3,1:40 - 黒色の横線、最初の系列、データポイント 3、幅 1 ピクセル、長さ 40 ピクセル。
  • o,FF9900,0,4.0,12.0 - オレンジ色の円、最初のシリーズ、5 番目の点、サイズ 12。
  • s,3399CC,0,5.0,11.0 - 青い四角形、最初の系列、6 番目の点、サイズ 11。
  • v,BBCCED,0,6.0,1.0 - 垂直線(最初の点まで)、最初の時系列、7 つ目の点、幅 1 ピクセル。
  • V,3399CC,0,7.0,1.0 - グラフの下から上への垂直線、最初の系列、8 つ目の点、幅 1 ピクセル。
  • x,FFCC33,0,8.0,20.0 - 黄 ' X'、最初のシリーズ、9 番目のポイント、サイズ 20。
  • H,FFFF00,0,9,2 - データポイント 9 のグラフの横幅の黄色の線。
  • h,FF0000,0,0.5,1 - 指定された高さの赤い水平線、1 つ目の系列、グラフの半分、幅 1 ピクセル。
マーカーのある折れ線グラフ
chm=
  a,990066,0,0.0,9.0|
  c,FF0000,0,1.0,20|
  d,80C65A,0,2.0,20.0|
  H,000000,0,3,1:40|
  o,FF9900,0,4.0,12.0|
  s,3399CC,0,5.0,11.0|
  v,BBCCED,0,6,1.0|
  V,3399CC,0,7,1.0|
  x,FFCC33,0,8,20|
  H,FFFF00,0,9,2|
  h,FF0000,0,0.5,1

ここでは、1 つのデータ系列にはひし形、もう 1 つのデータ系列には円を使用している例を示します。

2 つ以上のマーカーが同じポイントを占有している場合、マーカーは chm パラメータに表示されている順序で描画されます。ここでは、円は chm で指定された最初のマーカーであるため、最初に描画されます。ひし形は 2 番目に指定されて描画されるため、円の上に描画されます。

折れ線グラフの場合、各データポイント上に 15 ピクセルの円があり、もう一方の線に 10 ピクセルのひし形が表示されている。両線に共通する点にひし形が描画される
chm=
  o,FF9900,0,-1,15.0|
  d,FF0000,1,-1,10.0

ここでは、2 秒ごとのデータポイント上にマーカーを配置した折れ線グラフがあります(-2 は他のすべてのポイントを意味します)。

1 秒おきにマーカーが配置された折れ線グラフ
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-2,6
ここでは、データポイントの 2 倍の数のマーカーがある折れ線グラフです(-0.5 は 0.5 ポイントごとに意味します)。 1 秒おきにマーカーが配置された折れ線グラフ
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-.5,6
この例では、h マーカーと v マーカーを使用して、カスタムの配線と太さのグリッド線を作成する方法を示しています。Z オーダーの値(最後の値)は -1 に設定されており、データ線の下にグリッド線が描画されます。
1 秒おきにマーカーが配置された折れ線グラフ
chm=
  h,76A4FB,0,0:1:.2,2,-1|
  V,76A4FB,0,::2,0.5,-1

このグラフでは、折れ線グラフに縦方向の塗りつぶし線が追加されています。

  • v - グラフの垂直線。
  • FF0000 - 赤色の線
  • 0 - 系列インデックス
  • : :.5 - 範囲指定子: 開始から終了まで、0.5 ポイントごと。
  • 2 - 太さ 2 ピクセル。
1 秒おきにマーカーが配置された折れ線グラフ
chm=
  v,FF0000,0,::.5,2
この例では、正確な座標を使用して、グラフに矢印とテキスト マーカーを追加しています。最初の D マーカーは、棒の下にあるトレース線です。2 つ目のマーカーは矢印で、3 つ目のマーカーは矢印テキストです。
chm=
  D,003971,1,0,3|
  @a,000000,0,.25:.75,7|
  @tExpected,000000,0,.35:.85,10
特定のデータポイント(H)に固定された水平線は、相対値を表示する場合や、グラフ上のデータ値の高さを強調する場合に役立ちます。
chm=H,FF0000,0,18,1

このグラフでは、<size> パラメータで線の太さと長さを設定できるマーカーを示しています。

  • E,000000,0,6,1:20 - 黒いエラーバー(縦 1 ピクセルの線、上下バー 20 ピクセル)下はシリーズ 0 ポイント 8 に固定され、下はシリーズ 1 ポイント 8 に固定されます。
  • H,990066,1,2,5:50 - 紫色の横線、幅 5 ピクセル、データポイント 2 を中心とする長さ 50 ピクセル。
  • V,3399CC,0,8,3:50- 青色の縦線: 幅 3 ピクセル、長さ 50 ピクセル、データポイント 8 を中心とする。

chm=
  E,000000,0,6,1:20|
  H,990066,1,2,5:50|
  V,3399CC,0,8,3:50

トップへ戻る

テキスト / データ値マーカー chm [Bar、Line、Radar、Scatter]

グラフ内の特定のポイントには、カスタム テキストまたは特定の時点でのデータ形式のバージョンを使用してラベルを付けることができます。

パイプ文字(|)を使用して 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>
<マーカータイプ>
使用するマーカーのタイプ。次のタイプから選択できます。
  • f<text> - テキストを含むフラグ。&f3# の後に、URL エンコードされたカスタム テキストを指定します。テキスト マーカー内でカンマをエスケープするには、カンマの前に \ マークを付けます。例: fHello\,+World!
  • t<text> - シンプルなテキスト マーカー。「't'」に続けて、カスタム URL エンコード テキストを指定します。テキスト マーカー内でカンマをエスケープするには、カンマの前に \ マークを付けます。例: tHello\,+World!
  • A<text> - アノテーション マーカー。これはフラグ マーカーに似ていますが、マーカーが重複しないように位置を調整します。<opt_what_points> の有効な形式は n.d で、系列内の点のインデックスを示します。
  • 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 - グループの区切り文字を表示します。デフォルトは「いいえ」です。
      • x または y - x 座標または y 座標のデータを、指定されたとおりに表示します。x データの意味はグラフの種類によって異なります。さまざまなグラフを試して、その意味を確認してください。デフォルトは 'y' です。
    • <following_text> - 各値に従うテキスト。
<>
このセットのマーカーの色。RRGGBB の 16 進数形式で指定します。
<series_index>
: マーカーを描画するデータ系列(0 から始まるインデックス)。これが積み上げ棒グラフで、マーカー タイプが N(データポイントの値)の場合、-1 を指定すると、積み重ねられた棒グラフごとに合計値マーカーが作成されます。以下に例を示します。
<opt_what_points>
(省略可): マーカーを描画するポイント。デフォルトはすべてのマーカーです。次の値のいずれかを使用できます。
  • n.d - マーカーを描画するデータポイント。n.d はシリーズ内のゼロベースのインデックスです。整数以外の値を指定すると、この分数は計算された中間点を示します。たとえば、3.5 はポイント 3 とポイント 4 の中間を意味します。
  • -1 - すべてのデータポイントにマーカーを描画します。このパラメータを空白のままにして、すべてのデータポイントに描画することもできます。
  • -n - n 番目のデータポイントごとにマーカーを描画します。
  • start:end:n - 開始終了インデックス値の範囲内の n 番目のデータポイントすべてにマーカーを描画します。すべてのパラメータは省略可能であるため(存在しない場合もある)、3::1 は 4 つ目の要素から最後のステップ 1 までのステップ 1 になります。このパラメータを省略すると、デフォルトで first:last:1 になります。すべての値を浮動小数点数で指定できます。startend を負の値に指定すると、最後の値から逆方向にカウントできます。startend の両方が負の値の場合は、値を増やすようにリストします(例: -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,,bN,000000,0,1,10,,lvN,000000,0,1,10,,r::10
水平方向と水平方向の両端揃え
マーカーのアンカー ポイント。この場合、両端揃えとは逆の動作になるため、左アンカーでは実際にマーカーはデータポイントのに配置されます。次のリストから水平または垂直の両端揃えを選択できます。
  • 水平配置: 'l'、'h'、'r' - 左、中央、または右にアンカー。デフォルトは 'l' です。
  • 垂直方向の配置: 'b'、'v'、't' - 下、中央、または上部に固定(垂直)。デフォルトは 'b' です。
  • 棒グラフで配置する場合(棒グラフのみ): 's'、'c'、'e' - バーの中心、中央、または上部。積み上げ棒グラフの場合、これは棒グラフ全体ではなく、各シリーズの棒のセクションに対する相対値となります。シリーズ系インデックスが -1(スタック合計)の場合、棒全体に対する相対順序になります。縦向きのプレースメント値と組み合わせることができます(例: 'be' または 'vs')。デフォルト値は 'e' です。
horizontal_offset
このマーカーの水平オフセット(ピクセル単位)。デフォルトは 0 です。
vertical_offset
このマーカーの垂直オフセット(ピクセル単位)。棒グラフ以外: デフォルト 15、棒グラフのデフォルト: 2

説明

このグラフは、棒グラフに表示される値ラベルの例です。

最初のグラフ(N*p0*)は、データ値マーカーを指定します。値はパーセント値で表示され、小数点以下 0 桁に四捨五入されて 11 ポイントのテキストになります。データ値はすべて 0.0 ~ 1.0 で、パーセント形式では小数点以下 2 桁上に移動します。

2 番目のグラフ(N*cEUR1*)は、同じ値をユーロ値、10 進法で表した小数点以下 1 桁、11 ポイントのテキストで示します。

各棒の上に割合ラベルが表示された棒グラフ
chm=
  N*p0*,000000,0,-1,11
chd=t:
  0.4356,0.3562,0.4834,0.575,0.673,0.6091


各棒の上にユーロラベルが表示された棒グラフ


chm=
  N*cEUR1*,000000,0,-1,11

chds パラメータを使用して、表示される数値をスケーリングできます。chds は、単純なエンコードや拡張されたエンコードを含め、すべてのデータ形式に使用できます。これは、バーのサイズや軸ラベルには影響せず、データ マーカーの値のみに影響します。

次の例は、46、39、29、30、43、41 のシンプルな値がエンコードされたグラフです。シンプルなエンコード範囲は 0 ~ 61 です。chds パラメータでは、カスタム マーカー(0 ~ 1)のスケールが定義されているため、マーカーの値はこの範囲にスケーリングされます。ただし、バーの高さは影響を受けません(テキスト形式のデータの場合はバーもスケーリングされます)。


chd=s:underp
chm=N,000000,0,-1,11
chds=0,1

グラフの例として、最小点にテキストラベル、最大点にフラグラベルがあります。

10 点の青いテキストラベルが付いた折れ線グラフと 15 点の赤いテキストで示された旗が緑の破線のデータポイントに描画されている。
chm=
  tMin,0000FF,0,1,10|
  fMax,FF0000,0,3,15

この例は、個々の系列の値と系列の合計値を含む積み上げグラフを示しています。積み上げ系列の値を表示するには、位置決めオプション 'c' を使用する必要があります。指定しない場合、上の棒の値は各棒の最上部の合計値と重なります。
chm=
  N,FF0000,-1,,12|
  N,000000,0,,12,,c|
  N,000000,1,,12,,c|
  N,ffffff,2,,12,,c
垂直方向と水平方向の配置の仕組みをさらに示す。この例では、棒グラフのアンカー値のさまざまな組み合わせを示しています(縦配置には s、c、e を使用します)。右のアンカーでマーカーを左に、上部のアンカーでマーカーを下に移動します(その逆)。赤い点は、各棒のベース、中央、上部を示しています。 数値はデータ値であり、棒ごとにさまざまなアンカー値を使用して固定されています。
chm=
  N,000000,0,0,10,,rs
  N,000000,0,1,10,,ls
  N,000000,0,2,10,,c
  N,000000,0,3,10,,e
  N,000000,0,4,10,,e::15
  N,000000,0,5,10,,e::-12
アノテーション マーカーは、重複しないようにラベルの位置を自動的に調整します。最初の chm 値は線の塗りつぶしです。以下の値はすべてアノテーション マーカーです。 アノテーション マーカー。
chm=B,C5D4B5BB,0,0,0
  AA,666666,0,3,15
  AB,666666,0,5,15
  AC,666666,0,24,15
  AD,666666,0,25,15
  AE,666666,0,26,15
  AF,666666,0,51,15
  AG,666666,0,60,15
  AH,666666,0,73,15
  AI,666666,0,80,15
  AJ,666666,0,99,15
別のアノテーション マーカーの例で、スイスの都市高度を表す例。

トップへ戻る