Modificare l'interfaccia utente di navigazione

Con Navigation SDK for Android, puoi modificare l'esperienza utente con la tua mappa determinando quali elementi e controlli dell'interfaccia utente integrati devono essere visualizzati sulla mappa. Puoi anche modificare l'aspetto dell'interfaccia utente di navigazione. Consulta la pagina Norme per le linee guida sulle modifiche accettabili all'interfaccia utente di navigazione.

Questo documento descrive come modificare l'interfaccia utente della mappa in due modi:

• Controlli dell'interfaccia utente della mappa
• Accessori dell'interfaccia utente della mappa

Nota: nella maggior parte dei casi, consigliamo di utilizzare SupportNavigationFragment, che è un wrapper per NavigationView, invece di interagire direttamente con NavigationView. Per ulteriori informazioni, consulta Best practice per l'interazione con le mappe di navigazione .

Attenzione: l'SDK Navigation per Android non supporta gli stili delle mappe basati su cloud con ID mappa.

Controlli dell'interfaccia utente della mappa

I controlli dell'interfaccia utente della mappa sono il modo consigliato per posizionare elementi dell'interfaccia utente personalizzati nella visualizzazione di navigazione per garantire il posizionamento corretto. Quando il layout integrato cambia, Navigation SDK per Android riposiziona automaticamente i controlli personalizzati. Puoi impostare una sola visualizzazione dei controlli personalizzati alla volta per ogni posizione. Se il tuo design richiede più elementi dell'interfaccia utente, puoi inserirli in un ViewGroup e passarlo al metodo setCustomControl.

Il metodo setCustomControl fornisce le posizioni come definite nell'enum CustomControlPosition:

• SECONDARY_HEADER (viene visualizzato solo in modalità Ritratto)
• BOTTOM_START_BELOW
• BOTTOM_END_BELOW
• FOOTER

Posizioni dei controlli personalizzati per l'orientamento verticale

Posizioni dei controlli personalizzati per l'orientamento orizzontale

Aggiungere un controllo personalizzato

1. Crea una vista Android con l'elemento dell'interfaccia utente o ViewGroup personalizzato.
2. Infla l'XML o esegui l'inizializzazione della vista personalizzata per ottenere un'istanza della vista.

3. Utilizza NavigationView.setCustomControl o SupportNavigationFragment.setCustomControl con la posizione del controllo personalizzato scelto dall'CustomControlPosition enum.

   Nota: l'app deve chiamare questo metodo nel thread dell'interfaccia utente.

   L'esempio seguente crea un frammento e aggiunge un controllo personalizzato nella posizione dell'intestazione secondaria.

   Nota: il codice nell'esempio contiene interruzioni di riga per la visibilità nella documentazione. Assicurati di rimuoverli come appropriato.

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

Rimuovere un controllo personalizzato

Per rimuovere un controllo personalizzato, chiama il metodo setCustomControl con un parametro di visualizzazione null e la posizione del controllo personalizzato scelto.

Ad esempio, lo snippet seguente rimuove eventuali intestazioni secondarie personalizzate e ripristina i contenuti predefiniti:

mNavFragment.setCustomControl(null, CustomControlPosition.SECONDARY_HEADER);

Posizioni dei controlli personalizzati

Intestazione secondaria

Posizione del controllo personalizzato dell'intestazione secondaria per l'orientamento verticale

Per utilizzare questa posizione del controllo personalizzato, passa la posizione CustomControlPosition.SECONDARY_HEADER a setCustomControl.

Per impostazione predefinita, i layout delle schermate in modalità di navigazione prevedono una posizione per un'intestazione secondaria sotto l'intestazione principale. Questa intestazione secondaria viene visualizzata se necessario, ad esempio con le indicazioni stradali. L'app può utilizzare questa posizione del layout della sezione del titolo secondario per i contenuti personalizzati. Quando utilizzi questa funzionalità, il controllo copre tutti i contenuti dell'intestazione secondaria predefinita. Se la visualizzazione di navigazione ha un sfondo, questo rimane in posizione, coperto dall'intestazione secondaria. Quando l'app rimuove il controllo personalizzato, al suo posto può essere visualizzata qualsiasi intestazione secondaria predefinita.

La posizione dell'intestazione secondaria personalizzata allinea il bordo superiore al bordo inferiore dell'intestazione principale. Questa posizione è supportata solo in portrait mode. In landscape mode, l'intestazione secondaria non è disponibile e il layout non subisce modifiche.

Inizio da basso

Posizione del controllo personalizzato di inizio in basso per l'orientamento verticale

Posizione del controllo personalizzato in basso a sinistra per l'orientamento orizzontale

Per utilizzare questa posizione del controllo personalizzato, passa la posizione CustomControlPosition.BOTTOM_START_BELOW a setCustomControl.

Questa posizione del controllo personalizzato si trova nell'angolo inferiore sinistro della mappa. In entrambi portrait mode e landscape mode, si trova sopra la scheda ETA e/o il piè di pagina personalizzato (o nella parte inferiore della mappa se non sono presenti), mentre gli elementi dell'SDK Nav, tra cui il pulsante di reimpostazione della visualizzazione al centro e il logo di Google, si spostano verso l'alto per tenere conto dell'altezza della visualizzazione del controllo personalizzato. Questo controllo è posizionato all'interno dei confini della mappa visibili, pertanto qualsiasi spaziatura aggiunta ai bordi inferiore o iniziale della mappa cambierà anche la posizione di questo controllo.

Parte inferiore

Posizione del controllo personalizzato in basso per l'orientamento verticale

Posizione del controllo personalizzato in basso per l'orientamento orizzontale

Per utilizzare questa posizione del controllo personalizzato, passa la posizione CustomControlPosition.BOTTOM_END_BELOW a setCustomControl.

Questa posizione del controllo personalizzato si trova nell'angolo in basso a destra della mappa. In portrait mode, si trova sopra la scheda ETA e/o il piè di pagina personalizzato (o lungo la parte inferiore della mappa se non sono presenti), ma in landscape mode è allineato con la parte inferiore della mappa. Gli elementi dell'SDK Nav visibili sul lato opposto (lato destro in LTR) si spostano verso l'alto per tenere conto dell'altezza della visualizzazione del controllo personalizzato. Questo controllo è posizionato all'interno dei limiti della mappa visibili, pertanto eventuali spazi aggiuntivi aggiunti ai bordi inferiori o finali della mappa modificheranno anche la posizione di questo controllo.

Piè di pagina

Funzionalità Anteprima

Posizione del controllo personalizzato del piè di pagina per l'orientamento verticale

Posizione del controllo personalizzato del piè di pagina per l'orientamento orizzontale

Per utilizzare questa posizione del controllo personalizzato, passa la posizione CustomControlPosition.FOOTER a setCustomControl.

Questa posizione del controllo personalizzato è progettata per una visualizzazione del piè di pagina personalizzato. Se la scheda Orari di arrivo stimato del SDK Nav è visibile, questo controllo si trova sopra. In caso contrario, il controllo è alinhato con la parte inferiore della mappa. A differenza dei controlli personalizzati BOTTOM_START_BELOW e BOTTOM_END_BELOW, questo controllo è posizionato al di fuori dei limiti della mappa visibili, il che significa che eventuali spazi aggiuntivi aggiunti alla mappa non cambieranno la posizione di questo controllo.

In portrait mode, il piè di pagina personalizzato è a tutta larghezza. I controlli personalizzati nelle posizioni CustomControlPosition.BOTTOM_START_BELOW e CustomControlPosition.BOTTOM_END_BELOW, nonché gli elementi dell'interfaccia utente dell'SDK Nav come il pulsante di reimpostazione al centro e il logo Google, sono posizionati sopra il piè di pagina del controllo personalizzato. La posizione predefinita del triangolo prende in considerazione l'altezza personalizzata del piè di pagina.

In landscape mode, il piè di pagina personalizzato è metà della larghezza ed è allineato al lato iniziale (lato sinistro in LTR), proprio come la scheda ETA dell'SDK Nav. I controlli personalizzati nella posizione CustomControlPosition.BOTTOM_START_BELOW e gli elementi dell'interfaccia utente dell'SDK Nav, come il pulsante di centratura e il logo di Google, sono posizionati sopra il piè di pagina del controllo personalizzato. I controlli personalizzati in posizione CustomControlPosition.BOTTOM_END_BELOW e tutti gli elementi dell'interfaccia utente di Nav SDK lungo il lato di chiusura (lato destro in LTR) rimangono allineati alla parte inferiore della mappa. La posizione predefinita del triangolo non cambia se è presente un piè di pagina personalizzato, poiché il piè di pagina non si estende fino al lato finale della mappa.

I controlli personalizzati nelle posizioni CustomControlPosition.BOTTOM_START_BELOW e CustomControlPosition.BOTTOM_END_BELOW, nonché gli elementi dell'interfaccia utente dell'SDK Nav come il pulsante di centratura e il logo Google, sono posizionati sopra il piè di pagina del controllo personalizzato.

Accessori dell'interfaccia utente della mappa

L'SDK Navigation per Android fornisce accessori dell'interfaccia utente visualizzati durante la navigazione, simili a quelli presenti nell'applicazione Google Maps per Android. Puoi regolare la visibilità o l'aspetto di questi controlli come descritto in questa sezione. Le modifiche apportate qui vengono applicate durante la successiva sessione di navigazione.

Consulta la pagina Norme per le linee guida sulle modifiche accettabili all'interfaccia utente di navigazione.

Visualizza il codice

Mostra/Nascondi il codice Java per l'attività di navigazione.

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

Modificare l'intestazione di navigazione

Utilizza SupportNavigationFragment.setStylingOptions() o NavigationView.setStylingOptions() per cambiare il tema dell'intestazione di navigazione e l'indicatore della svolta successiva visualizzato sotto l'intestazione, se disponibile.

Nota: l'altezza dell'intestazione predefinita è dinamica e viene impostata in base alle indicazioni per le manovre visualizzate.

Puoi impostare i seguenti attributi:

Tipo di attributo	Attributi
Colore sfondo	Modalità giorno principale: il colore diurno dell'intestazione di navigazione Modalità giorno secondaria: il colore diurno dell'indicatore della svolta successiva Modalità notturna principale: il colore notturno dell'intestazione di navigazione Modalità notturna secondaria: il colore notturno dell'indicatore della svolta successiva
Elementi di testo per le istruzioni	Colore testo Carattere Dimensioni del testo della prima riga Dimensioni del testo della seconda riga
Elementi di testo per i passaggi successivi	Carattere Colore del testo del valore della distanza Dimensioni del testo del valore della distanza Colore del testo delle unità di misura della distanza Dimensioni del testo delle unità di misura della distanza
Icone di manovra	Colore dell'icona della manovra grande Colore dell'icona della manovra piccola
Indicazioni sulle corsie in cui posizionarsi	Colore della corsia o delle corsie consigliate

L'esempio seguente mostra come impostare le opzioni di stile:

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

Disattivare il livello di traffico

Utilizza GoogleMap.setTrafficEnabled() per attivare o disattivare il livello di traffico sulla mappa. Questa impostazione influisce sulle indicazioni della densità del traffico mostrate sulla mappa nel suo complesso. Tuttavia, non influisce sulle indicazioni sul traffico sul percorso tracciato dal navigatore.

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

Attivare semafori e segnali di stop

Puoi attivare la visualizzazione di semafori e segnali di stop nella mappa durante la navigazione attiva, in modo da avere un contesto aggiuntivo per i percorsi e le manovre.

Per impostazione predefinita, i semafori e i segnali di stop sono disattivati nell'SDK Navigation. Per attivare questa funzionalità, chiama DisplayOptions per ogni funzionalità indipendentemente.

Nota: i semafori possono essere visualizzati sulla mappa anche nelle modalità diverse dalla navigazione. L'opzione per configurare la visualizzazione dei semafori utilizzando solo DisplayOptions influisce sui semafori in modalità di navigazione attiva.

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

Aggiungere indicatori personalizzati

L'SDK Navigation per Android ora utilizza le API Google Maps per gli indicatori. Per saperne di più, consulta la documentazione dell'API Maps.

Testo fluttuante

Puoi aggiungere testo fluttuante in qualsiasi punto dell'app, a condizione che non copra l'attribuzione a Google. L'SDK Navigation non supporta l'ancoraggio del testo a una latitudine/longitudine sulla mappa o a un'etichetta. Per ulteriori informazioni, vai a Finestre informative.

Visualizzare il limite di velocità

Puoi mostrare o nascondere l'icona del limite di velocità tramite codice. Utilizza NavigationView.setSpeedLimitIconEnabled() o SupportNavigationFragment.setSpeedLimitIconEnabled() per mostrare o nascondere l'icona del limite di velocità. Se l'opzione è attivata, l'icona del limite di velocità viene visualizzata in un angolo in basso durante la guida assistita. L'icona mostra il limite di velocità della strada su cui viaggia il veicolo. L'icona viene visualizzata solo nelle località in cui sono disponibili dati affidabili sui limiti di velocità.

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

L'icona del limite di velocità viene nascosta temporaneamente quando viene visualizzato il pulsante per centrare la mappa.

Nota: gli utenti devono rispettare tutti i segnali stradali. I dati pubblicati nell'icona del limite di velocità sono solo di riferimento. L'accuratezza dei dati sui limiti di velocità non può essere garantita. Puoi segnalare le imprecisioni nei nostri dati sui limiti di velocità inviando una richiesta nella pagina di assistenza Google Cloud.

Impostare la modalità notturna

Puoi controllare il comportamento della modalità notturna tramite programmazione. Utilizza NavigationView.setForceNightMode() o SupportNavigationFragment.setForceNightMode() per attivare o disattivare la modalità notturna oppure lascia che sia l'SDK Navigation per Android a controllarla.

• AUTO Consente all'SDK di navigazione di determinare la modalità appropriata in base alla posizione e all'ora locale del dispositivo.
• FORCE_NIGHT forza l'attivazione della modalità notturna.
• FORCE_DAY forza l'attivazione della modalità giorno.

L'esempio seguente mostra come forzare l'attivazione della modalità notturna all'interno di un frammento di navigazione:

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

Mostra elenco indicazioni stradali

Innanzitutto, crea la visualizzazione e aggiungila alla gerarchia.

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

Assicurati di inoltrare gli eventi del ciclo di vita a DirectionsListView, come avviene per NavigationView. Ad esempio:

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

Nascondere i percorsi alternativi

Avviso: al momento questa funzionalità non è compatibile con la funzionalità di percorso più breve/più veloce. L'utilizzo di entrambe le funzionalità contemporaneamente può produrre comportamenti imprevisti.

Quando l'interfaccia utente è troppo ingombrata da troppe informazioni, puoi ridurre il numero di percorsi alternativi rispetto a quelli predefiniti (due) o non mostrare alcun percorso alternativo. Puoi configurare questa opzione prima di recuperare le route chiamando il metodo RoutingOptions.alternateRoutesStrategy() con uno dei seguenti valori di enumerazione:

Valore di enumerazione	Descrizione
AlternateRoutesStrategy.SHOW_ALL	Predefinita. Mostra fino a due percorsi alternativi.
AlternateRoutesStrategy.SHOW_ONE	Mostra un percorso alternativo (se disponibile).
AlternateRoutesStrategy.SHOW_NONE	Nasconde i percorsi alternativi.

Il seguente esempio di codice mostra come nascondere completamente i percorsi alternativi.

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

Barra di avanzamento del viaggio

Funzionalità sperimentale

La barra di avanzamento del viaggio è una barra verticale che viene visualizzata sul lato iniziale/di marcia della mappa all'avvio della navigazione. Se è attiva, viene visualizzata una panoramica di un intero viaggio, insieme alla destinazione e alla posizione corrente dell'utente.

Consente agli utenti di anticipare rapidamente eventuali problemi imminenti, come il traffico, senza dover aumentare lo zoom. Se necessario, può cambiare il percorso della corsa. Se l'utente cambia il percorso della corsa, la barra di avanzamento viene reimpostata come se da quel punto fosse iniziata una nuova corsa.

La barra di avanzamento del viaggio mostra i seguenti indicatori di stato:

• Percorso trascorso: la parte del viaggio trascorsa.

• Posizione attuale: la posizione attuale dell'utente nel viaggio.

• Stato del traffico: lo stato del traffico che si trova davanti.

• Destinazione finale: la destinazione finale del viaggio.

Attiva la barra di avanzamento del viaggio chiamando il metodo setTripProgressBarEnabled() su NavigationView o SupportNavigationFragment. Ad esempio:

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

Posizionamento della barra di avanzamento del viaggio

• Il lato sinistro della barra è allineato approssimativamente alla parte sinistra del tachimetro, del logo Google e del pulsante Ricentra (se visibile). La larghezza è 12 dp.
• La barra di avanzamento del viaggio mantiene un'altezza fissa. Per adattarsi alle limitazioni di spazio verticale nei dispositivi più piccoli, la visibilità e l'altezza della barra di avanzamento del viaggio si adattano in base ai punti di interruzione specificati nell'altezza dello schermo. Questi punti di interruzione sono indipendenti dall'orientamento del dispositivo e dallo spazio effettivamente occupato dalla mappa sullo schermo:

Altezza dello schermo	Visibilità della barra di avanzamento del viaggio	Altezza della barra di avanzamento del viaggio	Posizione dell'asse Y della barra di avanzamento del viaggio
Piccolo: da 0 a 551 dp	Non visibile	N/D	N/D
Media: 552 dp - 739 dp	Visibile	130 dp	Controlli laterali sopra l'avvio (tachimetro / logo Google / pulsante di reimpostazione al centro)
Grande: 740 dp e oltre	Visibile	290 dp	Controlli laterali sopra l'avvio (tachimetro / logo Google / pulsante di reimpostazione al centro)

Nota: i valori relativi all'altezza dello schermo mostrati nella tabella sopra si applicano alle versioni dell'SDK Navigation 6.2.1 e successive. Per la versione 6.2.0, gli schermi piccoli sono definiti come da 0 dp a 519 dp, gli schermi medi come da 520 dp a 599 dp e gli schermi grandi come da 600 dp in su. La visibilità, l'altezza e la posizione sull'asse y della barra di avanzamento del viaggio sono le stesse.
• Se la barra di avanzamento del viaggio si sovrappone alla scheda di svolta o ad altri elementi dell'interfaccia utente di Navigazione, viene visualizzata sotto questi altri elementi.

API Prompt Visibility (sperimentale)

Funzionalità sperimentale

L'API Prompt Visibility ti consente di evitare conflitti tra gli elementi dell'interfaccia utente generati dall'SDK Navigation e i tuoi elementi dell'interfaccia utente personalizzati aggiungendo un listener per ricevere un callback prima che un elemento dell'interfaccia utente dell'SDK Navigation stia per essere visualizzato e non appena l'elemento viene rimosso. Per ulteriori informazioni, inclusi i sample di codice, consulta la sezione API Prompt Visibility della pagina Configurare le interruzioni in tempo reale.