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 Object implements android.os.Parcelable
지도의 초기 옵션을 지정하는 클래스. MapFragment나 MapView를 생성할 때 이 클래스의 인스턴스를 전달해 초깃값을 지정하는 것을 권장합니다. 지도 객체가 생성된 후에는 이 객체를 사용할 수 없고 NaverMap의 메서드를 직접 호출해야 합니다.
See Also:

  • Field Details

    • CREATOR

      public static final android.os.Parcelable.Creator<NaverMapOptions> CREATOR

  • Constructor Details

    • NaverMapOptions

      public NaverMapOptions()
      기본 생성자.

  • Method Details

    • locale

      @NonNull public NaverMapOptions locale(@Nullable Locale locale)
      지도의 로캘을 지정합니다.

      기본값은 시스템 로캘을 의미하는 null입니다.
      Parameters:
      locale - 로캘. null일 경우 시스템 로캘 사용.
      Returns:
      객체 자신.

    • camera

      @NonNull public NaverMapOptions camera(@Nullable CameraPosition cameraPosition)
      지도의 초기 카메라 위치를 지정합니다.

      기본값은 NaverMap.DEFAULT_CAMERA_POSITION을 의미하는 null입니다.
      Parameters:
      cameraPosition - 카메라 위치. null일 경우 NaverMap.DEFAULT_CAMERA_POSITION.
      Returns:
      객체 자신.

    • extent

      @NonNull public NaverMapOptions extent(@Nullable com.naver.maps.geometry.LatLngBounds extent)
      지도의 제한 영역을 지정합니다.

      기본값은 제한이 없음을 의미하는 null입니다.
      Parameters:
      extent - 제한 영역. 제한을 두지 않을 경우 null.
      Returns:
      객체 자신.

    • minZoom

      @NonNull public NaverMapOptions minZoom(@FloatRange(from=0.0,to=21.0) double minZoom)
      지도의 최소 줌 레벨을 지정합니다.

      기본값은 NaverMap.MINIMUM_ZOOM입니다.
      Parameters:
      minZoom - 최소 줌 레벨.
      Returns:
      객체 자신.

    • maxZoom

      @NonNull public NaverMapOptions maxZoom(@FloatRange(from=0.0,to=21.0) double maxZoom)
      지도의 최대 줌 레벨을 지정합니다.

      기본값은 NaverMap.MAXIMUM_ZOOM입니다.
      Parameters:
      maxZoom - 최대 줌 레벨.
      Returns:
      객체 자신.

    • maxTilt

      @NonNull public NaverMapOptions maxTilt(@FloatRange(from=0.0,to=63.0) double maxTilt)
      지도의 최대 기울기 각도를 지정합니다.

      기본값은 NaverMap.MAXIMUM_TILT입니다.
      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)
      카메라 이동 애니메이션의 기본 지속 시간을 지정합니다.

      기본값은 NaverMap.DEFAULT_DEFAULT_CAMERA_ANIMATION_DURATION입니다.
      Parameters:
      duration - 카메라 이동 애니메이션의 기본 지속 시간. 밀리초 단위.
      Returns:
      객체 자신.

    • mapType

      @NonNull public NaverMapOptions mapType(@NonNull NaverMap.MapType mapType)
      지도의 유형을 지정합니다.

      기본값은 NaverMap.MapType.Basic입니다.
      Parameters:
      mapType - 지도 유형.
      Returns:
      객체 자신.

    • enabledLayerGroups

      @NonNull public NaverMapOptions enabledLayerGroups(@NonNull String... groups)
      활성화할 레이어 그룹의 목록을 지정합니다.
      Parameters:
      groups - 활성화할 레이어 그룹의 목록.
      Returns:
      객체 자신.

    • disabledLayerGroups

      @NonNull public NaverMapOptions disabledLayerGroups(@NonNull String... groups)
      비활성화할 레이어 그룹의 목록을 지정합니다.
      Parameters:
      groups - 비활성화할 레이어 그룹의 목록.
      Returns:
      객체 자신.

    • liteModeEnabled

      @NonNull public NaverMapOptions liteModeEnabled(boolean enabled)
      라이트 모드를 활성화할지 여부를 지정합니다. 라이트 모드가 활성화되면 지도의 로딩이 빨라지고 메모리 소모가 감소합니다. 그러나 다음과 같은 제약이 생깁니다. 기본값은 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

      @NonNull public NaverMapOptions backgroundResource(@DrawableRes int resId)
      지도의 배경 리소스를 지정합니다. 배경은 해당 지역의 지도 데이터가 없거나 로딩 중일 때 나타납니다. resId가 올바르지 않을 경우 backgroundColor(int)를 이용해 지정된 배경색이 사용됩니다.

      기본값은 NaverMap.DEFAULT_BACKGROUND_DRWABLE_LIGHT입니다.
      Parameters:
      resId - 배경 리소스의 ID.
      Returns:
      객체 자신.
      See Also:

    • 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:

    • scrollGesturesFriction

      @NonNull public NaverMapOptions scrollGesturesFriction(@FloatRange(from=0.0,to=1.0) float friction)
      스크롤 제스처의 마찰 계수를 0~1로 지정합니다. 계수가 클수록 마찰이 강해집니다.

      기본값은 NaverMap.DEFAULT_SCROLL_GESTURES_FRICTION입니다.
      Parameters:
      friction - 마찰 계수.
      Returns:
      객체 자신.

    • zoomGesturesFriction

      @NonNull public NaverMapOptions zoomGesturesFriction(@FloatRange(from=0.0,to=1.0) float friction)
      줌 제스처의 마찰 계수를 0~1로 지정합니다. 계수가 클수록 마찰이 강해집니다.

      기본값은 NaverMap.DEFAULT_ZOOM_GESTURES_FRICTION입니다.
      Parameters:
      friction - 마찰 계수.
      Returns:
      객체 자신.

    • rotateGesturesFriction

      @NonNull public NaverMapOptions rotateGesturesFriction(@FloatRange(from=0.0,to=1.0) float friction)
      회전 제스처의 마찰 계수를 0~1로 지정합니다. 계수가 클수록 마찰이 강해집니다.

      기본값은 NaverMap.DEFAULT_ROTATE_GESTURES_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(@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:
      객체 자신.

    • getLocale

      @Nullable public Locale getLocale()
      지도의 로캘을 반환합니다.

      기본값은 시스템 로캘을 의미하는 null입니다.
      Returns:
      로캘. null일 경우 시스템 로캘 사용.

    • getCameraPosition

      @Nullable public CameraPosition getCameraPosition()
      지도의 초기 카메라 위치를 반환합니다.

      기본값은 NaverMap.DEFAULT_CAMERA_POSITION을 의미하는 null입니다.
      Returns:
      카메라 위치. null일 경우 NaverMap.DEFAULT_CAMERA_POSITION.

    • getExtent

      @Nullable public com.naver.maps.geometry.LatLngBounds getExtent()
      지도의 제한 영역을 반환합니다.

      기본값은 제한이 없음을 의미하는 null입니다.
      Returns:
      제한 영역. 제한을 두지 않을 경우 null.

    • getMinZoom

      @FloatRange(from=0.0, to=21.0) public double getMinZoom()
      지도의 최소 줌 레벨을 반환합니다.

      기본값은 NaverMap.MINIMUM_ZOOM입니다.
      Returns:
      최소 줌 레벨.

    • getMaxZoom

      @FloatRange(from=0.0, to=21.0) public double getMaxZoom()
      지도의 최대 줌 레벨을 반환합니다.

      기본값은 NaverMap.MAXIMUM_ZOOM입니다.
      Returns:
      최대 줌 레벨.

    • getMaxTilt

      @FloatRange(from=0.0, to=63.0) public double getMaxTilt()
      지도의 최대 기울기 각도를 반환합니다.

      기본값은 NaverMap.MAXIMUM_TILT입니다.
      Returns:
      최대 기울기 각도.

    • getContentPadding

      @NonNull @Size(4L) public int[] getContentPadding()
      지도의 콘텐츠 패딩을 배열로 반환합니다. 배열의 크기는 4이며, 각 원소는 순서대로 왼쪽, 위쪽, 오른쪽, 아래쪽 패딩을 나타냅니다.

      기본값은 모두 0입니다.
      Returns:
      패딩 배열. 각 원소는 픽셀 단위.

    • getDefaultCameraAnimationDuration

      @IntRange(from=0L) public int getDefaultCameraAnimationDuration()
      카메라 이동 애니메이션의 기본 지속 시간을 반환합니다.

      기본값은 NaverMap.DEFAULT_DEFAULT_CAMERA_ANIMATION_DURATION입니다.
      Returns:
      카메라 이동 애니메이션의 기본 지속 시간. 밀리초 단위.

    • getMapType

      @NonNull public NaverMap.MapType getMapType()
      지도의 유형을 반환합니다.

      기본값은 NaverMap.MapType.Basic입니다.
      Returns:
      지도 유형.

    • getEnabledLayerGroups

      @NonNull public Set<String> getEnabledLayerGroups()
      활성화할 레이어 그룹의 집합을 반환합니다.
      Returns:
      활성화할 레이어 그룹의 집합.

    • isLiteModeEnabled

      public boolean isLiteModeEnabled()
      라이트 모드를 활성화할지 여부를 반환합니다. 라이트 모드가 활성화되면 지도의 로딩이 빨라지고 메모리 소모가 감소합니다. 그러나 다음과 같은 제약이 생깁니다. 기본값은 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()
      스크롤 제스처의 마찰 계수를 0~1로 반환합니다. 계수가 클수록 마찰이 강해집니다.

      기본값은 NaverMap.DEFAULT_SCROLL_GESTURES_FRICTION입니다.
      Returns:
      마찰 계수.

    • getZoomGesturesFriction

      @FloatRange(from=0.0, to=1.0) public float getZoomGesturesFriction()
      줌 제스처의 마찰 계수를 0~1로 반환합니다. 계수가 클수록 마찰이 강해집니다.

      기본값은 NaverMap.DEFAULT_ZOOM_GESTURES_FRICTION입니다.
      Returns:
      마찰 계수.

    • getRotateGesturesFriction

      @FloatRange(from=0.0, to=1.0) public float getRotateGesturesFriction()
      회전 제스처의 마찰 계수를 0~1로 반환합니다. 계수가 클수록 마찰이 강해집니다.

      기본값은 NaverMap.DEFAULT_ROTATE_GESTURES_FRICTION입니다.
      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(Object o)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • describeContents

      public int describeContents()
      Specified by:
      describeContents in interface android.os.Parcelable

    • writeToParcel

      public void writeToParcel(android.os.Parcel dest, int flags)
      Specified by:
      writeToParcel in interface android.os.Parcelable