交換に関するアラート: このマップグラフは新しいバージョンに置き換えられました。
このページでは、Charts API を使って色付き地図を作成する方法について説明します。
目次
概要
さまざまな国や州をカスタムカラーでハイライト表示した地図を作成できます。地図を指定するには、地図でズームインする世界の地域を指定します。また、地図で色を付ける地域のリストと、対応する各国に数値を割り当てる並列データリストも指定します。各国は、割り当てられた値に応じて、グラデーションに沿って色分けされます。必要に応じて、データ値のカスタム カラー グラデーションを指定できます。
マップグラフは次のパラメータをサポートしています。
パラメータ | 必須または省略可 | 説明 |
---|---|---|
cht=t |
必須 | マップグラフを指定します。 |
chs |
必須 | 地図のサイズ。地図の最大サイズは 440×220 です。 |
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_titlechart_title>
- グラフに表示するタイトル。表示位置を指定することはできませんが、必要に応じてフォントサイズと色を指定できます。スペースを示すには + 記号を、改行はパイプ文字(
|
)で表します。
chts
(省略可)- chtt
パラメータの色とフォントサイズ。
- <color>
- タイトルの色(RRGGBB の 16 進数形式)。デフォルトの色は黒です。
- <font_size>
- タイトルのフォントサイズ(ポイント単位)。
- <opt_alignment>
- (省略可)タイトルの配置。「l」(左)、「c」(中央)、「r」(右)の文字列値(大文字と小文字を区別)から 1 つを選択します。デフォルトは「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% の透明度です)。グラフの上にテーブルセルの背景が表示されます。 |
|
16 進数の 6 文字の文字列と 2 つのオプションの透明度値(RRGGBB[AA]
の形式)を使用して、色を指定します。次に例を示します。
FF0000
= 赤00FF00
= 緑0000FF
= 青000000
= 黒FFFFFF
= 白色
AA
はオプションの透明度値です。00
は完全に透明で、FF
は完全に不透明です。次に例を示します。
0000FFFF
= 青色で点灯0000FF66
= 透明な青