Package com.naver.maps.map
Class NaverMapOptions
- java.lang.Object
-
- com.naver.maps.map.NaverMapOptions
-
- All Implemented Interfaces:
android.os.Parcelable
public final class NaverMapOptions extends java.lang.Object implements android.os.Parcelable지도의 초기 옵션을 지정하는 클래스.MapFragment나MapView를 생성할 때 이 클래스의 인스턴스를 전달해 초깃값을 지정하는 것을 권장합니다. 지도 객체가 생성된 후에는 이 객체를 사용할 수 없고NaverMap의 메서드를 직접 호출해야 합니다.
-
-
Field Summary
Fields Modifier and Type Field Description static android.os.Parcelable.Creator<NaverMapOptions>CREATOR
-
Constructor Summary
Constructors Constructor Description NaverMapOptions()기본 생성자.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description NaverMapOptionsallGesturesEnabled(boolean enabled)모든 제스처의 활성화 상태를 일괄적으로 변경합니다.NaverMapOptionsbackgroundColor(int color)지도의 배경색을 지정합니다.NaverMapOptionsbackgroundResource(int resId)지도의 배경 리소스를 지정합니다.NaverMapOptionsbuildingHeight(float buildingHeight)건물의 3D 높이 배율을 지정합니다.NaverMapOptionscamera(CameraPosition cameraPosition)지도의 초기 카메라 위치를 지정합니다.NaverMapOptionscompassEnabled(boolean enabled)나침반을 활성화할지 여부를 지정합니다.NaverMapOptionscontentPadding(int left, int top, int right, int bottom)지도의 콘텐츠 패딩을 지정합니다.NaverMapOptionscustomStyleId(java.lang.String customStyleId)커스텀 스타일 ID를 지정합니다.NaverMapOptionsdefaultCameraAnimationDuration(int duration)카메라 이동 애니메이션의 기본 지속 시간을 지정합니다.intdescribeContents()NaverMapOptionsdisabledLayerGroups(java.lang.String... groups)비활성화할 레이어 그룹의 목록을 지정합니다.NaverMapOptionsenabledLayerGroups(java.lang.String... groups)활성화할 레이어 그룹의 목록을 지정합니다.booleanequals(java.lang.Object o)NaverMapOptionsextent(LatLngBounds extent)지도의 제한 영역을 지정합니다.NaverMapOptionsfpsLimit(int fps)지도의 최대 초당 프레임 수(FPS, frames per second)를 지정합니다.intgetBackgroundColor()지도의 배경색을 지정합니다.intgetBackgroundResource()지도의 배경 리소스를 반환합니다.floatgetBuildingHeight()건물의 3D 높이 배율을 반환합니다.CameraPositiongetCameraPosition()지도의 초기 카메라 위치를 반환합니다.int[]getContentPadding()지도의 콘텐츠 패딩을 배열로 반환합니다.java.lang.StringgetCustomStyleId()커스텀 스타일 ID를 반환합니다.intgetDefaultCameraAnimationDuration()카메라 이동 애니메이션의 기본 지속 시간을 반환합니다.java.util.Set<java.lang.String>getEnabledLayerGroups()활성화할 레이어 그룹의 집합을 반환합니다.LatLngBoundsgetExtent()지도의 제한 영역을 반환합니다.intgetFpsLimit()지도의 최대 초당 프레임 수(FPS, frames per second)를 반환합니다.intgetIndoorFocusRadius()실내지도 영역의 포커스 유지 반경을 반환합니다.floatgetLightness()배경의 명도 계수를 반환합니다.java.util.LocalegetLocale()지도의 로캘을 반환합니다.intgetLogoGravity()네이버 로고의 그래비티를 반환합니다.int[]getLogoMargin()네이버 로고의 마진을 배열로 반환합니다.NaverMap.MapTypegetMapType()지도의 유형을 반환합니다.doublegetMaxTilt()지도의 최대 기울기 각도를 반환합니다.doublegetMaxZoom()지도의 최대 줌 레벨을 반환합니다.doublegetMinZoom()지도의 최소 줌 레벨을 반환합니다.intgetPickTolerance()지도 클릭 시 피킹되는Pickable의 클릭 허용 반경을 지정합니다.floatgetRotateGesturesFriction()회전 제스처의 마찰 계수를0~1로 반환합니다.floatgetScrollGesturesFriction()스크롤 제스처의 마찰 계수를0~1로 반환합니다.floatgetSymbolPerspectiveRatio()지도를 기울일 때 적용되는 심벌의 원근 계수를 반환합니다.floatgetSymbolScale()심벌의 크기 배율을 반환합니다.floatgetZoomGesturesFriction()줌 제스처의 마찰 계수를0~1로 반환합니다.inthashCode()NaverMapOptionsindoorEnabled(boolean enabled)실내지도를 활성화할지 여부를 지정합니다.NaverMapOptionsindoorFocusRadius(int radius)실내지도 영역의 포커스 유지 반경을 지정합니다.NaverMapOptionsindoorLevelPickerEnabled(boolean enabled)실내지도 층 피커를 활성화할지 여부를 지정합니다.booleanisCompassEnabled()나침반을 활성화할지 여부를 반환합니다.booleanisIndoorEnabled()실내지도를 활성화할지 여부를 반환합니다.booleanisIndoorLevelPickerEnabled()실내지도 층 피커를 활성화할지 여부를 반환합니다.booleanisLiteModeEnabled()라이트 모드를 활성화할지 여부를 반환합니다.booleanisLocationButtonEnabled()현위치 버튼을 활성화할지 여부를 반환합니다.booleanisLogoClickEnabled()네이버 로고 클릭을 활성화할지 여부를 반환합니다.booleanisMsaaEnabled()4x MSAA를 적용할지 여부를 반환합니다.booleanisNightModeEnabled()야간 모드를 활성화할지 여부를 반환합니다.booleanisPreserveEGLContextOnPause()GLSurfaceView의preserveEGLContextOnPause를 활성화할지 여부를 반환합니다.booleanisRotateGesturesEnabled()회전 제스처를 활성화할지 여부를 반환합니다.booleanisScaleBarEnabled()축척 바를 활성화할지 여부를 반환합니다.booleanisScrollGesturesEnabled()스크롤 제스처를 활성화할지 여부를 반환합니다.booleanisStopGesturesEnabled()스톱 제스처를 활성화할지 여부를 반환합니다.booleanisTiltGesturesEnabled()틸트 제스처를 활성화할지 여부를 반환합니다.booleanisTranslucentTextureSurface()TextureView를 투명하게 만들지 여부를 지정합니다.booleanisUseTextureView()지도 렌더링을 위해GLSurfaceView대신TextureView를 사용할지 여부를 반환합니다.booleanisZoomControlEnabled()줌 컨트롤을 활성화할지 여부를 반환합니다.booleanisZoomGesturesEnabled()줌 제스처를 활성화할지 여부를 반환합니다.booleanisZOrderMediaOverlay()GLSurfaceView의zOrderMediaOverlay를 활성화할지 여부를 반환합니다.NaverMapOptionslightness(float lightness)배경의 명도 계수를 지정합니다.NaverMapOptionsliteModeEnabled(boolean enabled)라이트 모드를 활성화할지 여부를 지정합니다.NaverMapOptionslocale(java.util.Locale locale)지도의 로캘을 지정합니다.NaverMapOptionslocationButtonEnabled(boolean enabled)현위치 버튼을 활성화할지 여부를 지정합니다.NaverMapOptionslogoClickEnabled(boolean enabled)네이버 로고 클릭을 활성화할지 여부를 지정합니다.NaverMapOptionslogoGravity(int gravity)네이버 로고의 그래비티를 지정합니다.NaverMapOptionslogoMargin(int start, int top, int end, int bottom)네이버 로고의 마진을 지정합니다.NaverMapOptionsmapType(NaverMap.MapType mapType)지도의 유형을 지정합니다.NaverMapOptionsmaxTilt(double maxTilt)지도의 최대 기울기 각도를 지정합니다.NaverMapOptionsmaxZoom(double maxZoom)지도의 최대 줌 레벨을 지정합니다.NaverMapOptionsminZoom(double minZoom)지도의 최소 줌 레벨을 지정합니다.NaverMapOptionsmsaaEnabled(boolean enabled)4x MSAA를 적용할지 여부를 지정합니다.NaverMapOptionsnightModeEnabled(boolean enabled)야간 모드를 활성화할지 여부를 지정합니다.NaverMapOptionspickTolerance(int tolerance)지도 클릭 시 피킹되는Pickable의 클릭 허용 반경을 지정합니다.NaverMapOptionspreserveEGLContextOnPause(boolean enabled)GLSurfaceView의preserveEGLContextOnPause를 활성화할지 여부를 지정합니다.NaverMapOptionsrotateGesturesEnabled(boolean enabled)회전 제스처를 활성화할지 여부를 지정합니다.NaverMapOptionsrotateGesturesFriction(float friction)회전 제스처의 마찰 계수를0~1로 지정합니다.NaverMapOptionsscaleBarEnabled(boolean enabled)축척 바를 활성화할지 여부를 지정합니다.NaverMapOptionsscrollGesturesEnabled(boolean enabled)스크롤 제스처를 활성화할지 여부를 지정합니다.NaverMapOptionsscrollGesturesFriction(float friction)스크롤 제스처의 마찰 계수를0~1로 지정합니다.NaverMapOptionsstopGesturesEnabled(boolean enabled)스톱 제스처를 활성화할지 여부를 지정합니다.NaverMapOptionssymbolPerspectiveRatio(float ratio)지도를 기울일 때 적용되는 심벌의 원근 계수를 지정합니다.NaverMapOptionssymbolScale(float scale)심벌의 크기 배율을 지정합니다.NaverMapOptionstiltGesturesEnabled(boolean enabled)틸트 제스처를 활성화할지 여부를 지정합니다.NaverMapOptionstranslucentTextureSurface(boolean translucentTextureSurface)TextureView를 투명하게 만들지 여부를 지정합니다.NaverMapOptionsuseTextureView(boolean useTextureView)지도 렌더링을 위해GLSurfaceView대신TextureView를 사용할지 여부를 지정합니다.voidwriteToParcel(android.os.Parcel dest, int flags)NaverMapOptionszoomControlEnabled(boolean enabled)줌 컨트롤을 활성화할지 여부를 지정합니다.NaverMapOptionszoomGesturesEnabled(boolean enabled)줌 제스처를 활성화할지 여부를 지정합니다.NaverMapOptionszoomGesturesFriction(float friction)줌 제스처의 마찰 계수를0~1로 지정합니다.NaverMapOptionszOrderMediaOverlay(boolean enabled)GLSurfaceView의zOrderMediaOverlay를 활성화할지 여부를 지정합니다.
-
-
-
Field Detail
-
CREATOR
public static final android.os.Parcelable.Creator<NaverMapOptions> CREATOR
-
-
Method Detail
-
customStyleId
@NonNull public NaverMapOptions customStyleId(@Nullable java.lang.String customStyleId)
커스텀 스타일 ID를 지정합니다.
기본값은 커스텀 스타일을 사용하지 않음을 의미하는null입니다.- Parameters:
customStyleId- 커스텀 스타일 ID.null일 경우 커스텀 스타일을 사용하지 않음.- Returns:
- 객체 자신.
-
locale
@NonNull public NaverMapOptions locale(@Nullable java.util.Locale locale)
지도의 로캘을 지정합니다.
기본값은 시스템 로캘을 의미하는null입니다.- Parameters:
locale- 로캘.null일 경우 시스템 로캘 사용.- Returns:
- 객체 자신.
-
camera
@NonNull public NaverMapOptions camera(@Nullable CameraPosition cameraPosition)
- Parameters:
cameraPosition- 카메라 위치.null일 경우NaverMap.DEFAULT_CAMERA_POSITION.- Returns:
- 객체 자신.
-
extent
@NonNull public NaverMapOptions extent(@Nullable LatLngBounds extent)
지도의 제한 영역을 지정합니다.
기본값은 제한이 없음을 의미하는null입니다.- Parameters:
extent- 제한 영역. 제한을 두지 않을 경우null.- Returns:
- 객체 자신.
-
minZoom
@NonNull public NaverMapOptions minZoom(@FloatRange(from=0.0,to=21.0) double minZoom)
- Parameters:
minZoom- 최소 줌 레벨.- Returns:
- 객체 자신.
-
maxZoom
@NonNull public NaverMapOptions maxZoom(@FloatRange(from=0.0,to=21.0) double maxZoom)
- Parameters:
maxZoom- 최대 줌 레벨.- Returns:
- 객체 자신.
-
maxTilt
@NonNull public NaverMapOptions maxTilt(@FloatRange(from=0.0,to=63.0) double maxTilt)
- Parameters:
maxTilt- 최대 기울기 각도.- Returns:
- 객체 자신.
-
contentPadding
@NonNull public NaverMapOptions contentPadding(@Px int left, @Px int top, @Px int right, @Px int bottom)
지도의 콘텐츠 패딩을 지정합니다.
기본값은 모두0입니다.- Parameters:
left- 왼쪽 패딩. 픽셀 단위.top- 위쪽 패딩. 픽셀 단위.right- 오른쪽 패딩. 픽셀 단위.bottom- 아래쪽 패딩. 픽셀 단위.- Returns:
- 객체 자신.
-
defaultCameraAnimationDuration
@NonNull public NaverMapOptions defaultCameraAnimationDuration(@IntRange(from=0L) int duration)
- Parameters:
duration- 카메라 이동 애니메이션의 기본 지속 시간. 밀리초 단위.- Returns:
- 객체 자신.
-
mapType
@NonNull public NaverMapOptions mapType(@NonNull NaverMap.MapType mapType)
- Parameters:
mapType- 지도 유형.- Returns:
- 객체 자신.
-
enabledLayerGroups
@NonNull public NaverMapOptions enabledLayerGroups(@NonNull java.lang.String... groups)
활성화할 레이어 그룹의 목록을 지정합니다.- Parameters:
groups- 활성화할 레이어 그룹의 목록.- Returns:
- 객체 자신.
-
disabledLayerGroups
@NonNull public NaverMapOptions disabledLayerGroups(@NonNull java.lang.String... groups)
비활성화할 레이어 그룹의 목록을 지정합니다.- Parameters:
groups- 비활성화할 레이어 그룹의 목록.- Returns:
- 객체 자신.
-
liteModeEnabled
@NonNull public NaverMapOptions liteModeEnabled(boolean enabled)
라이트 모드를 활성화할지 여부를 지정합니다. 라이트 모드가 활성화되면 지도의 로딩이 빨라지고 메모리 소모가 감소합니다. 그러나 다음과 같은 제약이 생깁니다.- 지도의 전반적인 화질이 하락합니다.
- 카메라가 회전하거나 기울어지면 지도 심벌도 함께 회전하거나 기울어집니다.
- 줌 레벨이 커지거나 작아지면 지도 심벌도 일정 정도 함께 커지거나 작아집니다.
NaverMap.MapType.Navi지도 유형을 사용할 수 없습니다.enabledLayerGroups(String...),indoorEnabled(boolean),nightModeEnabled(boolean),lightness(float),buildingHeight(float),symbolScale(float),symbolPerspectiveRatio(float)가 동작하지 않습니다.NaverMap.OnSymbolClickListener.onSymbolClick(Symbol)이 호출되지 않습니다.Marker.setHideCollidedSymbols(boolean)가 동작하지 않습니다.
false입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
nightModeEnabled
@NonNull public NaverMapOptions nightModeEnabled(boolean enabled)
야간 모드를 활성화할지 여부를 지정합니다. 야간 모드가 활성화되면 지도 스타일이 어둡게 바뀝니다. 지도 유형이 야간 모드를 지원하지 않으면 활성화하더라도 아무 변화가 일어나지 않습니다.
기본값은false입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
buildingHeight
@NonNull public NaverMapOptions buildingHeight(@FloatRange(from=0.0,to=1.0) float buildingHeight)
건물의 3D 높이 배율을 지정합니다. 배율이0일 경우 지도를 기울이더라도 건물이 2D로 나타납니다.
기본값은1입니다.- Parameters:
buildingHeight- 건물의 3D 높이 배율.0~1범위.- Returns:
- 객체 자신.
-
lightness
@NonNull public NaverMapOptions lightness(@FloatRange(from=-1.0,to=1.0) float lightness)
배경의 명도 계수를 지정합니다. 계수가-1일 경우 명도 최소치인 검정색으로,1일 경우 명도 최대치인 흰색으로 표시됩니다. 오버레이에는 적용되지 않습니다.
기본값은0입니다.- Parameters:
lightness- 배경의 명도 계수.-1~1범위.- Returns:
- 객체 자신.
-
symbolScale
@NonNull public NaverMapOptions symbolScale(@FloatRange(from=0.0,to=2.0) float scale)
심벌의 크기 배율을 지정합니다. 배율이0.5일 경우 절반,2일 경우 두 배의 크기로 표시됩니다.
기본값은1입니다.- Parameters:
scale- 심벌의 크기 배율.0~2범위.- Returns:
- 객체 자신.
-
symbolPerspectiveRatio
@NonNull public NaverMapOptions symbolPerspectiveRatio(@FloatRange(from=0.0,to=1.0) float ratio)
지도를 기울일 때 적용되는 심벌의 원근 계수를 지정합니다. 계수가1일 경우 배경 지도와 동일한 비율로 멀리 있는 심벌은 작아지고 가까이 있는 심벌은 커지며,0에 가까울수록 원근 효과가 감소합니다.
기본값은1입니다.- Parameters:
ratio- 심벌의 원근 계수.0~1범위.- Returns:
- 객체 자신.
-
indoorEnabled
@NonNull public NaverMapOptions indoorEnabled(boolean enabled)
실내지도를 활성화할지 여부를 지정합니다. 활성화하면 카메라가 일정 이상 확대되고 실내지도가 있는 영역에 포커스될 경우 자동으로 해당 영역의 실내지도가 나타납니다.
기본값은false입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
indoorFocusRadius
@NonNull public NaverMapOptions indoorFocusRadius(@Px int radius)
실내지도 영역의 포커스 유지 반경을 지정합니다. 지정할 경우 카메라의 위치가 포커스 유지 반경을 완전히 벗어날 때까지 영역에 대한 포커스가 유지됩니다.
기본값은NaverMap.DEFAULT_INDOOR_FOCUS_RADIUS_DP를 픽셀로 환산한 값을 의미하는-1입니다.- Parameters:
radius- 실내지도 영역 포커스 유지 반경. 픽셀 단위.- Returns:
- 객체 자신.
-
backgroundColor
@NonNull public NaverMapOptions backgroundColor(@ColorInt int color)
지도의 배경색을 지정합니다. 배경은 해당 지역의 지도 데이터가 없거나 로딩 중일 때 나타납니다.
기본값은NaverMap.DEFAULT_BACKGROUND_COLOR_LIGHT입니다.- Parameters:
color- 배경색.- Returns:
- 객체 자신.
- See Also:
backgroundResource(int)
-
backgroundResource
@NonNull public NaverMapOptions backgroundResource(@DrawableRes int resId)
지도의 배경 리소스를 지정합니다. 배경은 해당 지역의 지도 데이터가 없거나 로딩 중일 때 나타납니다.resId가 올바르지 않을 경우backgroundColor(int)를 이용해 지정된 배경색이 사용됩니다.
기본값은NaverMap.DEFAULT_BACKGROUND_DRWABLE_LIGHT입니다.- Parameters:
resId- 배경 리소스의 ID.- Returns:
- 객체 자신.
- See Also:
backgroundColor(int)
-
pickTolerance
@NonNull public NaverMapOptions pickTolerance(@Px int tolerance)
지도 클릭 시 피킹되는Pickable의 클릭 허용 반경을 지정합니다. 사용자가 지도를 클릭했을 때, 클릭된 지점이Pickable의 영역 내에 존재하지 않더라도 허용 반경 내에 있다면 해당 요소가 클릭된 것으로 간주됩니다.
기본값은NaverMap.DEFAULT_PICK_TOLERANCE_DP를 픽셀로 환산한 값을 의미하는-1입니다.- Parameters:
tolerance- 클릭 시 피킹 허용 반경. 픽셀 단위.- Returns:
- 객체 자신.
-
scrollGesturesEnabled
@NonNull public NaverMapOptions scrollGesturesEnabled(boolean enabled)
스크롤 제스처를 활성화할지 여부를 지정합니다. 활성화하면 지도를 스와이프해 카메라의 좌표를 변경할 수 있습니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
zoomGesturesEnabled
@NonNull public NaverMapOptions zoomGesturesEnabled(boolean enabled)
줌 제스처를 활성화할지 여부를 지정합니다. 활성화하면 지도를 더블 탭, 두 손가락 탭, 핀치해 카메라의 줌 레벨을 변경할 수 있습니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
tiltGesturesEnabled
@NonNull public NaverMapOptions tiltGesturesEnabled(boolean enabled)
틸트 제스처를 활성화할지 여부를 지정합니다. 활성화하면 지도를 두 손가락으로 세로로 스와이프해 카메라의 기울기 각도를 변경할 수 있습니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
rotateGesturesEnabled
@NonNull public NaverMapOptions rotateGesturesEnabled(boolean enabled)
회전 제스처를 활성화할지 여부를 지정합니다. 활성화하면 두 손가락으로 지도를 돌려 카메라의 베어링 각도를 변경할 수 있습니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
stopGesturesEnabled
@NonNull public NaverMapOptions stopGesturesEnabled(boolean enabled)
스톱 제스처를 활성화할지 여부를 지정합니다. 활성화하면 지도 애니메이션 진행 중 탭으로 지도 애니메이션을 중지할 수 있습니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
allGesturesEnabled
@NonNull public NaverMapOptions allGesturesEnabled(boolean enabled)
모든 제스처의 활성화 상태를 일괄적으로 변경합니다.- Parameters:
enabled- 모두 활성화할 경우true, 모두 비활성화할 경우false.- Returns:
- 객체 자신.
- See Also:
zoomGesturesEnabled(boolean),scrollGesturesEnabled(boolean),rotateGesturesEnabled(boolean),tiltGesturesEnabled(boolean),stopGesturesEnabled(boolean)
-
scrollGesturesFriction
@NonNull public NaverMapOptions scrollGesturesFriction(@FloatRange(from=0.0,to=1.0) float friction)
- Parameters:
friction- 마찰 계수.- Returns:
- 객체 자신.
-
zoomGesturesFriction
@NonNull public NaverMapOptions zoomGesturesFriction(@FloatRange(from=0.0,to=1.0) float friction)
- Parameters:
friction- 마찰 계수.- Returns:
- 객체 자신.
-
rotateGesturesFriction
@NonNull public NaverMapOptions rotateGesturesFriction(@FloatRange(from=0.0,to=1.0) float friction)
- Parameters:
friction- 마찰 계수.- Returns:
- 객체 자신.
-
compassEnabled
@NonNull public NaverMapOptions compassEnabled(boolean enabled)
나침반을 활성화할지 여부를 지정합니다. 활성화하면 나침반이 노출됩니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
scaleBarEnabled
@NonNull public NaverMapOptions scaleBarEnabled(boolean enabled)
축척 바를 활성화할지 여부를 지정합니다. 활성화하면 축척 바가 노출됩니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
zoomControlEnabled
@NonNull public NaverMapOptions zoomControlEnabled(boolean enabled)
줌 컨트롤을 활성화할지 여부를 지정합니다. 활성화하면 줌 컨트롤이 노출됩니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
indoorLevelPickerEnabled
@NonNull public NaverMapOptions indoorLevelPickerEnabled(boolean enabled)
실내지도 층 피커를 활성화할지 여부를 지정합니다. 활성화하면 실내지도 패널이 노출됩니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
locationButtonEnabled
@NonNull public NaverMapOptions locationButtonEnabled(boolean enabled)
현위치 버튼을 활성화할지 여부를 지정합니다. 활성화하면 현위치 버튼이 노출됩니다.
기본값은false입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
logoClickEnabled
@NonNull public NaverMapOptions logoClickEnabled(boolean enabled)
네이버 로고 클릭을 활성화할지 여부를 지정합니다. 활성화하면 네이버 로고 클릭시 범례, 법적 공지, 오픈소스 라이선스를 보여주는 다이얼로그가 열립니다.
이 옵션을false로 지정하는 앱은 반드시 앱 내에 네이버 지도 SDK의 법적 공지 액티비티(LegalNoticeActivity) 및 오픈소스 라이선스 액티비티(OpenSourceLicenseActivity)로 연결되는 메뉴를 만들어야 합니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
logoGravity
@NonNull public NaverMapOptions logoGravity(int gravity)
네이버 로고의 그래비티를 지정합니다.
기본값은 지정하지 않음을 의미하는Gravity.NO_GRAVITY입니다.- Parameters:
gravity- 그래비티.- Returns:
- 객체 자신.
- See Also:
Gravity
-
logoMargin
@NonNull public NaverMapOptions logoMargin(@Px int start, @Px int top, @Px int end, @Px int bottom)
네이버 로고의 마진을 지정합니다.- Parameters:
start- 왼쪽 마진. 픽셀 단위.top- 위쪽 마진. 픽셀 단위.end- 오른쪽 마진. 픽셀 단위.bottom- 아래쪽 마진. 픽셀 단위.- Returns:
- 객체 자신.
-
fpsLimit
@NonNull public NaverMapOptions fpsLimit(@IntRange(from=0L) int fps)
지도의 최대 초당 프레임 수(FPS, frames per second)를 지정합니다.
기본값은 제한을 두지 않음을 의미하는0입니다.- Parameters:
fps- 최대 초당 프레임 수.- Returns:
- 객체 자신.
-
useTextureView
@NonNull public NaverMapOptions useTextureView(boolean useTextureView)
지도 렌더링을 위해GLSurfaceView대신TextureView를 사용할지 여부를 지정합니다.
기본값은false입니다.- Parameters:
useTextureView-TextureView를 사용할 경우true,GLSurfaceView를 사용할 경우false.- Returns:
- 객체 자신.
-
msaaEnabled
@NonNull public NaverMapOptions msaaEnabled(boolean enabled)
4x MSAA를 적용할지 여부를 지정합니다. 디바이스가 4x MSAA를 지원하지 않으면 무시됩니다.
기본값은false입니다.- Parameters:
enabled- 적용할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
translucentTextureSurface
@NonNull public NaverMapOptions translucentTextureSurface(boolean translucentTextureSurface)
TextureView를 투명하게 만들지 여부를 지정합니다.TextureView를 사용하지 않고GLSurfaceView를 사용하는 경우에는 무시됩니다.
기본값은false입니다.- Parameters:
translucentTextureSurface- 투명하게 만들 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
zOrderMediaOverlay
@NonNull public NaverMapOptions zOrderMediaOverlay(boolean enabled)
GLSurfaceView의zOrderMediaOverlay를 활성화할지 여부를 지정합니다.GLSurfaceView를 사용하지 않고TextureView를 사용하는 경우에는 무시됩니다.
기본값은false입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
preserveEGLContextOnPause
@NonNull public NaverMapOptions preserveEGLContextOnPause(boolean enabled)
GLSurfaceView의preserveEGLContextOnPause를 활성화할지 여부를 지정합니다.GLSurfaceView를 사용하지 않고TextureView를 사용하는 경우에는 무시됩니다.
기본값은true입니다.- Parameters:
enabled- 활성화할 경우true, 그렇지 않을 경우false.- Returns:
- 객체 자신.
-
getCustomStyleId
@Nullable public java.lang.String getCustomStyleId()
커스텀 스타일 ID를 반환합니다.
기본값은 커스텀 스타일을 사용하지 않음을 의미하는null입니다.- Returns:
- 커스텀 스타일 ID.
null일 경우 커스텀 스타일을 사용하지 않음.
-
getLocale
@Nullable public java.util.Locale getLocale()
지도의 로캘을 반환합니다.
기본값은 시스템 로캘을 의미하는null입니다.- Returns:
- 로캘.
null일 경우 시스템 로캘 사용.
-
getCameraPosition
@Nullable public CameraPosition getCameraPosition()
- Returns:
- 카메라 위치.
null일 경우NaverMap.DEFAULT_CAMERA_POSITION.
-
getExtent
@Nullable public LatLngBounds getExtent()
지도의 제한 영역을 반환합니다.
기본값은 제한이 없음을 의미하는null입니다.- Returns:
- 제한 영역. 제한을 두지 않을 경우
null.
-
getMinZoom
@FloatRange(from=0.0, to=21.0) public double getMinZoom()- Returns:
- 최소 줌 레벨.
-
getMaxZoom
@FloatRange(from=0.0, to=21.0) public double getMaxZoom()- Returns:
- 최대 줌 레벨.
-
getMaxTilt
@FloatRange(from=0.0, to=63.0) public double getMaxTilt()- Returns:
- 최대 기울기 각도.
-
getContentPadding
@NonNull @Size(4L) public int[] getContentPadding()
지도의 콘텐츠 패딩을 배열로 반환합니다. 배열의 크기는4이며, 각 원소는 순서대로 왼쪽, 위쪽, 오른쪽, 아래쪽 패딩을 나타냅니다.
기본값은 모두0입니다.- Returns:
- 패딩 배열. 각 원소는 픽셀 단위.
-
getDefaultCameraAnimationDuration
@IntRange(from=0L) public int getDefaultCameraAnimationDuration()
- Returns:
- 카메라 이동 애니메이션의 기본 지속 시간. 밀리초 단위.
-
getMapType
@NonNull public NaverMap.MapType getMapType()
- Returns:
- 지도 유형.
-
getEnabledLayerGroups
@NonNull public java.util.Set<java.lang.String> getEnabledLayerGroups()
활성화할 레이어 그룹의 집합을 반환합니다.- Returns:
- 활성화할 레이어 그룹의 집합.
-
isLiteModeEnabled
public boolean isLiteModeEnabled()
라이트 모드를 활성화할지 여부를 반환합니다. 라이트 모드가 활성화되면 지도의 로딩이 빨라지고 메모리 소모가 감소합니다. 그러나 다음과 같은 제약이 생깁니다.- 지도의 전반적인 화질이 하락합니다.
- 카메라가 회전하거나 기울어지면 지도 심벌도 함께 회전하거나 기울어집니다.
- 줌 레벨이 커지거나 작아지면 지도 심벌도 일정 정도 함께 커지거나 작아집니다.
NaverMap.MapType.Navi지도 유형을 사용할 수 없습니다.enabledLayerGroups(String...),indoorEnabled(boolean),nightModeEnabled(boolean),lightness(float),buildingHeight(float),symbolScale(float),symbolPerspectiveRatio(float)가 동작하지 않습니다.NaverMap.OnSymbolClickListener.onSymbolClick(Symbol)이 호출되지 않습니다.Marker.setHideCollidedSymbols(boolean)가 동작하지 않습니다.
false입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isNightModeEnabled
public boolean isNightModeEnabled()
야간 모드를 활성화할지 여부를 반환합니다. 야간 모드가 활성화되면 지도 스타일이 어둡게 바뀝니다. 지도 유형이 야간 모드를 지원하지 않으면 활성화하더라도 아무 변화가 일어나지 않습니다.
기본값은false입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
getBuildingHeight
@FloatRange(from=0.0, to=1.0) public float getBuildingHeight()건물의 3D 높이 배율을 반환합니다. 배율이0일 경우 지도를 틸트하더라도 건물이 2D로 나타납니다.
기본값은1입니다.- Returns:
- 건물의 3D 높이 배율.
0~1범위.
-
getLightness
@FloatRange(from=-1.0, to=1.0) public float getLightness()배경의 명도 계수를 반환합니다. 계수가-1일 경우 명도 최소치인 검정색으로,1일 경우 명도 최대치인 흰색으로 표시됩니다. 오버레이에는 적용되지 않습니다.
기본값은0입니다.- Returns:
- 배경의 명도 계수.
-1~1범위.
-
getSymbolScale
@FloatRange(from=0.0, to=2.0) public float getSymbolScale()심벌의 크기 배율을 반환합니다. 배율이0.5일 경우 절반,2일 경우 두 배의 크기로 표시됩니다.
기본값은1입니다.- Returns:
- 심벌의 크기 배율.
0~2범위.
-
getSymbolPerspectiveRatio
@FloatRange(from=0.0, to=1.0) public float getSymbolPerspectiveRatio()지도를 기울일 때 적용되는 심벌의 원근 계수를 반환합니다. 계수가1일 경우 배경 지도와 동일한 비율로 멀리 있는 심벌은 작아지고 가까이 있는 심벌은 커지며,0에 가까울수록 원근 효과가 감소합니다.
기본값은1입니다.- Returns:
- 심벌의 원근 계수.
0~1범위.
-
isIndoorEnabled
public boolean isIndoorEnabled()
실내지도를 활성화할지 여부를 반환합니다. 활성화하면 카메라가 일정 이상 확대되고 실내지도가 있는 영역에 포커스될 경우 자동으로 해당 영역의 실내지도가 나타납니다.
기본값은false입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
getIndoorFocusRadius
public int getIndoorFocusRadius()
실내지도 영역의 포커스 유지 반경을 반환합니다. 지정할 경우 카메라의 위치가 포커스 유지 반경을 완전히 벗어날 때까지 영역에 대한 포커스가 유지됩니다.
기본값은NaverMap.DEFAULT_INDOOR_FOCUS_RADIUS_DP를 픽셀로 환산한 값을 의미하는-1입니다.- Returns:
- 실내지도 영역 포커스 유지 반경. 픽셀 단위.
-
getBackgroundColor
@ColorInt public int getBackgroundColor()
지도의 배경색을 지정합니다. 배경은 해당 지역의 지도 데이터가 없거나 로딩 중일 때 나타납니다. 만약backgroundResource(int)를 통해 올바른 배경 리소스가 지정되었을 경우 이 값은 무시됩니다.
기본값은Color.LTGRAY입니다.- Returns:
- 배경색.
-
getBackgroundResource
@DrawableRes public int getBackgroundResource()
지도의 배경 리소스를 반환합니다. 배경은 해당 지역의 지도 데이터가 없거나 로딩 중일 때 나타납니다. 만약 배경 리소스가 올바르지 않은 경우backgroundColor(int)를 통해 지정된 배경색이 사용됩니다.- Returns:
- 배경 리소스의 ID.
-
getPickTolerance
@Px public int getPickTolerance()
지도 클릭 시 피킹되는Pickable의 클릭 허용 반경을 지정합니다. 사용자가 지도를 클릭했을 때, 클릭된 지점이Pickable의 영역 내에 존재하지 않더라도 허용 반경 내에 있다면 해당 요소가 클릭된 것으로 간주됩니다.
기본값은NaverMap.DEFAULT_PICK_TOLERANCE_DP를 픽셀로 환산한 값을 의미하는-1입니다.- Returns:
- 클릭 시 피킹 허용 반경. 픽셀 단위.
-
isScrollGesturesEnabled
public boolean isScrollGesturesEnabled()
스크롤 제스처를 활성화할지 여부를 반환합니다. 활성화하면 지도를 스와이프해 카메라의 좌표를 변경할 수 있습니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isZoomGesturesEnabled
public boolean isZoomGesturesEnabled()
줌 제스처를 활성화할지 여부를 반환합니다. 활성화하면 지도를 더블 탭, 두 손가락 탭, 핀치해 카메라의 줌 레벨을 변경할 수 있습니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isTiltGesturesEnabled
public boolean isTiltGesturesEnabled()
틸트 제스처를 활성화할지 여부를 반환합니다. 활성화하면 지도를 두 손가락으로 세로로 스와이프해 카메라의 기울기 각도를 변경할 수 있습니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isRotateGesturesEnabled
public boolean isRotateGesturesEnabled()
회전 제스처를 활성화할지 여부를 반환합니다. 활성화하면 두 손가락으로 지도를 돌려 카메라의 베어링 각도를 변경할 수 있습니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isStopGesturesEnabled
public boolean isStopGesturesEnabled()
스톱 제스처를 활성화할지 여부를 반환합니다. 활성화하면 지도 애니메이션 진행 중 탭으로 지도 애니메이션을 중지할 수 있습니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
getScrollGesturesFriction
@FloatRange(from=0.0, to=1.0) public float getScrollGesturesFriction()- Returns:
- 마찰 계수.
-
getZoomGesturesFriction
@FloatRange(from=0.0, to=1.0) public float getZoomGesturesFriction()- Returns:
- 마찰 계수.
-
getRotateGesturesFriction
@FloatRange(from=0.0, to=1.0) public float getRotateGesturesFriction()- Returns:
- 마찰 계수.
-
isCompassEnabled
public boolean isCompassEnabled()
나침반을 활성화할지 여부를 반환합니다. 활성화하면 나침반이 노출됩니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isScaleBarEnabled
public boolean isScaleBarEnabled()
축척 바를 활성화할지 여부를 반환합니다. 활성화하면 축척 바가 노출됩니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isZoomControlEnabled
public boolean isZoomControlEnabled()
줌 컨트롤을 활성화할지 여부를 반환합니다. 활성화하면 줌 컨트롤이 노출됩니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isIndoorLevelPickerEnabled
public boolean isIndoorLevelPickerEnabled()
실내지도 층 피커를 활성화할지 여부를 반환합니다. 활성화하면 실내지도 패널이 노출됩니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isLocationButtonEnabled
public boolean isLocationButtonEnabled()
현위치 버튼을 활성화할지 여부를 반환합니다. 활성화하면 현위치 버튼이 노출됩니다.
기본값은false입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isLogoClickEnabled
public boolean isLogoClickEnabled()
네이버 로고 클릭을 활성화할지 여부를 반환합니다. 활성화하면 네이버 로고 클릭시 범례, 법적 공지, 오픈소스 라이선스를 보여주는 다이얼로그가 열립니다.
이 옵션을false로 지정하는 앱은 반드시 앱 내에 네이버 지도 SDK의 법적 공지 액티비티(LegalNoticeActivity) 및 오픈소스 라이선스 액티비티(OpenSourceLicenseActivity)로 연결되는 메뉴를 만들어야 합니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
getLogoGravity
public int getLogoGravity()
네이버 로고의 그래비티를 반환합니다.
기본값은 지정하지 않음을 의미하는Gravity.NO_GRAVITY입니다.- Returns:
- 그래비티.
- See Also:
Gravity
-
getLogoMargin
@Nullable @Size(4L) public int[] getLogoMargin()
네이버 로고의 마진을 배열로 반환합니다. 배열이null이 아닐 경우 크기는4이며, 각 원소는 순서대로 왼쪽, 위쪽, 오른쪽, 아래쪽 마진을 나타냅니다.
기본값은 지정하지 않음을 의미하는null입니다.- Returns:
- 마진 배열. 각 원소는 픽셀 단위.
-
getFpsLimit
@IntRange(from=0L) public int getFpsLimit()
지도의 최대 초당 프레임 수(FPS, frames per second)를 반환합니다.
기본값은 제한을 두지 않음을 의미하는0입니다.- Returns:
- 한계 속도.
-
isUseTextureView
public boolean isUseTextureView()
지도 렌더링을 위해GLSurfaceView대신TextureView를 사용할지 여부를 반환합니다.
기본값은false입니다.- Returns:
TextureView를 사용할 경우true,GLSurfaceView를 사용할 경우false.
-
isMsaaEnabled
public boolean isMsaaEnabled()
4x MSAA를 적용할지 여부를 반환합니다. 디바이스가 4x MSAA를 지원하지 않으면 무시됩니다.
기본값은false입니다.- Returns:
- 적용할 경우
true, 그렇지 않을 경우false.
-
isTranslucentTextureSurface
public boolean isTranslucentTextureSurface()
TextureView를 투명하게 만들지 여부를 지정합니다.TextureView를 사용하지 않고GLSurfaceView를 사용하는 경우에는 무시됩니다.
기본값은false입니다.- Returns:
- 투명하게 만들 경우
true, 그렇지 않을 경우false.
-
isZOrderMediaOverlay
public boolean isZOrderMediaOverlay()
GLSurfaceView의zOrderMediaOverlay를 활성화할지 여부를 반환합니다.GLSurfaceView를 사용하지 않고TextureView를 사용하는 경우에는 무시됩니다.
기본값은false입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
isPreserveEGLContextOnPause
public boolean isPreserveEGLContextOnPause()
GLSurfaceView의preserveEGLContextOnPause를 활성화할지 여부를 반환합니다.GLSurfaceView를 사용하지 않고TextureView를 사용하는 경우에는 무시됩니다.
기본값은true입니다.- Returns:
- 활성화할 경우
true, 그렇지 않을 경우false.
-
equals
public boolean equals(java.lang.Object o)
- Overrides:
equalsin classjava.lang.Object
-
hashCode
public int hashCode()
- Overrides:
hashCodein classjava.lang.Object
-
describeContents
public int describeContents()
- Specified by:
describeContentsin interfaceandroid.os.Parcelable
-
writeToParcel
public void writeToParcel(android.os.Parcel dest, int flags)- Specified by:
writeToParcelin interfaceandroid.os.Parcelable
-
-