Cloud ベースのマップのスタイル設定を使用すると、Navigation SDK で Google ナビゲーション エクスペリエンスに再利用可能な地図のスタイルを定義できます。このページでは、地図のスタイルを定義して適用する方法の概要と、Navigation SDK の具体的な実装の詳細について説明します。Cloud ベースのマップのスタイル設定について詳しくは、Maps SDK for Android のドキュメントの概要ページをご覧ください。
地図のスタイルを定義する
Navigation SDK で地図のスタイルをカスタマイズする最初のステップは、地図のスタイルを作成してマップ ID に関連付けることです。地図のスタイルは、Google Maps Platform Cloud コンソールで作成、保存、編集します。マップ ID は、カスタマイズされた地図を表示するためにアプリコードで参照されます。
Navigation SDK には、スタイル設定可能な地図タイプが 2 つあります。1 つは、ナビゲーション セッション中に表示されるナビゲーション地図、もう 1 つは、ナビゲーション セッションがアクティブでないときに表示される道路地図です。定義してマップ ID に関連付けたスタイルは、ナビゲーションと道路地図の両方のタイプに適用されます。
地図のスタイルを定義する方法について詳しくは、Maps SDK for Android のドキュメントの 地図のスタイルを作成して使用するをご覧ください。
地図のスタイルを適用する
マップ ID に関連付けられた地図のスタイルを作成したら、アクティビティのレイアウト ファイルの <fragment> 要素を使って、
MapView クラスを使用するか、
MapFragment、
SupportMapFragment、
SupportNavigationFragment インスタンスで
GoogleMapOptions クラスを使用して、ID を追加できます。
地図のスタイルを適用する方法について詳しくは、Maps SDK for Android のドキュメントの アプリにマップ ID を追加するをご覧ください。
ライトモードとダークモードのスタイル
Cloud ベースのマップのスタイル設定では、ライトモードとダークモードのスタイルを定義できます。Navigation SDK では、道路地図(ナビゲーション以外の地図)にライトモードとダークモードがあり、ナビゲーション地図にデイライト モードと低照度モード(夜間モード)があります。Navigation SDK でスタイルを地図に関連付けると、そのスタイルは道路地図とナビゲーション地図の両方に適用されます。
- Cloud コンソールのライトモードのスタイルは、ライトモードのロードマップと昼間のナビゲーション マップの両方に適用されます。
- Cloud コンソールのダークモード スタイルは、ダークモードの道路地図と、低照度/夜間モードのナビゲーション地図の両方に適用されます。
課金
アプリがマップ ID を適用した地図を読み込むと、動的地図 SKU に対して課金される地図の読み込みがトリガーされます。このトリガーは、マップ ID が適用されていない地図の読み込みのトリガーとは異なります。マップ ID を使用しない地図の読み込みは、Maps SDK SKU に対して課金されます。各 SKU のトリガーと料金の詳細については、料金と請求をご覧ください。
ポリシーと使用
Navigation SDK で地図のスタイルをカスタマイズする際は、ナビゲーション UI の許容される変更に関するポリシーを遵守する必要があります。特に、ナビゲーション マップから道路網を削除したり、ナビゲーション マップ上の地図対象物の色のコントラストを大幅に下げたりしないでください。
ナビゲーション UI の許容される変更について詳しくは、Navigation SDK for Android のポリシーをご覧ください。