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 |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(Bundle outState)
|
void |
onStart()
|
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 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 |
---|