マップチャート（サポート終了バージョン）

 

代替アラート: このマップチャートは新しいバージョンに置き換えられました。

このページでは、Charts API を使用して色付きの地図を作成する方法について説明します。

目次

グラフ固有の機能

  1. 概要
  2. 米国の州コード

標準機能

  1. グラフのタイトル（chtt、chts）
  2. グラフの余白（chma）
  3. 背景の塗りつぶし
    1. 単色塗りつぶし（chf）

概要

さまざまな色や国をカスタムカラーでハイライト表示した地図を作成できます。地図を指定するには、地図を拡大する世界の領域を指定します。また、地図で色付けすべき地域のリストや、対応する国ごとに数値を割り当てる並列データリストも指定します。各国は、割り当てられた値に応じてグラデーションに沿って色付けされます。必要に応じて、データ値にカスタムのカラー グラデーションを指定できます。

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

パラメータ 必須または省略可 説明
cht=t 必須 地図グラフを指定します。
chs 必須 地図のサイズ。地図の最大サイズは 440×220 です。
chtm=<zoom_area> 必須

グラフに表示されている地域です。

  • zoom_area - 次のいずれかの値。
    • africa
    • asia
    • europe
    • middle_east
    • south_america
    • usa
    • world
chld=<country_or_state_codes> 必須

値を適用する国や地域のリスト。

  • country_or_state コード - 2 文字のコードのセット。間に区切り文字はありません。次のいずれかのタイプを使用します（タイプを組み合わせることはできません）。

例: chld=DZEGMG
chd=<country_values> 必須

リージョンのリストと並行する値のリスト（値は該当するリージョンに適用されます）。値は標準の形式化されたデータ値です。各領域には、chco で指定されたスケールに沿って色が割り当てられます。範囲の最小値は最も低い色に適用され、範囲内の最高値は最後の色に適用されます。

  • country_values - 適切な形式設定文字列のリスト。例: t:10,20,30、s:aU2Ff、e:BaPoqM-A
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient> 任意

データ形式の範囲の低データ値と高データ値に対応する色の範囲。データの値はこのグラデーションに沿って色値に変換され、対応する国に適用されます。

  • default_color - （省略可）データが割り当てられていない領域の色。デフォルトは BEBEBE（中グレー）です。RRGGBB 形式の 16 進数。
  • start_of_グラデーション - （省略可）データ形式範囲内の最小値に対応する色。デフォルト値は 0000FF（青色）です。RRGGBB 形式の 16 進数。
  • ... - [省略可] 中間色をいくつでも指定できます。
  • end_of_グラデーション - （省略可）データ形式範囲内の最大値に対応する色。デフォルトは FF0000（赤）です。RRGGBB 形式の 16 進数
chtt, chts 任意 グラフのタイトルとスタイル
chma 任意 グラフの余白
chf=bg 任意 単色塗りつぶし（バックグラウンドのみ）

 

例

説明 例

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

  • グラフのズームエリアはアフリカ（chtm=africa）です。
  • 3 か国（アルジェリア、エジプト、マダガスカル（chld=DZEGMG））に値が割り当てられます。
  • これらの国に割り当てられた 3 つの値は、それぞれ 0、100、50（chd=t:0,100,50）です。それぞれ、テキスト形式データの最小値、最大値、中間値です。
  • 色の範囲は、0 が赤、100 が緑、割り当てられていない国が白（chco=FFFFFF,FF0000,00FF00）です。
  • グラフには、背景色が水色（chf=bg,s,EAF7FE）になっています。

アフリカの地図
cht=t
chtm=africa
chld=DZEGMG
chd=t:0,100,50
chco=FFFFFF,FF0000,00FF00
chf=bg,s,EAF7FE

このグラフは前のグラフと似ていますが、詳細です。

 アフリカの地図
chtm=africa
chld=DZEGMGAOBWNGCFKECGCVSNDJTZGHMZZM
chco=FFFFFF,FF0000,FFFF00,00FF00
chd=t:0,100,50,32,60,40,43,12,14,54,98,17,70,76,18,29
chf=bg,s,EAF7FE

このグラフでは、未定義の値（chd=t:-1）を 1 つ指定することで、どの国がハイライトされないかを確認できます。

 世界地図
chs=440x220
chd=t:-1
cht=t
chtm=world

トップへ戻る

米国の州コード

地図が米国（chld=usa）にズームインしたときでサポートされる州コードは次のとおりです。

AL Alabama ロサンゼルス ルイジアナ OH オハイオ
AK アラスカ ME メイン OK オクラホマ
AZ Arizona MD メリーランド または オレゴン
AR アーカンソー MA マサチューセッツ PA ペンシルバニア
CA カリフォルニア MI ミシガン RI ロードアイランド
CO Colorado MN ミネソタ SC サウスカロライナ
CT コネチカット MS ミシシッピ SD サウスダコタ
DE デラウェア MO ミズーリ TN テネシー
FL フロリダ MT モンタナ TX テキサス
一般提供 ジョージア（グルジア） NE ネブラスカ UT ユタ
HI ハワイ NV ネバダ VT バーモント
ID アイダホ NH ニューハンプシャー VA バージニア
IL イリノイ NJ ニュージャージー WA ワシントン
IN インディアナ NM ニューメキシコ WV ウェストバージニア
IA アイオワ NY ニューヨーク WI ウィスコンシン
KS カンザス NC ノースカロライナ WY ワイオミング
KY ケンタッキー ND ノースダコタ

トップへ戻る

標準の機能

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

グラフのタイトル chtt、chts [すべてのグラフ]

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

構文

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

トップへ戻る

カラー形式

6 文字の 16 進数文字列と 2 つのオプションの透明度値（RRGGBB[AA] の形式）を使用して色を指定します。例:

  • FF0000 = 赤
  • 00FF00 = 緑
  • 0000FF = 青
  • 000000 = 黒
  • FFFFFF = 白色

AA はオプションの透明値です。ここで、00 は完全に透明で、FF は完全に不透明です。例:

  • 0000FFFF = 青色で点灯
  • 0000FF66 = 透明な青

トップへ戻る