ナビゲーション UI を変更する

Navigation SDK for Android を使用すると、マップに表示する組み込みの UI コントロールや要素を指定することで、地図のユーザー エクスペリエンスを変更できます。ナビゲーション UI の外観を調整することもできます。ナビゲーション UI で許可される変更に関するガイドラインについては、ポリシー ページをご覧ください。

このドキュメントでは、次の 2 つの方法で地図のユーザー インターフェースを変更する方法について説明します。

地図の UI コントロール

地図の UI コントロールはナビゲーション ビューの上に配置されます。Android 向け Navigation SDK では、組み込みのレイアウトが変更されると、カスタム コントロールの位置が自動的に調整されます。レイアウトの位置ごとにカスタム コントロールを 1 つ設定できます。カスタム コントロールは 1 つの UI 要素にすることもできますが、設計で複数の UI 要素が必要な場合は、複数の UI 要素で ViewGroup を使用できます。

setCustomControl メソッドは、CustomControlPosition 列挙型で定義されている位置を提供します。

  • SECONDARY_HEADER(ポートレート モードでのみ表示)
  • BOTTOM_START_BELOW
  • BOTTOM_END_BELOW

たとえば、以下の画像は、配車サービスの運転手に乗車時の乗客の位置情報を通知する UI コントロールのさまざまな位置の例を示しています。

カスタム コントロールの位置

カスタムのセカンダリ ヘッダーを追加する

デフォルトでは、ナビゲーション モードの画面レイアウトには、プライマリ ヘッダーの下にセカンダリ ヘッダーを配置するための位置が用意されています。このセカンダリ ヘッダーは、車線案内など、必要に応じて表示されます。アプリでは、このレイアウトのセカンダリ ヘッダー位置をカスタム コンテンツに使用できます。この機能を使用すると、デフォルトのセカンダリ ヘッダー コンテンツが制御対象になります。ナビゲーション ビューに背景がある場合、その背景はセカンダリ ヘッダーで覆われてそのまま残ります。アプリがカスタム コントロールを削除すると、デフォルトのセカンダリ ヘッダーが代わりに表示されます。

カスタム セカンダリ ヘッダーの位置は、上端がプライマリ ヘッダーの下端と揃います。この位置は portrait mode でのみサポートされています。landscape mode では、セカンダリ ヘッダーを使用できず、レイアウトは変更されません。

  1. カスタム UI 要素または ViewGroup を使用して Android View を作成します。
  2. XML をインフレートするか、カスタムビューをインスタンス化して、セカンダリ ヘッダーとして追加するビューのインスタンスを取得します。
  3. SECONDARY_HEADER として CustomControlPosition とともに NavigationView.setCustomControl または SupportNavigationFragment.setCustomControl を使用します。

    次の例では、フラグメントを作成し、セカンダリ ヘッダーの位置にカスタム コントロールを追加します。

     mNavFragment.setCustomControl(getLayoutInflater().
       inflate(R.layout.your_custom_control, null),
       CustomControlPosition.SECONDARY_HEADER);
     ```
    

セカンダリ ヘッダーを削除する

セカンダリ ヘッダーを削除してデフォルトのコンテンツに戻すには、setCustomControl メソッドを使用します。

ビューを削除するには、ビューを null に設定します。

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

ナビゲーション ビューの下部にカスタム コントロールを追加する

アプリでは、ナビゲーション ビューの下端に配置されたカスタム コントロールを指定できます。アプリにカスタム コントロールを追加すると、再中央揃えボタンと Google ロゴが上に移動して、カスタム コントロールが収まるようにします。

  1. 追加する UI 要素またはビュー グループを使用して Android ビューを作成します。
  2. ナビゲーション ビューまたはフラグメントを作成します。
  3. ナビゲーション ビューまたはフラグメントで setCustomControl メソッドを呼び出し、使用するコントロールと位置を指定します。

次の例は、SupportNavigationFragment に追加されたカスタム View を示しています。

private SupportNavigationFragment mNavFragment;
mNavFragment = (SupportNavigationFragment)
  getFragmentManager().findFragmentById(R.id.navigation_fragment);

// Create the custom control view.
MyCustomView myCustomView = new MyCustomView();

// Add the custom control to the bottom end corner of the layout.
mNavFragment.setCustomControl(myCustomView, CustomControlPosition.
  BOTTOM_END_BELOW);

カスタム コントロールを削除する

カスタム コントロールを削除するには、setCustomControl メソッドを使用して、削除するコントロールの位置を指定します。

その位置でビューを null に設定します。

mNavFragment.setCustomControl(null, CustomControlPosition.BOTTOM_END_BELOW);

地図 UI アクセサリ

Navigation SDK for Android には、ナビゲーション中に表示される UI アクセサリが用意されています。これは、Google Maps for Android アプリに表示される UI アクセサリに似ています。これらのコントロールの表示または外観は、このセクションで説明するように調整できます。ここで行った変更は、次のナビゲーション セッション時に反映されます。

ナビゲーション UI で許可される変更に関するガイドラインについては、ポリシー ページをご覧ください。

コードを表示する

ナビゲーション ヘッダーを変更する

SupportNavigationFragment.setStylingOptions() または NavigationView.setStylingOptions() を使用して、ナビゲーション ヘッダーのテーマと、ヘッダーの下に表示される次の曲がり角インジケーターを変更します(利用可能な場合)。

次の属性を設定できます。

属性タイプ属性
背景色
  • メインの日中モード - ナビゲーション ヘッダーの昼間の色
  • セカンダリ デイモード - 次の曲がり角インジケーターの昼間の色
  • プライマリ ナイトモード - ナビゲーション ヘッダーの夜間の色
  • セカンダリ ナイトモード - 次の曲がり角インジケーターの夜間色
手順のテキスト要素
  • テキストの色
  • フォント
  • 1 行目のテキストサイズ
  • 2 行目のテキストサイズ
次のステップのテキスト要素
  • フォント
  • 距離値のテキストの色
  • 距離値のテキストサイズ
  • 距離単位のテキストの色
  • 距離単位のテキストサイズ
操作アイコン
  • 大きな操作アイコンの色
  • 小さい操作アイコンの色
車線案内
  • 推奨される車線の色

次の例は、スタイル設定オプションを設定する方法を示しています。

private SupportNavigationFragment mNavFragment;
mNavFragment = (SupportNavigationFragment) getFragmentManager()
  .findFragmentById(R.id.navigation_fragment);

// Set the styling options on the fragment.
mNavFragment.setStylingOptions(new StylingOptions()
  .primaryDayModeThemeColor(0xff1A237E)
  .secondaryDayModeThemeColor(0xff3F51B5)
  .primaryNightModeThemeColor(0xff212121)
  .secondaryNightModeThemeColor(0xff424242)
  .headerLargeManeuverIconColor(0xffffff00)
  .headerSmallManeuverIconColor(0xffffa500)
  .headerNextStepTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
  .headerNextStepTextColor(0xff00ff00)
  .headerNextStepTextSize(20f)
  .headerDistanceTypefacePath("/system/fonts/NotoSerif-Italic.ttf")
  .headerDistanceValueTextColor(0xff00ff00)
  .headerDistanceUnitsTextColor(0xff0000ff)
  .headerDistanceValueTextSize(20f)
  .headerDistanceUnitsTextSize(18f)
  .headerInstructionsTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
  .headerInstructionsTextColor(0xffffff00)
  .headerInstructionsFirstRowTextSize(24f)
  .headerInstructionsSecondRowTextSize(20f)
  .headerGuidanceRecommendedLaneColor(0xffffa500));

交通状況レイヤをオフにする

GoogleMap.setTrafficEnabled() を使用して、地図上の交通レイヤを有効または無効にします。この設定は、地図全体に表示される交通量の密度の表示に影響します。ただし、ナビゲーターによってプロットされたルートの交通情報には影響しません。

private GoogleMap mMap;
// Get the map, and when the async call returns, setTrafficEnabled
// (callback will be on the UI thread)
mMap = mNavFragment.getMapAsync(navMap -> navMap.setTrafficEnabled(false));

信号と停止標識を有効にする

マップ UI で信号機と一時停止標識を有効にできます。この機能を使用すると、ルート上の信号機や停止標識のアイコンを表示できるため、より効率的で正確なルートを計画できます。

デフォルトでは、Navigation SDK の信号機と一時停止標識は無効になっています。この機能を有効にするには、対象物ごとに DisplayOptions を個別に呼び出します。

DisplayOptions displayOptions =
  new DisplayOptions().showTrafficLights(true).showStopSigns(true);

カスタム マーカーを追加する

Navigation SDK for Android で、マーカーに Google Maps API が使用されるようになりました。詳しくは、Maps API のドキュメントをご覧ください。

フローティング テキスト

フローティング テキストは、Google のアトリビューションを覆わない限り、アプリ内の任意の場所に追加できます。Navigation SDK では、地図上の緯度と経度やラベルにテキストをアンカーすることはできません。詳しくは、情報ウィンドウをご覧ください。

制限速度を表示する

制限速度アイコンはプログラムで表示または非表示にできます。制限速度アイコンの表示と非表示を切り替えるには、NavigationView.setSpeedLimitIconEnabled() または SupportNavigationFragment.setSpeedLimitIconEnabled() を使用します。有効にすると、案内中に下隅に速度制限アイコンが表示されます。このアイコンは、車両が走行している道路の制限速度を示します。このアイコンは、信頼できる制限速度データが利用可能な場所にのみ表示されます。

 // Display the Speed Limit icon
 mNavFragment.setSpeedLimitIconEnabled(true);

再調整ボタンが表示されると、制限速度アイコンが一時的に非表示になります。

夜間モードを設定する

夜間モードの動作をプログラムで制御できます。NavigationView.setForceNightMode() または SupportNavigationFragment.setForceNightMode() を使用して夜間モードをオンまたはオフにするか、Navigation SDK for Android に制御を任せます。

  • AUTO Navigation SDK がデバイスの位置情報と現地時間に応じて適切なモードを決定できるようにします。
  • FORCE_NIGHT は夜間モードを強制的にオンにします。
  • FORCE_DAY: 日中モードを強制的にオンにします。

次の例は、ナビゲーション フラグメント内で夜間モードを強制的にオンにする方法を示しています。

// Force night mode on.
mNavFragment.setForceNightMode(FORCE_NIGHT);

経路リストを表示する

まず、ビューを作成して階層に追加します。

void setupDirectionsListView() {
  // Create the view.
  DirectionsListView directionsListView = new DirectionsListView(getApplicationContext());
  // Add the view to your view hierarchy.
  ViewGroup group = findViewById(R.id.directions_view);
  group.addView(directionsListView);

  // Add a button to your layout to close the directions list view.
  ImageButton button = findViewById(R.id.close_directions_button); // this button is part of the container we hide in the next line.
  button.setOnClickListener(
      v -> findViewById(R.id.directions_view_container).setVisibility(View.GONE));
}

NavigationView の場合と同様に、ライフサイクル イベントを DirectionsListView に転送してください。例:

protected void onResume() {
  super.onResume();
  directionsListView.onResume();
}

別の経路を非表示にする

ユーザー インターフェースに情報が多すぎて混乱する場合は、デフォルト(2 つ)よりも少ない代替ルートを表示するか、代替ルートをまったく表示しないことで、混乱を軽減できます。ルートを取得する前に、次のいずれかの列挙値を指定して RoutingOptions.alternateRoutesStrategy() メソッドを呼び出すことで、このオプションを構成できます。

列挙値説明
AlternateRoutesStrategy.SHOW_ALL デフォルト。最大 2 つの代替ルートを表示します。
AlternateRoutesStrategy.SHOW_ONE 代替ルートが 1 つ表示されます(利用可能な場合)。
AlternateRoutesStrategy.SHOW_NONE 別のルートを非表示にします。

次のコードサンプルは、代替ルートをすべて非表示にする方法を示しています。

RoutingOptions routingOptions = new RoutingOptions();
routingOptions.alternateRoutesStrategy(AlternateRoutesStrategy.SHOW_NONE);
navigator.setDestinations(destinations, routingOptions, displayOptions);

ルートの進行状況バー

ナビゲーションに追加されたルートの進行状況バー。

ルートの進行状況バーは、ナビゲーション開始時に地図の右端に表示される垂直バーです。有効にすると、ルート全体の概要と、ユーザーの目的地と現在地が表示されます。

これにより、ユーザーはズームインしなくても、交通などの今後の問題をすばやく予測できます。ユーザーは必要に応じてルートを変更できます。ユーザーがルートを変更すると、その地点から新しいルートとして開始されたかのように、進行状況バーがリセットされます。

ルートの進行状況バーには、次のステータス インジケーターが表示されます。

  • 経路の経過時間 - ルートの経過時間。

  • 現在の位置 - ルート内のユーザーの現在地。

  • 交通状況 - 今後の交通状況。

  • 最終目的地 - ルートの最終目的地。

NavigationView または SupportNavigationFragmentsetTripProgressBarEnabled() メソッドを呼び出して、ルートの進行状況バーを有効にします。例:

// Enable the trip progress bar.
mNavFragment.setTripProgressBarEnabled(true);