Navigationsansicht

öffentliche Klasse NavigationView erweitert RelativeLayout

Eine Ansicht, die eine Karte zur Navigation anzeigt.

Nutzer dieser Klasse müssen alle Lebenszyklusmethoden aus dem Activity oder Fragment, das diese Ansicht enthält, an die entsprechenden Methoden in dieser Klasse weiterleiten. Insbesondere müssen Sie die folgenden Methoden weiterleiten:

Wenn das NavView-Element hinzugefügt wird, nachdem das übergeordnete Element Activity oder Fragment den Erstellungszyklus durchlaufen hat, müssen Sie onCreate(Bundle), onStart() und onResume() manuell aufrufen, um es richtig zu initialisieren. Wenn ein NavView von seinem übergeordneten Activity oder Fragment getrennt wird, müssen Sie onPause(), onStop() und onDestroy() manuell aufrufen, um Datenlecks zu vermeiden.

Hinweis: Es wird empfohlen, dieser Ansicht keine Kinder hinzuzufügen.

Alle NavView-Aufrufe sollten im UI-Thread ausgeführt werden.

Zusammenfassung für geschachtelte Klassen

Oberfläche NavigationView.OnNightModeChangedListener Schnittstelle für einen Listener, der benachrichtigt wird, wenn der Nachtmodus über die Benutzeroberfläche aktiviert oder beendet wird.
Oberfläche NavigationView.OnRecenterButtonClickedListener Schnittstelle für einen Listener, der benachrichtigt wird, wenn auf die Schaltfläche zum Rezensieren geklickt wird. 

Inherited Constant Summary

Inherited Field Summary

Public Constructor Summary

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

Public Method Summary

Kamera
getCamera()
Gibt ein Kameraobjekt zurück, mit dem der Darstellungsbereich der Karte geändert werden kann.
NavigationMap
getMap()
Gibt ein -Objekt zurück, mit dem der Karte Inhalte hinzugefügt werden können.
void
onConfigurationChanged(Konfigurationskonfiguration)
void
onCreate(Bundle savedInstanceState)
void
void
void
void
onSaveInstanceState(Bundle outState)
void
void
onStop()
void
onTrimMemory(int level)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
Überschreibt den Standardanzeigemodus für Callouts für erweiterte Textanzeigen während der Navigation.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride)
Legt den Formatmodus für Zusatzinformationen für Routen-Callouts fest.
void
setCompassEnabled(boolesch aktiviert)
Legt fest, ob der Kompass sichtbar ist.
void
setCustomControl(Ansichtssteuerung, Position CustomControlPosition)
Legt eine benutzerdefinierte Steuerelementansicht fest, die an der angegebenen Position in der Navigations-UI angezeigt wird.
void
setEtaCardEnabled(boolesch aktiviert)
Legt fest, ob die voraussichtliche Ankunftszeit während der Navigation sichtbar ist.
void
setForceNightMode(int NightMode)
Legt den aktuellen ForceNightMode fest.
void
setHeaderEnabled(boolesch aktiviert)
Legt fest, ob die Überschrift der Schritt-für-Schritt-Navigation während der Navigation sichtbar sein soll.
void
setOnNightModeChangedListener(NavigationView.OnNightModeChangedListener-Listener)
Legt einen Listener fest, der sofort über den aktuellen "Nachtmodus"-Status und immer dann benachrichtigt wird, wenn die UI in den "Nachtmodus" ein- oder ausschaltet.
void
setOnRecenterButtonClickedListener(NavigationView.OnRecenterButtonClickedListener-Listener)
Legt einen Listener fest, der benachrichtigt wird, wenn auf die Schaltfläche zum Rezensieren geklickt wird.
void
setRecenterButtonEnabled(boolesch aktiviert)
Legt fest, ob die Schaltfläche „Neu zentrieren“ angezeigt werden soll.
void
setSpeedAlertOptions(SpeedAlertOptions „speedAlertOptions“)
Legt SpeedAlertOptions zum Anpassen der Trigger-Schwellenwerte für SpeedAlertSeveritys fest.
void
setSpeedLimitIconEnabled(boolesch aktiviert)
Gibt an, ob das Symbol für die Geschwindigkeitsbegrenzung angezeigt wird.
void
setSpeedometerIconEnabled(boolesch aktiviert)
Gibt an, ob das Tacho-Symbol angezeigt wird.
void
setSpeedometerUiOptions(SpeedometerUiOptions TachoUiOptions)
Legt die UI-Konfiguration für den Tacho SpeedometerUiOptions auf Grundlage von SpeedAlertSeverity fest.
void
setStylingOptions(StylingOptions StylingOptions)
Legt einige Stiloptionen für die Navigations-UI fest.
void
setTrafficIncidentCardsEnabled(boolesch aktiviert)
Legt fest, ob Karten zu Verkehrsbehinderungen angezeigt werden sollen, wenn der Nutzer auf ein Verkehrsstörungssymbol klickt.
void
setTrafficPromptsEnabled(boolesch aktiviert)
Legt fest, ob Aufforderungen zur Verkehrslage angezeigt werden sollen.

Inherited Method Summary

Public Constructors

öffentlich NavigationView (Kontextkontext)

Parameter
context

public NavigationView (Context context, AttributeSet attrs)

Parameter
context
attrs

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

Parameter
context
attrs
defStyleAttr

Public Methods

public Kamera getCamera ()

Gibt ein Kameraobjekt zurück, mit dem der Darstellungsbereich der Karte geändert werden kann. Diese Methode sollte nur im UI-Thread aufgerufen werden.

Rückgaben
  • Das Camera-Objekt, das dieser Ansicht zugeordnet ist

public NavigationMap getMap ()

Gibt ein -Objekt zurück, mit dem der Karte Inhalte hinzugefügt werden können. Diese Methode sollte nur im UI-Thread aufgerufen werden.

public void onConfigurationChanged (Konfigurationskonfiguration)

Parameter
config

public void onCreate (Bundle savedInstanceState)

Parameter
savedInstanceState

public void onDestroy ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

Parameter
outState

public void onStart ()

public void onStop ()

public void onTrimMemory (int level)

Parameter
level

public void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)

Überschreibt den Standardanzeigemodus für Callouts für erweiterte Textanzeigen während der Navigation. Wenn Sie null übergeben, wird der Standardanzeigemodus zurückgesetzt.

Parameter
calloutInfoDisplayModeOverride den neuen gewünschten Anzeigemodus.

public void setCalloutInfoFormatOverride (RouteCalloutInfoFormat calloutInfoFormatOverride)

Legt den Formatmodus für Zusatzinformationen für Routen-Callouts fest. Wird diese Methode nicht aufgerufen, folgen Callouts dem durch RouteCalloutInfoFormat.DEFAULT definierten Verhalten.

Parameter
calloutInfoFormatOverride das gewünschte Format für Zusatzinformationen.

public void setCompassEnabled (boolean enabled)

Legt fest, ob der Kompass sichtbar ist. Diese Methode sollte nur im UI-Thread aufgerufen werden.

Parameter
aktiviert

public void setCustomControl (Ansichtssteuerung, Position CustomControlPosition)

Legt eine benutzerdefinierte Steuerelementansicht fest, die an der angegebenen Position in der Navigations-UI angezeigt wird. Wenn an der angegebenen Position bereits ein benutzerdefiniertes Steuerelement vorhanden ist, wird es ersetzt. Wenn Sie diese Methode mit einem Steuerelementwert null aufrufen, wird das benutzerdefinierte Steuerelement an der angegebenen Position entfernt. Wenn das Steuerelement bereits an einer anderen Position hinzugefügt wurde oder bereits ein übergeordnetes Element hat, wird es ignoriert. Diese Methode sollte nur im UI-Thread aufgerufen werden.

Parameter
Kontrolle eine Ansicht, die in der Navigations-UI positioniert wird
position legt fest, wo das benutzerdefinierte Steuerelement relativ zu den integrierten Steuerelementen in der UI platziert wird.

public void setEtaCardEnabled (boolean enabled)

Legt fest, ob die voraussichtliche Ankunftszeit während der Navigation sichtbar ist. Diese Methode sollte nur für den UI-Thread aufgerufen werden.

Parameter
aktiviert

public void setForceNightMode (int nightMode)

Legt den aktuellen ForceNightMode fest.

Parameter
nightMode

public void setHeaderEnabled (boolean enabled)

Legt fest, ob die Überschrift der Schritt-für-Schritt-Navigation während der Navigation sichtbar sein soll. Diese Methode sollte nur im UI-Thread aufgerufen werden.

Parameter
aktiviert

public void setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener-Listener)

Legt einen Listener fest, der sofort über den aktuellen "Nachtmodus"-Status und immer dann benachrichtigt wird, wenn die UI in den "Nachtmodus" ein- oder ausschaltet. Diese Methode sollte nur im UI-Thread aufgerufen werden.

Hinweis: Zur Vermeidung von Speicherlecks sollte setOnNightModeChangedListener(null) aufgerufen werden, wenn der Listener nicht mehr benötigt wird.

Parameter
Listener Listener, der benachrichtigt wird, wenn der Nachtmodus über die Benutzeroberfläche aktiviert oder beendet wird

public void setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener-Listener)

Legt einen Listener fest, der benachrichtigt wird, wenn auf die Schaltfläche zum Rezensieren geklickt wird. Diese Methode sollte nur im UI-Thread aufgerufen werden.

Hinweis: Zur Vermeidung von Speicherlecks sollte setOnRecenterButtonClickedListener(null) aufgerufen werden, wenn der Listener nicht mehr benötigt wird.

Parameter
Listener Listener, der benachrichtigt wird, wenn auf die Schaltfläche zum Rezensieren geklickt wird

public void setRecenterButtonEnabled (boolean enabled)

Legt fest, ob die Schaltfläche „Neu zentrieren“ angezeigt werden soll. Diese Methode sollte nur im UI-Thread aufgerufen werden.

Parameter
aktiviert

public void setSpeedAlertOptions (SpeedAlertOptions speedAlertOptions)

Legt SpeedAlertOptions zum Anpassen der Trigger-Schwellenwerte für SpeedAlertSeveritys fest.

Mit dieser Methode können Sie die Grenzwerte zum Auslösen von Geschwindigkeitswarnungen in Prozent sowohl für MINOR- als auch für MAJOR-Benachrichtigungen anpassen. Mit dieser Methode lässt sich auch die Zeit in Sekunden konfigurieren, die für das Upgrade der Geschwindigkeitsbenachrichtigungen von MINOR auf MAJOR erforderlich ist.

Wenn Sie eine null-SpeedAlertOptions festlegen oder keine festlegen, wird die Standardgeschwindigkeitswarnung des NavSDK angezeigt: Die Geschwindigkeitswarnung zeigt für den Tag- und Nachtmodus roter Text auf weißem/dunklem Hintergrund an, wenn die Geschwindigkeit weniger als 10 km/h über der Höchstgeschwindigkeit liegt. Bei über 10 km/h wird weißer Text auf rotem Hintergrund angezeigt.

Parameter
speedAlertOptions

public void setSpeedLimitIconEnabled (boolean enabled)

Gibt an, ob das Symbol für die Geschwindigkeitsbegrenzung angezeigt wird. Rufen Sie diese Methode nur im UI-Thread auf.

Wenn diese Funktion aktiviert ist, wird in der unteren Startecke der Route ein Symbol für die Geschwindigkeitsbegrenzung angezeigt, das die Höchstgeschwindigkeit auf der Straße angibt. Das Symbol wird nur an Orten angezeigt, an denen verlässliche Daten zu Geschwindigkeitsbegrenzungen verfügbar sind. Wenn das Tacho-Symbol angezeigt wird, sind sie angebracht.

Wenn die Schaltfläche zum Zentrieren aktiviert ist, wird das Symbol für die Geschwindigkeitsbegrenzung vorübergehend ausgeblendet, wenn die Schaltfläche zum Zentrieren angezeigt wird.

Hinweis: Die Fahrer müssen allen Schildern auf der Straße folgen und das Symbol für die Geschwindigkeitsbegrenzung nur als Referenz verwenden. Die Genauigkeit der Daten zu Geschwindigkeitsbegrenzungen kann nicht garantiert werden. Sie können Ungenauigkeiten in Bezug auf Geschwindigkeitsbegrenzungen melden, indem Sie im Google Cloud-Supportportal eine Supportanfrage stellen.

Parameter
aktiviert

public void setSpeedometerIconEnabled (boolean enabled)

Gibt an, ob das Tacho-Symbol angezeigt wird. Rufen Sie diese Methode nur im UI-Thread auf.

Wenn diese Funktion aktiviert ist, wird während der Routenführung unten in der Startecke ein Tacho-Symbol für die Geschwindigkeit des Fahrzeugs angezeigt. Wenn das Symbol für die Geschwindigkeitsbegrenzung zu sehen ist, wird es angehängt. Je nach Schweregrad der Geschwindigkeit können der Text und der Hintergrund dann unterschiedliche Farben haben.

Wenn Sie das Symbol für die Geschwindigkeitsbegrenzung aktivieren, wird das Symbol für die Geschwindigkeitsbegrenzung ebenfalls aktiviert. Mit setSpeedLimitIconEnabled(boolean) können Sie das Symbol für die Geschwindigkeitsbegrenzung jedoch separat deaktivieren/aktivieren.

Wenn die Schaltfläche zum Zentrieren aktiviert ist, wird das Tacho-Symbol vorübergehend ausgeblendet, wenn die Schaltfläche zum Zentrieren angezeigt wird.

Parameter
aktiviert

public void setSpeedometerUiOptions (SpeedometerUiOptions speedometerUiOptions)

Legt die UI-Konfiguration für den Tacho SpeedometerUiOptions auf Grundlage von SpeedAlertSeverity fest. Rufen Sie diese Methode nur im UI-Thread auf.

Durch Festlegen eines null-SpeedometerUiOptions löschen Sie die vorherige, falls festgelegt. Wenn kein SpeedometerUiOptions konfiguriert ist, greift die Tacho-Benutzeroberfläche für Geschwindigkeitswarnungen für verschiedene SpeedAlertSeverity auf die NavSDK-Standardkonfigurationen zurück:

  • Geschwindigkeitswarnung für MINOR im Tagesmodus: roter Text auf weißem Hintergrund
  • Geschwindigkeitswarnung (MINOR) im Nachtmodus: roter Text vor dunklem Hintergrund
  • Geschwindigkeitswarnung für MAJOR im Tagesmodus: weißer Text auf rotem Hintergrund
  • Geschwindigkeitswarnung (MAJOR) im Nachtmodus: weißer Text auf rotem Hintergrund

Parameter
speedometerUiOptions

public void setStylingOptions (StylingOptions StylingOptions)

Legt einige Stiloptionen für die Navigations-UI fest. Diese Methode sollte nur im UI-Thread aufgerufen werden.

Parameter
stylingOptions

public void setTrafficIncidentCardsEnabled (boolean enabled)

Legt fest, ob Karten zu Verkehrsbehinderungen angezeigt werden sollen, wenn der Nutzer auf ein Verkehrsstörungssymbol klickt. Diese Methode sollte nur im UI-Thread aufgerufen werden.

Hinweis: Während der geführten Navigation werden in den Aufforderungen Details zu Verkehrsbehinderungen angezeigt. Um Details zu Verkehrsbehinderungen während der Navigation zu deaktivieren, sollte stattdessen setTrafficPromptsEnabled(boolean) verwendet werden.

Parameter
aktiviert

public void setTrafficPromptsEnabled (boolean enabled)

Legt fest, ob Aufforderungen zur Verkehrslage angezeigt werden sollen. Während der Navigation werden regelmäßig Aufforderungen zur Verkehrslage angezeigt, um Nutzer über die Verkehrslage zu informieren. Diese Methode sollte nur im UI-Thread aufgerufen werden.

Parameter
aktiviert