代替アラート: この地図グラフは新しいバージョンに置き換えられました。
このページでは、Charts API を使ってカラーマップを作成する方法について説明します。
目次
概要
さまざまな国や州をカスタムカラーでハイライト表示した地図を作成できます。地図を指定するには、世界のどの地域に地図を拡大するかを指定します。また、マップ内で色を付ける地域のリストと、対応する各国に数値を割り当てる並列データリストも指定します。各国は、割り当てられた値に応じてグラデーションに沿って色分けされます。必要に応じて、データ値にカスタム カラー グラデーションを指定できます。
地図グラフでは、次のパラメータがサポートされています。
パラメータ | 必須または任意 | 説明 |
---|---|---|
cht=t |
必須 | 地図グラフを指定します。 |
chs |
必須 | 地図のサイズ。地図の最大サイズは 440x220 です。 |
chtm=<zoom_area> |
必須 | グラフに表示される地域。
|
chld=<country_or_state_codes> |
必須 | 値を適用する国または州のリスト。
例: |
chd=<country_values> |
必須 | リージョンのリストに対応する値のリスト。値は対応するリージョンに適用されます。値は、標準の書式設定されたデータ値です。各領域には、chco で指定されたスケールに従って色が割り当てられます。範囲の最小値が最小の色に適用され、その範囲の最大値が最後の色に適用されます。
|
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient> |
任意 | データ形式の範囲の下限および上限データ値に対応する色の範囲。データ値はこのグラデーションに沿って色値に変換され、対応する国に適用されます。
|
chtt, chts |
任意 | グラフのタイトルとスタイル |
chma |
任意 | グラフの余白 |
chf=bg |
任意 | 単色塗りつぶし(背景のみ) |
例
説明 | 例 |
---|---|
この例では
|
|
このグラフは前のグラフと似ていますが、詳細です。 |
chtm=africa |
このグラフでは、未定義の単一の値( |
chs=440x220 |
米国の州法
地図を米国にズームインしたときにサポートされる州コード(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" です。
例
説明 | 例 |
---|---|
デフォルトの色とフォントサイズを使用したタイトル付きのグラフ。 プラス記号( パイプ文字( ここでは |
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% の透明度です)。表セルの背景がグラフ全体に表示されます。 |
|
RRGGBB[AA]
の形式で、6 文字の 16 進数文字列と 2 つのオプションの透明度値を使用して、色を指定します。例:
FF0000
= 赤00FF00
= 緑0000FF
= 青000000
= 黒FFFFFF
= 白
AA
はオプションの透明度値です。00
は完全に透明、FF
は完全に不透明です。例:
0000FFFF
= 青色で点灯0000FF66
= 透明な青