Maps Static API を使用して独自のスタイルを適用し、標準の Google マップをカスタマイズしましょう。道路、公園、市街地、その他の名所などの対象物の視覚的表示を変更できます。色やスタイルを変更して、特定のコンテンツを強調したり、ページの周囲のコンテンツを目立たせたり、機能を完全に非表示にしたりします。
例
次の例は、地方道を明るい緑色に、居住地を黒にスタイル設定した米国ブルックリンの地図を示しています。またラベルの明度を反転させて、暗い背景でより目立つようにしています。この動作を示す例では、URL エンコードを使用しています。
https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=15¢er=Brooklyn&style=feature:road.local%7Celement:geometry%7Ccolor:0x00ff00&style=feature:landscape%7Celement:geometry.fill%7Ccolor:0x000000&style=element:labels%7Cinvert_lightness:true&style=feature:road.arterial%7Celement:labels%7Cinvert_lightness:false&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
次の例では、スタイル処理と簡素化によって、一般的なアメリカの道路図のような地図を表示しています。
https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=12¢er=Chicago&format=png&style=feature:road.highway%7Celement:geometry%7Cvisibility:simplified%7Ccolor:0xc280e9&style=feature:transit.line%7Cvisibility:simplified%7Ccolor:0xbababa&style=feature:road.highway%7Celement:labels.text.stroke%7Cvisibility:on%7Ccolor:0xb06eba&style=feature:road.highway%7Celement:labels.text.fill%7Cvisibility:on%7Ccolor:0xffffff&key=YOUR_API_KEY&signature=DITIGAL_SIGNATURE
スタイルの構文
スタイル化されたカスタム マップを作成するには、1 つ以上の style パラメータをリクエスト URL に含めます。
各 style 宣言には、次の引数をパイプ文字（|）で区切って含めることができます。
feature（省略可）: このスタイル変更を適用する地物を指定します。地物は、道路、公園、またはその他の有名スポットなど、マップ上に存在する物です。feature引数を指定しない場合、指定されたスタイルはすべての地物に適用されます。element（省略可）: このスタイル変更を適用する特定の地物の要素を指定します。要素とは、ジオメトリやラベルなど、対象物の特性のことです。element引数が存在しない場合、スタイルは指定した対象物のすべての要素に適用されます。- 指定した対象物と要素に適用するスタイルルールのセット（必須）。API はこの規則を
style宣言で記述した順序で適用します。Maps Static API の通常の URL 長制限内であれば、任意の数の規則を含めることができます。
style=feature:myFeatureArgument|element:myElementArgument|myRule1:myRule1Argument|myRule2:myRule2Argument
機能
次の style 宣言は、マップ上のすべての道路に色を付けます。
style=feature:road|color:0xffffff
以下に、地物の一般的な選択例を示します。
feature:all（デフォルト）: マップ上のすべての地物を選択します。feature:road: マップ上のすべての道路を選択します。feature:road.local: すべての地方道路を選択します。
対象物または対象物のタイプとは、道路、公園、水域、企業や店舗など、マップ上の地理的特性のことです。
対象物は、all をルートとするツリー構造で分類されます。対象物を指定しない場合、すべての対象物が選択されます。対象物を all として指定した場合も、すべての対象物が選択されます。
一部の対象物には、ドット表記で指定した子対象物が含まれます。たとえば、landscape.natural や road.local などです。road などの親対象物のみを指定した場合、親対象物に指定したスタイルは、road.local や road.highway などのすべての子対象物に適用されます。
親対象物に含まれる要素は、その子対象物すべてに含まれない場合があることに注意してください。
利用できる対象物は次のとおりです。
all（デフォルト）: すべての対象物を選択します。administrative: すべての行政区域を選択します。スタイルは行政区域のラベルのみに適用され、地理的境界や形状の塗りつぶしには適用されません。administrative.country: 国を選択します。administrative.land_parcel: 土地区画を選択します。administrative.locality: 地域区分を選択します。administrative.neighborhood: 周辺地域を選択します。administrative.province: 県 / 州を選択します。
landscape: すべての風景を選択します。landscape.man_made: ビルディングやその他の建物など、人工の対象物を選択します。landscape.natural: 山、河川、砂漠、氷河などの自然の対象物を選択します。landscape.natural.landcover: 土地被覆の対象物や、森林、草地、湿地などの地表を覆う物理的な物質、裸地を選択します。landscape.natural.terrain: 標高、勾配、方位など、地表にある地形の対象物を選択します。
poi: すべてのスポットを選択します。poi.attraction: 観光名所を選択します。poi.business: 企業や店舗を選択します。poi.government: 政府機関を選択します。poi.medical: 病院、薬局、警察、医師などの緊急サービスを選択します。poi.park: 公園を選択します。poi.place_of_worship: 教会、寺院、モスクなどの礼拝所を選択します。poi.school: 学校を選択します。poi.sports_complex: スポーツ施設を選択します。
road: すべての道路を選択します。road.arterial: 幹線道路を選択します。road.highway: 高速道路を選択します。road.highway.controlled_access: 出入り口が制限されている高速道路を選択します。road.local: 地方道を選択します。
transit: 交通機関のすべての駅、停留所、空港、路線を選択します。transit.line: 交通機関の路線を選択します。transit.station: 交通機関のすべての駅、停留所、空港を選択します。transit.station.airport: 空港を選択します。transit.station.bus: バスの停留所を選択します。transit.station.rail: 鉄道駅を選択します。
water: 水域を選択します。
要素
次の style 宣言では、すべてのローカル道路のラベルに色を付けます。
style=feature:road.local|element:labels|color:0xffffff
要素は対象物の下位区分です。たとえば道路は、地図上のグラフィカルな線（幾何学図形）と、道路の名称を示すテキスト（ラベル）で構成されます。
次の要素が利用可能ですが、対象物によっては、一部またはすべての要素に対応する場合や、すべての要素に非対応の場合があります。
all（デフォルト）: 指定した対象物のすべての要素を選択します。geometry指定した対象物のすべてのジオメトリ要素を選択します。geometry.fill: 対象物のジオメトリの塗りつぶしのみを選択します。geometry.stroke: 対象物のジオメトリのストロークのみを選択します。
labels: 指定した対象物に関連付けられているテキストのラベルを選択します。labels.icon: 対象物のラベル内に表示されるアイコンのみを選択します。labels.text: ラベルのテキストのみを選択します。labels.text.fill: ラベルの塗りつぶしのみを選択します。通常、ラベルの塗りつぶしは、ラベルテキストを囲む色付きのアウトラインとしてレンダリングされます。labels.text.stroke: ラベルのテキストのストロークのみを選択します。
スタイルルール
スタイル規則とは、各 style 宣言で指定された地物や要素に適用される書式オプションです。
次の style 宣言は、2 つのスタイル規則をマップ上の道路に適用します。最初の規則は、色を道路に適用します。2 番目のルールは、道路の表示を簡素化して輪郭がない細い線にしています。
style=feature:road|color:0xffffff|visibility:simplified
各 style 宣言には、パイプ文字（「|」）で区切られた 1 つ以上の演算を含める必要があります。各処理では、コロン（:）文字で引数の値を指定します。すべての処理は、指定された順序で選択対象に適用されます。
次のスタイル オプションがサポートされています。
hue（#RRGGBB形式で RGB 値を示す 16 進文字列）: 基本色を示します。注: このオプションは、Google のデフォルト スタイル（またはマップ上で定義したその他のスタイル オプション）で指定されている彩度と明度を維持したまま色相を設定します。設定された色は、基本地図のスタイルに相関しています。Google が基本地図のスタイルに変更を加えた場合、その変更は、
hueでスタイルが設定されたマップの対象物に影響を及ぼします。可能な場合は、絶対的なcolorスタイラを使用することをおすすめします。lightness（-100以上100以下の浮動小数点値）: 要素の明度の変化率です。負の値を指定すると暗くなり（-100 は黒を示す）、正の値を指定すると明るくなります（+100 は白を示す）。注: このオプションは、Google のデフォルト スタイル（またはマップ上で定義したその他のスタイル オプション）で指定されている彩度と色相を維持したまま明度を設定します。設定された色は、基本地図のスタイルに相関しています。Google が基本地図のスタイルに変更を加えた場合、その変更は
lightnessでスタイルが設定されたマップの対象物に適用されます。可能な場合は、絶対的なcolorスタイラを使用することをおすすめします。saturation（-100以上100以下の浮動小数点値）: 要素に適用する基本色の彩度の変化率です。注: このオプションは、Google のデフォルト スタイル（またはマップ上で定義したその他のスタイル オプション）で指定されている色相と明度を維持したまま彩度を設定します。設定された色は、基本地図のスタイルに相関しています。Google が基本地図のスタイルに変更を加えた場合、その変更は、
saturationでスタイルが設定されたマップの対象物に適用されます。可能な場合は、絶対的なcolorスタイラを使用することをおすすめします。gamma（0.01以上10.0以下の浮動小数点値で、1.0は無補正）: 対象の要素に適用するガンマ補正の量です。ガンマ補正は色の明度を非線形的に変更し、白や黒の値には影響を及ぼしません。通常、ガンマは複数の要素のコントラストを変更する際に使用します。たとえば、要素の縁と内部のコントラストの強弱を調整するためにガンマ補正を行うことができます。注: このオプションは、ガンマカーブを使用して、Google のデフォルト スタイルに相関する明度を調整します。Google が基本地図のスタイルに変更を加えた場合、その変更は
gammaでスタイルが設定されたマップの対象物に適用されます。可能な場合は、絶対的なcolorスタイラを使用することをおすすめします。invert_lightness（trueの場合）: 既存の明度を反転します。これは、たとえば暗い地図と白いテキストに素早く切り替える場合に便利です。注: このオプションは単に Google のデフォルト スタイルを反転します。Google が基本地図のスタイルに変更を加えた場合、その変更は
invert_lightnessでスタイルが設定されたマップの対象物に適用されます。可能な場合は、絶対的なcolorスタイラを使用することをおすすめします。visibility（on、off、またはsimplified）: マップ上での要素の表示有無あるいは表示方法を指定します。visibility がsimplifiedの場合、影響を受ける対象物から一部のスタイル機能が削除されます。たとえば、道路はアウトラインがない細い線に簡素化され、公園はラベルテキストが失われラベルアイコンが保持されます。color（#RRGGBB形式で RGB 値を示す 16 進文字列）: 対象物の色を設定します。weight（ゼロ以上の整数値）: 対象物の厚みをピクセル単位で設定します。weight を大きな値に設定すると、タイルの境界付近でクリップする場合があります。
スタイルのルールは、指定した順序で適用されます。複数の処理は、単一のスタイル処理に統合せずに、各処理をスタイル配列の個別のエントリとして定義してください。
順番が変わると結果が異なる処理もあるため、順番は重要です。スタイル処理によって変更される対象物や要素には、（通常は）既存のスタイルが適用されています。既存のスタイルが存在する場合、処理はそのスタイルに対して行われます。
色相、彩度、明度モデル
スタイル付き地図では、スタイラ処理での色の指定に色相、彩度、明度（HSL）モデルが使用されます。色相は基本色、彩度はその色の強度、明度は構成色の白や黒の相対的な量を示しています。
ガンマ補正は、色空間に対して明度を変更する操作で、通常はコントラストを強めたり弱めたりするために行われます。さらに、HSL モデルは、座標空間内で色を定義しています。hue は色相環内の回転方向を、saturation と lightness はそれぞれ異なる軸の大きさを示します。hue は、ある RGB 色空間（白と黒の色調がないことを除けば、ほとんどの RGB 色空間と同じです）で計測されます。
hue は HTML の 16 進数で色の値を示しますが、この値は彩度や明度ではなく基本色（色相環の回転方向）を決めるためだけに使用されます。彩度や明度は、変化率という形で別に指定します。
たとえば、純粋な緑色の色相を hue:0x00ff00 または hue:0x000100 として定義できます。両方の色相は同一のもので、どちらの値も、HSL 色モデルでは純粋な緑色を指します。
RGB のカラーホイール
赤、緑、青の値が等しい RGB の hue 値には、色相がありません。このような値はいずれも HSL 座標空間での回転方向を示さないためです。たとえば、"#000000"（黒）や "#FFFFFF"（白）、純粋な灰色の色調などが該当します。黒、白、灰色を表示するには、saturation をすべて取り除いて（値を -100 に設定）、代わりに lightness を調整する必要があります。
また、すでにカラースキームが設定されている既存の対象物を変更する場合は、hue などの値を変更しても既存の saturation や lightness には影響しません。