Navigations-UI ändern

Mit dem Navigation SDK für Android können Sie die Nutzererfahrung mit 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 werden zwei Möglichkeiten beschrieben, wie Sie die Benutzeroberfläche Ihrer Karte ändern können:

• UI-Steuerelemente für Karten
• UI-Zubehör zuordnen

Hinweis: In den meisten Fällen empfehlen wir, NavigationFragment 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 der Navigationskarte .

UI-Steuerelemente für die Karte

Hinweis: Die in diesem Abschnitt beschriebenen slotbasierten Layout-Steuerelemente wie setCustomControl werden eingestellt. Es wird empfohlen, stattdessen die experimentelle Funktion Layoutanpassung zu verwenden.

Wenn Sie benutzerdefinierte UI-Elemente in der Navigationsansicht platzieren möchten, verwenden Sie die UI-Steuerelemente der Karte, um sie richtig zu positionieren. Wenn sich das integrierte Layout ändert, werden die benutzerdefinierten Steuerelemente vom Navigation SDK for Android automatisch neu positioniert. Sie können für jede Position jeweils eine benutzerdefinierte Steuerungsansicht festlegen. Wenn Ihr Design mehrere UI-Elemente erfordert, können Sie diese in einem ViewGroup platzieren und an die Methode setCustomControl übergeben.

Die Methode setCustomControl liefert Positionen, wie sie im Enum CustomControlPosition definiert sind:

• SECONDARY_HEADER (wird nur im Porträtmodus angezeigt)
• 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. Blähe die XML-Datei auf oder instanziiere die benutzerdefinierte Ansicht, um eine Instanz der Ansicht zu erhalten.

3. Verwenden Sie NavigationView.setCustomControl oder NavigationFragment.setCustomControl mit der ausgewählten Position des benutzerdefinierten Steuerelements aus der CustomControlPosition-Aufzählung.

   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 hinzugefügt.

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

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

Benutzerdefinierte Einstellung entfernen

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

Im folgenden Snippet wird beispielsweise ein benutzerdefinierter sekundärer Header entfernt und der Standardinhalt zurückgegeben:

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

Benutzerdefinierte Positionen für Steuerelemente

Sekundäre Kopfzeile

Benutzerdefinierte Position des sekundären Headers für das Hochformat

Wenn Sie diese benutzerdefinierte Position für Steuerelemente 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. Diese sekundäre Überschrift wird bei Bedarf angezeigt, z. B. bei der Spurführung. Ihre App kann diese sekundäre Headerposition des Layouts für benutzerdefinierte Inhalte verwenden. Wenn Sie diese Funktion verwenden, deckt Ihr Steuerelement alle standardmäßigen sekundären Headerinhalte ab. Wenn Ihre Navigationsansicht einen Hintergrund hat, bleibt dieser Hintergrund erhalten und wird vom sekundären Header verdeckt. Wenn die benutzerdefinierte Einstellung in der App entfernt wird, kann an ihrer Stelle ein standardmäßiger sekundärer Header angezeigt werden.

Die benutzerdefinierte sekundäre Headerposition richtet die Oberkante an der Unterkante des primären Headers aus. 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 links

Benutzerdefinierte Steuerelementposition „Unten links“ für das Hochformat

Position des benutzerdefinierten Steuerelements im Querformat: unten links

Wenn Sie diese benutzerdefinierte Position für Steuerelemente 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 befindet sie sich über der voraussichtliche-Ankunft-Karte und/oder der benutzerdefinierten Fußzeile (oder am unteren Rand der Karte, wenn keine der beiden vorhanden ist). Nav SDK-Elemente wie die Schaltfläche „Neu zentrieren“ und das Google-Logo werden nach oben verschoben, um die Höhe der benutzerdefinierten Steuerungsansicht zu berücksichtigen. Dieses Steuerelement befindet sich innerhalb der sichtbaren Kartengrenzen. Wenn Sie also am unteren oder linken Rand der Karte einen Abstand hinzufügen, ändert sich auch die Position dieses Steuerelements.

Unteres Ende

Position des benutzerdefinierten Steuerelements am unteren Ende im Hochformat

Position des benutzerdefinierten Steuerelements am unteren Ende für das Querformat

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

Diese benutzerdefinierte Steuerelementposition befindet sich in der unteren Ecke der Karte. In portrait mode befindet sie sich über der voraussichtliche-Ankunft-Karte und/oder der benutzerdefinierten Fußzeile (oder am unteren Rand der Karte, wenn weder die Karte noch die Fußzeile vorhanden ist). In landscape mode ist sie am unteren Rand der Karte ausgerichtet. Alle Nav SDK-Elemente, die auf der rechten Seite (bei LTR) sichtbar sind, werden nach oben verschoben, um die Höhe der benutzerdefinierten Steuerelementansicht zu berücksichtigen. Dieses Steuerelement befindet sich innerhalb der sichtbaren Kartengrenzen. Wenn Sie also am unteren oder rechten Rand der Karte einen Abstand hinzufügen, ändert sich auch die Position dieses Steuerelements.

Fußzeile

Vorabversion

Position des benutzerdefinierten Steuerelements in der Fußzeile im Hochformat

Position des benutzerdefinierten Steuerelements in der Fußzeile im Querformat

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

Diese benutzerdefinierte Steuerelementposition ist für eine benutzerdefinierte Fußzeilenansicht vorgesehen. Wenn die voraussichtliche-Ankunft-Karte des Nav SDK sichtbar ist, befindet sich dieses Steuerelement darüber. Andernfalls wird das Steuerelement am unteren Rand der Karte ausgerichtet. Im Gegensatz zu den benutzerdefinierten Steuerelementen BOTTOM_START_BELOW und BOTTOM_END_BELOW befindet sich dieses Steuerelement außerhalb der sichtbaren Kartengrenzen. Das bedeutet, dass sich die Position dieses Steuerelements nicht ändert, wenn der Karte ein Padding hinzugefügt wird.

In portrait mode wird die benutzerdefinierte Fußzeile in voller Breite angezeigt. Benutzerdefinierte Steuerelemente an den Positionen CustomControlPosition.BOTTOM_START_BELOW und CustomControlPosition.BOTTOM_END_BELOW sowie UI-Elemente des Nav SDK wie die Schaltfläche „Neu zentrieren“ und das Google-Logo werden über der Fußzeile für benutzerdefinierte Steuerelemente positioniert. Bei der Standardposition des Winkels wird die benutzerdefinierte Höhe der Fußzeile berücksichtigt.

In landscape mode hat die benutzerdefinierte Fußzeile die halbe Breite und ist an der Startseite (links in LTR) ausgerichtet, genau wie die Nav SDK-Karte für die voraussichtliche Ankunft. Die benutzerdefinierten Steuerelemente an der Position CustomControlPosition.BOTTOM_START_BELOW und die UI-Elemente des Nav SDK, z. B. die Schaltfläche „Neu zentrieren“ und das Google-Logo, werden über der Fußzeile mit den benutzerdefinierten Steuerelementen positioniert. Die benutzerdefinierten Steuerelemente an der Position CustomControlPosition.BOTTOM_END_BELOW und alle UI-Elemente des Nav SDK auf der Endseite (rechte Seite in LTR) bleiben am unteren Rand der Karte ausgerichtet. Die Standardposition des Winkelzeichens ändert sich nicht, wenn eine benutzerdefinierte Fußzeile vorhanden ist, da die Fußzeile 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 Nav SDK wie die Schaltfläche zum Neuzentrieren und das Google-Logo werden über der Fußzeile für benutzerdefinierte Steuerelemente positioniert.

UI-Zubehör für Karten

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

Auf der Seite „Richtlinien“ finden Sie Richtlinien zu zulässigen Ä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.util.Log;
import android.widget.Toast;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.GoogleMap.CameraPerspective;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.model.BitmapDescriptorFactory;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.Marker;
import com.google.android.gms.maps.model.MarkerOptions;
import com.google.android.libraries.navigation.AudioGuidanceSettings;
import com.google.android.libraries.navigation.ListenableResultFuture;
import com.google.android.libraries.navigation.NavigationApi;
import com.google.android.libraries.navigation.NavigationFragment;
import com.google.android.libraries.navigation.Navigator;
import com.google.android.libraries.navigation.SimulationOptions;
import com.google.android.libraries.navigation.StylingOptions;
import com.google.android.libraries.navigation.Waypoint;

/** An activity that displays a map and a customized navigation UI. */
public class NavigationActivityCustomization extends AppCompatActivity {

  private static final String TAG = NavigationActivityCustomization.class.getSimpleName();
  private Navigator mNavigator;
  private NavigationFragment mNavFragment;
  private GoogleMap mMap;
  // Define the Sydney Opera House by specifying its place ID.
  private static final String SYDNEY_OPERA_HOUSE = "ChIJ3S-JXmauEmsRUcIaWtf4MzE";
  // Set fields for requesting location permission.
  private static final int PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION = 1;
  private boolean mLocationPermissionGranted;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Initialize the Navigation SDK.
    initializeNavigationSdk();
  }

  /**
   * Starts the Navigation SDK and sets the camera to follow the device's location. Calls the
   * navigateToPlace() method when the navigator is ready.
   */
  private void initializeNavigationSdk() {
    /*
     * Request location permission, so that we can get the location of the
     * device. The result of the permission request is handled by a callback,
     * onRequestPermissionsResult.
     */
    if (ContextCompat.checkSelfPermission(
            this.getApplicationContext(), android.Manifest.permission.ACCESS_FINE_LOCATION)
        == PackageManager.PERMISSION_GRANTED) {
      mLocationPermissionGranted = true;
    } else {
      ActivityCompat.requestPermissions(
          this,
          new String[] {android.Manifest.permission.ACCESS_FINE_LOCATION},
          PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION);
    }

    if (!mLocationPermissionGranted) {
      displayMessage(
          "Error loading Navigation SDK: " + "The user has not granted location permission.");
      return;
    }

    // Get a navigator.
    NavigationApi.getNavigator(
        this,
        new NavigationApi.NavigatorListener() {
          /** Sets up the navigation UI when the navigator is ready for use. */
          @Override
          public void onNavigatorReady(Navigator navigator) {
            displayMessage("Navigator ready.");
            mNavigator = navigator;
            mNavFragment =
                (NavigationFragment)
                    getSupportFragmentManager().findFragmentById(R.id.navigation_fragment);

            // Get the map.
            mNavFragment.getMapAsync(
                new OnMapReadyCallback() {
                  @Override
                  public void onMapReady(GoogleMap map) {
                    mMap = map;
                    // Navigate to a place, specified by Place ID.
                    navigateToPlace(SYDNEY_OPERA_HOUSE);
                  }
                });
          }

          /**
           * Handles errors from the Navigation SDK.
           *
           * @param errorCode The error code returned by the navigator.
           */
          @Override
          public void onError(@NavigationApi.ErrorCode int errorCode) {
            switch (errorCode) {
              case NavigationApi.ErrorCode.NOT_AUTHORIZED:
                displayMessage(
                    "Error loading Navigation SDK: Your API key is "
                        + "invalid or not authorized to use the Navigation SDK.");
                break;
              case NavigationApi.ErrorCode.TERMS_NOT_ACCEPTED:
                displayMessage(
                    "Error loading Navigation SDK: User did not accept "
                        + "the Navigation Terms of Use.");
                break;
              case NavigationApi.ErrorCode.NETWORK_ERROR:
                displayMessage("Error loading Navigation SDK: Network error.");
                break;
              case NavigationApi.ErrorCode.LOCATION_PERMISSION_MISSING:
                displayMessage(
                    "Error loading Navigation SDK: Location permission " + "is missing.");
                break;
              default:
                displayMessage("Error loading Navigation SDK: " + errorCode);
            }
          }
        });
  }

  /** Customizes the navigation UI and the map. */
  private void customizeNavigationUI() {
    // Set custom colors for the navigator.
    mNavFragment.setStylingOptions(
        new StylingOptions()
            .primaryDayModeThemeColor(0xff1A237E)
            .secondaryDayModeThemeColor(0xff3F51B5)
            .primaryNightModeThemeColor(0xff212121)
            .secondaryNightModeThemeColor(0xff424242)
            .headerLargeManeuverIconColor(0xffffff00)
            .headerSmallManeuverIconColor(0xffffa500)
            .headerNextStepTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
            .headerNextStepTextColor(0xff00ff00)
            .headerNextStepTextSize(20f)
            .headerDistanceTypefacePath("/system/fonts/NotoSerif-Italic.ttf")
            .headerDistanceValueTextColor(0xff00ff00)
            .headerDistanceUnitsTextColor(0xff0000ff)
            .headerDistanceValueTextSize(20f)
            .headerDistanceUnitsTextSize(18f)
            .headerInstructionsTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
            .headerInstructionsTextColor(0xffffff00)
            .headerInstructionsFirstRowTextSize(24f)
            .headerInstructionsSecondRowTextSize(20f)
            .headerGuidanceRecommendedLaneColor(0xffffa500));

    mMap.setTrafficEnabled(false);

    // Place a marker at the final destination.
    if (mNavigator.getCurrentRouteSegment() != null) {
      LatLng destinationLatLng = mNavigator.getCurrentRouteSegment().getDestinationLatLng();

      Bitmap destinationMarkerIcon =
          BitmapFactory.decodeResource(getResources(), R.drawable.ic_person_pin_48dp);

      mMap.addMarker(
          new MarkerOptions()
              .position(destinationLatLng)
              .icon(BitmapDescriptorFactory.fromBitmap(destinationMarkerIcon))
              .title("Destination marker"));

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

              // The event has been handled.
              return true;
            }
          });
    }

    // Set the camera to follow the device location with 'TILTED' driving view.
    mMap.followMyLocation(CameraPerspective.TILTED);
  }

  /**
   * Requests directions from the user's current location to a specific place (provided by the
   * Google Places API).
   */
  private void navigateToPlace(String placeId) {
    Waypoint destination;
    try {
      destination =
          Waypoint.builder().setPlaceIdString(placeId).build();
    } catch (Waypoint.UnsupportedPlaceIdException e) {
      displayMessage("Error starting navigation: Place ID is not supported.");
      return;
    }

    // Create a future to await the result of the asynchronous navigator task.
    ListenableResultFuture<Navigator.RouteStatus> pendingRoute =
        mNavigator.setDestination(destination);

    // Define the action to perform when the SDK has determined the route.
    pendingRoute.setOnResultListener(
        new ListenableResultFuture.OnResultListener<Navigator.RouteStatus>() {
          @Override
          public void onResult(Navigator.RouteStatus code) {
            switch (code) {
              case OK:
                // Hide the toolbar to maximize the navigation UI.
                if (getActionBar() != null) {
                  getActionBar().hide();
                }

                // Customize the navigation UI.
                customizeNavigationUI();

                // Enable voice audio guidance (through the device speaker).
                AudioGuidanceSettings audioSettings =
                    AudioGuidanceSettings.builder()
                        .setGuidanceMode(
                            AudioGuidanceSettings.GuidanceMode.VOICE_ALERTS_AND_GUIDANCE)
                        .build();
                mNavigator.setAudioGuidanceSettings(audioSettings);

                // Simulate vehicle progress along the route for demo/debug builds.
                if (BuildConfig.DEBUG) {
                  mNavigator
                      .getSimulator()
                      .simulateLocationsAlongExistingRoute(
                          new SimulationOptions().speedMultiplier(5));
                }

                // Start turn-by-turn guidance along the current route.
                mNavigator.startGuidance();
                break;
              // Handle error conditions returned by the navigator.
              case NO_ROUTE_FOUND:
                displayMessage("Error starting navigation: No route found.");
                break;
              case NETWORK_ERROR:
                displayMessage("Error starting navigation: Network error.");
                break;
              case ROUTE_CANCELED:
                displayMessage("Error starting navigation: Route canceled.");
                break;
              case ROUTING_TIMEOUT:
                displayMessage("Error starting navigation: Routing timed out.");
                break;
              default:
                displayMessage("Error starting navigation: " + String.valueOf(code));
            }
          }
        });
  }

  /** Handles the result of the request for location permissions. */
  @Override
  public void onRequestPermissionsResult(
      int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    mLocationPermissionGranted = false;
    switch (requestCode) {
      case PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION:
        {
          // If request is canceled, the result arrays are empty.
          if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            mLocationPermissionGranted = true;
          }
        }
    }
  }

  /**
   * Shows a message on screen and in the log. Used when something goes wrong.
   *
   * @param errorMessage The message to display.
   */
  private void displayMessage(String errorMessage) {
    Toast.makeText(this, errorMessage, Toast.LENGTH_LONG).show();
    Log.d(TAG, errorMessage);
  }
}

Hervorhebung von Zielen und Eingängen

Wenn ein Ziel mit einer placeID erstellt wird, wird das Zielgebäude hervorgehoben und nach Möglichkeit ein Eingangssymbol angezeigt. Diese visuellen Hinweise helfen Nutzern, ihr Ziel zu erkennen und dorthin zu navigieren.

Verwenden Sie zum Erstellen eines Ziels mit einem placeID die Methode Waypoint.Builder.setPlaceIdString().

Hinweis: Das Navigation SDK unterstützt keine Indoor-Navigation. Für Indoor-Karten ohne Navigation verwenden Sie die Klassen indoorBuilding und indoorLevel des Maps SDK for Android.

Navigationsheader ändern

Verwenden Sie NavigationFragment.setStylingOptions() oder NavigationView.setStylingOptions(), um das Design des Navigationsheaders und der Anzeige für die nächste Abbiegung zu ändern, die gegebenenfalls unter dem Header angezeigt wird.

Hinweis: Die Standardhöhe der Kopfzeile ist dynamisch und wird basierend auf den angezeigten Fahranweisungen angepasst.

Sie können die folgenden Attribute festlegen:

Attributtyp	Attribute
Hintergrundfarbe	Primärer Tagmodus – die Farbe der Navigationskopfzeile tagsüber Sekundärer Tagmodus – die Farbe des Abbiegehinweises im Tagmodus Primärer Nachtmodus – die Farbe der Navigationskopfzeile im Nachtmodus Sekundärer Nachtmodus – die Farbe des Symbols für die nächste Abbiegung im Nachtmodus
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 Textgröße des Entfernungswerts Textfarbe der Entfernungseinheiten Textgröße der Entfernungseinheiten
Symbole für Fahrmanöver	Farbe des großen Manöversymbols Farbe des kleinen Manöversymbols
Spurführung	Farbe der empfohlenen Fahrspur(en)

Im folgenden Beispiel wird gezeigt, wie Stiloptionen festgelegt werden:

private NavigationFragment mNavFragment;
mNavFragment = (NavigationFragment) getSupportFragmentManager()
  .findFragmentById(R.id.navigation_fragment);

// Set the styling options on the fragment.
mNavFragment.setStylingOptions(new StylingOptions()
  .primaryDayModeThemeColor(0xff1A237E)
  .secondaryDayModeThemeColor(0xff3F51B5)
  .primaryNightModeThemeColor(0xff212121)
  .secondaryNightModeThemeColor(0xff424242)
  .headerLargeManeuverIconColor(0xffffff00)
  .headerSmallManeuverIconColor(0xffffa500)
  .headerNextStepTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
  .headerNextStepTextColor(0xff00ff00)
  .headerNextStepTextSize(20f)
  .headerDistanceTypefacePath("/system/fonts/NotoSerif-Italic.ttf")
  .headerDistanceValueTextColor(0xff00ff00)
  .headerDistanceUnitsTextColor(0xff0000ff)
  .headerDistanceValueTextSize(20f)
  .headerDistanceUnitsTextSize(18f)
  .headerInstructionsTypefacePath("/system/fonts/NotoSerif-BoldItalic.ttf")
  .headerInstructionsTextColor(0xffffff00)
  .headerInstructionsFirstRowTextSize(24f)
  .headerInstructionsSecondRowTextSize(20f)
  .headerGuidanceRecommendedLaneColor(0xffffa500));

Verkehrsebene deaktivieren

Mit GoogleMap.setTrafficEnabled() können Sie die Verkehrsebene auf der Karte aktivieren oder deaktivieren. Diese Einstellung wirkt sich auf die Darstellung der Verkehrsdichte auf der gesamten Karte aus. Die Verkehrshinweise auf der vom Navigator 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));

Ampeln und Stoppschilder

Während der aktiven Navigation werden auf der Karte Ampeln und Stoppschilder angezeigt, um Nutzern mehr Kontext zur Route und zu bevorstehenden Manövern zu bieten. Ab Version 8.0.0 kann diese Funktion nicht mehr deaktiviert werden.

Hinweis :Ampeln werden möglicherweise auch außerhalb des Navigationsmodus auf der Karte angezeigt.

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 schwebenden Text hinzufügen, sofern die Google-Quellenangabe dadurch nicht verdeckt wird. Das Navigation SDK unterstützt nicht das Verankern des Texts an einem Breiten-/Längengrad auf der Karte oder an einem Label. Weitere Informationen finden Sie unter Infofenster.

Tempolimit anzeigen

Sie können das Tempolimit-Symbol programmatisch ein- oder ausblenden. Verwenden Sie NavigationView.setSpeedLimitIconEnabled() oder NavigationFragment.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 Höchstgeschwindigkeit während der Zielführung in einer der unteren Ecken angezeigt. Das Symbol zeigt das Tempolimit der Straße an, auf der das Fahrzeug fährt. Das Symbol wird nur an Orten angezeigt, für die zuverlässige Daten zu Tempolimits 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: Nutzer müssen alle Verkehrsschilder beachten. Die im Tempolimit-Symbol angezeigten Daten dienen nur als Referenz. Die Genauigkeit der Daten zu Geschwindigkeitsbegrenzungen kann nicht garantiert werden. Sie können Ungenauigkeiten in unseren Daten zu Geschwindigkeitsbegrenzungen melden, indem Sie auf der Google Cloud-Supportseite eine Anfrage einreichen.

Nachtmodus festlegen

Du kannst das Verhalten des Nachtmodus programmatisch steuern. Mit NavigationView.setForceNightMode() oder NavigationFragment.setForceNightMode() können Sie den Nachtmodus aktivieren oder deaktivieren. Alternativ können Sie ihn auch über das Navigation SDK for Android steuern lassen.

• AUTO: Das Navigation SDK bestimmt den geeigneten Modus anhand des Gerätestandorts und der Ortszeit.
• FORCE_NIGHT erzwingt den Nachtmodus.
• FORCE_DAY erzwingt den Tagmodus.

Im folgenden Beispiel wird gezeigt, wie der Nachtmodus in einem Navigationsfragment aktiviert wird:

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

Liste mit Routen 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));
}

Achten Sie darauf, Lifecycle-Events an die DirectionsListView weiterzuleiten, genau wie bei NavigationView. Beispiel:

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

Alternative Routen ausblenden

Warnung :Diese Funktion ist nicht mit der Funktion für die kürzeste/schnellste Route kompatibel. Wenn du beide Funktionen gleichzeitig verwendest, kann es zu unerwartetem Verhalten kommen.

Wenn die Benutzeroberfläche mit zu vielen Informationen überladen ist, können Sie die Unordnung reduzieren, indem Sie weniger alternative Routen als die Standardanzahl (zwei) oder gar keine alternativen Routen anzeigen. Sie können diese Option konfigurieren, bevor Sie die Routen abrufen, indem Sie die Methode RoutingOptions.alternateRoutesStrategy() mit einem der folgenden Aufzählungswerte aufrufen:

Aufzählungswert	Beschreibung
AlternateRoutesStrategy.SHOW_ALL	Standard. Zeigt bis zu zwei alternative Routen an.
AlternateRoutesStrategy.SHOW_ONE	Zeigt eine alternative Route an (falls verfügbar).
AlternateRoutesStrategy.SHOW_NONE	Blendet alternative Routen aus.

Im folgenden Codebeispiel wird gezeigt, wie Sie alternative Routen vollständig ausblenden.

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

Fortschrittsanzeige für die Fahrt

Experimentelle Funktion

Die Fortschrittsanzeige für die Fahrt ist eine vertikale Leiste, die zu Beginn der Navigation auf der Start-/Vorderseite der Karte angezeigt wird. Wenn diese Option aktiviert ist, wird eine Übersicht für die gesamte Fahrt zusammen mit dem Ziel und der aktuellen Position des Nutzers angezeigt.

So können Nutzer bevorstehende Probleme wie Staus vorhersehen, ohne heranzoomen zu müssen. Die Route kann dann bei Bedarf neu berechnet werden. Wenn der Nutzer die Route neu berechnet, wird die Fortschrittsanzeige zurückgesetzt, als ob ab diesem Punkt eine neue Fahrt begonnen hätte.

In der Fortschrittsanzeige für die Fahrt werden die folgenden Statusindikatoren angezeigt:

• Zurückgelegte Route: Der bereits zurückgelegte Teil der Fahrt.

• Aktuelle Position: Der aktuelle Standort des Nutzers auf der Fahrt.

• Verkehrslage: Die Verkehrslage auf der Strecke.

• Zielort: Das endgültige Ziel der Fahrt.

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

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

Positionierung der Fortschrittsanzeige für die Fahrt

• Die linke Seite der Leiste ist ungefähr am linken Rand des Tachometers, des Google-Logos und der Schaltfläche „Neu zentrieren“ (falls sichtbar) ausgerichtet. Die Breite beträgt 12 dp.
• Die Fortschrittsanzeige für die Fahrt hat eine statische Höhe. Um die vertikalen Platzbeschränkungen auf kleineren Geräten zu berücksichtigen, werden die Sichtbarkeit und Höhe der Fortschrittsanzeige für die Fahrt anhand von festgelegten Haltepunkten in der Bildschirmhöhe angepasst. Diese Haltepunkte sind unabhängig von der Geräteausrichtung und davon, wie viel Platz die Karte tatsächlich auf dem Bildschirm einnimmt:

Bildschirmhöhe	Sichtbarkeit der Fortschrittsanzeige für die Fahrt	Höhe der Fortschrittsanzeige für die Fahrt	Y-Achsenposition der Fortschrittsanzeige für die Fahrt
Klein: 0–551 dp	Nicht sichtbar	–	–
Mittel: 552 dp bis 739 dp	Sichtbar	130 dp	Über den Steuerelementen auf der Startseite (Tachometer / Google-Logo / Schaltfläche „Neu zentrieren“)
Groß: ab 740 dp	Sichtbar	290 dp	Über den Steuerelementen auf der Startseite (Tachometer / Google-Logo / Schaltfläche „Neu zentrieren“)

Hinweis: Die in der Tabelle oben angegebenen Werte für die Bildschirmhöhe gelten für Navigation SDK-Versionen ab 6.2.1. In Version 6.2.0 sind kleine Bildschirme als 0–519 dp, mittelgroße Bildschirme als 520–599 dp und große Bildschirme als 600 dp und höher definiert. Sichtbarkeit, Höhe und Position auf der Y-Achse der Fortschrittsanzeige für die Fahrt sind gleich.
• Wenn sich die Fortschrittsanzeige der Fahrt mit der Abbiegekarte oder anderen UI-Elementen der Navigation überschneidet, wird sie unter diesen anderen Elementen angezeigt.

Kompass

Das Navigation SDK bietet eine Kompassgrafik, die unter bestimmten Umständen und nur, wenn sie aktiviert ist, oben rechts auf der Karte erscheint. Wenn der Nutzer auf den Kompass klickt, wird die Kamera an eine Position mit Nullrichtung (Standardorientierung) zurückbewegt. Anschließend wird der Kompass ausgeblendet.

Wenn die Navigation aktiviert ist und der Kameramodus auf „Folgen“ eingestellt ist, bleibt der Kompass sichtbar. Durch Tippen auf den Kompass wird zwischen der geneigten Kameraperspektive und der Übersichtsperspektive gewechselt.

Um den Fahrer nicht abzulenken, bleibt der Kompass an derselben Position, wenn sich die Kopfzeile (im Hochformat) vergrößert und mit der Standardposition des Kompasses kollidiert. Wenn Sie ein sekundäres benutzerdefiniertes Steuerelement für die Kopfzeile oder eine Ansicht für Kopfzeilenzubehör hinzufügen, wird der Kompass ausgeblendet, um Konflikte mit der Benutzeroberfläche zu vermeiden.

Der Kompass unterstützt den Tag- und Nachtmodus sowie den dunklen Modus.

Der Kompass ist standardmäßig aktiviert. Mit der Methode compassEnabled der Klasse GoogleMapOptions können Sie festlegen, ob der Kompass aktiviert ist.

3D-Gebäude deaktivieren

Bei Geräten mit eingeschränkter Leistung können Sie die Anzeige von 3D-Gebäuden deaktivieren, indem Sie GoogleMap.setBuildingsEnabled(false) aufrufen.

Prompt Visibility API (experimentell)

Experimentelle Funktion

Mit der Prompt Visibility API können Sie Konflikte zwischen UI-Elementen, die vom Navigation SDK generiert werden, und Ihren eigenen benutzerdefinierten UI-Elementen vermeiden. Dazu fügen Sie einen Listener hinzu, der einen Callback empfängt, bevor ein UI-Element des Navigation SDK angezeigt wird und sobald das Element entfernt wird. Weitere Informationen, einschließlich Codebeispielen, finden Sie im Abschnitt Prompt Visibility API auf der Seite Echtzeitstörungen konfigurieren.