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