Modyfikowanie interfejsu użytkownika

Za pomocą pakietu Navigation SDK na Androida możesz modyfikować sposób korzystania z mapy, określając, które z wbudowanych elementów interfejsu i elementów mają się pojawiać na mapie. Możesz też dostosować wygląd interfejsu nawigacji. Wskazówki na temat dopuszczalnych modyfikacji interfejsu nawigacyjnego znajdziesz na stronie Zasady.

W tym dokumencie opisano, jak modyfikować interfejs użytkownika mapy na dwa sposoby:

• Elementy sterujące interfejsu mapy
• Akcesoria do interfejsu Map Google

Uwaga: pakiet Android Navigation SDK nie obsługuje określania w chmurze stylów map z identyfikatorami map.

Elementy sterujące interfejsu mapy

Elementy sterujące interfejsu mapy znajdują się nad widokiem nawigacji. Pakiet Navigation SDK na Androida automatycznie zmienia położenie elementów sterujących niestandardowych po zmianie wbudowanego układu. Dla każdej pozycji układu możesz ustawić 1 niestandardowy element sterujący. Elementem sterującym niestandardowym może być jeden element interfejsu. Jeśli Twój projekt wymaga więcej, możesz użyć ViewGroup z wieloma elementami interfejsu.

Metoda setCustomControl podaje pozycje zgodnie z definicją za pomocą wyliczenia CustomControlPosition:

• SECONDARY_HEADER (wyświetla się tylko w trybie pionowym)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW

Obraz przedstawia przykłady różnych pozycji elementu sterującego interfejsu, który informuje kierowcę o lokalizacji pasażera.

Dodawanie niestandardowego nagłówka dodatkowego

Domyślnie układy ekranu w trybie nawigacji umożliwiają umieszczenie dodatkowego nagłówka znajdującego się pod nagłówkiem głównym. Ten dodatkowy nagłówek pojawia się, gdy jest to potrzebne, np. przy rozpoznawaniu pasa ruchu. Aplikacja może używać tego dodatkowego pozycji nagłówka w układzie dla treści niestandardowych. Gdy używasz tej funkcji, element sterujący obejmuje domyślną treść dodatkowego nagłówka. Jeśli widok nawigacyjny ma tło, pozostaje ono na swoim miejscu i zasłonięte nagłówkiem dodatkowym. Gdy aplikacja usunie niestandardowy element sterujący, w jego miejscu może pojawić się dowolny domyślny nagłówek dodatkowy.

Niestandardowe położenie dodatkowego nagłówka wyrównuje jego górną krawędź do dolnej krawędzi nagłówka głównego. Ta pozycja jest obsługiwana tylko w języku: portrait mode. W landscape mode dodatkowy nagłówek jest niedostępny, a układ się nie zmienia.

1. Utwórz widok Androida za pomocą niestandardowego elementu interfejsu lub ViewGroup.
2. Rozszerz plik XML lub utwórz instancję widoku niestandardowego, aby pobrać instancję widoku, którą chcesz dodać jako nagłówek dodatkowy.

3. Użyj właściwości NavigationView.setCustomControl lub SupportNavigationFragment.setCustomControl z opcją CustomControlPosition jako SECONDARY_HEADER.

   Uwaga: aplikacja powinna wywoływać tę metodę w wątku interfejsu użytkownika.

   W przykładzie poniżej tworzymy fragment i dodaje on niestandardową opcję w pozycji dodatkowego nagłówka.

   Uwaga: kod w przykładzie zawiera podziały wierszy, które zwiększają widoczność w dokumentacji. Usuń je w razie potrzeby.

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

Usuwanie dodatkowego nagłówka

Aby usunąć dodatkowy nagłówek i wrócić do treści domyślnej, użyj metody setCustomControl.

Aby go usunąć, ustaw widok na null.

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

Dodaj niestandardowy element sterujący u dołu widoku nawigacji

Aplikacja może mieć niestandardowy element sterujący wyrównany do dolnej krawędzi widoku nawigacji. Gdy aplikacja doda niestandardowy element sterujący, przycisk wyśrodkuj i logo Google przesuwają się do góry, aby je zmieścić.

1. Utwórz widok Androida z elementem interfejsu lub grupą widoków, które chcesz dodać.
2. Utwórz widok lub fragment nawigacji.
3. Wywołaj metodę setCustomControl w widoku lub fragmencie nawigacji i określ element sterujący oraz pozycję, która ma być używana.

Uwaga: aplikacja musi wywoływać tę metodę w wątku interfejsu użytkownika.

Ten przykład pokazuje niestandardową View dodaną do SupportNavigationFragment:

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

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

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

Usuwanie elementu sterującego niestandardowego

Aby usunąć niestandardowy element sterujący, użyj metody setCustomControl i określ jego pozycję, którą chcesz usunąć.

Ustaw widok na null dla tej pozycji.

mNavFragment.setCustomControl(null, CustomControlPosition.BOTTOM_END_BELOW);

Akcesoria do interfejsu Map

Pakiet Navigation SDK na Androida zawiera akcesoria interfejsu, które pojawiają się podczas nawigacji podobne do tych w aplikacji Mapy Google na Androida. Możesz dostosować widoczność i wygląd tych elementów sterujących w sposób opisany w tej sekcji. Wprowadzone tu zmiany będą widoczne podczas kolejnej podróży kierowcy.

Wskazówki na temat dopuszczalnych modyfikacji interfejsu nawigacyjnego znajdziesz na stronie Zasady.

Wyświetl kod

< > Pokaż/ukryj kod Java dla czynności związanej z nawigacją.

package com.example.navsdkcustomization;

import android.content.pm.PackageManager;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.os.Bundle;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.widget.Toast;
import androidx.annotation.NonNull;
import com.google.android.libraries.navigation.Camera;
import com.google.android.libraries.navigation.LatLng;
import com.google.android.libraries.navigation.ListenableResultFuture;
import com.google.android.libraries.navigation.Marker;
import com.google.android.libraries.navigation.MarkerOptions;
import com.google.android.libraries.navigation.NavigationApi;
import com.google.android.libraries.navigation.NavigationMap;
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 NavigationMap 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) getFragmentManager()
                                .findFragmentById(R.id.navigation_fragment);

                        // 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));
        // Get the map.
        mMap = mNavFragment.getMap();
        // Turn off the traffic layer on the map.
        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(destinationMarkerIcon)
                    .title("Destination marker"));

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


        // Set the camera to follow the device location with 'TILTED' driving view.
        mNavFragment.getCamera().followMyLocation(Camera.Perspective.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.fromPlaceId(placeId, null);
        } 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);
    }
}

Modyfikowanie nagłówka nawigacyjnego

Użyj klawiszy SupportNavigationFragment.setStylingOptions() lub NavigationView.setStylingOptions(), aby zmienić motyw nagłówka nawigacji i wskaźnik następnego skrętu, który pojawia się pod nagłówkiem (jeśli jest dostępny).

Możesz ustawić te atrybuty:

Typ atrybutu	Atrybuty
Kolor tła	Główny tryb dnia – kolor nagłówka nawigacji w ciągu dnia. Tryb dnia dodatkowego – kolor dnia wskaźnika następnego skrętu. Główny tryb nocny – kolor nocny nagłówka nawigacji Dodatkowy tryb nocny – kolor nocny wskaźnika następnego skrętu.
Elementy tekstowe instrukcji	Kolor tekstu Czcionka Rozmiar tekstu w pierwszym wierszu Rozmiar tekstu w drugim wierszu
Elementy tekstowe kolejnych 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 przesuwania	Kolor dużej ikony manewru Kolor małej ikony manewru
Asystent pasa ruchu	Kolor zalecanego pasa

Ten przykład pokazuje, 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

Użyj GoogleMap.setTrafficEnabled(), aby włączyć lub wyłączyć warstwę natężenia ruchu na mapie. To ustawienie wpływa na wskaźniki natężenia ruchu widoczne na całej mapie. Nie ma jednak wpływu na informacje o natężeniu ruchu na trasie wyznaczonej przez nawigację.

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 stopu

Możesz włączyć sygnalizację świetlną i znaki stopu w interfejsie mapy. Dzięki tej funkcji kierowca może włączyć wyświetlanie ikon sygnalizacji świetlnej lub znaków stopu na trasie, co zapewnia lepszy kontekst dla bardziej efektywnego i precyzyjnego przejazdu.

Domyślnie sygnalizacja świetlna i znaki stopu w pakiecie SDK nawigacji są wyłączone. Aby włączyć tę funkcję, wywołaj metodę DisplayOptions w przypadku każdej z nich z osobna.

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

Dodaj znaczniki niestandardowe

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

Tekst pływający

Tekst pływający możesz dodać w dowolnym miejscu w aplikacji, o ile nie zasłania on danych atrybucji Google. Pakiet Navigation SDK nie obsługuje zakotwiczenia tekstu do szerokości i długości geograficznej na mapie ani etykiety. Więcej informacji znajdziesz w oknach informacyjnych.

Wyświetlanie ograniczenia prędkości

Możesz programowo wyświetlać lub ukrywać ikonę ograniczenia prędkości. Użyj przycisku NavigationView.setSpeedLimitIconEnabled() lub SupportNavigationFragment.setSpeedLimitIconEnabled(), aby wyświetlić lub ukryć ikonę ograniczenia prędkości. Gdy ta funkcja jest włączona, w dolnym rogu podczas prowadzenia pojazdu wyświetla się ikona ograniczenia prędkości. Ikona wyświetla ograniczenie prędkości na drodze, po której porusza się pojazd. Ikona pojawia się tylko w miejscach, 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świetlany jest przycisk ponownego wyśrodkowania.

Uwaga: kierowcy muszą przestrzegać wszystkich znaków drogowych znajdujących się na drodze. Dane publikowane na ikonie ograniczenia prędkości służą tylko jako odniesienie. Nie możemy zagwarantować dokładności danych o ograniczeniach prędkości. Nieścisłości w naszych danych dotyczących limitów prędkości możesz zgłosić, przesyłając zgłoszenie na stronie pomocy Google Cloud.

Ustaw tryb nocny

Możesz automatycznie sterować działaniem trybu nocnego. Użyj przycisku NavigationView.setForceNightMode() lub SupportNavigationFragment.setForceNightMode(), aby włączyć lub wyłączyć tryb nocny, albo pozwolić, aby sterował nim pakiet SDK nawigacji na Androida.

• AUTO Pozwala pakietowi Navigation SDK określić odpowiedni tryb na podstawie lokalizacji urządzenia i czasu lokalnego.
• FORCE_NIGHT wymusza włączenie trybu nocnego.
• FORCE_DAY wymusza włączenie trybu dziennego.

Ten przykład pokazuje wymuszanie włączenia trybu nocnego w ramach fragmentu nawigacji:

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

Wyświetl listę wskazówek dojazdu

Najpierw utwórz widok i dodaj go do swojej 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, by przekazywać zdarzenia cyklu życia do DirectionsListView w taki sam sposób jak NavigationView. Na przykład:

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

Ukrywam trasy alternatywne

Ostrzeżenie: ta funkcja jest obecnie niezgodna z funkcją najkrótszej lub najszybszej trasy. Korzystanie z obu funkcji jednocześnie może spowodować nieoczekiwane zachowanie.

Gdy interfejs użytkownika zaśmieca się za dużo informacji, możesz zwiększyć przejrzystość informacji, wyświetlając mniej tras alternatywnych niż domyślne (2) lub nie wyświetlając żadnych tras alternatywnych. Możesz skonfigurować tę opcję przed pobraniem tras, wywołując metodę RoutingOptions.alternateRoutesStrategy() z jedną z tych wartości wyliczeniowych:

Wartość wyliczenia	Opis
AlternateRoutesStrategy.SHOW_ALL	Domyślny: Wyświetla maksymalnie dwie alternatywne trasy.
AlternateRoutesStrategy.SHOW_ONE	Wyświetla jedną trasę alternatywną (jeśli jest dostępna).
AlternateRoutesStrategy.SHOW_NONE	Ukrywa trasy alternatywne.

Poniższy przykładowy kod pokazuje, jak całkowicie ukryć alternatywne trasy.

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

Pasek postępu podróży

Pasek postępu podróży to pionowy pasek wyświetlany na prawej krawędzi mapy po rozpoczęciu nawigacji. Gdy ta opcja jest włączona, wyświetlany jest przegląd całej podróży wraz z miejscem docelowym kierowcy i bieżącą pozycją.

Dzięki temu kierowcy mogą szybko przewidywać nadchodzące problemy, np. natężenie ruchu, bez konieczności powiększania widoku. W razie potrzeby mogą zmienić trasę. Jeśli kierowca zmieni trasę, pasek postępu zostanie zresetowany tak, jakby rozpoczynała się nowa podróż.

Pasek postępu podróży zawiera następujące wskaźniki stanu:

• Upływ trasy – pozostały czas podróży.

• Aktualna pozycja – bieżąca lokalizacja kierowcy na trasie.

• Stan ruchu – stan nadchodzącego ruchu.

• Ostatnie miejsce docelowe – ostateczne miejsce podróży.

Uwaga: pasek postępu jest widoczny tylko w trybie pionowym.

Włącz pasek postępu podróży, wywołując metodę setTripProgressBarEnabled() w obiekcie NavigationView lub SupportNavigationFragment. Na przykład:

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