交換に関するアラート: このマップグラフは新しいバージョンに置き換えられました。

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

目次

概要

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

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

パラメータ	必須または省略可	説明
cht=t	必須	マップグラフを指定します。
chs	必須	地図のサイズ。地図の最大サイズは 440×220 です。
chtm=<zoom_area>	必須	グラフに表示される地理的エリア。 zoom_area - 次のいずれかの値 africa asia europe middle_east south_america usa world
chld=<country_or_state_codes>	必須	値を適用する国または州のリスト。 国コードまたは州コード - 2 文字のコードのセットで、間に区切り文字はありません。次のいずれかのタイプを使用します（異なるタイプを混在させることはできません）。 ISO 3166-1-alpha-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_gradient - [start_of_gradient] データ形式の範囲の最小値に対応する色。デフォルト値は 0000FF（青）です。RRGGBB 形式の 16 進数。 ... - [省略可] 中間色はいくつでも指定できます。 end_of_gradient - [end_of_gradient] データ形式の範囲の最大値に対応する色。デフォルトは 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）を指定することで、どの国もハイライト表示されないことを示しています。	chs=440x220 chd=t:-1 cht=t chtm=world

トップへ戻る

米国の州コード

以下は、地図を米国にズームインしたときでサポートされる州コード（chld=usa）です。

AL	アラバマ	ロサンゼルス	ルイジアナ	OH	オハイオ
AK	アラスカ	ME	メイン	OK	オクラホマ
AZ	アリゾナ	MD	メリーランド	または	オレゴン
AR	アーカンソー	MA	マサチューセッツ	PA	ペンシルバニア
CA	カリフォルニア	MI	ミシガン	RI	ロードアイランド
CO	コロラド	MN	ミネソタ	SC	サウスカロライナ
CT	コネチカット	MS	ミシシッピ	SD	サウスダコタ
DE	デラウェア	MO	ミズーリ	TN	テネシー
FL	フロリダ	MT	モンタナ	TX	テキサス
GA	ジョージア	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 - グラフのタイトルを指定します。

<chart_titlechart_title>

グラフに表示するタイトル。表示位置を指定することはできませんが、必要に応じてフォントサイズと色を指定できます。スペースを示すには + 記号を、改行はパイプ文字（|）で表します。

 

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

<color>

タイトルの色（RRGGBB の 16 進数形式）。デフォルトの色は黒です。

<font_size>

タイトルのフォントサイズ（ポイント単位）。

<opt_alignment>

（省略可）タイトルの配置。「l」（左）、「c」（中央）、「r」（右）の文字列値（大文字と小文字を区別）から 1 つを選択します。デフォルトは「c」です。

 

例

説明	例
デフォルトの色とフォントサイズを使用したタイトル付きのグラフ。 プラス記号（+）を使用してスペースを指定します。 改行を強制するには、パイプ文字（|）を使用します。 chts はここでは指定されません。	chtt=Site+visitors+by+month| January+to+July
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_typefill_type>

グラフの塗りつぶし部分。次のいずれかの値を指定します。

• bg - 背景塗りつぶし
• c - グラフ領域の塗りつぶし。マップグラフではサポートされていません。
• a - グラフ全体（背景を含む）を透明にします。<color> の最初の 6 桁は無視され、最後の 2 桁（透明度の値）のみがグラフ全体とすべての塗りつぶしに適用されます。
• b<index> - 棒無地塗りつぶし（棒グラフのみ）。<index> をバーのシリーズ インデックスに置き換えて、単色で塗りつぶします。これは、棒グラフで chco を指定する場合と同様です。例については、棒グラフの系列の色をご覧ください。

s

塗りつぶし（塗りつぶし）を指定します。

<color>

塗りつぶしの色（RRGGBB の 16 進数形式）。透明性を確保するため、最初の 6 桁は無視されますが、含めて含めてください。

 

例

説明	例
この例では、グラフの背景が淡いグレー（EFEFEF）で塗りつぶされます。	chf=bg,s,EFEFEF
この例では、グラフの背景を淡いグレー（EFEFEF）で塗りつぶし、グラフ領域を黒（000000）で塗りつぶします。	chf=c,s,000000| bg,s,EFEFEF
この例では、グラフ全体に 50% の透明度を適用します（16 進数の 80 は 128、つまり約 50% の透明度です）。グラフの上にテーブルセルの背景が表示されます。	chf=a,s,00000080

トップへ戻る

トップへ戻る