應用程式中的導覽元件。這個片段是在應用程式中使用導覽最簡單的方式。是導覽地圖檢視畫面的包裝函式,可自動處理必要的生命週期需求。這個元件是片段,只需透過下列 XML 即可新增至活動的版面配置檔案。
<fragment class="com.google.android.libraries.navigation.SupportNavigationFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>
公用建構函式摘要
公用方法摘要
相機 |
getCamera()
傳回相機物件,可用於調整地圖可視區域。
|
NavigationMap |
getMap()
傳回可用來將內容新增至地圖的物件。
|
void |
onConfigurationChanged(配置設定)
|
查看 |
onCreateView(LayoutInflater inflater、ViewGroup 容器、Bundle savedInstanceState)
|
void | |
void | |
void |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(Bundle outState)
|
void |
onStart()
|
void |
onStop()
|
void |
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
在瀏覽期間覆寫延展型文字廣告摘要的預設顯示模式。
|
void | |
void |
setCompassEnabled(已啟用布林值)
設定是否顯示指南針。
|
void | |
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 | |
void |
setTrafficIncidentCardsEnabled(已啟用布林值)
設定是否要在使用者點選交通事件圖示時顯示交通事件資訊卡。
|
void |
setTrafficPromptsEnabled(已啟用布林值)
設定是否應顯示流量提示。
|
繼承方法摘要
公用建構函式
public SupportNavigationFragment ()
公用方法
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 支援入口網站提交案件,回報速限資料有誤。
參數
已啟用 |
---|
public void setSpeedometerIconEnabled (boolean enabled)
指定是否要顯示計速器圖示。只在 UI 執行緒上呼叫這個方法。
啟用後,系統會在導航期間的底部角落顯示計速器圖示,表示車輛速度。當顯示速限圖示顯示時,系統會附加此類圖示,然後計速計就可以根據速度嚴重性等級而有不同的文字和背景顏色。
啟用 Speedomter 圖示可完全啟用速限圖示,但您可以使用 setSpeedLimitIconEnabled(boolean)
單獨停用/啟用速限圖示
如果已啟用重新置中按鈕,則顯示重新置中按鈕時,計速器圖示會暫時隱藏。
參數
已啟用 |
---|
public void setSpeedometerUiOptions (SpeedometerUiOptions speedAlertUiOptions)
根據 SpeedAlertSeverity
設定計速器 UI 設定 SpeedometerUiOptions
。只在 UI 執行緒上呼叫這個方法。
設定 null
SpeedometerUiOptions
後,系統會清除先前的設定 (如有設定)。如未設定 SpeedometerUiOptions
,速度計使用者介面會改回使用 NavSDK 預設設定,以接收不同 SpeedAlertSeverity
的速度快訊:
參數
speedAlertUiOptions |
---|
public void setStylingOptions (StylingOptions styleOptions)
設定導覽 UI 的一些樣式選項。這個方法只能在 UI 執行緒上呼叫。
參數
stylingOptions |
---|
public void setTrafficIncidentCardsEnabled (boolean enabled)
設定是否要在使用者點選交通事件圖示時顯示交通事件資訊卡。這個方法只能在 UI 執行緒上呼叫。
參數
已啟用 |
---|
public void setTrafficPromptsEnabled (boolean enabled)
設定是否應顯示流量提示。系統會定期顯示路況提示,在導航期間更新使用者路況。這個方法只能在 UI 執行緒上呼叫。
參數
已啟用 |
---|