Modyfikowanie interfejsu użytkownika

Za pomocą pakietu Navigation SDK na Androida możesz modyfikować wrażenia użytkowników związane z mapą, określając, które wbudowane elementy sterujące i elementy interfejsu mają się na niej pojawiać. Możesz też dostosować wygląd interfejsu nawigacji. Wskazówki dotyczące dopuszczalnych modyfikacji interfejsu nawigacji znajdziesz na stronie Zasady.

Z tego dokumentu dowiesz się, jak modyfikować interfejs mapy na 2 sposoby:

• Elementy sterujące interfejsu mapy
• Dodatki do interfejsu mapy

Uwaga: w większości przypadków zalecamy używanie elementu SupportNavigationFragment, który jest otoką elementu NavigationView, zamiast bezpośrednio wchodzić w interakcję z elementem NavigationView. Więcej informacji znajdziesz w artykule Sprawdzone metody dotyczące interakcji z mapą nawigacji .

Elementy sterujące interfejsu mapy

Aby umieścić niestandardowe elementy interfejsu w widoku nawigacji, użyj elementów sterujących interfejsu mapy, aby zapewnić prawidłowe pozycjonowanie. Gdy wbudowany układ się zmieni, pakiet Navigation SDK na Androida automatycznie zmieni położenie niestandardowych elementów sterujących. W każdej pozycji możesz ustawić 1 niestandardowy widok elementu sterującego. Jeśli projekt wymaga użycia kilku elementów interfejsu, możesz umieścić je w elemencie ViewGroup i przekazać go do metody setCustomControl.

Metoda setCustomControl udostępnia pozycje zdefiniowane w CustomControlPosition wyliczeniu:

• SECONDARY_HEADER (wyświetla się tylko w orientacji pionowej)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW
• FOOTER

Pozycje niestandardowych elementów sterujących w orientacji pionowej

Pozycje niestandardowych elementów sterujących w orientacji poziomej

Dodawanie niestandardowego elementu sterującego

1. Utwórz widok Androida z niestandardowym elementem interfejsu lub elementem ViewGroup.
2. Rozwiń kod XML lub utwórz instancję widoku niestandardowego, aby uzyskać instancję widoku.

3. Użyj NavigationView.setCustomControl lub SupportNavigationFragment.setCustomControl z wybraną pozycją niestandardowego elementu sterującego z wyliczenia CustomControlPosition.

   Uwaga: aplikacja powinna wywoływać tę metodę w wątku UI.

   W przykładzie poniżej tworzymy fragment i dodajemy niestandardowy element sterujący w pozycji nagłówka dodatkowego.

   Uwaga: kod w przykładzie zawiera znaki łamania wierszy, aby był lepiej widoczny w dokumentacji. W razie potrzeby usuń je.

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

Usuwanie niestandardowego elementu sterującego

Aby usunąć niestandardowy element sterujący, wywołaj metodę setCustomControl z parametrem widoku null i wybraną pozycją niestandardowego elementu sterującego.

Na przykład ten fragment kodu usuwa niestandardowy nagłówek dodatkowy i przywraca domyślną treść:

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

Pozycje niestandardowych elementów sterujących

Nagłówek dodatkowy

Pozycja niestandardowego elementu sterującego w nagłówku dodatkowym w orientacji pionowej

Aby użyć tej pozycji niestandardowego elementu sterującego, przekaż pozycję CustomControlPosition.SECONDARY_HEADER do metody setCustomControl.

Domyślnie układy ekranu w trybie nawigacji udostępniają pozycję nagłówka dodatkowego, która znajduje się pod nagłówkiem głównym. Ten nagłówek dodatkowy pojawia się w razie potrzeby, np. w przypadku asystenta pasa ruchu. Aplikacja może używać tej pozycji nagłówka dodatkowego w układzie do wyświetlania treści niestandardowych. Gdy używasz tej funkcji, element sterujący zakrywa domyślną treść nagłówka dodatkowego. Jeśli widok nawigacji ma tło, pozostaje ono na swoim miejscu, przykryte nagłówkiem dodatkowym. Gdy aplikacja usunie niestandardowy element sterujący, w jego miejscu może się pojawić domyślny nagłówek dodatkowy.

Pozycja niestandardowego nagłówka dodatkowego jest wyrównana do dolnej krawędzi nagłówka głównego. Ta pozycja jest obsługiwana tylko w portrait mode. W landscape mode, nagłówek dodatkowy jest niedostępny, a układ nie zmienia się.

Dół po lewej

Pozycja niestandardowego elementu sterującego w dole po lewej w orientacji pionowej

Pozycja niestandardowego elementu sterującego w dole po lewej w orientacji poziomej

Aby użyć tej pozycji niestandardowego elementu sterującego, przekaż pozycję CustomControlPosition.BOTTOM_START_BELOW do metody setCustomControl.

Ta pozycja niestandardowego elementu sterującego znajduje się w lewym dolnym rogu mapy. Zarówno w portrait mode jak i landscape mode, znajduje się ona nad kartą z szacowanym czasem dotarcia na miejsce i/lub niestandardową stopką (lub u dołu mapy, jeśli żadna z tych opcji nie jest dostępna), a elementy pakietu SDK Nav w tym przycisk ponownego wyśrodkowania i logo Google, przesuwają się w górę, aby uwzględnić wysokość widoku niestandardowego elementu sterującego. Ten element sterujący jest umieszczony w widocznych granicach mapy, więc wszelkie dopełnienie dodane do dolnej lub lewej krawędzi mapy zmieni też położenie tego elementu sterującego.

Dół po prawej

Pozycja niestandardowego elementu sterującego w dole po prawej w orientacji pionowej

Pozycja niestandardowego elementu sterującego w dole po prawej w orientacji poziomej

Aby użyć tej pozycji niestandardowego elementu sterującego, przekaż pozycję CustomControlPosition.BOTTOM_END_BELOW do metody setCustomControl.

Ta pozycja niestandardowego elementu sterującego znajduje się w prawym dolnym rogu mapy. W portrait mode znajduje się ona nad kartą z szacowanym czasem dotarcia na miejsce i/lub niestandardową stopką (lub u dołu mapy, jeśli żadna z tych opcji nie jest dostępna), ale w landscape mode jest wyrównana do dołu mapy. Wszystkie elementy pakietu Nav SDK widoczne po prawej stronie (w przypadku języków pisanych od lewej do prawej) przesuwają się w górę, aby uwzględnić wysokość widoku niestandardowego elementu sterującego. Ten element sterujący jest umieszczony w widocznych granicach mapy, więc wszelkie dopełnienie dodane do dolnej lub prawej krawędzi mapy zmieni też położenie tego elementu sterującego.

Stopka

Funkcja w wersji zapoznawczej

Pozycja niestandardowego elementu sterującego w stopce w orientacji pionowej

Pozycja niestandardowego elementu sterującego w stopce w orientacji poziomej

Aby użyć tej pozycji niestandardowego elementu sterującego, przekaż pozycję CustomControlPosition.FOOTER do metody setCustomControl.

Ta pozycja niestandardowego elementu sterującego jest przeznaczona dla niestandardowego widoku stopki. Jeśli widoczna jest karta z szacowanym czasem dotarcia pakietu Nav SDK, ten element sterujący znajduje się nad nią. W przeciwnym razie element sterujący jest wyrównany do dołu mapy. W przeciwieństwie do niestandardowych elementów sterujących BOTTOM_START_BELOW i BOTTOM_END_BELOW ten element sterujący jest umieszczony poza widocznymi granicami mapy, co oznacza, że wszelkie dopełnienie dodane do mapy nie zmieni położenia tego elementu sterującego.

W portrait mode niestandardowa stopka ma pełną szerokość. Niestandardowe elementy sterujące w pozycjach CustomControlPosition.BOTTOM_START_BELOW i CustomControlPosition.BOTTOM_END_BELOW, a także elementy interfejsu pakietu Nav SDK, takie jak przycisk ponownego wyśrodkowania i logo Google, są umieszczone nad niestandardową stopką elementu sterującego. Domyślna pozycja szewronu uwzględnia wysokość niestandardowej stopki.

W landscape mode niestandardowa stopka ma połowę szerokości i jest wyrównana do lewej strony (w przypadku języków pisanych od lewej do prawej), tak jak karta z szacowanym czasem dotarcia pakietu Nav SDK. Niestandardowe elementy sterujące w pozycji CustomControlPosition.BOTTOM_START_BELOW oraz elementy interfejsu pakietu Nav SDK, takie jak przycisk ponownego wyśrodkowania i logo Google, są umieszczone nad niestandardową stopką elementu sterującego. Niestandardowe elementy sterujące w pozycji CustomControlPosition.BOTTOM_END_BELOW oraz wszystkie elementy interfejsu pakietu Nav SDK po prawej stronie (w przypadku języków pisanych od lewej do prawej) pozostają wyrównane do dołu mapy. Domyślna pozycja szewronu nie zmienia się, gdy jest obecna niestandardowa stopka, ponieważ nie rozciąga się ona do prawej strony mapy.

Niestandardowe elementy sterujące w pozycjach CustomControlPosition.BOTTOM_START_BELOW i CustomControlPosition.BOTTOM_END_BELOW, a także elementy interfejsu pakietu Nav SDK, takie jak przycisk ponownego wyśrodkowania i logo Google, są umieszczone nad niestandardową stopką elementu sterującego.

Dodatki do interfejsu mapy

Pakiet Navigation SDK na Androida udostępnia dodatki do interfejsu, które pojawiają się podczas nawigacji podobnie jak w aplikacji Mapy Google na Androida. Widoczność lub wygląd tych elementów sterujących możesz dostosować zgodnie z opisem w tej sekcji. Wprowadzone tu zmiany będą widoczne podczas następnej sesji nawigacji.

Wskazówki dotyczące dopuszczalnych modyfikacji interfejsu nawigacji znajdziesz na stronie Zasady.

Wyświetlanie kodu

Wyświetlanie lub ukrywanie kodu Java dla aktywności nawigacji.

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

Wyróżnianie miejsca docelowego i wejść

Gdy miejsce docelowe zostanie utworzone za pomocą parametru placeID, budynek docelowy zostanie wyróżniony, a ikona wejścia będzie wyświetlana, jeśli to możliwe. Te wskazówki wizualne pomagają użytkownikom rozróżniać miejsca docelowe i do nich nawigować.

Aby utworzyć miejsce docelowe za pomocą parametru placeID, użyj metody.Waypoint.Builder.setPlaceIdString()

Uwaga: pakiet Navigation SDK nie obsługuje nawigacji w pomieszczeniach. W przypadku map pomieszczeń bez nawigacji użyj klas indoorBuilding i indoorLevel z pakietu Maps SDK na Androida.

Modyfikowanie nagłówka nawigacji

Aby zmienić motyw nagłówka nawigacji i wskaźnika następnego skrętu, który pojawia się pod nagłówkiem, gdy jest dostępny, użyj metody SupportNavigationFragment.setStylingOptions() lub NavigationView.setStylingOptions().

Uwaga: domyślna wysokość nagłówka jest dynamiczna i zależy od wyświetlanych wskazówek dotyczących manewru.

Możesz ustawić te atrybuty:

Typ atrybutu	Atrybuty
Kolor tła	Kolor podstawowy w trybie dziennym – kolor nagłówka nawigacji w ciągu dnia Kolor dodatkowy w trybie dziennym – kolor wskaźnika następnego skrętu w ciągu dnia Kolor podstawowy w trybie nocnym – kolor nagłówka nawigacji w nocy Kolor dodatkowy w trybie nocnym – kolor wskaźnika następnego skrętu w nocy
Elementy tekstowe instrukcji	Kolor tekstu Czcionka Rozmiar tekstu w pierwszym wierszu Rozmiar tekstu w drugim wierszu
Elementy tekstowe następnych kroków	Czcionka Kolor tekstu wartości odległości Rozmiar tekstu wartości odległości Kolor tekstu jednostek odległości Rozmiar tekstu jednostek odległości
Ikony manewrów	Kolor dużej ikony manewru Kolor małej ikony manewru
Asystent pasa ruchu	Kolor zalecanego pasa lub pasów

W przykładzie poniżej pokazujemy, jak ustawić opcje stylu:

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

Wyłączanie warstwy natężenia ruchu

Aby włączyć lub wyłączyć warstwę natężenia ruchu na mapie, użyj metody GoogleMap.setTrafficEnabled(). To ustawienie wpływa na wskazania natężenia ruchu wyświetlane na całej mapie. Nie wpływa jednak na wskazania natężenia ruchu na trasie wyznaczonej przez nawigatora.

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

Włączanie sygnalizacji świetlnej i znaków stop

Podczas aktywnej nawigacji możesz włączyć wyświetlanie sygnalizacji świetlnej i znaków stop na mapie, co zapewnia dodatkowy kontekst dla tras i manewrów.

Domyślnie sygnalizacja świetlna i znaki stop są wyłączone w pakiecie Navigation SDK. Aby włączyć tę funkcję, wywołaj DisplayOptions dla każdej funkcji osobno.

Uwaga: sygnalizacja świetlna może się też pojawiać na mapie w trybach innych niż nawigacja. Opcja konfigurowania wyświetlania sygnalizacji świetlnej za pomocą metody DisplayOptions wpływa tylko na sygnalizację świetlną w trybie aktywnej nawigacji.

W przykładzie poniżej pokazujemy, jak ukryć sygnalizację świetlną i znaki stop:

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

Metody showTrafficLights(boolean) i showStopSigns(boolean) zostały wycofane i zostaną usunięte w następnej głównej wersji, a sygnalizacja świetlna i znaki stop będą wyświetlane domyślnie.

Dodawanie niestandardowych znaczników

Pakiet Navigation SDK na Androida używa teraz interfejsów Google Maps API do obsługi znaczników. Więcej informacji znajdziesz w dokumentacji interfejsu API Map Google.

Pływający tekst

Możesz dodać pływający tekst w dowolnym miejscu aplikacji, o ile nie zakrywa on atrybucji Google. Pakiet Navigation SDK nie obsługuje zakotwiczania tekstu do szerokości i długości geograficznej na mapie ani do etykiety. Więcej informacji znajdziesz w artykule Info windows.

Wyświetlanie ograniczenia prędkości

Możesz programowo wyświetlać lub ukrywać ikonę ograniczenia prędkości. Aby wyświetlić lub ukryć ikonę ograniczenia prędkości, użyj metody NavigationView.setSpeedLimitIconEnabled() lub SupportNavigationFragment.setSpeedLimitIconEnabled(). Gdy ta opcja jest włączona, ikona ograniczenia prędkości wyświetla się w dolnym rogu podczas nawigacji. Ikona pokazuje ograniczenie prędkości na drodze, po której porusza się pojazd. Ikona pojawia się tylko w lokalizacjach, w których dostępne są wiarygodne dane o ograniczeniach prędkości.

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

Ikona ograniczenia prędkości jest tymczasowo ukryta, gdy wyświetla się przycisk ponownego wyśrodkowania.

Uwaga: użytkownicy muszą przestrzegać wszystkich znaków drogowych. Dane wyświetlane na ikonie ograniczenia prędkości służą wyłącznie jako odniesienie. Nie możemy zagwarantować dokładności danych o ograniczeniach prędkości. Nieścisłości w danych o ograniczeniach prędkości możesz zgłaszać, otwierając zgłoszenie na stronie pomocy Google Cloud.

Ustawianie trybu nocnego

Możesz programowo sterować działaniem trybu nocnego. Aby włączyć lub wyłączyć tryb nocny albo pozwolić pakietowi Navigation SDK na Androida na sterowanie nim, użyj NavigationView.setForceNightMode() lub SupportNavigationFragment.setForceNightMode().

• AUTO – pakiet Navigation SDK określa odpowiedni tryb na podstawie lokalizacji urządzenia i czasu lokalnego.
• FORCE_NIGHT – wymusza włączenie trybu nocnego.
• FORCE_DAY – wymusza włączenie trybu dziennego.

W przykładzie poniżej pokazujemy, jak wymusić włączenie trybu nocnego we fragmencie nawigacji:

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

Wyświetlanie listy wskazówek dojazdu

Najpierw utwórz widok i dodaj go do hierarchii.

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

Pamiętaj, aby przekazywać zdarzenia cyklu życia do elementu DirectionsListView tak samo jak w przypadku elementu NavigationView. Na przykład:

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

Ukrywanie tras alternatywnych

Ostrzeżenie: ta funkcja jest niezgodna z funkcją najkrótszej/najszybszej trasy. Używanie obu tych funkcji jednocześnie może powodować nieoczekiwane działanie.

Gdy interfejs użytkownika jest przeładowany zbyt dużą ilością informacji, możesz zmniejszyć bałagan, wyświetlając mniej tras alternatywnych niż domyślne (2) lub nie wyświetlając ich wcale. Tę opcję możesz skonfigurować przed pobraniem tras, wywołując metodę RoutingOptions.alternateRoutesStrategy() z jedną z tych wartości wyliczeniowych:

Wartość wyliczeniowa	Opis
AlternateRoutesStrategy.SHOW_ALL	Domyślna. Wyświetla maksymalnie 2 trasy alternatywne.
AlternateRoutesStrategy.SHOW_ONE	Wyświetla 1 trasę alternatywną (jeśli jest dostępna).
AlternateRoutesStrategy.SHOW_NONE	Ukrywa trasy alternatywne.

W tym przykładzie kodu pokazujemy, jak całkowicie ukryć trasy alternatywne.

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

Pasek postępu podróży

Funkcja eksperymentalna

Pasek postępu podróży to pionowy pasek, który pojawia się po lewej stronie mapy po rozpoczęciu nawigacji. Gdy ta opcja jest włączona, wyświetla się podsumowanie całej podróży wraz z miejscem docelowym użytkownika i jego bieżącą pozycją.

Umożliwia użytkownikom szybkie przewidywanie nadchodzących problemów, takich jak natężenie ruchu, bez konieczności powiększania. W razie potrzeby mogą zmienić trasę. Jeśli użytkownik zmieni trasę, pasek postępu zostanie zresetowany tak, jakby od tego momentu rozpoczęła się nowa podróż.

Pasek postępu podróży wyświetla te wskaźniki stanu:

• Czas podróży – czas, który upłynął od rozpoczęcia podróży.

• Bieżąca pozycja – bieżąca lokalizacja użytkownika podczas podróży.

• Natężenie ruchu – stan nadchodzącego natężenia ruchu.

• Ostateczny cel podróży – ostateczny cel podróży.

Aby włączyć pasek postępu podróży, wywołaj metodę setTripProgressBarEnabled() w NavigationView lub SupportNavigationFragment. Na przykład:

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

Położenie paska postępu podróży

• Lewa strona paska jest w przybliżeniu wyrównana do lewej strony prędkościomierza, logo Google i przycisku ponownego wyśrodkowania (gdy są widoczne). Szerokość wynosi 12 dp.
• Pasek postępu podróży ma stałą wysokość. Aby dostosować się do ograniczeń miejsca w pionie na mniejszych urządzeniach, widoczność i wysokość paska postępu podróży dostosowują się na podstawie określonych punktów przerwania wysokości ekranu. Te punkty przerwania są niezależne od orientacji urządzenia i ilości miejsca, jaką mapa zajmuje na ekranie:

Wysokość ekranu	Widoczność paska postępu podróży	Wysokość paska postępu podróży	Położenie paska postępu podróży na osi Y
Mała: 0 dp – 551 dp	Niewidoczna	Nie dotyczy	Nie dotyczy
Średnia: 552 dp – 739 dp	Widoczna	130 dp	Nad elementami sterującymi po lewej stronie (prędkościomierz / logo Google / przycisk ponownego wyśrodkowania)
Duża: 740 dp i więcej	Widoczna	290 dp	Nad elementami sterującymi po lewej stronie (prędkościomierz / logo Google / przycisk ponownego wyśrodkowania)

Uwaga: wartości wysokości ekranu podane w tabeli powyżej dotyczą pakietu Navigation SDK w wersji 6.2.1 i nowszych. W przypadku wersji 6.2.0 małe ekrany są definiowane jako 0 dp – 519 dp, średnie jako 520 dp – 599 dp, a duże ekrany jako 600 dp i więcej. Widoczność, wysokość i położenie na osi Y paska postępu podróży są takie same.
• Jeśli pasek postępu podróży nakłada się na kartę skrętu lub inne elementy interfejsu nawigacji, pojawia się pod nimi.

Kompas

Pakiet Navigation SDK udostępnia grafikę kompasu, która w określonych okolicznościach pojawia się w prawym górnym rogu mapy i tylko wtedy, gdy jest włączona. Gdy użytkownik kliknie kompas, kamera animuje się z powrotem do pozycji z kursem zero (orientacja domyślna), a kompas znika po chwili.

Jeśli nawigacja jest włączona, a tryb kamery jest ustawiony na „śledzenie”, kompas pozostaje widoczny, a kliknięcie kompasu przełącza między perspektywą pochyloną a perspektywą ogólną.

Aby nie rozpraszać kierowcy, kompas pozostaje w tej samej pozycji, jeśli nagłówek (w orientacji pionowej) rozszerza się i koliduje z domyślną pozycją kompasu. Jeśli dodasz niestandardowy element sterujący nagłówka dodatkowego lub widok dodatku do nagłówka, kompas zostanie ukryty, aby uniknąć konfliktów w interfejsie.

Kompas obsługuje tryb dzienny i nocny oraz tryb ciemny.

Kompas jest domyślnie włączony. Czy kompas jest włączony, możesz ustawić za pomocą metody compassEnabled w klasie GoogleMapOptions.

Wyłączanie budynków 3D

Na urządzeniach o ograniczonej wydajności możesz wyłączyć wyświetlanie budynków 3D, wywołując metodę GoogleMap.setBuildingsEnabled(false).

Interfejs Prompt Visibility API (eksperymentalny)

Funkcja eksperymentalna

Interfejs Prompt Visibility API umożliwia unikanie konfliktów między elementami interfejsu generowanymi przez pakiet Navigation SDK a własnymi elementami interfejsu niestandardowego przez dodanie odbiornika, który będzie otrzymywać wywołanie zwrotne przed pojawieniem się elementu interfejsu pakietu Navigation SDK i zaraz po jego usunięciu. Więcej informacji, w tym przykłady kodu, znajdziesz w sekcji Prompt Visibility API na stronie Konfigurowanie zakłóceń w czasie rzeczywistym.