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

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

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

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

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

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

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

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

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

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

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

Специальные позиции элементов управления для горизонтальной ориентации

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

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

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

   Примечание. Приложение должно вызывать этот метод в потоке UI.

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

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

    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) он находится над карточкой с расчетным временем прибытия и/или настраиваемым нижним колонтитулом (или внизу карты, если ни того, ни другого нет), а элементы Navigation SDK, включая кнопку центрирования и логотип Google, сдвигаются вверх, чтобы освободить место для настраиваемого элемента управления. Этот элемент управления находится в пределах видимых границ карты, поэтому любые отступы, добавленные к нижнему или начальному краям карты, также изменят его положение.

Нижний конец

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

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

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

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

Footer

Предварительная версия функции

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

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

Чтобы использовать эту позицию, передайте CustomControlPosition.FOOTER в setCustomControl.

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

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

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

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

Дополнительные элементы интерфейса карты

Navigation SDK для Android предоставляет элементы интерфейса, которые появляются во время навигации, аналогичные тем, которые есть в приложении "Google Карты" для 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.AudioGuidanceSettings;
import com.google.android.libraries.navigation.ListenableResultFuture;
import com.google.android.libraries.navigation.NavigationApi;
import com.google.android.libraries.navigation.NavigationFragment;
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.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 NavigationFragment 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 =
                (NavigationFragment)
                    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).
                AudioGuidanceSettings audioSettings =
                    AudioGuidanceSettings.builder()
                        .setGuidanceMode(
                            AudioGuidanceSettings.GuidanceMode.VOICE_ALERTS_AND_GUIDANCE)
                        .build();
                mNavigator.setAudioGuidanceSettings(audioSettings);

                // 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;
              case ROUTING_TIMEOUT:
                displayMessage("Error starting navigation: Routing timed out.");
                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().

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

Как изменить заголовок навигации

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

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

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

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

В примере ниже показано, как задать параметры стиля.

private NavigationFragment mNavFragment;
mNavFragment = (NavigationFragment) getSupportFragmentManager()
  .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));

Светофоры и знаки "Стоп"

Во время навигации на карте показываются светофоры и знаки "Стоп", чтобы пользователи лучше понимали, что их ждет на маршруте. Начиная с версии 8.0.0, отключить эту функцию нельзя.

Примечание. Светофоры могут показываться на карте и в других режимах.

Добавление собственных маркеров

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

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

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

Показывать ограничение скорости

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

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

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

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

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

Вы можете программно управлять поведением ночного режима. Используйте NavigationView.setForceNightMode() или NavigationFragment.setForceNightMode(), чтобы включить или отключить ночной режим, или разрешите Navigation SDK для 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));
}

Не забудьте перенаправить события жизненного цикла в 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 или NavigationFragment. Пример:

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

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

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

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

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

Компас

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

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

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

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

Компас включен по умолчанию. Чтобы включить или отключить компас, используйте метод compassEnabled класса GoogleMapOptions.

Отключить 3D-здания

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

Prompt Visibility API (экспериментальная функция)

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

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