Изменить интерфейс навигации

Используя SDK навигации для Android, вы можете изменить пользовательский интерфейс карты, определив, какие из встроенных элементов управления и компонентов интерфейса будут отображаться на карте. Вы также можете настроить внешний вид интерфейса навигации. Рекомендации по допустимым изменениям интерфейса навигации см. на странице «Политика».

В этом документе описывается, как изменить пользовательский интерфейс вашей карты двумя способами:

• Элементы управления пользовательского интерфейса карты
• Аксессуары пользовательского интерфейса карты

Примечание: В большинстве случаев мы рекомендуем использовать SupportNavigationFragment , который является оберткой для NavigationView , вместо прямого взаимодействия с NavigationView . Для получения дополнительной информации см. раздел «Рекомендации по взаимодействию с картой навигации» .

Элементы управления пользовательского интерфейса карты

Для размещения пользовательских элементов интерфейса в навигационном представлении используйте элементы управления Map UI для правильного позиционирования. При изменении встроенной компоновки Navigation SDK для Android автоматически изменяет положение ваших пользовательских элементов управления. Для каждой позиции можно задать только одно представление пользовательского элемента управления. Если ваш дизайн требует нескольких элементов интерфейса, вы можете разместить их в ViewGroup и передать его методу setCustomControl .

Метод setCustomControl предоставляет позиции, определенные в перечислении CustomControlPosition :

• SECONDARY_HEADER (отображается только в портретном режиме)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW
• FOOTER

Настраиваемые положения элементов управления для портретной ориентации

Настраиваемые положения элементов управления для альбомной ориентации

Добавить пользовательский элемент управления

1. Создайте представление Android с пользовательским элементом интерфейса или ViewGroup.
2. Чтобы получить экземпляр представления, создайте XML-файл или инициализируйте пользовательское представление.

3. Используйте NavigationView.setCustomControl или SupportNavigationFragment.setCustomControl , указав положение выбранного пользовательского элемента управления из перечисления CustomControlPosition .

   Примечание: Ваш метод должен вызываться в потоке пользовательского интерфейса.

   В приведенном ниже примере создается фрагмент и добавляется пользовательский элемент управления в позицию вторичного заголовка.

   Примечание: В примере код содержит переносы строк для наглядности в документации. Не забудьте удалить их, если это необходимо.

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

Удалить пользовательский элемент управления

Чтобы удалить пользовательский элемент управления, вызовите метод setCustomControl , передав в качестве параметра представления значение null и указав выбранное положение пользовательского элемента управления.

Например, следующий фрагмент кода удаляет любые пользовательские дополнительные заголовки и возвращает содержимое по умолчанию:

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

Позиции пользовательского управления

Вторичный заголовок

Положение дополнительного элемента управления в заголовке для портретной ориентации.

Чтобы использовать это пользовательское положение элемента управления, передайте позицию CustomControlPosition.SECONDARY_HEADER в setCustomControl .

По умолчанию в режиме навигации макеты экрана предусматривают позицию для дополнительного заголовка, расположенного под основным заголовком. Этот дополнительный заголовок появляется при необходимости, например, для подсказок по полосам движения. Ваше приложение может использовать эту позицию дополнительного заголовка для размещения пользовательского контента. При использовании этой функции ваш элемент управления перекрывает любое содержимое дополнительного заголовка по умолчанию. Если у вашего навигационного представления есть фон, этот фон остается на месте, перекрываемый дополнительным заголовком. Когда ваше приложение удаляет пользовательский элемент управления, на его месте может появиться любой дополнительный заголовок по умолчанию.

Настраиваемое положение дополнительного заголовка выравнивает его верхний край с нижним краем основного заголовка. Это положение поддерживается только в portrait mode . В landscape mode дополнительный заголовок недоступен, и макет не меняется.

Начало снизу

Нижнее положение элемента управления для настройки портретной ориентации

Начальное положение нижнего элемента управления для альбомной ориентации

Чтобы использовать это пользовательское положение элемента управления, передайте позицию CustomControlPosition.BOTTOM_START_BELOW в setCustomControl .

Этот настраиваемый элемент управления располагается в нижнем начальном углу карты. Как в portrait mode , так и landscape mode он находится над карточкой предполагаемого времени прибытия и/или пользовательским нижним колонтитулом (или вдоль нижней части карты, если ни то, ни другое отсутствует), а элементы Nav SDK, включая кнопку центрирования и логотип Google, смещаются вверх, чтобы компенсировать высоту пользовательского элемента управления. Этот элемент управления расположен внутри видимых границ карты, поэтому любой отступ, добавленный к нижнему или начальному краю карты, также изменит его положение.

Нижний конец

Положение нижнего элемента управления для портретной ориентации

Положение нижнего элемента управления для альбомной ориентации

Чтобы использовать это пользовательское положение элемента управления, передайте позицию CustomControlPosition.BOTTOM_END_BELOW в setCustomControl .

Этот элемент управления располагается в нижнем углу карты. В portrait mode он находится над карточкой ETA и/или пользовательским нижним колонтитулом (или вдоль нижней части карты, если ни то, ни другое отсутствует), а в landscape mode он выравнивается по нижней части карты. Любые элементы Nav SDK, видимые вдоль торцевой стороны (справа в режиме LTR), смещаются вверх, чтобы компенсировать высоту элемента управления. Этот элемент управления расположен внутри видимых границ карты, поэтому любой отступ, добавленный к нижнему или торцевому краю карты, также изменит положение этого элемента управления.

Нижний колонтитул

Предварительный просмотр функции

Положение элементов управления в нижнем колонтитуле для портретной ориентации.

В нижнем колонтитуле настраиваемое положение элементов управления для альбомной ориентации.

Чтобы использовать это пользовательское положение элемента управления, передайте параметр ` CustomControlPosition.FOOTER в setCustomControl .

Это пользовательское положение элемента управления предназначено для пользовательского отображения нижнего колонтитула. Если карточка Nav SDK ETA видна, этот элемент управления располагается над ней. В противном случае элемент управления выравнивается по нижнему краю карты. В отличие от пользовательских элементов управления BOTTOM_START_BELOW и BOTTOM_END_BELOW , этот элемент управления расположен за пределами видимых границ карты, а это значит, что любой добавленный к карте отступ не изменит его положение.

В portrait mode пользовательский нижний колонтитул занимает всю ширину страницы. Пользовательские элементы управления в позициях CustomControlPosition.BOTTOM_START_BELOW и CustomControlPosition.BOTTOM_END_BELOW , а также элементы пользовательского интерфейса Nav SDK, такие как кнопка центрирования и логотип Google, располагаются над пользовательским нижним колонтитулом. Положение стрелки по умолчанию учитывает высоту пользовательского нижнего колонтитула.

В landscape mode пользовательский нижний колонтитул имеет половинную ширину и выровнен по начальной стороне (левая сторона в режиме LTR), как и карточка ETA из Nav SDK. Пользовательские элементы управления в позиции CustomControlPosition.BOTTOM_START_BELOW и элементы пользовательского интерфейса Nav SDK, такие как кнопка центрирования и логотип Google, располагаются над пользовательским нижним колонтитулом. Пользовательские элементы управления в позиции CustomControlPosition.BOTTOM_END_BELOW и любые элементы пользовательского интерфейса Nav SDK вдоль конечной стороны (правая сторона в режиме LTR) остаются выровненными по нижнему краю карты. Положение стрелки по умолчанию не меняется при наличии пользовательского нижнего колонтитула, поскольку нижний колонтитул не выходит за пределы карты.

Пользовательские элементы управления, расположенные в позициях CustomControlPosition.BOTTOM_START_BELOW и CustomControlPosition.BOTTOM_END_BELOW , а также элементы пользовательского интерфейса Nav SDK, такие как кнопка центрирования и логотип Google, размещены над нижним колонтитулом пользовательского элемента управления.

Аксессуары пользовательского интерфейса карты

SDK навигации для Android предоставляет элементы пользовательского интерфейса, которые отображаются во время навигации, аналогично тем, что используются в приложении Google Maps для Android. Вы можете настроить видимость или внешний вид этих элементов управления, как описано в этом разделе. Внесенные здесь изменения будут применены в следующей сессии навигации.

Рекомендации по допустимым изменениям пользовательского интерфейса навигации см. на странице «Политика» .

Посмотреть код

Показать/скрыть 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.
    ListenableResultFuture<Navigator.RouteStatus> pendingRoute =
        mNavigator.setDestination(destination);

    // Define the action to perform when the SDK has determined the route.
    pendingRoute.setOnResultListener(
        new ListenableResultFuture.OnResultListener<Navigator.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, @NonNull 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() .

Примечание: SDK навигации не поддерживает навигацию внутри помещений. Для карт помещений без навигации используйте классы indoorBuilding и indoorLevel из SDK карт для Android .

Измените заголовок навигации.

Используйте SupportNavigationFragment.setStylingOptions() или NavigationView.setStylingOptions() чтобы изменить тему заголовка навигации и индикатора следующего поворота, который отображается под заголовком (если он доступен).

Примечание: Высота заголовка по умолчанию является динамической и определяется в зависимости от отображаемых указаний по выполнению маневра.

Вы можете задать следующие атрибуты:

Тип атрибута	Атрибуты
Цвет фона	Основной дневной режим — дневной цвет заголовка навигации. Дополнительный дневной режим — дневной цвет индикатора следующего поворота. Основной ночной режим — ночной цвет заголовка навигации. Дополнительный ночной режим — ночной цвет указателя следующего поворота.
Текстовые элементы для инструкций	Цвет текста Шрифт Размер текста первой строки Размер текста второй строки
Текстовые элементы для следующих шагов	Шрифт Цвет текста, соответствующий значению расстояния Размер текста значения расстояния Цвет текста единиц измерения расстояния Размер текста в единицах расстояния
Значки маневров	Цвет большого значка маневра Цвет значка малого маневра
Указания по полосам движения	Цвет рекомендуемой полосы или полос

В следующем примере показано, как задать параметры стиля:

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 displayOptions =
  new DisplayOptions().showTrafficLights(true).showStopSigns(true);

Добавить пользовательские маркеры

В SDK навигации для Android теперь используются API Google Maps для отображения маркеров. Для получения дополнительной информации обратитесь к документации по API карт .

Плавающий текст

Вы можете добавлять плавающий текст в любое место вашего приложения, при условии, что он не закрывает информацию об авторских правах Google. SDK навигации не поддерживает привязку текста к широте/долготе на карте или к метке. Для получения дополнительной информации перейдите в окно «Информация» .

Отобразить ограничение скорости

Вы можете программно отображать или скрывать значок ограничения скорости. Используйте NavigationView.setSpeedLimitIconEnabled() или SupportNavigationFragment.setSpeedLimitIconEnabled() для отображения или скрытия значка ограничения скорости. При включении значок ограничения скорости отображается в нижнем углу во время навигации. Значок отображает ограничение скорости на дороге, по которой движется транспортное средство. Значок появляется только в местах, где доступны достоверные данные об ограничении скорости.

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

Значок ограничения скорости временно скрывается, когда отображается кнопка центрирования.

Примечание: Пользователи должны соблюдать все дорожные знаки. Данные, указанные в значке ограничения скорости, служат лишь справочной информацией. Точность данных об ограничении скорости не гарантируется. Вы можете сообщить о неточностях в наших данных об ограничении скорости, отправив запрос на странице поддержки Google Cloud .

Установить ночной режим

Вы можете программно управлять поведением ночного режима. Используйте NavigationView.setForceNightMode() или SupportNavigationFragment.setForceNightMode() для включения или выключения ночного режима, или позвольте SDK навигации для Android управлять им.

• Функция AUTO позволяет 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));
}

Обязательно передавайте события жизненного цикла в DirectionsListView так же, как и в NavigationView . Например:

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

Скрыть альтернативные маршруты

Внимание: Эта функция несовместима с функцией выбора кратчайшего/быстрейшего маршрута. Одновременное использование обеих функций может привести к непредсказуемому поведению.

Когда пользовательский интерфейс перегружен информацией, вы можете уменьшить её количество, отображая меньше альтернативных маршрутов, чем по умолчанию (два), или вообще не отображая альтернативные маршруты. Вы можете настроить этот параметр перед получением маршрутов, вызвав метод RoutingOptions.alternateRoutesStrategy() с одним из следующих значений перечисления:

Значение перечисления	Описание
AlternateRoutesStrategy.SHOW_ALL	По умолчанию. Отображает до двух альтернативных маршрутов.
AlternateRoutesStrategy.SHOW_ONE	Отображает один альтернативный маршрут (если таковой имеется).
AlternateRoutesStrategy.SHOW_NONE	Скрывает альтернативные маршруты.

Следующий пример кода демонстрирует, как полностью скрыть альтернативные маршруты.

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

Индикатор выполнения поездки

Экспериментальная функция

Индикатор выполнения поездки — это вертикальная полоса, которая появляется в начале/передней части карты при запуске навигации. При включении она отображает общий обзор всей поездки, а также пункт назначения пользователя и его текущее местоположение.

Это позволяет пользователям быстро прогнозировать любые предстоящие проблемы, такие как пробки, без необходимости масштабирования. Затем они могут изменить маршрут поездки, если это необходимо. Если пользователь меняет маршрут, индикатор выполнения сбрасывается, как если бы с этого момента началась новая поездка.

Индикатор выполнения поездки отображает следующие показатели состояния:

• Пройденный маршрут — пройденный отрезок пути.

• Текущее местоположение — текущее местоположение пользователя во время поездки.

• Состояние дорожной ситуации — информация о предстоящем движении транспорта.

• Конечный пункт назначения — конечная цель путешествия.

Включите индикатор выполнения поездки, вызвав метод setTripProgressBarEnabled() в NavigationView или SupportNavigationFragment . Например:

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

Расположение индикатора выполнения поездки

• Левая сторона полосы примерно совпадает с левой стороной спидометра, логотипа Google и кнопки «Перецентрировать» (если она видна). Ширина составляет 12 знаков после запятой.
• Индикатор выполнения поездки имеет постоянную высоту. Для адаптации к ограничениям вертикального пространства на небольших устройствах видимость и высота индикатора выполнения поездки изменяются в зависимости от заданных точек перегиба по высоте экрана. Эти точки перегиба не зависят от ориентации устройства и фактического места, занимаемого картой на экране.

высота экрана	Видимость индикатора выполнения поездки	Высота индикатора выполнения поездки	Положение индикатора выполнения поездки по оси Y
Малый: 0–551 дП	Не видно	Н/Д	Н/Д
Средний: 552 дп. - 739 дп.	Видимый	130 дп	Элементы управления на стороне запуска (спидометр / логотип Google / кнопка "Перецентрировать") расположены над кнопкой запуска.
Большой: 740 dp и выше	Видимый	290 дп	Элементы управления на стороне запуска (спидометр / логотип Google / кнопка "Перецентрировать") расположены над кнопкой запуска.

Примечание: Значения высоты экрана, указанные в таблице выше, относятся к версиям Navigation SDK 6.2.1 и выше. Для версии 6.2.0 маленькие экраны определены как 0–519 dp, средние — как 520–599 dp, а большие — как 600 dp и выше. Видимость, высота и положение по оси Y индикатора выполнения поездки остаются теми же.
• Если индикатор выполнения поездки перекрывает карточку поворота или другие элементы пользовательского интерфейса навигации, он отображается под этими элементами.

Компас

В состав Navigation SDK входит графический компас, который появляется в правом верхнем углу карты при определенных условиях и только при включении этой функции. Когда пользователь щелкает по компасу, камера анимируется, возвращаясь в положение с нулевым азимутом (ориентация по умолчанию), и компас вскоре исчезает.

Если навигация включена и режим камеры установлен на «следование», компас остается видимым, а касание компаса переключает между наклонным и общим ракурсами камеры.

Чтобы избежать отвлечения внимания водителя, компас остается в том же положении, если заголовок (в портретном режиме) расширяется и конфликтует с положением компаса по умолчанию. Если вы добавите дополнительный элемент управления в заголовок или дополнительное представление заголовка, компас будет скрыт во избежание конфликтов пользовательского интерфейса.

Компас поддерживает дневной и ночной режимы, а также темный режим.

Компас включен по умолчанию. Вы можете включить компас, используя метод ` comapassEnabled класса ` GoogleMapOptions .

Отключите 3D-моделирование зданий.

Для устройств с ограниченными возможностями производительности можно отключить отображение 3D-зданий, вызвав метод GoogleMap.setBuildingsEnabled(false) .

API для отображения подсказок (экспериментальная версия)

Экспериментальная функция

API Prompt Visibility позволяет избежать конфликтов между элементами пользовательского интерфейса, созданными Navigation SDK, и вашими собственными пользовательскими элементами интерфейса, добавив обработчик событий, который будет получать обратный вызов перед появлением элемента пользовательского интерфейса Navigation SDK и сразу после его удаления. Для получения дополнительной информации, включая примеры кода, см. раздел «API Prompt Visibility» на странице «Настройка сбоев в реальном времени» .