導覽檢視

公用類別 NavigationView 擴充 RelativeLayout

顯示導覽地圖的檢視畫面。

這個類別的使用者必須從含有此檢視區塊的 ActivityFragment,將所有生命週期方法,轉送至這個類別中的對應方法。具體來說,您必須轉送下列方法:

如果在父項 ActivityFragment 透過建立生命週期後新增 NavView,您必須手動呼叫 onCreate(Bundle)onStart()onResume(),才能正確初始化。同樣地,如果 NavView 從父項 ActivityFragment 卸離,則須手動呼叫 onPause()onStop()onDestroy(),以免資料外洩。

注意:建議您不要在這個檢視畫面中新增子項。

所有對 NavView 的呼叫都應在 UI 執行緒上執行。

巢狀類別摘要

NavigationView.OnNightModeChangedListener 事件監聽器介面,在 UI 進入或退出「夜間模式」時會收到通知。
NavigationView.OnRecenterButtonClickedListener 事件監聽器介面,會在按下最近按鈕按鈕時收到通知。

繼承常數摘要

繼承欄位摘要

公用建構函式摘要

NavigationView(情境環境)
NavigationView(情境結構定義、屬性集屬性)
NavigationView(情境結構定義、AttributeSet attrs、int defStyleAttr)

公用方法摘要

相機
getCamera()
傳回相機物件,可用於調整地圖可視區域。
NavigationMap
getMap()
傳回可用來將內容新增至地圖的物件。
void
onConfigurationChanged(配置設定)
void
onCreate(Bundle savedInstanceState)
void
void
void
void
onSaveInstanceState(Bundle outState)
void
void
onStop()
void
onTrimMemory(整數)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
在瀏覽期間覆寫延展型文字廣告摘要的預設顯示模式。
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride)
設定路線摘要的摘要資訊格式模式。
void
setCompassEnabled(已啟用布林值)
設定是否顯示指南針。
void
setCustomControl(檢視畫面控制項、CustomControlPosition 位置)
設定自訂控制項檢視畫面,顯示在導覽 UI 中的指定位置。
void
setEtaCardEnabled(已啟用布林值)
設定是否在導航期間顯示預計到達時間資訊卡。
void
setForceNightMode(int NightMode)
設定目前的 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(SpeedometerUiOptions SpeedometerUiOptions)
根據 SpeedAlertSeverity 設定計速器 UI 設定 SpeedometerUiOptions
void
setStylingOptions(StylingOptions styleOptions)
設定導覽 UI 的一些樣式選項。
void
setTrafficIncidentCardsEnabled(已啟用布林值)
設定是否要在使用者點選交通事件圖示時顯示交通事件資訊卡。
void
setTrafficPromptsEnabled(已啟用布林值)
設定是否應顯示流量提示。

繼承方法摘要

公用建構函式

公開 NavigationView (情境結構定義)

參數
context

public NavigationView (Context content, AttributeSet attrs)

參數
context
attrs

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

參數
context
attrs
defStyleAttr

公用方法

public 相機 getCamera ()

傳回相機物件,可用於調整地圖可視區域。這個方法只能在 UI 執行緒上呼叫。

傳回
  • 與這個檢視區塊相關聯的 Camera 物件

public NavigationMap getMap ()

傳回可用來將內容新增至地圖的物件。這個方法只能在 UI 執行緒上呼叫。

public void onConfigurationChanged (配置設定)

參數
config

public void onCreate (Bundle savedInstanceState)

參數
savedInstanceState

public void onDestroy ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

參數
outState

public void onStart ()

public void onStop ()

public void onTrimMemory (整數)

參數
level

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 NightMode)

設定目前的 ForceNightMode

參數
nightMode

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 的觸發門檻。

您可以使用這個方法,自訂 MINORMAJOR 快訊的速度快訊觸發門檻 (以百分比表示)。您也可以使用這個方法,設定將速度快訊從 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 SpeedometerUiOptions)

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

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

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

參數
speedometerUiOptions

public void setStylingOptions (StylingOptions styleOptions)

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

參數
stylingOptions

public void setTrafficIncidentCardsEnabled (boolean enabled)

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

請注意,導覽功能執行時,系統會在提示中顯示交通事件詳細資料。如要停用導航期間的交通事件詳細資料,請改用 setTrafficPromptsEnabled(boolean)

參數
已啟用

public void setTrafficPromptsEnabled (boolean enabled)

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

參數
已啟用