SupportNavigationFragment

公用類別 SupportNavigationFragment 擴充 Fragment

應用程式中的導覽元件。這個片段是在應用程式中使用導覽最簡單的方式。是導覽地圖檢視畫面的包裝函式，可自動處理必要的生命週期需求。這個元件是片段，只需透過下列 XML 即可新增至活動的版面配置檔案。

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

公用建構函式摘要

SupportNavigationFragment()

公用方法摘要

相機	getCamera() 傳回相機物件，可用於調整地圖可視區域。
NavigationMap	getMap() 傳回可用來將內容新增至地圖的物件。
void	onConfigurationChanged(配置設定)
查看	onCreateView(LayoutInflater inflater、ViewGroup 容器、Bundle savedInstanceState)
void	onDestroyView()
void	onLowMemory()
void	onPause()
void	onResume()
void	onSaveInstanceState(Bundle outState)
void	onStart()
void	onStop()
void	setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride) 在瀏覽期間覆寫延展型文字廣告摘要的預設顯示模式。
void	setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride) 設定路線摘要的摘要資訊格式模式。
void	setCompassEnabled(已啟用布林值) 設定是否顯示指南針。
void	setCustomControl(檢視畫面控制項、CustomControlPosition 位置) 設定自訂控制項檢視畫面，顯示在導覽 UI 中的指定位置。
void	setEtaCardEnabled(已啟用布林值) 設定是否在導航期間顯示預計到達時間資訊卡。
void	setForceNightMode(int forceNightMode)
void	setHeaderEnabled(已啟用布林值) 設定是否在導航期間顯示即時路線導航標頭。
void	setOnNightModeChangedListener(NavigationView.OnNightModeChangedListener事件監聽器) 設定監聽器，當 UI 進入或離開夜間模式時，就會收到通知。
void	setOnRecenterButtonClickedListener(NavigationView.OnRecenterButtonClickedListener 事件監聽器) 設定監聽器，在點選最近按鈕時會收到通知。
void	setRecenterButtonEnabled(已啟用布林值) 設定是否顯示重新置中按鈕。
void	setSpeedAlertOptions(SpeedAlertOptions speedAlertOptions) 設定 SpeedAlertOptions，用於自訂 SpeedAlertSeverity 的觸發門檻。
void	setSpeedLimitIconEnabled(已啟用布林值) 指定是否要顯示速限圖示。
void	setSpeedometerIconEnabled(已啟用布林值) 指定是否要顯示計速器圖示。
void	setSpeedometerUiOptions(SpeedometerUiOptionsSpeedAlertUiOptions) 根據 SpeedAlertSeverity 設定計速器 UI 設定 SpeedometerUiOptions。
void	setStylingOptions(StylingOptions styleOptions) 設定導覽 UI 的一些樣式選項。
void	setTrafficIncidentCardsEnabled(已啟用布林值) 設定是否要在使用者點選交通事件圖示時顯示交通事件資訊卡。
void	setTrafficPromptsEnabled(已啟用布林值) 設定是否應顯示流量提示。

繼承方法摘要

來自類別 java.lang.Object

布林值	equals(物件 arg0)
最終版<?>	getClass()
int	hashCode()
最後 void	notify()
最後 void	notifyAll()
字串	toString()
最後 void	wait(long arg0, int arg1)
最後 void	wait(long arg0)
最後 void	wait()

公用建構函式

public SupportNavigationFragment ()

公用方法

public 相機 getCamera ()

傳回相機物件，可用於調整地圖可視區域。

傳回

• 與此片段相關聯的 Camera 物件

public NavigationMap getMap ()

傳回可用來將內容新增至地圖的物件。

public void onConfigurationChanged (配置設定)

參數

config

public 查看 onCreateView (LayoutInflater inflater、ViewGroup 容器、 Bundle savedInstanceState)

參數

發氣機
容器
savedInstanceState

public void onDestroyView ()

public void onLowMemory ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

參數

outState

public void onStart ()

public void onStop ()

public void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)

在瀏覽期間覆寫延展型文字廣告摘要的預設顯示模式。傳送空值會重設預設顯示模式。

參數

calloutInfoDisplayModeOverride	所需的新顯示模式。

public void setCalloutInfoFormatOverride (RouteCalloutInfoFormat calloutInfoFormatOverride)

設定路線摘要的摘要資訊格式模式。如未呼叫此方法，摘要會遵循 Route calloutInfoFormat.DEFAULT 的定義。

參數

calloutInfoFormatOverride	中新增所需的摘要格式。

public void setCompassEnabled (boolean enabled)

設定是否顯示指南針。這個方法只能在 UI 執行緒上呼叫。

參數

已啟用

public void setCustomControl (檢視畫面控制、CustomControlPosition 位置)

設定自訂控制項檢視畫面，顯示在導覽 UI 中的指定位置。如果位於指定位置的任何自訂控制項，系統就會替換該控制項。如果使用空值控制項值呼叫這個方法，系統會在指定位置移除自訂控制項。如果控制項已新增至其他位置，或已有父項，系統就會忽略該控制項。這個方法只能在 UI 執行緒上呼叫。

參數

控管	會顯示在導覽 UI 中的檢視畫面
排名	會根據內建控制項，決定自訂控制項在 UI 中的位置。

public void setEtaCardEnabled (boolean enabled)

設定是否在導航期間顯示預計到達時間資訊卡。這個方法只能在 UI 執行緒上呼叫。

參數

已啟用

public void setForceNightMode (int forceNightMode)

參數

forceNightMode

public void setHeaderEnabled (boolean enabled)

設定是否在導航期間顯示即時路線導航標頭。這個方法只能在 UI 執行緒上呼叫。

參數

已啟用

public void setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener事件監聽器)

設定監聽器，當 UI 進入或離開夜間模式時，就會收到通知。這個方法只能在 UI 執行緒上呼叫。

注意：為了避免記憶體流失，應在不再需要事件監聽器時呼叫 setOnNightModeChangedListener(null)。

參數

事件監聽器	會在 UI 進入或退出夜間模式時接收通知的

public void setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener 事件監聽器)

設定監聽器，在點選最近按鈕時會收到通知。這個方法只能在 UI 執行緒上呼叫。

注意：為了避免記憶體流失，應在不再需要事件監聽器時呼叫 setOnRecenterButtonClickedListener(null)。

參數

事件監聽器	會在按下最近按鈕按鈕時通知的監聽器。

public void setRecenterButtonEnabled (boolean enabled)

設定是否顯示重新置中按鈕。這個方法只能在 UI 執行緒上呼叫。

參數

已啟用

public void setSpeedAlertOptions (SpeedAlertOptions speedAlertOptions)

設定 SpeedAlertOptions，自訂 SpeedAlertSeverity 的觸發門檻。

您可以使用這個方法，自訂 MINOR 和 MAJOR 快訊的速度快訊觸發門檻 (以百分比表示)。您也可以使用這個方法，設定將速度快訊從 MINOR 升級至 MAJOR 所需的時間 (以秒為單位)。

如果設定 null SpeedAlertOptions 或不設定任何值，NavSDK 的預設速度快訊就會顯示：當速度低於時速低於 5 英里/小時或 10 公里時，速度快訊會分別以白色/深色背景顯示紅色文字，並在速度超過 5 英里或 10 公里時，以紅色背景顯示白色文字。

參數

speedAlertOptions

public void setSpeedLimitIconEnabled (boolean enabled)

指定是否要顯示速限圖示。只在 UI 執行緒上呼叫這個方法。

啟用後，系統會在導航期間的底部角落顯示速限圖示。這個圖示只會顯示在可提供可靠速限資料的位置。顯示計速器圖示時，表示已附加。

如果啟用了「最近間隔」按鈕，則顯示「重新置中」按鈕時，會暫時隱藏速限圖示。

注意：駕駛人必須遵守道路上所有的標誌，且速限圖示僅供參考。無法保證速限資料準確性。您可以在 Google Cloud 支援入口網站提交案件，回報速限資料有誤。

參數

已啟用

另請參閱

• ERROR(com.google.android.libraries.navigation.Navigator#startGuidance()}/{@code com.google.android.libraries.navigation.Navigator#startGuidance()})
• ERROR(#setRecenterButtonEnabled(boolean)) /{@code #setRecenterButtonEnabled(boolean)))

public void setSpeedometerIconEnabled (boolean enabled)

指定是否要顯示計速器圖示。只在 UI 執行緒上呼叫這個方法。

啟用後，系統會在導航期間的底部角落顯示計速器圖示，表示車輛速度。當顯示速限圖示顯示時，系統會附加此類圖示，然後計速計就可以根據速度嚴重性等級而有不同的文字和背景顏色。

啟用 Speedomter 圖示可完全啟用速限圖示，但您可以使用 setSpeedLimitIconEnabled(boolean) 單獨停用/啟用速限圖示

如果已啟用重新置中按鈕，則顯示重新置中按鈕時，計速器圖示會暫時隱藏。

參數

已啟用

另請參閱

• ERROR(com.google.android.libraries.navigation.Navigator#startGuidance()}/{@code com.google.android.libraries.navigation.Navigator#startGuidance()})
• ERROR(#setRecenterButtonEnabled(boolean)) /{@code #setRecenterButtonEnabled(boolean)))

public void setSpeedometerUiOptions (SpeedometerUiOptions speedAlertUiOptions)

根據 SpeedAlertSeverity 設定計速器 UI 設定 SpeedometerUiOptions。只在 UI 執行緒上呼叫這個方法。

設定 null SpeedometerUiOptions 後，系統會清除先前的設定 (如有設定)。如未設定 SpeedometerUiOptions，速度計使用者介面會改回使用 NavSDK 預設設定，以接收不同 SpeedAlertSeverity 的速度快訊：

• 日間模式的MINOR速度快訊：白色背景文字
• 夜間模式下的 MINOR 速度快訊：以深色背景顯示紅色文字
• 日間模式的MAJOR速度快訊：紅色背景的白色文字
• 夜間模式下的 MAJOR 速度快訊：以紅色背景呈現白色文字

參數

speedAlertUiOptions

public void setStylingOptions (StylingOptions styleOptions)

設定導覽 UI 的一些樣式選項。這個方法只能在 UI 執行緒上呼叫。

參數

stylingOptions

public void setTrafficIncidentCardsEnabled (boolean enabled)

設定是否要在使用者點選交通事件圖示時顯示交通事件資訊卡。這個方法只能在 UI 執行緒上呼叫。

參數

已啟用

public void setTrafficPromptsEnabled (boolean enabled)

設定是否應顯示流量提示。系統會定期顯示路況提示，在導航期間更新使用者路況。這個方法只能在 UI 執行緒上呼叫。

參數

已啟用