Widok nawigacji

klasa publiczna NavigationView rozszerza względne układy

Widok, który zawiera mapę do nawigacji.

Użytkownicy tej klasy muszą przekazywać wszystkie metody cyklu życia z instancji Activity lub Fragment zawierających ten widok do odpowiednich metod w tej klasie. W szczególności musisz używać tych metod:

Jeśli widok nawigacyjny został dodany po zakończeniu cyklu tworzenia elementu nadrzędnego (Activity lub Fragment), musisz ręcznie wywołać zdarzenia onCreate(Bundle), onStart() i onResume(), by go prawidłowo zainicjować. Podobnie jeśli widok nawigacyjny jest odłączony od nadrzędnego (Activity lub Fragment), musisz ręcznie wywoływać onPause(), onStop() i onDestroy(), by zapobiec wyciekom.

Uwaga: odradzamy dodawanie dzieci do tego widoku.

Wszystkie wywołania NavView powinny być wykonywane w wątku UI.

Podsumowanie zagnieżdżonych zajęć

interfejs, NavigationView.OnNightModeChangedListener Interfejs odbiornika, który będzie powiadamiany, gdy interfejs użytkownika otworzy lub wyjdzie z trybu nocnego.
interfejs, NavigationView.OnRecenterButtonClickedListener Interfejs detektora, który będzie powiadamiany po kliknięciu przycisku wyśrodkowania. 

Dziedziczone podsumowanie stałych

Podsumowanie dziedziczonych pól

Publiczne podsumowanie konstruktora

NavigationView(kontekst)
NavigationView(kontekst kontekst, atrybuty zbioru atrybutów)
NavigationView(kontekst kontekst, atrybuty zbioru atrybutów, int defStyleAttr)

Podsumowanie metod publicznych

Aparat
getCamera()
Zwraca obiekt aparatu, którego można użyć do zmiany widocznego obszaru mapy.
NavigationMap
getMap()
Zwraca obiekt, którego można użyć do dodania treści do mapy.
void
onConfigurationChanged(konfiguracja konfiguracji)
void
onCreate(Bundle savedInstanceState)
void
void
void
void
onSaveInstanceState(Bundle outState)
void
void
onStop()
void
onTrimMemory(poziom integracyjny)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
Zastępuje domyślny tryb wyświetlania objaśnień na temat rozszerzonych reklam tekstowych podczas nawigacji.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride)
Ustawia tryb formatu informacji o objaśnieniach trasy.
void
setCompassEnabled(wartość logiczna włączona)
Określa, czy kompas ma być widoczny.
void
setCustomControl(element sterujący widoku, pozycja CustomControlPosition)
Konfiguruje niestandardowy widok elementu sterującego, który pojawi się w określonym miejscu w interfejsie nawigacji.
void
setEtaCardEnabled(wartość logiczna włączona)
Określa, czy karta z szacowanym czasem dotarcia na miejsce jest widoczna podczas nawigacji.
void
setForceNightMode(w trybie nocnym)
Ustawia bieżącą wartość ForceNightMode.
void
setHeaderEnabled(wartość logiczna włączona)
Określa, czy nagłówek nawigacji zakręt po zakręcie jest widoczny podczas nawigacji.
void
setOnNightModeChangedListener(detektor NavigationView.OnNightModeChangedListener)
Ustawia odbiornik, który będzie powiadamiany natychmiast o bieżącym stanie „trybu nocnego” i za każdym razem, gdy interfejs użytkownika otworzy lub wyjdzie z „trybu nocnego”.
void
setOnRecenterButtonClickedListener(NavigationView.OnRecenterButtonClickedListener)
Konfiguruje odbiornik, który będzie powiadamiany po kliknięciu przycisku wyśrodkowania.
void
setRecenterButtonEnabled(wartość logiczna włączona)
Określa, czy ma być wyświetlany przycisk ponownego wyśrodkowania.
void
setSpeedAlertOptions(SpeedAlertOptions szybkośćAlertOptions)
Ustawia wartość SpeedAlertOptions, aby dostosować progi wyzwalania dla zdarzenia SpeedAlertSeverity.
void
setSpeedLimitIconEnabled(wartość logiczna włączona)
Określa, czy ma być wyświetlana ikona ograniczenia prędkości.
void
setSpeedometerIconEnabled(wartość logiczna włączona)
Określa, czy ma być wyświetlana ikona prędkościomierza.
void
setSpeedometerUiOptions(SpeedometerUiOptions prędkościometrUiOptions)
Ustawia konfigurację interfejsu prędkościomierza SpeedometerUiOptions na podstawie wartości SpeedAlertSeverity.
void
setStylingOptions(StylingOptions styleingOptions)
Ustawia niektóre opcje stylu interfejsu nawigacji.
void
setTrafficIncidentCardsEnabled(wartość logiczna włączona)
Określa, czy po kliknięciu przez użytkownika ikony zdarzenia drogowego mają się wyświetlać karty zdarzeń drogowych.
void
setTrafficPromptsEnabled(wartość logiczna włączona)
Określa, czy podpowiedzi dotyczące ruchu mają być wyświetlane.

Podsumowanie metod dziedziczonych

Publiczne konstruktorzy

public NavigationView (kontekst)

Parametry
sytuacja

public NavigationView (Kontekst kontekst, atrybuty AttributeSet)

Parametry
sytuacja
attrs

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

Parametry
sytuacja
attrs
defStyleAttr

Metody publiczne

public Kamera getCamera ()

Zwraca obiekt aparatu, którego można użyć do zmiany widocznego obszaru mapy. Tę metodę należy wywoływać tylko w wątku interfejsu użytkownika.

Akcje powrotne
  • obiekt Camera powiązany z tym widokiem

public NavigationMap getMap ()

Zwraca obiekt, którego można użyć do dodania treści do mapy. Tę metodę należy wywoływać tylko w wątku interfejsu użytkownika.

public void onConfigurationChanged (Konfiguracja konfiguracji)

Parametry
konfiguracja

public void onCreate (Bundle savedInstanceState)

Parametry
savedInstanceState

public void onDestroy ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

Parametry
outState

public void onStart ()

public void onStop ()

public void onTrimMemory (poziom integracji)

Parametry
poziom

public void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)

Zastępuje domyślny tryb wyświetlania objaśnień na temat rozszerzonych reklam tekstowych podczas nawigacji. Przekazanie wartości null resetuje domyślny tryb wyświetlania.

Parametry
calloutInfoDisplayModeOverride wybierz nowy tryb wyświetlania.

public void setCalloutInfoFormatOverride (RouteCalloutInfoFormat calloutInfoFormatOverride)

Ustawia tryb formatu informacji o objaśnieniach trasy. Jeśli ta metoda nie zostanie wywołana, objaśnienia będą działać zgodnie z definicją podaną w RouteCalloutInfoFormat.DEFAULT.

Parametry
calloutInfoFormatOverride wybierz nowy format objaśnienia.

public void setCompassEnabled (boolean enabled)

Określa, czy kompas ma być widoczny. Tę metodę należy wywoływać tylko w wątku interfejsu użytkownika.

Parametry
włączone

public void setCustomControl (element sterujący widoku, pozycja CustomControlPosition)

Konfiguruje niestandardowy widok elementu sterującego, który pojawi się w określonym miejscu w interfejsie nawigacji. Jeśli w danej pozycji istnieje już element sterujący niestandardowy, zostanie on zastąpiony. Wywołanie tej metody z pustą wartością kontrolną spowoduje usunięcie elementu sterującego niestandardowego w danej pozycji. Jeśli element sterujący został już dodany w innej pozycji lub ma już element nadrzędny, zostanie zignorowany. Tę metodę należy wywoływać tylko w wątku interfejsu użytkownika.

Parametry
kontrola widok, który zostanie umieszczony w interfejsie nawigacji
position określa, gdzie w interfejsie zostanie umieszczony element sterujący względem wbudowanych elementów sterujących.

public void setEtaCardEnabled (boolean enabled)

Określa, czy karta z szacowanym czasem dotarcia na miejsce jest widoczna podczas nawigacji. Tę metodę należy wywoływać tylko w wątku interfejsu użytkownika.

Parametry
włączone

public void setForceNightMode (w trybie nocnym)

Ustawia bieżącą wartość ForceNightMode.

Parametry
nightMode

public void setHeaderEnabled (boolean enabled)

Określa, czy nagłówek nawigacji zakręt po zakręcie jest widoczny podczas nawigacji. Tę metodę należy wywoływać tylko w wątku interfejsu użytkownika.

Parametry
włączone

public void setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener)

Ustawia odbiornik, który będzie powiadamiany natychmiast o bieżącym stanie „trybu nocnego” i za każdym razem, gdy interfejs użytkownika otworzy lub wyjdzie z „trybu nocnego”. Tę metodę należy wywoływać tylko w wątku UI.

Uwaga: aby uniknąć wycieku pamięci, należy wywoływać setOnNightModeChangedListener(null), gdy odbiornik nie jest już wymagany.

Parametry
detektor detektor, który będzie powiadamiał o przejściu lub zamknięciu trybu nocnego przez interfejs

public void setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener)

Konfiguruje odbiornik, który będzie powiadamiany po kliknięciu przycisku wyśrodkowania. Tę metodę należy wywoływać tylko w wątku interfejsu użytkownika.

Uwaga: aby uniknąć wycieku pamięci, należy wywoływać setOnRecenterButtonClickedListener(null), gdy odbiornik nie jest już wymagany.

Parametry
detektor detektor, który będzie powiadamiany po kliknięciu przycisku wyśrodkowania

public void setRecenterButtonEnabled (boolean enabled)

Określa, czy ma być wyświetlany przycisk ponownego wyśrodkowania. Tę metodę należy wywoływać tylko w wątku UI.

Parametry
włączone

public void setSpeedAlertOptions (SpeedAlertOptions szybkośćAlertOptions)

Ustawia wartość SpeedAlertOptions, aby dostosować progi wyzwalania dla zdarzenia SpeedAlertSeverity.

Możesz użyć tej metody, aby dostosować wyrażone w procentach progi wyzwalające alerty dotyczące szybkości (MINOR i MAJOR). Możesz też użyć tej metody, aby skonfigurować czas (w sekundach) potrzebny do uaktualnienia alertów o szybkości z MINOR do MAJOR.

Gdy ustawisz wartość null SpeedAlertOptions lub nie ustawisz żadnego, domyślny alert dotyczący prędkości w NavSDK będzie się wyświetlał: alert dotyczący prędkości wyświetla czerwony tekst na białym/ciemnym tle w trybie dziennym lub nocnym, jeśli prędkość jest mniejsza niż 8 km/h lub 10 km/h, a jeśli prędkość przekracza 8 km/h lub 10 km/h, będzie wyświetlany biały tekst na czerwonym tle.

Parametry
speedAlertOptions

public void setSpeedLimitIconEnabled (boolean enabled)

Określa, czy ma być wyświetlana ikona ograniczenia prędkości. Wywołuj tę metodę tylko w wątku interfejsu użytkownika.

Gdy ta opcja jest włączona, w dolnym rogu startu pojawia się ikona ograniczenia prędkości wskazująca ograniczenie prędkości na drodze. Ikona pojawia się tylko w lokalizacjach, w których dostępne są niezawodne dane o ograniczeniach prędkości. Gdy ikona prędkościomierza jest widoczna, są one dołączone.

Jeśli włączony jest przycisk wyśrodkowywania, ikona ograniczenia prędkości jest tymczasowo ukryta, gdy wyświetlany jest ten przycisk.

Uwaga: kierowcy muszą przestrzegać wszystkich znaków towarowych znajdujących się na drodze, a ikona ograniczenia prędkości ma tylko charakter informacyjny. Nie można zagwarantować dokładności danych dotyczących ograniczenia prędkości. Możesz zgłosić nieścisłości w naszych danych o ograniczeniach prędkości, przesyłając zgłoszenie w portalu pomocy Google Cloud.

Parametry
włączone

public void setSpeedometerIconEnabled (boolean enabled)

Określa, czy ma być wyświetlana ikona prędkościomierza. Wywołuj tę metodę tylko w wątku interfejsu użytkownika.

Gdy ta opcja jest włączona, w dolnym rogu startowym pojawia się ikona prędkościomierza wskazująca prędkość pojazdu. Gdy widoczna jest ikona ograniczenia prędkości, prędkościomierz może mieć różne kolory tekstu i tła w zależności od natężenia ruchu.

Włączenie ikony prędkościomierza powoduje też całkowite włączenie ikony ograniczenia prędkości, ale za pomocą przycisku setSpeedLimitIconEnabled(boolean) można oddzielnie wyłączyć lub włączyć ikonę ograniczenia prędkości.

Jeśli przycisk wyśrodkowywania jest włączony, ikona prędkościomierza jest tymczasowo ukryta, gdy wyświetla się ten przycisk.

Parametry
włączone

public void setSpeedometerUiOptions (SpeedometerUiOptions prędkościometrUiOptions)

Ustawia konfigurację interfejsu prędkościomierza SpeedometerUiOptions na podstawie wartości SpeedAlertSeverity. Wywołuj tę metodę tylko w wątku interfejsu użytkownika.

Ustawiając null w kolumnie SpeedometerUiOptions, usuwasz poprzedni element (jeśli jest ustawiony). Jeśli SpeedometerUiOptions nie jest skonfigurowany, w przypadku alertów o szybkości na różnych urządzeniach SpeedAlertSeverity interfejs prędkościomierza przełącza się na domyślne konfiguracje NavSDK:

  • Alert o prędkości w trybie MINOR w trybie dziennym: czerwony tekst na białym tle
  • Alert o szybkości w trybie MINOR w trybie nocnym: czerwony tekst na ciemnym tle
  • Alert o szybkości w trybie MAJOR w trybie dziennym: biały tekst na czerwonym tle
  • Alert o prędkości w trybie MAJOR w trybie nocnym: biały tekst na czerwonym tle

Parametry
speedometerUiOptions

public void setStylingOptions (StylingOptions styleingOptions)

Ustawia niektóre opcje stylu interfejsu nawigacji. Tę metodę należy wywoływać tylko w wątku UI.

Parametry
stylingOptions

public void setTrafficIncidentCardsEnabled (boolean enabled)

Określa, czy po kliknięciu przez użytkownika ikony zdarzenia drogowego mają się wyświetlać karty zdarzeń drogowych. Tę metodę należy wywoływać tylko w wątku interfejsu użytkownika.

Pamiętaj, że podczas nawigacji z przewodnikiem szczegółowe informacje o zdarzeniach drogowych są wyświetlane w promptach. Aby wyłączyć szczegóły zdarzenia drogowego podczas nawigacji, użyj właściwości setTrafficPromptsEnabled(boolean).

Parametry
włączone

public void setTrafficPromptsEnabled (boolean enabled)

Określa, czy podpowiedzi dotyczące ruchu mają być wyświetlane. Co jakiś czas wyświetlają się komunikaty o natężeniu ruchu, które informują użytkownika o warunkach na drodze. Tę metodę należy wywoływać tylko w wątku UI.

Parametry
włączone