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