このページは Cloud Translation API によって翻訳されました。

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

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

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

地図の UI コントロール
地図 UI アクセサリー

地図の UI コントロール

カスタム UI 要素をナビゲーションビューに配置するには、地図 UI コントロールを使用して適切な位置に配置します。組み込みレイアウトが変更されると、Navigation SDK for Android はカスタムコントロールを自動的に再配置します。各位置に設定できるカスタムコントロールビューは一度に 1 つだけです。デザインで複数の UI 要素が必要な場合は、それらを ViewGroup に配置して setCustomControl メソッドに渡すことができます。

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

SECONDARY_HEADER（ポートレートモードでのみ表示されます）
BOTTOM_START_BELOW
BOTTOM_END_BELOW
FOOTER

カスタムコントロールを追加する

カスタム UI 要素または ViewGroup を使用して Android View を作成します。
XML を拡張するか、カスタムビューをインスタンス化して、ビューのインスタンスを取得します。
CustomControlPosition 列挙型から選択したカスタムコントロールの位置を指定して、NavigationView.setCustomControl または SupportNavigationFragment.setCustomControl を使用します。

注: アプリは、UI スレッドでこのメソッドを呼び出す必要があります。
次の例では、フラグメントを作成し、セカンダリヘッダーの位置にカスタムコントロールを追加します。

注: この例のコードには、ドキュメントで視認性を高めるために改行が含まれています。必要に応じて削除してください。
```
 mNavFragment.setCustomControl(getLayoutInflater().
   inflate(R.layout.your_custom_control, null),
   CustomControlPosition.SECONDARY_HEADER);
 ```
```

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

カスタムコントロールを削除するには、null ビューパラメータと選択したカスタムコントロールの位置を指定して setCustomControl メソッドを呼び出します。

たとえば、次のスニペットはカスタムのセカンダリヘッダーを削除し、デフォルトのコンテンツに戻します。

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

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

Secondary header

このカスタムコントロールの位置を使用するには、位置 CustomControlPosition.SECONDARY_HEADER を setCustomControl に渡します。

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

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

下から開始

縦向きのカスタムコントロールの開始位置を下部に設定します。 — 縦向きのカスタムコントロールの開始位置の下部

横向きのカスタムコントロールの開始位置を下部に設定します。 — 横向きのカスタムコントロールの開始位置の下部

このカスタムコントロールの位置を使用するには、位置 CustomControlPosition.BOTTOM_START_BELOW を setCustomControl に渡します。

このカスタムコントロールの位置は、地図の左下隅にあります。portrait mode と landscape mode の両方で、ETA カードやカスタムフッターの上に表示されます（どちらも存在しない場合は地図の下部に表示されます）。また、再センタリングボタンや Google ロゴなどの Nav SDK 要素は、カスタムコントロールビューの高さに合わせて上に移動します。このコントロールは表示されている地図の境界内に配置されるため、地図の下端または左端に追加されたパディングによって、このコントロールの位置も変更されます。

下端

縦向きのカスタムコントロールの最下部の位置。 — 縦向きのカスタムコントロールの下端の位置

横向きのカスタムコントロールの最下部の位置。 — 横向きのカスタムコントロールの下端の位置

このカスタムコントロールの位置を使用するには、位置 CustomControlPosition.BOTTOM_END_BELOW を setCustomControl に渡します。

このカスタムコントロールの位置は、地図の右下隅に配置されます。portrait mode では、到着予定時刻カードやカスタムフッターの上に配置されます（どちらも存在しない場合は地図の下部に沿って配置されます）。一方、landscape mode では、地図の下部に沿って配置されます。終了側（LTR の場合は右側）に表示される Nav SDK の要素は、カスタムコントロールビューの高さに合わせて上に移動します。このコントロールは表示されている地図の境界内に配置されるため、地図の下端または右端に追加されたパディングによって、このコントロールの位置も変わります。

縦向きのフッターカスタムコントロールの位置。 — 縦向きのフッターカスタムコントロールの位置

横向きのフッターカスタムコントロールの位置。 — 横向きのフッターカスタムコントロールの位置

このカスタムコントロールの位置を使用するには、位置 CustomControlPosition.FOOTER を setCustomControl に渡します。

このカスタムコントロールの位置は、カスタムフッタービュー用に設計されています。ナビゲーション SDK の到着予定時刻カードが表示されている場合、このコントロールはその上に表示されます。そうでない場合、コントロールは地図の下部に沿って配置されます。BOTTOM_START_BELOW カスタムコントロールや BOTTOM_END_BELOW カスタムコントロールとは異なり、このコントロールは表示される地図の境界の外側に配置されます。つまり、地図に追加されたパディングによって、このコントロールの位置が変更されることはありません。

portrait mode では、カスタムフッターは全幅になります。CustomControlPosition.BOTTOM_START_BELOW と CustomControlPosition.BOTTOM_END_BELOW の両方の位置にあるカスタムコントロールと、再センタリングボタンや Google ロゴなどの Nav SDK UI 要素は、カスタムコントロールフッターの上に配置されます。シェブロンのデフォルトの位置は、カスタムフッターの高さを考慮します。

landscape mode では、カスタムフッターは Nav SDK の ETA カードと同様に、幅が半分で開始側（LTR の場合は左側）に配置されます。CustomControlPosition.BOTTOM_START_BELOW の位置にあるカスタムコントロールと、再センタリングボタンや Google ロゴなどの Nav SDK UI 要素は、カスタムコントロールフッターの上に配置されます。CustomControlPosition.BOTTOM_END_BELOW 位置のカスタムコントロールと、終了側（LTR の場合は右側）に沿った Nav SDK UI 要素は、地図の下部と揃ったままになります。カスタムフッターが存在する場合、フッターは地図の端まで伸びないため、シェブロンのデフォルトの位置は変わりません。

CustomControlPosition.BOTTOM_START_BELOW と CustomControlPosition.BOTTOM_END_BELOW の位置にあるカスタムコントロールと、再センタリングボタンや Google ロゴなどの Nav SDK UI 要素は、カスタムコントロールフッターの上に配置されます。

地図 UI のアクセサリ

Navigation SDK for Android には、Android 版 Google マップアプリケーションに表示されるものと同様の、ナビゲーション中に表示される UI アクセサリが用意されています。このセクションで説明するように、これらのコントロールの表示 / 非表示や外観を調整できます。ここで変更した内容は、次のナビゲーションセッションで反映されます。

ナビゲーション UI の許容される変更に関するガイドラインについては、ポリシーのページを参照してください。

コードを表示する

ナビゲーションアクティビティの Java コードを表示または非表示にする

package com.example.navsdkcustomization;

import android.content.pm.PackageManager;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.Bundle;
import android.util.Log;
import android.widget.Toast;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.GoogleMap.CameraPerspective;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.model.BitmapDescriptorFactory;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.Marker;
import com.google.android.gms.maps.model.MarkerOptions;
import com.google.android.libraries.navigation.ListenableResultFuture;
import com.google.android.libraries.navigation.NavigationApi;
import com.google.android.libraries.navigation.Navigator;
import com.google.android.libraries.navigation.SimulationOptions;
import com.google.android.libraries.navigation.StylingOptions;
import com.google.android.libraries.navigation.SupportNavigationFragment;
import com.google.android.libraries.navigation.Waypoint;

/** An activity that displays a map and a customized navigation UI. */
public class NavigationActivityCustomization extends AppCompatActivity {

  private static final String TAG = NavigationActivityCustomization.class.getSimpleName();
  private Navigator mNavigator;
  private SupportNavigationFragment mNavFragment;
  private GoogleMap mMap;
  // Define the Sydney Opera House by specifying its place ID.
  private static final String SYDNEY_OPERA_HOUSE = "ChIJ3S-JXmauEmsRUcIaWtf4MzE";
  // Set fields for requesting location permission.
  private static final int PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION = 1;
  private boolean mLocationPermissionGranted;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Initialize the Navigation SDK.
    initializeNavigationSdk();
  }

  /**
   * Starts the Navigation SDK and sets the camera to follow the device's location. Calls the
   * navigateToPlace() method when the navigator is ready.
   */
  private void initializeNavigationSdk() {
    /*
     * Request location permission, so that we can get the location of the
     * device. The result of the permission request is handled by a callback,
     * onRequestPermissionsResult.
     */
    if (ContextCompat.checkSelfPermission(
            this.getApplicationContext(), android.Manifest.permission.ACCESS_FINE_LOCATION)
        == PackageManager.PERMISSION_GRANTED) {
      mLocationPermissionGranted = true;
    } else {
      ActivityCompat.requestPermissions(
          this,
          new String[] {android.Manifest.permission.ACCESS_FINE_LOCATION},
          PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION);
    }

    if (!mLocationPermissionGranted) {
      displayMessage(
          "Error loading Navigation SDK: " + "The user has not granted location permission.");
      return;
    }

    // Get a navigator.
    NavigationApi.getNavigator(
        this,
        new NavigationApi.NavigatorListener() {
          /** Sets up the navigation UI when the navigator is ready for use. */
          @Override
          public void onNavigatorReady(Navigator navigator) {
            displayMessage("Navigator ready.");
            mNavigator = navigator;
            mNavFragment =
                (SupportNavigationFragment)
                    getSupportFragmentManager().findFragmentById(R.id.navigation_fragment);

            // Get the map.
            mNavFragment.getMapAsync(
                new OnMapReadyCallback() {
                  @Override
                  public void onMapReady(GoogleMap map) {
                    mMap = map;
                    // Navigate to a place, specified by Place ID.
                    navigateToPlace(SYDNEY_OPERA_HOUSE);
                  }
                });
          }

          /**
           * Handles errors from the Navigation SDK.
           *
           * @param errorCode The error code returned by the navigator.
           */
          @Override
          public void onError(@NavigationApi.ErrorCode int errorCode) {
            switch (errorCode) {
              case NavigationApi.ErrorCode.NOT_AUTHORIZED:
                displayMessage(
                    "Error loading Navigation SDK: Your API key is "
                        + "invalid or not authorized to use the Navigation SDK.");
                break;
              case NavigationApi.ErrorCode.TERMS_NOT_ACCEPTED:
                displayMessage(
                    "Error loading Navigation SDK: User did not accept "
                        + "the Navigation Terms of Use.");
                break;
              case NavigationApi.ErrorCode.NETWORK_ERROR:
                displayMessage("Error loading Navigation SDK: Network error.");
                break;
              case NavigationApi.ErrorCode.LOCATION_PERMISSION_MISSING:
                displayMessage(
                    "Error loading Navigation SDK: Location permission " + "is missing.");
                break;
              default:
                displayMessage("Error loading Navigation SDK: " + errorCode);
            }
          }
        });
  }

  /** Customizes the navigation UI and the map. */
  private void customizeNavigationUI() {
    // Set custom colors for the navigator.
    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));

    mMap.setTrafficEnabled(false);

    // Place a marker at the final destination.
    if (mNavigator.getCurrentRouteSegment() != null) {
      LatLng destinationLatLng = mNavigator.getCurrentRouteSegment().getDestinationLatLng();

      Bitmap destinationMarkerIcon =
          BitmapFactory.decodeResource(getResources(), R.drawable.ic_person_pin_48dp);

      mMap.addMarker(
          new MarkerOptions()
              .position(destinationLatLng)
              .icon(BitmapDescriptorFactory.fromBitmap(destinationMarkerIcon))
              .title("Destination marker"));

      // Listen for a tap on the marker.
      mMap.setOnMarkerClickListener(
          new GoogleMap.OnMarkerClickListener() {
            @Override
            public boolean onMarkerClick(Marker marker) {
              displayMessage(
                  "Marker tapped: "
                      + marker.getTitle()
                      + ", at location "
                      + marker.getPosition().latitude
                      + ", "
                      + marker.getPosition().longitude);

              // The event has been handled.
              return true;
            }
          });
    }

    // Set the camera to follow the device location with 'TILTED' driving view.
    mMap.followMyLocation(CameraPerspective.TILTED);
  }

  /**
   * Requests directions from the user's current location to a specific place (provided by the
   * Google Places API).
   */
  private void navigateToPlace(String placeId) {
    Waypoint destination;
    try {
      destination =
          Waypoint.builder().setPlaceIdString(placeId).build();
    } catch (Waypoint.UnsupportedPlaceIdException e) {<
      displayMessage>("Error starting navigation: Place ID is not supported.");
      return;
    }

    // Create a future to await the result of the asynchronous navigator task.
    ListenableResultFutureNavigator.RouteStatus pendingRoute< =
        mNavigator>.setDestination(destination);

    // Define the action to perform when the SDK has determined the route.
    pendingRoute.setOnResultListener(
        new ListenableResultFuture.OnResultListenerNavigator.RouteStatus() {
          @Override
          public void onResult(Navigator.RouteStatus code) {
            switch (code) {
              case OK:
                // Hide the toolbar to maximize the navigation UI.
                if (getActionBar() != null) {
                  getActionBar().hide();
                }

                // Customize the navigation UI.
                customizeNavigationUI();

                // Enable voice audio guidance (through the device speaker).
                mNavigator.setAudioGuidance(Navigator.AudioGuidance.VOICE_ALERTS_AND_GUIDANCE);

                // Simulate vehicle progress along the route for demo/debug builds.
                if (BuildConfig.DEBUG) {
                  mNavigator
                      .getSimulator()
                      .simulateLocationsAlongExistingRoute(
                          new SimulationOptions().speedMultiplier(5));
                }

                // Start turn-by-turn guidance along the current route.
                mNavigator.startGuidance();
                break;
              // Handle error conditions returned by the navigator.
              case NO_ROUTE_FOUND:
                displayMessage("Error starting navigation: No route found.");
                break;
              case NETWORK_ERROR:
                displayMessage("Error starting navigation: Network error.");
                break;
              case ROUTE_CANCELED:
                displayMessage("Error starting navigation: Route canceled.");
                break;
              default:
                displayMessage("Error starting navigation: " + String.valueOf(code));
            }
          }
        });
  }

  /** Handles the result of the request for location permissions. */
  @Override
  public void onRequestPermissionsResult(
      int requestCode, @NonNull String[] permissions, @NonN>ull&& int[] grantResults) {
    mLocationPermissionGranted = false;
    switch (requestCode) {
      case PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION:
        {
          // If request is canceled, the result arrays are empty.
          if (grantResults.length  0  grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            mLocationPermissionGranted = true;
          }
        }
    }
  }

  /**
   * Shows a message on screen and in the log. Used when something goes wrong.
   *
   * @param errorMessage The message to display.
   */
  private void displayMessage(String errorMessage) {
    Toast.makeText(this, errorMessage, Toast.LENGTH_LONG).show();
    Log.d(TAG, errorMessage);
  }
}

目的地と入口のハイライト表示

placeID を使用して目的地を作成すると、可能な場合は、目的地の建物がハイライト表示され、入り口のアイコンが表示されます。これらの視覚的な手がかりは、ユーザーが目的地を区別して移動するのに役立ちます。

placeID を使用して宛先を作成するには、Waypoint.Builder.setPlaceIdString() メソッドを使用します。

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

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));

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

ナビゲーション中に地図上に信号や一時停止の標識を表示することで、ルートや移動の操作に関する追加のコンテキストを提供できます。

デフォルトでは、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 または SupportNavigationFragment で setTripProgressBarEnabled() メソッドを呼び出して、乗車中の進行状況バーを有効にします。次に例を示します。

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

乗車中の進行状況バーの位置

バーの左側は、スピードメーター、Google ロゴ、再センタリングボタン（表示されている場合）の左側とほぼ揃っています。幅は 12 dp です。
乗車中のプログレスバーの高さは一定です。小型デバイスの縦方向のスペースの制約に対応するため、乗車中の進行状況バーの表示と高さは、画面の高さで指定されたブレークポイントに基づいて調整されます。これらのブレークポイントは、デバイスの向きや、地図が実際に画面上で占めるスペースとは無関係です。

画面の高さ	移動の進行状況バーの表示設定	旅行の進行状況バーの高さ	移動の進行状況バーの Y 軸の位置
小: 0 dp ～ 551 dp	非表示	なし	なし
中: 552 dp - 739 dp	表示	130 dp	スタートサイドのコントロール（スピードメーター / Google ロゴ / 再センタリングボタン）
大: 740 dp 以上	表示	290 dp	スタートサイドのコントロール（スピードメーター / Google ロゴ / 再センタリングボタン）

ルートの進行状況バーがターンカードや他のナビゲーション UI 要素と重なっている場合、進行状況バーは他の要素の下に表示されます。

Prompt Visibility API（試験運用版）

プロンプトの可視性 API を使用すると、Navigation SDK によって生成された UI 要素と独自のカスタム UI 要素の競合を回避できます。Navigation SDK の UI 要素が表示される直前と、要素が削除された直後にコールバックを受け取るリスナーを追加します。コードサンプルを含む詳細については、リアルタイムの運行停止を構成するページの Prompt Visibility API セクションをご覧ください。