表示対象: この対象物は、Android、iOS、JavaScript、Maps Static 上に表示されます。
表示中の地図のズームレベルに応じて対象物をハイライト表示することで、ユーザーのニーズに合わせて地図をカスタマイズできます。たとえば、ユーザーが特定の場所をズームインしたら、その地図上の場所や道路がハイライト表示されるようにできます。
地図上の対象物の要素は、地図のあらゆるズームレベルで常に同じスタイルで表示するよう設定できます。また、一部の要素については、ズームレベルの違いに応じて別のスタイルにすることもできます。
すべての対象物でズームレベルをカスタマイズできるわけではありません。地図上の対象物の要素の中で、ズームレベル スタイリングが可能なものには、右側にひし形のアイコンがあります。
![]()
ズームレベル スタイリングを理解する
ズームレベルは 0 から始まり、最大の 22 までズームアウトすると世界全体が表示されます。また、最大限にズームインすると、その地図の最も細かい要素が表示されます。keyzoom は、新しいスタイルの適用を始めるズームレベルです。
地図上の対象物に対し、さまざまなズームレベルごとに異なるスタイルを設定した場合、各スタイルは指定したレベルよりも上の(さらにズームインした)すべてのレベルで適用され、次のズームレベルに達すると、そのレベルのスタイルが適用されます。ズームレベル 0 には必ず現在のスタイルが適用されます。
例: ズームレベル 5 と 10 にスタイルを設定した場合:
- ズームレベル 5 のスタイルは、ズームレベル 5 ~ 9 まで適用されます。
- ズームレベル 10 のスタイルは、ズームレベル 10 ~ 22 まで適用されます。
- ズームレベル 0~4 では、現在のスタイルが維持されます。
ズームレベルに応じて地図上の対象物に適用されるカスタム スタイルは、地図上の対象物全体に適用されるどのカスタム スタイルよりも優先されます。
2D ベクターマップでのズームレベルの遷移について
2D ベクターマップで 2 つの keyzoom に異なる色を設定すると、その間のズームレベルでは、それらの色がブレンドされます。アイコンの色が混ざらない。
たとえば、水域に次のズームレベル スタイルを設定したとします。
- ズームレベル 10 の場合、水域の塗りつぶしの色 = 黒。
- ズームレベル 11 の場合、水域の塗りつぶしの色 = 白。
レベル 10 と 11 の間でズームすると、次の図に示すように、水域の塗りつぶしの色がグレーになります。
3D 地図のズームレベルについて
3D roadmap マップと 3D hybrid マップで Cloud ベースのマップのスタイル設定を使用すると、ズームレベル スタイルが 2D マップとは異なる表示になります。これは、3D マップではビュー全体でズームレベルが一定ではないためです。
2D 地図では、傾斜している場合でも、ビュー全体が一度に 1 つのズームレベルでレンダリングされるため、色のブレンドによって地図全体に均一な色が生成されます。傾斜した 3D 地図では、前景は水平線付近のエリアよりも高いズームレベルでレンダリングされます。1 つのビューが複数のズームレベルにまたがっているため、近くの keyzoom スタイルは、地図全体を一度に切り替えるのではなく、前景から地平線に向かってカラー グラデーションにブレンドされます。
たとえば、3D roadmap 地図の水域に次のズームレベル スタイルを設定したとします。
- ズームレベル 10 の場合、水域の塗りつぶしの色 = 緑。
- ズームレベル 14 の場合、水域の塗りつぶしの色 = 紫。
ズームレベル 14 で 3D 地図を傾けると、両方のスタイルとそれらの間のブレンドされたシェードが同じビューに表示されます。次の図に示すように、前景は紫、中距離はブレンドされたシェード、水平線付近は緑になります。
スタイル エディタで 3D roadmap または 3D hybrid の地図タイプでスタイルをプレビューすると、[現在のズーム] に地図の中心のズームレベルが表示されます。[現在のズーム] を変更すると、スタイル エディタは、中心、傾き、方向を維持しながら、カメラの範囲(中心からの距離)を調整します。
3D 地図のズームレベル スタイルのベスト プラクティス
ズームレベル スタイルが 3D 地図で適切に機能するようにするには、次のガイドラインに沿って対応してください。
- 近くの keyzoom で調和のとれた色を使用する。傾斜ビューで滑らかで自然なグラデーションを実現するには、互いに調和する色を選択し、濁った帯に混ざり合うような不調和な色は避けてください。
- 複数の傾斜とズームレベルでスタイルをプレビューします。公開する前に、スタイル エディタで地図タイプを
3D roadmapまたは3D hybridに切り替え、地図を傾けて、ズームレベル スタイリングがどのようにブレンドされるかを確認します。
さまざまなズームレベルでカスタマイズする
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 以上では、道路地図の対象物が消え、代わりに地表地図の対象物になります。ズームインすると、[Surface] 地図対象物に適用されるスタイル設定された要素が表示され、[Road] 地図対象物とスタイルが置き換えられます。
地図上の対象物のスタイルをよりスムーズに切り替えるには、ズームレベル スタイルを追加して、特定のズームレベル間でスタイルの色を固定します。ズームレベル スタイルを使用すると、新しいスタイルカラーにスムーズに移行するタイミングを制御することもできます。
たとえば、ズームレベル 16 では、リストされている地図対象物のスタイルは次のようになります。
- 幹線道路は赤色です。
- 高速道路は青色です。
- ローカルは黄色です。
- 表面はベージュです。
ズームレベル 17 にズームインすると、幹線道路、高速道路、一般道路が、ベージュにスタイル設定された Surface 地図上の対象物に変わります。
道路地図対象物と地表地図対象物の間の遷移をスムーズにするには、次の keyzoom とズームレベル スタイリングを追加します。
| 地図上の対象物 | ズームレベル 0 | ズームレベル 12 | ズームレベル 17 |
|---|---|---|---|
| 幹線道路 | 赤 | 赤 | ベージュ |
| 高速道路 | 青 | 青 | ベージュ |
| ローカル | 黄 | 黄 | ベージュ |
ズームレベル スタイリングを追加した後、ズームインすると次のようになります。
- 幹線道路、高速道路、一般道路は、ズームレベル 0 ~ 12 でカスタム スタイルの色で表示されます。
- ズームレベル 12 以降、スタイル設定された色はベージュ色にフェードし始め、ズームレベル 17 で地表の地図対象物スタイルからベージュ色に完全に移行します。