Navigations-UI ändern

Mit dem Navigation SDK for Android können Sie die Nutzerfreundlichkeit Ihrer Karte ändern, 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 mit den 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
• UI-Zubehör für Karten

Hinweis: In den meisten Fällen empfehlen wir, SupportNavigationFragment zu verwenden, einen Wrapper für NavigationView, anstatt direkt mit NavigationView zu interagieren. Weitere Informationen finden Sie unter Best Practices für die Interaktion mit Navigationskarten .

Achtung: Das Android Navigation SDK unterstützt kein cloudbasiertes Gestalten von Karteninhalten mit Karten-IDs.

Steuerelemente für die Kartenoberfläche

Die Karten-UI-Steuerelemente sind die empfohlene Methode, um benutzerdefinierte UI-Elemente in der Navigationsansicht zu platzieren und so eine korrekte Positionierung zu gewährleisten. Wenn sich das integrierte Layout ändert, werden Ihre benutzerdefinierten Steuerelemente vom Navigation SDK für Android automatisch neu positioniert. Sie können für jede Position jeweils eine benutzerdefinierte Steuerelementansicht festlegen. Wenn Ihr Design mehrere UI-Elemente erfordert, können Sie sie in einen ViewGroup-Block einfügen und an die setCustomControl-Methode übergeben.

Die setCustomControl-Methode bietet Positionen, die im CustomControlPosition-Enum definiert sind:

• SECONDARY_HEADER (nur im Hochformat zu sehen)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW
• FOOTER

Benutzerdefinierte Steuerelementpositionen für das Hochformat

Benutzerdefinierte Steuerelementpositionen für das Querformat

Benutzerdefiniertes Steuerelement hinzufügen

1. Erstellen Sie eine Android-Ansicht mit dem benutzerdefinierten UI-Element oder der ViewGroup.
2. Erweitern Sie die XML-Datei oder erstellen Sie eine Instanz der benutzerdefinierten Ansicht, um eine Instanz der Ansicht zu erhalten.

3. Verwenden Sie NavigationView.setCustomControl oder SupportNavigationFragment.setCustomControl mit der ausgewählten Position des benutzerdefinierten Steuerelements aus dem CustomControlPosition-Enum.

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

   Im folgenden Beispiel wird ein Fragment erstellt und ein benutzerdefiniertes Steuerelement an der Position des sekundären Headers eingefügt.

   Hinweis: Der Code im Beispiel enthält Zeilenumbrüche, damit er in der Dokumentation besser lesbar ist. Entfernen Sie sie gegebenenfalls.

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

Benutzerdefiniertes Steuerelement entfernen

Wenn Sie ein benutzerdefiniertes Steuerelement entfernen möchten, rufen Sie die Methode setCustomControl mit dem Datenansichtsparameter null und der Position des ausgewählten benutzerdefinierten Steuerelements auf.

Im folgenden Snippet wird beispielsweise jeder benutzerdefinierte sekundäre Header entfernt und der Standardinhalt wird wiederhergestellt:

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

Positionen für benutzerdefinierte Steuerelemente

Sekundäre Überschrift

Position der benutzerdefinierten Steuerelemente für die sekundäre Überschrift im Hochformat

Wenn Sie diese benutzerdefinierte Steuerelementposition verwenden möchten, übergeben Sie die Position CustomControlPosition.SECONDARY_HEADER an setCustomControl.

Standardmäßig bieten Bildschirmlayouts im Navigationsmodus eine Position für eine sekundäre Überschrift unter der primären Überschrift. Dieser sekundäre Titel wird bei Bedarf angezeigt, z. B. bei der Fahrstreifenführung. In Ihrer App kann diese sekundäre Headerposition des Layouts für benutzerdefinierte Inhalte verwendet werden. Wenn Sie diese Funktion verwenden, werden alle standardmäßigen sekundären Header-Inhalte von Ihrer Einstellung abgedeckt. Wenn Ihre Navigationsansicht einen Hintergrund hat, bleibt dieser erhalten und wird vom sekundären Header verdeckt. Wenn Sie das benutzerdefinierte Steuerelement aus Ihrer App entfernen, kann an seiner Stelle ein beliebiger sekundärer Standardheader angezeigt werden.

Bei der benutzerdefinierten Position der sekundären Überschrift wird der obere Rand an den unteren Rand der primären Überschrift 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.

Unten beginnen

Position der benutzerdefinierten Steuerelemente für das Hochformat

Position der benutzerdefinierten Steuerelemente für das Querformat

Wenn Sie diese benutzerdefinierte Steuerelementposition verwenden möchten, übergeben Sie die Position CustomControlPosition.BOTTOM_START_BELOW an setCustomControl.

Diese benutzerdefinierte Steuerelementposition befindet sich in der unteren linken Ecke der Karte. Sowohl in portrait mode als auch in landscape mode wird sie über der Karte mit der geschätzten Ankunftszeit und/oder der benutzerdefinierten Fußzeile angezeigt (oder am unteren Rand der Karte, wenn keines der beiden Elemente vorhanden ist). Die Elemente des Navigations-SDK, einschließlich der Schaltfläche zum Zentrieren und des Google-Logos, werden nach oben verschoben, um die Höhe der benutzerdefinierten Steuerfeldansicht zu berücksichtigen. Dieses Steuerelement wird innerhalb der sichtbaren Kartengrenzen platziert. Wenn Sie also den unteren oder oberen Rändern der Karte Ränder hinzufügen, ändert sich auch die Position dieses Steuerelements.

Unterer Anschluss

Position der benutzerdefinierten Steuerelemente am unteren Ende im Hochformat

Position der benutzerdefinierten Steuerelemente am unteren Ende im Querformat

Wenn Sie diese benutzerdefinierte Steuerelementposition verwenden möchten, übergeben Sie die Position CustomControlPosition.BOTTOM_END_BELOW an setCustomControl.

Diese Position für benutzerdefinierte Steuerelemente befindet sich unten rechts auf der Karte. In portrait mode wird sie über der Karte mit der geschätzten Ankunftszeit und/oder der benutzerdefinierten Fußzeile platziert (oder unten auf der Karte, wenn keine vorhanden ist). In landscape mode ist sie dagegen mit dem unteren Rand der Karte ausgerichtet. Alle Nav SDK-Elemente, die an der Endseite (rechte Seite bei LTR) sichtbar sind, werden nach oben verschoben, um die Höhe der Ansicht des benutzerdefinierten Steuerelements zu berücksichtigen. Dieses Steuerelement wird innerhalb der sichtbaren Kartengrenzen platziert. Wenn Sie also den unteren oder den Endrändern der Karte Ränder hinzufügen, ändert sich auch die Position dieses Steuerelements.

Fußzeile

Position der benutzerdefinierten Fußzeilensteuerung für das Hochformat

Position der benutzerdefinierten Steuerelemente in der Fußzeile im Querformat

Wenn Sie diese benutzerdefinierte Steuerelementposition verwenden möchten, übergeben Sie die Position CustomControlPosition.FOOTER an setCustomControl.

Diese benutzerdefinierte Steuerelementposition ist für eine benutzerdefinierte Fußzeilenanzeige vorgesehen. Wenn die ETA-Karte des Nav SDK sichtbar ist, befindet sich dieses Steuerelement darüber. Andernfalls ist das Steuerelement am unteren Rand der Karte ausgerichtet. Im Gegensatz zu den benutzerdefinierten Steuerelementen BOTTOM_START_BELOW und BOTTOM_END_BELOW wird dieses Steuerelement außerhalb der sichtbaren Kartengrenzen positioniert. Das bedeutet, dass sich die Position dieses Steuerelements durch zusätzliche Ränder, die der Karte hinzugefügt werden, nicht ändert.

In portrait mode hat die benutzerdefinierte Fußzeile die volle Breite. Benutzerdefinierte Steuerelemente an den Positionen CustomControlPosition.BOTTOM_START_BELOW und CustomControlPosition.BOTTOM_END_BELOW sowie UI-Elemente des Nav SDK wie die Schaltfläche zum Zentrieren und das Google-Logo werden über der Fußzeile des benutzerdefinierten Steuerelements platziert. Bei der Standardposition des Dreistrich-Menüs wird die benutzerdefinierte Fußzeilenhöhe berücksichtigt.

In landscape mode ist die benutzerdefinierte Fußzeile halb so breit und wie die ETA-Karte des Nav SDK an der Startseite (linke Seite bei linksläufiger Textrichtung) ausgerichtet. Die benutzerdefinierten Steuerelemente an der Position CustomControlPosition.BOTTOM_START_BELOW und die UI-Elemente des Navigations-SDKs wie die Schaltfläche zum Zentrieren und das Google-Logo werden über der Fußzeile des benutzerdefinierten Steuerelements platziert. Die benutzerdefinierten Steuerelemente an der Position CustomControlPosition.BOTTOM_END_BELOW und alle UI-Elemente des Nav SDK an der Endseite (rechte Seite bei LTR) bleiben mit dem unteren Rand der Karte ausgerichtet. Die Standardposition des Dreistrich-Symbols ändert sich nicht, wenn ein benutzerdefinierter Footer vorhanden ist, da der Footer nicht bis zum Ende der Karte reicht.

Benutzerdefinierte Steuerelemente an den Positionen CustomControlPosition.BOTTOM_START_BELOW und CustomControlPosition.BOTTOM_END_BELOW sowie UI-Elemente des Navigations-SDKs wie die Schaltfläche zum Zentrieren und das Google-Logo werden über der Fußzeile des benutzerdefinierten Steuerelements platziert.

UI-Zubehör für Karten

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

Auf der Richtlinienseite finden Sie Richtlinien zu zulässigen Änderungen an der Navigationsoberfläche.

Code ansehen

Java-Code für die Navigationsaktivität ein- oder ausblenden

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

Navigationsheader ändern

Verwenden Sie SupportNavigationFragment.setStylingOptions() oder NavigationView.setStylingOptions(), um das Design der Navigationsleiste und des Richtungsanzeigers zu ändern, der bei Verfügbarkeit unter der Leiste angezeigt wird.

Sie können die folgenden Attribute festlegen:

Attributtyp	Attribute
Hintergrundfarbe	Primärer Tagmodus – die Tagesfarbe der Navigationsleiste Sekundäre Farbe für den Tagmodus – die Tagesfarbe der Richtungsanzeige Primärer Nachtmodus – die Farbe der Navigationsleiste im Nachtmodus Sekundärer Nachtmodus – die Farbe der Richtungsanzeige bei Nacht
Textelemente für Anleitungen	Schriftfarbe Schriftart Textgröße der ersten Zeile Textgröße der zweiten Zeile
Textelemente für die nächsten Schritte	Schriftart Textfarbe des Entfernungswerts Schriftgröße des Entfernungswerts Textfarbe der Entfernungseinheiten Schriftgröße der Entfernungseinheiten
Symbole für Fahrmanöver	Farbe des großen Manöversymbols Farbe des kleinen Manöversymbols
Spurführung	Farbe der empfohlenen Fahrstreifen

Im folgenden Beispiel wird gezeigt, 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

Verwenden Sie GoogleMap.setTrafficEnabled(), um die Verkehrsebene auf der Karte zu aktivieren oder zu deaktivieren. Diese Einstellung wirkt sich auf die Verkehrsdichtehinweise auf der gesamten Karte aus. Die Verkehrsinformationen auf der vom Navigationssystem geplanten Route sind davon jedoch nicht betroffen.

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

Ampel- und Stoppschilder aktivieren

Sie können Ampel und Haltebuchten in der Kartenoberfläche aktivieren. Mit dieser Funktion kann der Nutzer die Anzeige von Ampeln oder Stoppschildsymbolen entlang der Route aktivieren. So erhält er einen besseren Kontext für effizientere und genauere Fahrten.

Im Navigation SDK sind Ampel- und Stoppschilder standardmäßig deaktiviert. Wenn Sie diese Funktion aktivieren möchten, rufen Sie DisplayOptions für jede Funktion separat auf.

Hinweis: Ampeln und Stoppschilder können nur bei aktiver Navigation angezeigt werden.

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

Benutzerdefinierte Markierungen hinzufügen

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

Schwebender Text

Sie können Textfelder an beliebiger Stelle in Ihrer App einfügen, sofern sie die Google-Attribution nicht verdecken. Das Navigation SDK unterstützt nicht das Anpinnen von Text an einen Breiten-/Längengrad auf der Karte oder an ein Label. Weitere Informationen finden Sie unter Infofenster.

Geschwindigkeitsbegrenzung anzeigen

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

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

Das Symbol für die zulässige Höchstgeschwindigkeit wird vorübergehend ausgeblendet, wenn die Schaltfläche „Jüngere zuerst“ angezeigt wird.

Hinweis :Nutzer müssen alle angegebenen Verkehrszeichen auf der Straße beachten. Die Daten, die im Symbol für die Geschwindigkeitsbegrenzung angezeigt werden, dienen nur als Referenz. Die Richtigkeit der Daten zu Geschwindigkeitsbeschränkungen kann nicht garantiert werden. Sie können Fehler in unseren Daten zu Geschwindigkeitsbeschränkungen melden, indem Sie auf der Google Cloud-Supportseite einen Fall erstellen.

Nachtmodus einstellen

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 for Android steuern.

• AUTO Ermöglicht es dem Navigations-SDK, den geeigneten Modus anhand des Gerätestandorts und der Ortszeit zu bestimmen.
• FORCE_NIGHT erzwingt den Nachtmodus.
• FORCE_DAY erzwingt den Tagmodus.

Im folgenden Beispiel wird der Nachtmodus in einem Navigationsfragment erzwungen:

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

Liste der Routen anzeigen

Erstellen Sie zuerst die Ansicht und fügen Sie sie der 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));
}

Lebenszyklusereignisse müssen wie bei NavigationView an DirectionsListView weitergeleitet werden. Beispiel:

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

Ausweichrouten ausblenden

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 zu überladen ist, können Sie die Anzahl der alternativen Routen reduzieren. Sie können entweder weniger als die standardmäßigen zwei Routen anzeigen lassen oder gar keine alternativen Routen. Sie können diese Option vor dem Abrufen der Routen konfigurieren, indem Sie die Methode RoutingOptions.alternateRoutesStrategy() mit einem der folgenden Aufzählungswerte aufrufen:

Aufzählungswert	Beschreibung
AlternateRoutesStrategy.SHOW_ALL	Standard. Es werden bis zu zwei alternative Routen angezeigt.
AlternateRoutesStrategy.SHOW_ONE	Eine alternative Route wird angezeigt, sofern verfügbar.
AlternateRoutesStrategy.SHOW_NONE	Alternative Routen werden ausgeblendet.

Im folgenden Codebeispiel wird gezeigt, 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 für die Fahrt ist eine vertikale Leiste, die rechts am Ende der Karte angezeigt wird, wenn die Navigation gestartet wird. Wenn diese Option aktiviert ist, wird eine Übersicht für eine gesamte Fahrt zusammen mit dem Ziel und der aktuellen Position des Nutzers angezeigt.

So können Nutzer schnell auf anstehende Probleme wie Staus reagieren, ohne heranzoomen zu müssen. Er kann die Fahrt dann bei Bedarf neu planen. Wenn der Nutzer die Route ändert, wird die Fortschrittsanzeige zurückgesetzt, als würde an diesem Punkt eine neue Fahrt gestartet.

In der Fortschrittsanzeige der Fahrt werden die folgenden Statussymbole angezeigt:

• Verstrichene Route: Der zurückgelegte Teil der Fahrt.

• Aktuelle Position: Der aktuelle Standort des Nutzers während der Fahrt.

• Verkehrsstatus: Der Status des anstehenden Verkehrs.

• Zielort: Der Zielort der Fahrt.

Hinweis :Die Fortschrittsanzeige für Fahrten ist nur im Hochformat sichtbar.

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

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