このドキュメントでは、カスタム スタイルとライトモード、ダークモードの概念的な関係について説明し、さまざまな地図の種類と、それらにスタイルを適用する方法を定義します。
カスタム スタイルを使い始めるには、新しいスタイルを作成するをご覧ください。
ライトモードとダークモードについて
1 つのマップ ID に対して、明るい背景用に最適化されたスタイルと暗い背景用に最適化されたスタイルの 2 つの異なるスタイルを作成できます。明るい背景の地図では、暗い背景の地図とは異なるベースマップが使用されます。そのため、両方のモードで同じスタイルを使用することはできません。
ライトモードとダークモードのスタイルは、さまざまな環境に最適なスタイル設定された地図を提供します。アプリケーションで地図 ID を使用すると、プログラムされた動作またはユーザーのデバイス設定に基づいて、アプリが適切なスタイルを読み込むことができます。
スタイルを作成するときにライトモードまたはダークモードを選択する
ライトモードとダークモードは、スタイルを作成またはコピーするときに選択します。作成後にスタイルのモードを変更することはできません。
スタイル タイプは、スタイルの詳細ページで確認できます。
カスタム スタイルの作成手順については、地図のスタイルを作成して使用するをご覧ください。
1 つのライトモード スタイルと 1 つのダークモード スタイルをマップ ID に関連付ける
マップ ID でサポートされるのは、ライトモードのスタイルとダークモードのスタイルがそれぞれ 1 つずつのみです。 [編集] アイコンをクリックしてライトモード スタイルまたはダークモード スタイルを変更すると、パネルにはそのモードのスタイルのみが表示されます。詳しくは、スタイルをマップ ID に関連付けるをご覧ください。
カスタム スタイルが複数の地図のタイプにどのように適用されるかを理解する
Google Maps Platform では、roadmap、terrain、hybrid、navigation など、さまざまなユースケースに対応するさまざまな地図タイプが用意されています。カスタマイズのレベルは、地図がベクターデータ（roadmap や navigation など）に基づいているか、ラスター画像（hybrid や terrain など）に基づいているかによって異なります。
- ベクトルデータマップ
- これらの地図ではベクターデータが使用されています。これにより、陸地と水域のポリゴン、道路、ランドマーク、スポットなど、ほとんどの地図上の対象物のスタイルを包括的に設定できます。
- ラスター画像地図
- これらの地図は主に地図画像を使用します。そのため、スタイリング機能は制限されています。通常、スタイル設定できるのは、画像に重ねて表示するベクトルデータ（ラベル、ピン、一部のポリライン（道路、境界線など））のみです。湖の色や山脈の形状など、ベース画像の一部である対象物をカスタマイズすることはできません。
- この画像は、ピンク色の海を含むカスタム スタイルのロードマップを示しています。ただし、地形地図とハイブリッド地図のタイプのスタイルをプレビューすると、水はピンク色で表示されません。
地図の種類の定義とモードのサポート
次の表に、地図の種類と、ライトモードとダークモードをサポートする地図の種類を示します。
| 地図タイプ | 説明 | ベクターかラスターか | モードのサポート |
|---|---|---|---|
roadmap |
道路や主要な対象物を表示する標準の地図ビュー。 | ベクトル | 両方 |
terrain |
山、川、標高などの地形を強調した地図。 | ベクトル | 両方 |
hybrid |
衛星画像と地図データの組み合わせ。画像に道路名などの主要な特徴が重ねて表示されます。 | ラスター | ライトモードのみ |
navigation |
Navigation SDK を使用したターンバイターン ガイダンス用に最適化された特殊な地図タイプ。ナビゲーションについて詳しくは、Navigation SDK for Android と Navigation SDK for Android の地図のスタイルをカスタマイズする概要をご覧ください。 | ラスター | 両方 |
terrain と hybrid の地図タイプのポリゴンスタイルに関する注意事項
terrain と hybrid の地図のタイプをスタイル設定すると、次のような動作が発生することがあります。
terrainマップタイプで Android と iOS でカスタム スタイルを使用すると、水面が一時的に点滅することがあります。この想定される動作は、地形タイルが読み込まれた後にロードマップ タイルが読み込まれるため、水域のスタイル設定時に発生します。この遅延読み込みにより、カスタムカラーで視覚的な競合が短時間発生します。ポリゴンのスタイルは、
terrainとhybridの地図タイプで、基盤となる地図要素を隠すことがあります。たとえば、地形マップ上の様式化された公園のポリゴンは、微妙な地形の特徴を隠す可能性があります。ハイブリッド地図では、基盤となる衛星画像が非表示になることがあります。
各地図タイプでスタイルをプレビューする
カスタム スタイルを作成したら、さまざまな地図の種類でテストして、どのように適用されるかを確認します。すべてのスタイルがすべての地図タイプに適用されるわけではないため、これは特に重要です。
Google Cloud コンソールでは、スタイル エディタまたは地図の詳細ページでカスタム スタイルをプレビューできます。
- スタイル エディタ: コンテキスト パネルで、
Map typeプルダウン リストを選択して地図の種類を変更します。地図が更新され、スタイルが適用された地図の種類が表示されます。 - 地図の詳細ページ: [地図のプレビュー] セクションで、ライトモードとダークモードのスタイルを切り替えたり、プルダウン リストでバリエーションを変更して地図の種類を変更したりできます。スタイルをプレビューするには、まずスタイルをマップ ID に関連付ける必要があります。
複数の地図のタイプにカスタム スタイルを適用する
地図の詳細ページで、ライトモードとダークモードのスタイルをマップ ID に関連付けた後、詳細を表示をクリックして、カスタム スタイルを複数の地図の種類に適用するかどうかを選択します。[地図のプレビュー] セクションで、スタイルが地図の種類にどのように適用されるかを確認できます。