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