Navigations-UI ändern

Mit dem Navigation SDK for Android können Sie die Nutzerfreundlichkeit Ihrer Karte anpassen, indem Sie festlegen, welche der integrierten UI-Steuerelemente und -Elemente auf der Karte angezeigt werden. Sie können auch die visuelle Darstellung der Navigations-UI anpassen. Auf der Seite „Richtlinien“ finden Sie Richtlinien zu zulässigen Änderungen an der Navigations-UI.

In diesem Dokument wird beschrieben, wie Sie die Benutzeroberfläche Ihrer Karte auf zwei Arten ändern können:

• Karten-UI-Steuerelemente
• Karten-UI-Zubehör

Achtung :Das Android Navigation SDK unterstützt das cloudbasierte Gestalten von Karteninhalten mit Karten-IDs nicht.

UI-Steuerelemente für die Karte

Die Karten-UI-Steuerelemente befinden sich über der Navigationsansicht. Das Navigation SDK for Android positioniert Ihre benutzerdefinierten Steuerelemente automatisch neu, wenn sich das integrierte Layout ändert. Für jede Position des Layouts können Sie ein benutzerdefiniertes Steuerelement festlegen. Das benutzerdefinierte Steuerelement kann ein einzelnes UI-Element sein. Wenn Ihr Design mehr Elemente erfordert, können Sie ein ViewGroup mit mehreren UI-Elementen verwenden.

Die Methode setCustomControl stellt Positionen gemäß der Definition in der Aufzählung CustomControlPosition bereit:

• SECONDARY_HEADER (wird nur im Hochformat angezeigt)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW

Das Bild zeigt Beispiele für verschiedene Positionen eines UI-Steuerelements, das den Fahrer über den Standort eines Fahrgasts informiert.

Benutzerdefinierten sekundären Header hinzufügen

Standardmäßig stellen Bildschirmlayouts im Navigationsmodus eine Position für eine sekundäre Überschrift unter dem primären Header bereit. Dieser sekundäre Header wird bei Bedarf angezeigt, z. B. bei der Spurführung. Ihre App kann diese sekundäre Kopfzeilenposition des Layouts für benutzerdefinierte Inhalte verwenden. Wenn Sie diese Funktion verwenden, deckt Ihr Steuerelement jeden standardmäßigen sekundären Headerinhalt ab. Wenn Ihre Navigationsansicht einen Hintergrund hat, bleibt dieser Hintergrund erhalten und wird vom sekundären Header verdeckt. Wenn das benutzerdefinierte Steuerelement durch die Anwendung entfernt wird, kann stattdessen jeder sekundäre Standardheader angezeigt werden.

Die obere Kante des benutzerdefinierten sekundären Headers wird an der Unterkante des primären Headers ausgerichtet. Diese Position wird nur in portrait mode unterstützt. In landscape mode ist der sekundäre Header nicht verfügbar und das Layout ändert sich nicht.

1. Erstelle eine Android View mit dem benutzerdefinierten UI-Element oder der ViewGroup.
2. Maximieren Sie die XML-Datei oder instanziieren Sie die benutzerdefinierte Ansicht, um eine Instanz der Ansicht abzurufen, die als sekundären Header hinzugefügt werden kann.

3. Verwenden Sie NavigationView.setCustomControl oder SupportNavigationFragment.setCustomControl mit CustomControlPosition als SECONDSARY_HEADER.

   Hinweis: Ihre App sollte diese Methode im UI-Thread aufrufen.

   Im folgenden Beispiel wird ein Fragment erstellt und an der sekundären Headerposition ein benutzerdefiniertes Steuerelement hinzugefügt.

   Hinweis: Der Code im Beispiel enthält Zeilenumbrüche zur besseren Sichtbarkeit in der Dokumentation. Entfernen Sie diese gegebenenfalls.

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

Sekundären Header entfernen

Mit der Methode setCustomControl können Sie den sekundären Header entfernen und zum Standardinhalt zurückkehren.

Wenn Sie die Ansicht entfernen möchten, legen Sie für die Ansicht null fest.

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

Benutzerdefiniertes Steuerelement unten in der Navigationsansicht hinzufügen

In Ihrer App kann ein benutzerdefiniertes Steuerelement angegeben werden, das am unteren Rand der Navigationsansicht ausgerichtet ist. Wenn in deiner App das benutzerdefinierte Steuerelement hinzugefügt wird, werden die Schaltfläche zum erneuten Zentrieren und das Google-Logo nach oben verschoben.

1. Erstellen Sie eine Android-Ansicht mit dem UI-Element oder der Ansichtsgruppe, die Sie hinzufügen möchten.
2. Erstellen Sie die Navigationsansicht oder das Fragment.
3. Rufen Sie die Methode setCustomControl in der Navigationsansicht oder dem Fragment auf und geben Sie das Steuerelement und die zu verwendende Position an.

Hinweis :Ihre Anwendung muss diese Methode im UI-Thread aufrufen.

Das folgende Beispiel zeigt eine benutzerdefinierte View, die einem SupportNavigationFragment hinzugefügt wurde:

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

Benutzerdefiniertes Steuerelement entfernen

Wenn Sie das benutzerdefinierte Steuerelement entfernen möchten, verwenden Sie die Methode setCustomControl und geben Sie die Position des zu entfernenden Steuerelements an.

Legen Sie als Ansicht für diese Position null fest.

mNavFragment.setCustomControl(null, CustomControlPosition.BOTTOM_END_BELOW);

Karten-UI-Zubehör

Das Navigation SDK for Android bietet UI-Zubehör, das während der Navigation ähnlich dem UI-Zubehör in der Google Maps for Android-App angezeigt wird. Sie können die Sichtbarkeit und das visuelle Erscheinungsbild dieser Steuerelemente wie in diesem Abschnitt beschrieben anpassen. Änderungen, die Sie hier vornehmen, werden für die nächste Fahrt des Fahrers übernommen.

Auf der Seite Richtlinien finden Sie Informationen zu akzeptablen Änderungen an der Navigations-UI.

Code ansehen

< > Java-Code für die Navigationsaktivität ein-/ausblenden

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

Navigationsüberschrift ändern

Mit SupportNavigationFragment.setStylingOptions() oder NavigationView.setStylingOptions() können Sie das Design der Navigationskopfzeile und der Markierung für die nächste Abbiegung unter der Kopfzeile ändern, sofern verfügbar.

Sie können die folgenden Attribute festlegen:

Attributtyp	Attribute
Hintergrundfarbe	Primärer Tagmodus - die Tagesfarbe der Navigationsüberschrift Sekundärer Tagesmodus - die Tagesfarbe des nächsten Richtungsindikators Primärer Nachtmodus – die Nachtfarbe der Navigationsüberschrift Sekundärer Nachtmodus – die Farbe der Nachtanzeige des nächsten Richtungsschalters
Textelemente für Anweisungen	Schriftfarbe Schriftart Textgröße der ersten Zeile Textgröße der zweiten Zeile
Textelemente für die nächsten Schritte	Schriftart Textfarbe des Entfernungswerts Textgröße des Entfernungswerts Textfarbe der Entfernungseinheiten Textgröße der Entfernungseinheiten
Manöversymbole	Farbe des großen Manöversymbols Farbe des kleinen Manöversymbols
Spurführung	Farbe der empfohlenen Spuren

Das folgende Beispiel zeigt, wie Stiloptionen festgelegt werden:

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

Verkehrsebene deaktivieren

Mit GoogleMap.setTrafficEnabled() kannst du die Verkehrsebene auf der Karte aktivieren oder deaktivieren. Diese Einstellung wirkt sich auf die Anzeige der Verkehrsdichte aus, die auf der Karte als Ganzes angezeigt wird. Sie hat jedoch keine Auswirkungen auf die Verkehrshinweise auf der vom Navigator eingezeichneten Route.

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

Ampeln und Stoppschilder aktivieren

Sie können Ampeln und Stoppschilder in der Karten-UI aktivieren. Mit dieser Funktion kann der Fahrer die Anzeige von Ampel- oder Stoppschildern auf seiner Route aktivieren und so einen besseren Kontext für effizientere und präzisere Fahrten bieten.

Standardmäßig sind Ampeln und Stoppschilder im Navigation SDK deaktiviert. Rufen Sie zum Aktivieren dieses Features für jedes Feature separat DisplayOptions auf.

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

Benutzerdefinierte Markierungen hinzufügen

Das Navigation SDK for Android verwendet jetzt Google Maps APIs für Markierungen. Weitere Informationen finden Sie in der Google Maps API-Dokumentation.

Unverankerter Text

Sie können überall in Ihrer App unverankerten Text hinzufügen, sofern dies nicht die Google-Attribution abdeckt. Das Navigation SDK unterstützt keine Verankerung des Texts an einem Breiten- und Längengrad auf der Karte oder bei einem Label. Weitere Informationen finden Sie unter Infofenster.

Geschwindigkeitsbegrenzung anzeigen

Sie können das Symbol für die Geschwindigkeitsbegrenzung programmatisch ein- oder ausblenden. Mit NavigationView.setSpeedLimitIconEnabled() oder SupportNavigationFragment.setSpeedLimitIconEnabled() können Sie das Symbol für die Geschwindigkeitsbegrenzung ein- oder ausblenden. Wenn diese Option aktiviert ist, wird das Symbol für die Geschwindigkeitsbegrenzung in der unteren Ecke der Navigation angezeigt. Das Symbol zeigt die Höchstgeschwindigkeit der Straße an, auf der das Fahrzeug unterwegs ist. Das Symbol wird nur an Orten angezeigt, an denen zuverlässige Daten zu Geschwindigkeitsbegrenzungen verfügbar sind.

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

Das Symbol für die Geschwindigkeitsbegrenzung wird vorübergehend ausgeblendet, wenn die Schaltfläche „Neu zentrieren“ angezeigt wird.

Hinweis: Die Fahrer müssen allen Schildern auf der Straße folgen. Daten, die im Symbol für die Geschwindigkeitsbegrenzung veröffentlicht werden, dienen nur als Referenz. Die Genauigkeit der Daten zu Geschwindigkeitsbegrenzungen kann nicht garantiert werden. Wenn Sie Ungenauigkeiten in unseren Daten zu Geschwindigkeitsbegrenzungen melden möchten, können Sie auf der Google Cloud-Supportseite eine Supportanfrage stellen.

Nachtmodus festlegen

Sie können das Verhalten des Nachtmodus programmatisch steuern. Verwenden Sie NavigationView.setForceNightMode() oder SupportNavigationFragment.setForceNightMode(), um den Nachtmodus zu aktivieren oder zu deaktivieren, oder lassen Sie ihn vom Navigation SDK für Android steuern.

• AUTO Damit kann das Navigation SDK anhand des Gerätestandorts und der Ortszeit den geeigneten Modus ermitteln.
• FORCE_NIGHT erzwingt die Aktivierung des Nachtmodus.
• FORCE_DAY erzwingt die Aktivierung des Tagesmodus.

Das folgende Beispiel zeigt, wie Sie den Nachtmodus innerhalb eines Navigationsfragments aktivieren:

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

Liste der Wegbeschreibungen anzeigen

Erstellen Sie zuerst die Ansicht und fügen Sie sie Ihrer Hierarchie hinzu.

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

Leiten Sie Lebenszyklusereignisse genau wie bei NavigationView an DirectionsListView weiter. Beispiel:

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

Alternative Routen werden ausgeblendet

Warnung :Diese Funktion ist derzeit nicht mit der Funktion für die kürzeste/schnellste Route kompatibel. Die gleichzeitige Verwendung beider Funktionen kann zu unerwartetem Verhalten führen.

Wenn die Benutzeroberfläche mit zu vielen Informationen überladen ist, können Sie die Route reduzieren, indem Sie weniger alternative Routen als die Standardroute (zwei) oder gar keine alternativen Routen einblenden. Sie können diese Option vor dem Abrufen der Routen konfigurieren. Dazu rufen Sie die Methode RoutingOptions.alternateRoutesStrategy() mit einem der folgenden Aufzählungswerte auf:

Aufzählungswert	Beschreibung
AlternateRoutesStrategy.SHOW_ALL	Standard. Es werden bis zu zwei alternative Routen angezeigt.
AlternateRoutesStrategy.SHOW_ONE	Es wird eine alternative Route angezeigt (falls verfügbar).
AlternateRoutesStrategy.SHOW_NONE	Alternative Routen werden ausgeblendet.

Das folgende Codebeispiel zeigt, wie alternative Routen vollständig ausgeblendet werden.

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

Fortschrittsanzeige für Fahrt

Die Fortschrittsanzeige ist eine vertikale Leiste, die am rechten Rand der Karte zu sehen ist, wenn die Navigation beginnt. Wenn sie aktiviert ist, werden eine Übersicht für die gesamte Fahrt sowie das Ziel und die aktuelle Position des Fahrers angezeigt.

Mit dieser Funktion können Fahrer bevorstehende Probleme wie den Verkehr schnell vorhersehen, ohne heranzoomen zu müssen. Bei Bedarf kann die Route dann neu berechnet werden. Wenn der Fahrer die Fahrt umleitet, wird die Fortschrittsanzeige zurückgesetzt, als ob an diesem Punkt eine neue Fahrt begonnen hat.

In der Fortschrittsanzeige werden die folgenden Statusanzeigen angezeigt:

• Route verstrichen: Der verstrichene Teil der Fahrt.

• Aktuelle Position: Aktuelle Position des Fahrers während der Fahrt.

• Verkehrsstatus: Der Status der nächsten Verkehrslage.

• Endziel: Das endgültige Ziel.

Hinweis :Die Fortschrittsanzeige ist nur im Hochformat sichtbar.

Aktivieren Sie die Fortschrittsanzeige der Fahrt, indem Sie die Methode setTripProgressBarEnabled() für NavigationView oder SupportNavigationFragment aufrufen. Beispiel:

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