Fragment kodu nawigacji

klasa publiczna SupportNavigationFragment rozszerza fragment

Komponent nawigacji w aplikacji. Ten fragment to najprostszy sposób korzystania z nawigacji w aplikacji. To owijka wokół mapy nawigacyjnej, która automatycznie obsługuje niezbędne potrzeby związane z cyklem życia. Ten komponent jest fragmentem, więc można go dodać do pliku układu działania za pomocą poniższego kodu XML.

 <fragment
    class="com.google.android.libraries.navigation.SupportNavigationFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

Publiczne podsumowanie konstruktora

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)
Wyświetl
onCreateView(narzędzie Szablon Inflater, kontener ViewGroup, pakiet zapisanego stanu instancji)
void
void
void
void
void
onSaveInstanceState(Bundle outState)
void
void
onStop()
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(int 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, 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 szybkośćAlertUiOptions)
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 SupportNavigationFragment ()

Metody publiczne

public Kamera getCamera ()

Zwraca obiekt aparatu, którego można użyć do zmiany widocznego obszaru mapy.

Akcje powrotne
  • obiekt Camera powiązany z tym fragmentem

public NavigationMap getMap ()

Zwraca obiekt, którego można użyć do dodania treści do mapy.

public void onConfigurationChanged (Konfiguracja konfiguracji)

Parametry
konfiguracja

public Widok onCreateView (LayoutInflater zmienną, kontener ViewGroup, pakiet zapisany stan instancji)

Parametry
nadmuch
kontener
savedInstanceState

public void onDestroyView ()

public void onLowMemory ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

Parametry
outState

public void onStart ()

public void onStop ()

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 (int forceNightMode)

Parametry
forceNightMode

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, gdy interfejs użytkownika otworzy lub wyjdzie z trybu nocnego. Tę metodę należy wywoływać tylko w wątku interfejsu użytkownika.

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ą setSpeedLimitIconEnabled(boolean) można ją wyłączyć lub włączyć oddzielnie

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 szybkościAlertUiOptions)

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
speedAlertUiOptions

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.

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