表示対象: この対象物は、Android、iOS、JavaScript、Maps Static 上に表示されます。
表示中の地図のズームレベルに応じて対象物をハイライト表示することで、ユーザーのニーズに合わせて地図をカスタマイズできます。たとえば、ユーザーが特定の場所をズームインしたら、その地図上の場所や道路がハイライト表示されるようにできます。
地図上の対象物の要素は、地図のあらゆるズームレベルで常に同じスタイルで表示するよう設定できます。また、一部の要素については、ズームレベルの違いに応じて別のスタイルにすることもできます。
すべての対象物でズームレベルをカスタマイズできるわけではありません。地図上の対象物の要素の中で、ズームレベル スタイリングが可能なものには、右側にひし形のアイコンがあります。
![]()
ズームレベル スタイリングを理解する
ズームレベルは 0 から始まり、最大の 22 までズームアウトすると世界全体が表示されます。また、最大限にズームインすると、その地図の最も細かい要素が表示されます。keyzoom は、新しいスタイルの適用を始めるズームレベルです。
地図上の対象物に対し、さまざまなズームレベルごとに異なるスタイルを設定した場合、各スタイルは指定したレベルよりも上の(さらにズームインした)すべてのレベルで適用され、次のズームレベルに達すると、そのレベルのスタイルが適用されます。ズームレベル 0 には必ず現在のスタイルが適用されます。
例: ズームレベル 5 と 10 にスタイルを設定した場合:
- ズームレベル 5 のスタイルは、ズームレベル 5 ~ 9 まで適用されます。
- ズームレベル 10 のスタイルは、ズームレベル 10 ~ 22 まで適用されます。
- ズームレベル 0 ~ 4 では、現在のスタイルが維持されます。
ズームレベルに応じて地図上の対象物に適用されるカスタム スタイルは、地図上の対象物全体に適用されるどのカスタム スタイルよりも優先されます。
3D 地図のズームレベルの切り替えについて
3D 地図を傾けてズームレベルを切り替えると、設定したズームレベル スタイルの範囲外の切り替え色が表示されることがあります。
たとえば、ズームレベルのスタイルを次のように設定した場合:
- ズームレベル 10 の場合、水域の塗りつぶしの色 = 黒。
- ズームレベル 11 の場合、水域の塗りつぶしの色 = 白。
次の図に示すように、2 つのズームレベルを切り替える際に、水域の塗りつぶしの色がグレーで表示されることがあります。
さまざまなズームレベルでカスタマイズする
Cloud コンソールで [**地図のスタイル**] に移動して、 必要に応じてプロジェクトを選びます。
地図のスタイルを作成するか既存のスタイルを開き、[カスタマイズ] を選択します。 詳しくは、地図のスタイルを作成するをご覧ください。
[地図上の対象物] パネルで、カスタマイズする地図上の対象物を選びます。スタイルパネルが開き、カスタマイズできる要素が表示されます。
ズームレベル スタイリングを追加する要素で、その右にあるひし形ズームアイコンを選択し、keyzoom パネルを開きます。

[現在のズーム] の横で、カスタマイズするズームレベルを選びます。すると、そのズームレベルに合わせてプレビュー用の地図が調整されます。

[keyzoom を追加] を選択すると、選択したズームレベルに新しい keyzoom が追加され、対応するデフォルトの基本地図の値が表示されます。

必要に応じて、このズームレベルと他のズームレベルのスタイルを設定します。

別のズームレベルを設定するには、[現在のズーム] を変更して再び [keyzoom を追加] を選択し、リストに別のズームレベルを追加します。その後も必要に応じて、ズームレベルのスタイルの追加と設定を続けます。
作業が完了したら、keyzoom パネルを閉じます。
要素に使用されるデフォルトの基本地図の色の値を上書きする
すべてのズームレベルで、要素に使用されるデフォルトの基本地図の色の値をすべて上書きするには、まず要素のスタイルを設定します。keyzoom を追加すると、その keyzoom ではデフォルトの基本地図の色の値ではなく、設定した要素の色の値が使用されます。
ズームレベル スタイリングを保存して公開する
地図のスタイル設定の変更を保存するには、[保存] を選択します。
地図のスタイルに関連付けたマップ ID で変更を公開するには、[公開] を選択します。
ズームレベルのスタイルを削除する
[地図上の対象物] パネルで、カスタマイズした地図上の対象物を選びます。
スタイル要素の横にある右側のひし形アイコンを選択します。 カスタムのズームレベル スタイリングが設定された要素には、青で塗りつぶされたひし形アイコンが表示されています。

keyzoom パネルで、マイナス アイコンを選択してズームレベルを削除します。

ズームレベルのスタイルをすべて削除する
地図上の対象物の要素からカスタム スタイルをすべて削除する場合は、次のいずれかを行います。
- [スタイルパネル] で、要素名の横にある マイナス アイコンを選択します。
- [keyzoom パネル] で、要素名の横にあるリセット アイコン を選択します。
道路レベルの詳細をプレビューする
一部の都市では、既存のスタイル(リアルな道路幅、歩道、車線のマーキングなど)で、ズームレベル 17 以上で道路レベルの詳細をプレビューできます。プレビューは、スタイル エディタのセッションごとに有効にする必要があります。これらの道路の詳細地図上の対象物は、道路レベルの詳細をサポートする SDK または API でのみ表示されます。アプリで適用するには、関連する SDK または API を道路レベルの詳細をサポートするバージョンに更新する必要があります。API と SDK のバージョンの詳細については、Google Maps Platform の道路 レベルの詳細をご覧ください。
道路の詳細プレビューを有効にする手順は次のとおりです。
Google Cloud コンソールで、[地図のスタイル] に移動します。
既存のスタイルを選択するか、[スタイルを作成] を選択します。
[カスタマイズ] をクリックします。
スタイル エディタで、[道路の詳細プレビュー] をクリックします。
プレビュー ダイアログで、[道路の詳細] をオンに切り替えます。
スタイルを設定できる道路レベルの詳細については、スタイル設定が可能な要素 地図でをご覧ください。
ズームレベル 17 以上のスタイル切り替えをスムーズにするためにズームレベルのスタイルを追加する
道路レベルの詳細が有効になっているズームレベル 17 以上では、道路地図上の対象物が消え、代わりにサーフェス地図上の対象物が表示されます。ズームインすると、サーフェス地図上の対象物に適用されるスタイル設定された要素が表示され、道路地図上の対象物とスタイルが置き換えられます。
地図上の対象物のスタイルの切り替えをスムーズにするには、ズームレベルのスタイルを追加して、特定のズームレベル間でスタイルの色を固定します。ズームレベルのスタイルを使用して、新しいスタイルの色にスムーズに切り替えるタイミングを制御することもできます。
たとえば、ズームレベル 16 では、リストされている地図上の対象物は次のようにスタイル設定されます。
- 幹線道路は赤。
- 高速道路は青。
- 一般道路は黄。
- サーフェスはベージュ。
ズームレベル 17 にズームインすると、幹線道路、高速道路、一般道路がサーフェス地図上の対象物に変わり、ベージュでスタイル設定されます。
道路地図上の対象物とサーフェス地図上の対象物の切り替えをスムーズにするには、次の keyzoom とズームレベル スタイリングを追加します。
| 地図上の対象物 | ズームレベル 0 | ズームレベル 12 | ズームレベル 17 |
|---|---|---|---|
| 幹線道路 | 赤 | 赤 | ベージュ |
| 高速道路 | 青 | 青 | ベージュ |
| 一般道路 | 黄 | 黄 | ベージュ |
ズームレベル スタイリングを追加すると、ズームイン時に次のようになります。
- 幹線道路、高速道路、一般道路には、ズームレベル 0 ~ 12 のカスタム スタイル設定の色が表示されます。
- ズームレベル 12 を超えると、スタイル設定された色がベージュにフェードし始め、ズームレベル 17 でサーフェス地図上の対象物のスタイルのベージュに完全に切り替わります。