代替アラート: この地図グラフは新しいバージョンに置き換えられました。

このページでは、Charts API を使ってカラーマップを作成する方法について説明します。

目次

概要

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

地図グラフでは、次のパラメータがサポートされています。

パラメータ	必須または任意	説明
cht=t	必須	地図グラフを指定します。
chs	必須	地図のサイズ。地図の最大サイズは 440x220 です。
chtm=<zoom_area>	必須	グラフに表示される地域。 zoom_area - 次のいずれかの値になります。 africa asia europe middle_east south_america usa world
chld=<country_or_state_codes>	必須	値を適用する国または州のリスト。 country_or_state_code - 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_title>

グラフに表示するタイトル。このテキストが表示される場所は指定できませんが、フォントサイズと色は任意で指定できます。スペースは + 記号、改行の場合はパイプ文字（|）を使用します。

 

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

<color>

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

<font_size>

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

<opt_alignment>

（省略可）: タイトルの配置。次のいずれかの文字列値（大文字と小文字を区別）を選択します。「l」（左）、「c」（中央）、「r」（右）デフォルトは "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

トップへ戻る

トップへ戻る