NavigationView

공개 클래스 NavigationView RelativeLayout 확장

탐색을 위해 지도를 표시하는 뷰입니다.

이 클래스의 사용자는 이 뷰가 포함된 Activity 또는 Fragment의 모든 수명 주기 메서드를 이 클래스의 상응하는 메서드에 전달해야 합니다. 특히 다음 메서드를 전달해야 합니다.

NavView가 상위 Activity 또는 Fragment의 생성 수명 주기를 거친 후 추가된 경우 onCreate(Bundle), onStart(), onResume()를 수동으로 호출하여 올바르게 초기화해야 합니다. 마찬가지로 NavView가 상위 Activity 또는 Fragment에서 분리된 경우 onPause(), onStop()onDestroy()를 수동으로 호출하여 누수를 방지해야 합니다.

참고: 이 보기에는 어린이를 추가하지 않는 것이 좋습니다.

NavView 호출은 모두 UI 스레드에서 실행해야 합니다.

중첩된 클래스 요약

인터페이스 NavigationView.OnNightModeChangedListener UI가 '야간 모드'로 전환되거나 '야간 모드'에서 나갈 때 알림을 받는 리스너의 인터페이스입니다.
인터페이스 NavigationView.OnRecenterButtonClickedListener 중심 재설정 버튼을 클릭하면 알림을 받는 리스너의 인터페이스입니다. 

상속받은 상수 요약

상속받은 필드 요약

공개 생성자 요약

NavigationView(컨텍스트 컨텍스트)
NavigationView(컨텍스트 컨텍스트, AttributeSet 속성)
NavigationView(Context context, AttributeSet attrs, int defStyleAttr)

공개 메서드 요약

카메라
getCamera()
지도의 표시 영역을 변경하는 데 사용할 수 있는 카메라 객체를 반환합니다.
NavigationMap
getMap()
지도에 콘텐츠를 추가하는 데 사용할 수 있는 객체를 반환합니다.
void
onConfigurationChanged(구성 구성)
void
onCreate(Bundle savedInstanceState)
void
void
void
void
onSaveInstanceState(번들 outState)
void
void
onStop()
void
onTrimMemory(int level)
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)
SpeedAlertSeverity의 트리거 기준을 맞춤설정하기 위해 SpeedAlertOptions를 설정합니다.
void
setSpeedLimitIconEnabled(불리언 사용 설정됨)
속도 제한 아이콘의 표시 여부를 지정합니다.
void
setSpeedometerIconEnabled(불리언 사용 설정됨)
속도계 아이콘의 표시 여부를 지정합니다.
void
setSpeedometerUiOptions(SpeedometerUiOptions speedometerUiOptions)를(를) 이용해 보세요.
SpeedAlertSeverity에 기반하여 속도계 UI 구성 SpeedometerUiOptions를 설정합니다.
void
setStylingOptions(StylingOptions stylingOptions)
탐색 UI의 스타일 지정 옵션을 설정합니다.
void
setTrafficIncidentCardsEnabled(불리언 사용 설정됨)
사용자가 교통사고 아이콘을 클릭할 때 교통사고 카드를 표시할지 여부를 설정합니다.
void
setTrafficPromptsEnabled(불리언 사용 설정됨)
교통정보 프롬프트 표시 여부를 설정합니다.

상속받은 메서드 요약

공개 생성자

공개 NavigationView (컨텍스트 컨텍스트)

매개변수
context

public NavigationView (Context context, AttributeSet attrs)

매개변수
context
attrs

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

매개변수
context
attrs
defStyleAttr

공개 메서드

공개 카메라 getCamera ()

지도의 표시 영역을 변경하는 데 사용할 수 있는 카메라 객체를 반환합니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

반환 값
  • 이 뷰와 연결된 Camera 객체

공개 NavigationMap getMap ()

지도에 콘텐츠를 추가하는 데 사용할 수 있는 객체를 반환합니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

public void onConfigurationChanged (구성 구성)

매개변수
config

공개 void onCreate (Bundle savedInstanceState)

매개변수
savedInstanceState

공개 void onDestroy ()

공개 void onPause ()

공개 void onResume ()

공개 void onSaveInstanceState (Bundle outState)

매개변수
outState

공개 void onStart ()

공개 void onStop ()

공개 void onTrimMemory (int level)

매개변수
레벨

public void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)

내비게이션 이용 중에 도착예정시간 콜아웃의 기본 표시 모드를 재정의합니다. null을 전달하면 기본 표시 모드가 재설정됩니다.

매개변수
calloutInfoDisplayModeOverride 표시할 수 있습니다

공개 void setCalloutInfoFormatOverride (RouteCalloutInfoFormat calloutInfoFormatOverride)

경로 콜아웃의 콜아웃 정보 형식 모드를 설정합니다. 이 메서드가 호출되지 않으면 콜아웃은 RouteKMLInfoFormat.DEFAULT에서 정의한 동작을 따릅니다.

매개변수
calloutInfoFormatOverride 새 콜아웃 형식입니다.

public void setCompassEnabled (boolean enabled)

나침반 표시 여부를 설정합니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

매개변수
사용 설정됨

public void setCustomControl (뷰 컨트롤, CustomControlPosition 위치)

탐색 UI의 지정된 위치에 표시될 맞춤 컨트롤 뷰를 설정합니다. 지정된 위치에 맞춤 컨트롤이 이미 있으면 대체됩니다. null 컨트롤 값을 사용하여 이 메서드를 호출하면 지정된 위치에서 맞춤 컨트롤이 삭제됩니다. 컨트롤이 이미 다른 위치에 추가되었거나 이미 상위 요소가 있는 경우에는 무시됩니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

매개변수
컨트롤 탐색 UI 내에 배치될 뷰
position 내장 컨트롤을 기준으로 UI에서 맞춤 컨트롤이 배치될 위치를 결정합니다.

공개 void setEtaCardEnabled (boolean enabled)

내비게이션 이용 중에 도착예정시간 카드를 표시할지 여부를 설정합니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

매개변수
사용 설정됨

공개 void setForceNightMode (intnightMode)

현재 ForceNightMode를 설정합니다.

매개변수
nightMode

공개 void setHeaderEnabled (boolean enabled)

내비게이션 중에 세부 경로 안내 탐색 헤더를 표시할지 설정합니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

매개변수
사용 설정됨

공개 void setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener 리스너)

현재 '야간 모드' 상태와 UI가 '야간 모드'로 전환되거나 '야간 모드'에서 나갈 때마다 알림을 받을 리스너를 설정합니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

참고: 메모리 누수를 방지하려면 리스너가 더 이상 필요하지 않을 때 setOnNightModeChangedListener(null)를 호출해야 합니다.

매개변수
리스너 UI가 야간 모드로 전환되거나 종료될 때 알림을 받는 리스너

공개 void setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener 리스너)

중심 재설정 버튼을 클릭하면 알림을 받을 리스너를 설정합니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

참고: 메모리 누수를 방지하려면 리스너가 더 이상 필요하지 않을 때 setOnRecenterButtonClickedListener(null)를 호출해야 합니다.

매개변수
리스너 중심 재설정 버튼이 클릭되면 알림을 받을 리스너

공개 void setRecenterButtonEnabled (boolean enabled)

다시 가운데로 버튼을 표시할지 여부를 설정합니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

매개변수
사용 설정됨

공개 void setSpeedAlertOptions (SpeedAlertOptions speedAlertOptions)

SpeedAlertSeverity의 트리거 기준을 맞춤설정하기 위해 SpeedAlertOptions를 설정합니다.

이 메서드를 사용하여 MINORMAJOR 알림의 속도 알림 트리거 기준을 백분율로 맞춤설정할 수 있습니다. 이 메서드를 사용하여 속도 알림을 MINOR에서 MAJOR로 업그레이드하는 데 필요한 시간(초)을 구성할 수도 있습니다.

null SpeedAlertOptions를 설정하거나 아무것도 설정하지 않으면 NavSDK의 기본 속도 알림이 표시됩니다. 속도 알림은 속도가 속도 제한을 초과하는 5mph 또는 10kph 미만일 때 흰색/어두운 배경에서 각각 흰색/어두운 배경에 빨간색 텍스트를 표시하고 5mph 또는 10kph를 초과하는 속도에서는 빨간색 배경에 흰색 텍스트를 표시합니다.

매개변수
speedAlertOptions

공개 void setSpeedLimitIconEnabled (boolean enabled)

속도 제한 아이콘의 표시 여부를 지정합니다. UI 스레드에서만 이 메서드를 호출합니다.

사용 설정하면 도로의 속도 제한을 나타내는 속도 제한 아이콘이 안내 중에 하단 시작 모서리에 표시됩니다. 이 아이콘은 신뢰할 수 있는 속도 제한 데이터를 사용할 수 있는 위치에서만 표시됩니다. 속도계 아이콘이 표시되면 연결된 것입니다.

가운데 맞춤 버튼이 사용 설정된 경우 중심 재설정 버튼이 표시될 때 속도 제한 아이콘이 일시적으로 숨겨집니다.

참고: 운전자는 도로에 게시된 모든 표지판을 따라야 하며 속도 제한 아이콘은 참고용으로만 사용해야 합니다. 제한 속도 데이터의 정확도는 보장되지 않습니다. 속도 제한 데이터의 부정확성은 Google Cloud 지원 포털에서 케이스를 접수하여 부정확성을 신고할 수 있습니다.

매개변수
사용 설정됨

공개 void setSpeedometerIconEnabled (boolean enabled)

속도계 아이콘의 표시 여부를 지정합니다. UI 스레드에서만 이 메서드를 호출합니다.

사용 설정하면 안내 중에 차량 속도를 나타내는 속도계 아이콘이 하단 시작 모서리에 표시됩니다. 속도 제한 아이콘이 표시되면 연결된 다음 속도계의 텍스트와 배경 색상이 속도계의 심각도에 따라 달라질 수 있습니다.

속도계 아이콘을 사용 설정하면 속도 제한 아이콘이 완전히 사용 설정됩니다. 그러나 setSpeedLimitIconEnabled(boolean)을 사용하여 속도 제한 아이콘을 별도로 사용 중지하거나 사용 설정할 수 있습니다.

가운데 맞춤 버튼이 사용 설정된 경우 중심 재설정 버튼이 표시될 때 속도계 아이콘이 일시적으로 숨겨집니다.

매개변수
사용 설정됨

공개 void setSpeedometerUiOptions (SpeedometerUiOptions speedometerUiOptions)

SpeedAlertSeverity에 기반하여 속도계 UI 구성 SpeedometerUiOptions를 설정합니다. UI 스레드에서만 이 메서드를 호출합니다.

null SpeedometerUiOptions를 설정하면 이전 항목이 삭제됩니다(설정된 경우). SpeedometerUiOptions가 구성되지 않은 경우 속도계 UI는 다양한 SpeedAlertSeverity의 속도 알림을 위해 NavSDK 기본 구성으로 대체됩니다.

  • 주간 모드에서 MINOR 속도 알림: 흰색 배경의 빨간색 텍스트
  • 야간 모드의 MINOR 속도 알림: 어두운 배경에 표시되는 빨간색 텍스트
  • 주간 모드에서 MAJOR 속도 알림: 빨간색 배경의 흰색 텍스트
  • 야간 모드에서 MAJOR 속도 알림: 빨간색 배경의 흰색 텍스트

매개변수
speedometerUiOptions

public void setStylingOptions (StylingOptions stylingOptions)

탐색 UI의 스타일 지정 옵션을 설정합니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

매개변수
stylingOptions

공개 void setTrafficIncidentCardsEnabled (boolean enabled)

사용자가 교통사고 아이콘을 클릭할 때 교통사고 카드를 표시할지 여부를 설정합니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

안내 내비게이션이 실행 중일 때는 교통사고 세부정보가 프롬프트에 표시됩니다. 내비게이션 중에 교통사고 세부정보를 사용 중지하려면 대신 setTrafficPromptsEnabled(boolean)를 사용해야 합니다.

매개변수
사용 설정됨

공개 void setTrafficPromptsEnabled (boolean enabled)

교통정보 프롬프트 표시 여부를 설정합니다. 교통정보 메시지는 내비게이션 중에 사용자에게 교통상황을 알려주기 위해 주기적으로 표시됩니다. 이 메서드는 UI 스레드에서만 호출해야 합니다.

매개변수
사용 설정됨