Navigazione

classe pubblica NavigationView estende relativeLayout

Una vista che mostra una mappa per la navigazione.

Gli utenti di questa classe devono inoltrare tutti i metodi del ciclo di vita da Activity o Fragment che contengono questa vista a quelli corrispondenti in questa classe. In particolare, devi utilizzare i seguenti metodi:

Se NavView viene aggiunto dopo che l'elemento Activity o Fragment principale ha completato il ciclo di vita di creazione, devi chiamare onCreate(Bundle), onStart() e onResume() manualmente per inizializzarlo correttamente. Allo stesso modo, se un NavView viene scollegato da quello principale Activity o Fragment, devi chiamare manualmente onPause(), onStop() e onDestroy() per evitare perdite.

Nota: è sconsigliato aggiungere bambini a questa visualizzazione.

Tutte le chiamate a NavView devono essere eseguite nel thread dell'interfaccia utente.

Riepilogo dei corsi nidificati

interfaccia NavigationView.OnNightModeChangedListener Interfaccia per un listener che riceverà una notifica quando l'UI entra o esce dalla "modalità notturna". 
interfaccia NavigationView.OnRecenterButtonClickedListener Interfaccia per un listener che verrà avvisata quando viene fatto clic sul pulsante di riposizionamento. 

Riepilogo delle costanti ereditate

Riepilogo campi ereditato

Riepilogo del costruttore pubblico

NavigationView(Contesto del contesto)
NavigationView(Contesto contesto, attributi AttributeSet)
NavigationView(Context context, AttributeSet attrs, int defStyleAttr)

Riepilogo del metodo pubblico

Fotocamera
getCamera()
Restituisce un oggetto fotocamera che può essere utilizzato per modificare l'area visibile della mappa.
NavigationMap
getMap()
Restituisce un oggetto che può essere utilizzato per aggiungere contenuti alla mappa.
void
onConfigurationChanged(Configurazione della configurazione)
void
onCreate(Bundle savedInstanceState)
void
void
void
void
onSaveInstanceState(outState bundle)
void
void
onStop()
void
onTrimMemory(livello int)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
Sostituisce la modalità di visualizzazione predefinita per i callout Orario di arrivo stimato durante la navigazione.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride)
Imposta la modalità del formato delle informazioni sul callout per i callout del percorso.
void
setCompassEnabled(booleano abilitato)
Consente di impostare se la bussola è visibile.
void
setCustomControl(Controllo visualizzazione, posizione CustomControlPosition)
Consente di impostare una visualizzazione di controllo personalizzata che verrà mostrata nella posizione specificata nell'interfaccia utente di navigazione.
void
setEtaCardEnabled(booleano attivato)
Consente di impostare se la carta dell'orario di arrivo stimato è visibile durante la navigazione.
void
setForceNightMode(int NightMode)
Imposta l'attuale ForceNightMode.
void
setHeaderEnabled(booleano abilitato)
Consente di impostare se l'intestazione di navigazione passo passo è visibile durante la navigazione.
void
setOnNightModeChangedListener(listener NavigationView.OnNightModeChangedListener)
Imposta un listener che verrà avvisato immediatamente dello stato corrente della "modalità notturna" e ogni volta che l'UI entra o esce dalla "modalità notturna".
void
setOnRecenterButtonClickedListener(Listener NavigationView.OnRecenterButtonClickedListener)
Imposta un listener che verrà avvisato quando viene fatto clic sul pulsante di riposizionamento.
void
setRecenterButtonEnabled(booleano attivato)
Consente di impostare se mostrare o meno il pulsante di nuovo centratura.
void
setSpeedAlertOptions(SpeedAlertOptions SpeedalertOptions)
Imposta SpeedAlertOptions per personalizzare le soglie di attivazione per SpeedAlertSeverity.
void
setSpeedLimitIconEnabled(booleano abilitato)
Consente di specificare se visualizzare o meno l'icona del limite di velocità.
void
setSpeedometerIconEnabled(booleano abilitato)
Consente di specificare se visualizzare l'icona del tachimetro.
void
setSpeedometerUiOptions(SpeedometerUiOptions tachimetroUiOptions)
Consente di impostare la configurazione dell'interfaccia utente del tachimetro SpeedometerUiOptions in base a SpeedAlertSeverity.
void
setStylingOptions(StylingOptions styleOptions)
Imposta alcune opzioni di stile per l'interfaccia utente di navigazione.
void
setTrafficIncidentCardsEnabled(booleano abilitato)
Consente di impostare se visualizzare o meno le schede sugli incidenti stradali quando l'utente fa clic sull'icona di un incidente stradale.
void
setTrafficPromptsEnabled(booleano attivato)
Consente di impostare se mostrare le richieste di traffico.

Riepilogo del metodo ereditato

Costruttori pubblici

pubblico NavigationView (contesto del contesto)

Parametri
context

Public NavigationView (Context context, AttributeSet attrs)

Parametri
context
attrs

Public NavigationView (Context context, AttributeSet attrs, int defStyleAttr)

Parametri
context
attrs
defStyleAttr

Metodi pubblici

pubblica Videocamera getCamera ()

Restituisce un oggetto fotocamera che può essere utilizzato per modificare l'area visibile della mappa. Questo metodo deve essere chiamato solo nel thread dell'interfaccia utente.

Ritorni
  • l'oggetto Camera associato a questa vista

Public NavigationMap getMap ()

Restituisce un oggetto che può essere utilizzato per aggiungere contenuti alla mappa. Questo metodo deve essere chiamato solo nel thread dell'interfaccia utente.

Public void onConfigurationChanged (Configurazione configurazione)

Parametri
config

Public void onCreate (Bundle savedInstanceState)

Parametri
savedInstanceState

Public void onDestroy ()

Public void onPause ()

Public void onResume ()

Public void onSaveInstanceState (outState bundle)

Parametri
outState

Public void onStart ()

Public void onStop ()

Public void onTrimMemory (livello int)

Parametri
livello

pubblici void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)

Sostituisce la modalità di visualizzazione predefinita per i callout Orario di arrivo stimato durante la navigazione. Se viene superato un valore null, viene reimpostata la modalità di visualizzazione predefinita.

Parametri
calloutInfoDisplayModeOverride la nuova modalità di visualizzazione desiderata.

Public void setCalloutInfoFormatOverride (RouteCalloutInfoFormat calloutInfoFormatOverride)

Imposta la modalità del formato delle informazioni sul callout per i callout del percorso. Se questo metodo non viene chiamato, i callout seguiranno il comportamento definito da RouteCalloutInfoFormat.DEFAULT.

Parametri
calloutInfoFormatOverride il nuovo formato di callout desiderato.

Public void setCompassEnabled (boolean enabled)

Consente di impostare se la bussola è visibile. Questo metodo deve essere chiamato solo nel thread dell'interfaccia utente.

Parametri
abilitata

Public void setCustomControl (Controllo vista, CustomControlPosition)

Consente di impostare una visualizzazione di controllo personalizzata che verrà mostrata nella posizione specificata nell'interfaccia utente di navigazione. Se esiste già un controllo personalizzato nella posizione specificata, questo verrà sostituito. Se chiami questo metodo con un valore di controllo nullo, il controllo personalizzato verrà rimosso nella posizione specificata. Se il controllo è già stato aggiunto in una posizione diversa o ha già un elemento padre, verrà ignorato. Questo metodo deve essere chiamato solo nel thread dell'interfaccia utente.

Parametri
controllo una vista che verrà posizionata all'interno dell'interfaccia utente di navigazione
position determina dove verrà posizionato il controllo personalizzato nell'interfaccia utente rispetto ai controlli integrati.

Public void setEtaCardEnabled (boolean enabled)

Consente di impostare se la carta dell'orario di arrivo stimato è visibile durante la navigazione. Questo metodo deve essere chiamato solo nel thread dell'interfaccia utente.

Parametri
abilitata

Public void setForceNightMode (int NightMode)

Imposta l'attuale ForceNightMode.

Parametri
nightMode

Public void setHeaderEnabled (boolean enabled)

Consente di impostare se l'intestazione di navigazione passo passo è visibile durante la navigazione. Questo metodo deve essere chiamato solo nel thread dell'interfaccia utente.

Parametri
abilitata

Public void setOnNightModeChangedListener (Listener NavigationView.OnNightModeChangedListener)

Imposta un listener che verrà avvisato immediatamente dello stato corrente della "modalità notturna" e ogni volta che l'UI entra o esce dalla "modalità notturna". Questo metodo deve essere chiamato solo nel thread della UI.

Nota: per evitare perdite di memoria, è necessario chiamare setOnNightModeChangedListener(null) quando il listener non è più richiesto.

Parametri
listener un listener che riceverà una notifica quando l'UI entra o esce dalla modalità notturna

Public void setOnRecenterButtonClickedListener (listener NavigationView.OnRecenterButtonClickedListener)

Imposta un listener che verrà avvisato quando viene fatto clic sul pulsante di riposizionamento. Questo metodo deve essere chiamato solo nel thread dell'interfaccia utente.

Nota: per evitare perdite di memoria, setOnRecenterButtonClickedListener(null) deve essere chiamato quando il listener non è più richiesto.

Parametri
listener un listener che riceverà una notifica quando l'utente fa clic sul pulsante di riposizionamento

Public void setRecenterButtonEnabled (boolean enabled)

Consente di impostare se mostrare o meno il pulsante di nuovo centratura. Questo metodo deve essere chiamato solo nel thread della UI.

Parametri
abilitata

Public void setSpeedAlertOptions (SpeedAlertOptions SpeedalertOptions)

Imposta SpeedAlertOptions per personalizzare le soglie di attivazione per SpeedAlertSeverity.

Puoi utilizzare questo metodo per personalizzare in percentuale le soglie di attivazione degli avvisi di velocità sia per gli avvisi MINOR sia per gli avvisi MAJOR. Puoi utilizzare questo metodo anche per configurare il tempo in secondi necessario per eseguire l'upgrade degli avvisi di velocità da MINOR a MAJOR.

Se imposti un valore null SpeedAlertOptions o non ne imposti uno, viene visualizzato l'avviso di velocità predefinito di NavSDK. L'avviso di velocità mostra il testo in rosso su sfondo bianco/scuro per la modalità giorno/notte, rispettivamente, quando la velocità è inferiore a 8 km/h o 10 km/h sopra il limite di velocità, e mostra il testo bianco su sfondo rosso quando la velocità supera i 10 km/h.

Parametri
speedAlertOptions

Public void setSpeedLimitIconEnabled (boolean enabled)

Consente di specificare se visualizzare o meno l'icona del limite di velocità. Chiama questo metodo solo nel thread dell'interfaccia utente.

Quando l'opzione è abilitata, un'icona del limite di velocità che indica il limite di velocità della strada viene visualizzata nell'angolo in basso durante le indicazioni. L'icona viene visualizzata solo nelle località in cui sono disponibili dati affidabili sui limiti di velocità. Quando l'icona del tachimetro è visibile, sono agganciate.

Se il pulsante di riposizionamento è abilitato, l'icona del limite di velocità è temporaneamente nascosta quando viene mostrato il pulsante di riposizionamento.

Nota: i conducenti devono seguire tutti i segnali stradali affissi sulla strada e utilizzare l'icona del limite di velocità solo come riferimento. Non è possibile garantire l'accuratezza dei dati relativi al limite di velocità. Puoi segnalare inesattezze nei nostri dati sui limiti di velocità presentando una richiesta nel portale di assistenza Google Cloud.

Parametri
abilitata

Public void setSpeedometerIconEnabled (boolean enabled)

Consente di specificare se visualizzare l'icona del tachimetro. Chiama questo metodo solo nel thread dell'interfaccia utente.

Quando l'opzione è abilitata, un'icona di tachimetro che indica la velocità del veicolo viene visualizzata nell'angolo in basso durante la guida. Quando l'icona dei limiti di velocità è visibile, vengono attaccate e il tachimetro può avere colori diversi per il testo e lo sfondo, a seconda della gravità dell'eccesso.

L'attivazione dell'icona del limite di velocità consente anche di attivare completamente l'icona del limite di velocità, ma puoi utilizzare setSpeedLimitIconEnabled(boolean) per disattivare/attivare separatamente l'icona del limite di velocità.

Se il pulsante di riposizionamento è attivato, l'icona del tachimetro è temporaneamente nascosta quando viene visualizzato il pulsante di riposizionamento.

Parametri
abilitata

Public void setSpeedometerUiOptions (SpeedometerUiOptions tachimetroUiOptions)

Consente di impostare la configurazione dell'interfaccia utente del tachimetro SpeedometerUiOptions in base a SpeedAlertSeverity. Chiama questo metodo solo nel thread dell'interfaccia utente.

Se imposti un SpeedometerUiOptions null, cancelli quello precedente, se impostato. Se non è configurato alcun SpeedometerUiOptions, l'UI del tachimetro utilizza le configurazioni predefinite di NavSDK per gli avvisi di velocità di SpeedAlertSeverity diversi:

  • Avviso di velocità MINOR in modalità giorno: testo rosso su sfondo bianco
  • Avviso di velocità MINOR in modalità notturna: testo rosso su sfondo scuro
  • Avviso di velocità MAJOR in modalità giorno: testo bianco su sfondo rosso
  • Avviso di velocità MAJOR in modalità notturna: testo bianco su sfondo rosso

Parametri
speedometerUiOptions

Public void setStylingOptions (StylingOptions styleOptions)

Imposta alcune opzioni di stile per l'interfaccia utente di navigazione. Questo metodo deve essere chiamato solo nel thread della UI.

Parametri
stylingOptions

Public void setTrafficIncidentCardsEnabled (boolean enabled)

Consente di impostare se visualizzare o meno le schede sugli incidenti stradali quando l'utente fa clic sull'icona di un incidente stradale. Questo metodo deve essere chiamato solo nel thread dell'interfaccia utente.

Tieni presente che, quando è in corso la navigazione guidata, i dettagli dell'incidente di traffico vengono visualizzati nei prompt. Per disabilitare i dettagli degli incidenti stradali durante la navigazione, utilizza setTrafficPromptsEnabled(boolean).

Parametri
abilitata

Public void setTrafficPromptsEnabled (boolean enabled)

Consente di impostare se mostrare le richieste di traffico. Periodicamente vengono visualizzati messaggi sul traffico per aggiornare l'utente sulle condizioni del traffico durante la navigazione. Questo metodo deve essere chiamato solo nel thread della UI.

Parametri
abilitata