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 NaverMapOptions
allGesturesEnabled(boolean enabled)
모든 제스처의 활성화 상태를 일괄적으로 변경합니다.NaverMapOptions
backgroundColor(int color)
지도의 배경색을 지정합니다.NaverMapOptions
backgroundResource(int resId)
지도의 배경 리소스를 지정합니다.NaverMapOptions
buildingHeight(float buildingHeight)
건물의 3D 높이 배율을 지정합니다.NaverMapOptions
camera(CameraPosition cameraPosition)
지도의 초기 카메라 위치를 지정합니다.NaverMapOptions
compassEnabled(boolean enabled)
나침반을 활성화할지 여부를 지정합니다.NaverMapOptions
contentPadding(int left, int top, int right, int bottom)
지도의 콘텐츠 패딩을 지정합니다.NaverMapOptions
defaultCameraAnimationDuration(int duration)
카메라 이동 애니메이션의 기본 지속 시간을 지정합니다.int
describeContents()
NaverMapOptions
disabledLayerGroups(java.lang.String... groups)
비활성화할 레이어 그룹의 목록을 지정합니다.NaverMapOptions
enabledLayerGroups(java.lang.String... groups)
활성화할 레이어 그룹의 목록을 지정합니다.boolean
equals(java.lang.Object o)
NaverMapOptions
extent(LatLngBounds extent)
지도의 제한 영역을 지정합니다.NaverMapOptions
fpsLimit(int fps)
지도의 최대 초당 프레임 수(FPS, frames per second)를 지정합니다.int
getBackgroundColor()
지도의 배경색을 지정합니다.int
getBackgroundResource()
지도의 배경 리소스를 반환합니다.float
getBuildingHeight()
건물의 3D 높이 배율을 반환합니다.CameraPosition
getCameraPosition()
지도의 초기 카메라 위치를 반환합니다.int[]
getContentPadding()
지도의 콘텐츠 패딩을 배열로 반환합니다.int
getDefaultCameraAnimationDuration()
카메라 이동 애니메이션의 기본 지속 시간을 반환합니다.java.util.Set<java.lang.String>
getEnabledLayerGroups()
활성화할 레이어 그룹의 집합을 반환합니다.LatLngBounds
getExtent()
지도의 제한 영역을 반환합니다.int
getFpsLimit()
지도의 최대 초당 프레임 수(FPS, frames per second)를 반환합니다.int
getIndoorFocusRadius()
실내지도 영역의 포커스 유지 반경을 반환합니다.float
getLightness()
배경의 명도 계수를 반환합니다.java.util.Locale
getLocale()
지도의 로캘을 반환합니다.int
getLogoGravity()
네이버 로고의 그래비티를 반환합니다.int[]
getLogoMargin()
네이버 로고의 마진을 배열로 반환합니다.NaverMap.MapType
getMapType()
지도의 유형을 반환합니다.double
getMaxTilt()
지도의 최대 기울기 각도를 반환합니다.double
getMaxZoom()
지도의 최대 줌 레벨을 반환합니다.double
getMinZoom()
지도의 최소 줌 레벨을 반환합니다.int
getPickTolerance()
지도 클릭 시 피킹되는Pickable
의 클릭 허용 반경을 지정합니다.float
getRotateGesturesFriction()
회전 제스처의 마찰 계수를0
~1
로 반환합니다.float
getScrollGesturesFriction()
스크롤 제스처의 마찰 계수를0
~1
로 반환합니다.float
getSymbolPerspectiveRatio()
지도를 기울일 때 적용되는 심벌의 원근 계수를 반환합니다.float
getSymbolScale()
심벌의 크기 배율을 반환합니다.float
getZoomGesturesFriction()
줌 제스처의 마찰 계수를0
~1
로 반환합니다.int
hashCode()
NaverMapOptions
indoorEnabled(boolean enabled)
실내지도를 활성화할지 여부를 지정합니다.NaverMapOptions
indoorFocusRadius(int radius)
실내지도 영역의 포커스 유지 반경을 지정합니다.NaverMapOptions
indoorLevelPickerEnabled(boolean enabled)
실내지도 층 피커를 활성화할지 여부를 지정합니다.boolean
isCompassEnabled()
나침반을 활성화할지 여부를 반환합니다.boolean
isIndoorEnabled()
실내지도를 활성화할지 여부를 반환합니다.boolean
isIndoorLevelPickerEnabled()
실내지도 층 피커를 활성화할지 여부를 반환합니다.boolean
isLiteModeEnabled()
라이트 모드를 활성화할지 여부를 반환합니다.boolean
isLocationButtonEnabled()
현위치 버튼을 활성화할지 여부를 반환합니다.boolean
isLogoClickEnabled()
네이버 로고 클릭을 활성화할지 여부를 반환합니다.boolean
isMsaaEnabled()
4x MSAA를 적용할지 여부를 반환합니다.boolean
isNightModeEnabled()
야간 모드를 활성화할지 여부를 반환합니다.boolean
isPreserveEGLContextOnPause()
GLSurfaceView
의preserveEGLContextOnPause
를 활성화할지 여부를 반환합니다.boolean
isRotateGesturesEnabled()
회전 제스처를 활성화할지 여부를 반환합니다.boolean
isScaleBarEnabled()
축척 바를 활성화할지 여부를 반환합니다.boolean
isScrollGesturesEnabled()
스크롤 제스처를 활성화할지 여부를 반환합니다.boolean
isStopGesturesEnabled()
스톱 제스처를 활성화할지 여부를 반환합니다.boolean
isTiltGesturesEnabled()
틸트 제스처를 활성화할지 여부를 반환합니다.boolean
isTranslucentTextureSurface()
TextureView
를 투명하게 만들지 여부를 지정합니다.boolean
isUseTextureView()
지도 렌더링을 위해GLSurfaceView
대신TextureView
를 사용할지 여부를 반환합니다.boolean
isZoomControlEnabled()
줌 컨트롤을 활성화할지 여부를 반환합니다.boolean
isZoomGesturesEnabled()
줌 제스처를 활성화할지 여부를 반환합니다.boolean
isZOrderMediaOverlay()
GLSurfaceView
의zOrderMediaOverlay
를 활성화할지 여부를 반환합니다.NaverMapOptions
lightness(float lightness)
배경의 명도 계수를 지정합니다.NaverMapOptions
liteModeEnabled(boolean enabled)
라이트 모드를 활성화할지 여부를 지정합니다.NaverMapOptions
locale(java.util.Locale locale)
지도의 로캘을 지정합니다.NaverMapOptions
locationButtonEnabled(boolean enabled)
현위치 버튼을 활성화할지 여부를 지정합니다.NaverMapOptions
logoClickEnabled(boolean enabled)
네이버 로고 클릭을 활성화할지 여부를 지정합니다.NaverMapOptions
logoGravity(int gravity)
네이버 로고의 그래비티를 지정합니다.NaverMapOptions
logoMargin(int left, int top, int right, int bottom)
네이버 로고의 마진을 지정합니다.NaverMapOptions
mapType(NaverMap.MapType mapType)
지도의 유형을 지정합니다.NaverMapOptions
maxTilt(double maxTilt)
지도의 최대 기울기 각도를 지정합니다.NaverMapOptions
maxZoom(double maxZoom)
지도의 최대 줌 레벨을 지정합니다.NaverMapOptions
minZoom(double minZoom)
지도의 최소 줌 레벨을 지정합니다.NaverMapOptions
msaaEnabled(boolean enabled)
4x MSAA를 적용할지 여부를 지정합니다.NaverMapOptions
nightModeEnabled(boolean enabled)
야간 모드를 활성화할지 여부를 지정합니다.NaverMapOptions
pickTolerance(int tolerance)
지도 클릭 시 피킹되는Pickable
의 클릭 허용 반경을 지정합니다.NaverMapOptions
preserveEGLContextOnPause(boolean enabled)
GLSurfaceView
의preserveEGLContextOnPause
를 활성화할지 여부를 지정합니다.NaverMapOptions
rotateGesturesEnabled(boolean enabled)
회전 제스처를 활성화할지 여부를 지정합니다.NaverMapOptions
rotateGesturesFriction(float friction)
회전 제스처의 마찰 계수를0
~1
로 지정합니다.NaverMapOptions
scaleBarEnabled(boolean enabled)
축척 바를 활성화할지 여부를 지정합니다.NaverMapOptions
scrollGesturesEnabled(boolean enabled)
스크롤 제스처를 활성화할지 여부를 지정합니다.NaverMapOptions
scrollGesturesFriction(float friction)
스크롤 제스처의 마찰 계수를0
~1
로 지정합니다.NaverMapOptions
stopGesturesEnabled(boolean enabled)
스톱 제스처를 활성화할지 여부를 지정합니다.NaverMapOptions
symbolPerspectiveRatio(float ratio)
지도를 기울일 때 적용되는 심벌의 원근 계수를 지정합니다.NaverMapOptions
symbolScale(float scale)
심벌의 크기 배율을 지정합니다.NaverMapOptions
tiltGesturesEnabled(boolean enabled)
틸트 제스처를 활성화할지 여부를 지정합니다.NaverMapOptions
translucentTextureSurface(boolean translucentTextureSurface)
TextureView
를 투명하게 만들지 여부를 지정합니다.NaverMapOptions
useTextureView(boolean useTextureView)
지도 렌더링을 위해GLSurfaceView
대신TextureView
를 사용할지 여부를 지정합니다.void
writeToParcel(android.os.Parcel dest, int flags)
NaverMapOptions
zoomControlEnabled(boolean enabled)
줌 컨트롤을 활성화할지 여부를 지정합니다.NaverMapOptions
zoomGesturesEnabled(boolean enabled)
줌 제스처를 활성화할지 여부를 지정합니다.NaverMapOptions
zoomGesturesFriction(float friction)
줌 제스처의 마찰 계수를0
~1
로 지정합니다.NaverMapOptions
zOrderMediaOverlay(boolean enabled)
GLSurfaceView
의zOrderMediaOverlay
를 활성화할지 여부를 지정합니다.
-
-
-
Field Detail
-
CREATOR
public static final android.os.Parcelable.Creator<NaverMapOptions> CREATOR
-
-
Method Detail
-
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(double minZoom)
- Parameters:
minZoom
- 최소 줌 레벨.- Returns:
- 객체 자신.
-
maxZoom
@NonNull public NaverMapOptions maxZoom(double maxZoom)
- Parameters:
maxZoom
- 최대 줌 레벨.- Returns:
- 객체 자신.
-
maxTilt
@NonNull public NaverMapOptions maxTilt(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(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(float buildingHeight)
건물의 3D 높이 배율을 지정합니다. 배율이0
일 경우 지도를 기울이더라도 건물이 2D로 나타납니다.
기본값은1
입니다.- Parameters:
buildingHeight
- 건물의 3D 높이 배율.0
~1
범위.- Returns:
- 객체 자신.
-
lightness
@NonNull public NaverMapOptions lightness(float lightness)
배경의 명도 계수를 지정합니다. 계수가-1
일 경우 명도 최소치인 검정색으로,1
일 경우 명도 최대치인 흰색으로 표시됩니다. 오버레이에는 적용되지 않습니다.
기본값은0
입니다.- Parameters:
lightness
- 배경의 명도 계수.-1
~1
범위.- Returns:
- 객체 자신.
-
symbolScale
@NonNull public NaverMapOptions symbolScale(float scale)
심벌의 크기 배율을 지정합니다. 배율이0.5
일 경우 절반,2
일 경우 두 배의 크기로 표시됩니다.
기본값은1
입니다.- Parameters:
scale
- 심벌의 크기 배율.0
~2
범위.- Returns:
- 객체 자신.
-
symbolPerspectiveRatio
@NonNull public NaverMapOptions symbolPerspectiveRatio(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(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(float friction)
- Parameters:
friction
- 마찰 계수.- Returns:
- 객체 자신.
-
zoomGesturesFriction
@NonNull public NaverMapOptions zoomGesturesFriction(float friction)
- Parameters:
friction
- 마찰 계수.- Returns:
- 객체 자신.
-
rotateGesturesFriction
@NonNull public NaverMapOptions rotateGesturesFriction(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 left, @Px int top, @Px int right, @Px int bottom)
네이버 로고의 마진을 지정합니다.- Parameters:
left
- 왼쪽 마진. 픽셀 단위.top
- 위쪽 마진. 픽셀 단위.right
- 오른쪽 마진. 픽셀 단위.bottom
- 아래쪽 마진. 픽셀 단위.- Returns:
- 객체 자신.
-
fpsLimit
@NonNull public NaverMapOptions fpsLimit(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:
- 객체 자신.
-
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
public double getMinZoom()
- Returns:
- 최소 줌 레벨.
-
getMaxZoom
public double getMaxZoom()
- Returns:
- 최대 줌 레벨.
-
getMaxTilt
public double getMaxTilt()
- Returns:
- 최대 기울기 각도.
-
getContentPadding
@NonNull public int[] getContentPadding()
지도의 콘텐츠 패딩을 배열로 반환합니다. 배열의 크기는4
이며, 각 원소는 순서대로 왼쪽, 위쪽, 오른쪽, 아래쪽 패딩을 나타냅니다.
기본값은 모두0
입니다.- Returns:
- 패딩 배열. 각 원소는 픽셀 단위.
-
getDefaultCameraAnimationDuration
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
public float getBuildingHeight()
건물의 3D 높이 배율을 반환합니다. 배율이0
일 경우 지도를 틸트하더라도 건물이 2D로 나타납니다.
기본값은1
입니다.- Returns:
- 건물의 3D 높이 배율.
0
~1
범위.
-
getLightness
public float getLightness()
배경의 명도 계수를 반환합니다. 계수가-1
일 경우 명도 최소치인 검정색으로,1
일 경우 명도 최대치인 흰색으로 표시됩니다. 오버레이에는 적용되지 않습니다.
기본값은0
입니다.- Returns:
- 배경의 명도 계수.
-1
~1
범위.
-
getSymbolScale
public float getSymbolScale()
심벌의 크기 배율을 반환합니다. 배율이0.5
일 경우 절반,2
일 경우 두 배의 크기로 표시됩니다.
기본값은1
입니다.- Returns:
- 심벌의 크기 배율.
0
~2
범위.
-
getSymbolPerspectiveRatio
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
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
public float getScrollGesturesFriction()
- Returns:
- 마찰 계수.
-
getZoomGesturesFriction
public float getZoomGesturesFriction()
- Returns:
- 마찰 계수.
-
getRotateGesturesFriction
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 public int[] getLogoMargin()
네이버 로고의 마진을 배열로 반환합니다. 배열이null
이 아닐 경우 크기는4
이며, 각 원소는 순서대로 왼쪽, 위쪽, 오른쪽, 아래쪽 마진을 나타냅니다.
기본값은 지정하지 않음을 의미하는null
입니다.- Returns:
- 마진 배열. 각 원소는 픽셀 단위.
-
getFpsLimit
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:
equals
in classjava.lang.Object
-
hashCode
public int hashCode()
- Overrides:
hashCode
in classjava.lang.Object
-
describeContents
public int describeContents()
- Specified by:
describeContents
in interfaceandroid.os.Parcelable
-
writeToParcel
public void writeToParcel(android.os.Parcel dest, int flags)
- Specified by:
writeToParcel
in interfaceandroid.os.Parcelable
-
-