Package com.naver.maps.map

Class NaverMap

java.lang.Object
com.naver.maps.map.NaverMap
@UiThread public final class NaverMap extends Object
하나의 지도를 나타내는 클래스. 지도와 관련된 모든 조작은 이 클래스를 통해 이루어집니다. 이 클래스의 인스턴스는 직접 생성할 수 없고 MapFragment.getMapAsync(OnMapReadyCallback)와 같은 메서드를 호출해 비동기적으로 얻어야 합니다.
See Also:

  • Field Details

    • LAYER_GROUP_BUILDING

      public static final String LAYER_GROUP_BUILDING
      건물 레이어 그룹. 기본적으로 활성화됩니다.
      See Also:

    • LAYER_GROUP_TRANSIT

      public static final String LAYER_GROUP_TRANSIT
      대중교통 레이어 그룹.
      See Also:

    • LAYER_GROUP_BICYCLE

      public static final String LAYER_GROUP_BICYCLE
      자전거 도로 레이어 그룹.
      See Also:

    • LAYER_GROUP_TRAFFIC

      public static final String LAYER_GROUP_TRAFFIC
      실시간 교통정보 레이어 그룹.
      See Also:

    • LAYER_GROUP_CADASTRAL

      public static final String LAYER_GROUP_CADASTRAL
      지적편집도 레이어 그룹.
      See Also:

    • LAYER_GROUP_MOUNTAIN

      public static final String LAYER_GROUP_MOUNTAIN
      등산로 레이어 그룹.
      See Also:

    • MINIMUM_ZOOM

      public static final int MINIMUM_ZOOM
      지도에서 표현할 수 있는 최소 줌 레벨.
      See Also:

    • MAXIMUM_ZOOM

      public static final int MAXIMUM_ZOOM
      지도에서 표현할 수 있는 최대 줌 레벨.
      See Also:

    • MINIMUM_TILT

      public static final int MINIMUM_TILT
      지도에서 표현할 수 있는 최소 기울기 각도.
      See Also:

    • MAXIMUM_TILT

      public static final int MAXIMUM_TILT
      지도에서 표현할 수 있는 최대 기울기 각도.
      See Also:

    • DEFAULT_MAXIMUM_TILT

      public static final int DEFAULT_MAXIMUM_TILT
      기본 최대 기울기 각도.
      See Also:

    • MINIMUM_BEARING

      public static final int MINIMUM_BEARING
      지도에서 표현할 수 있는 최소 베어링 각도.
      See Also:

    • MAXIMUM_BEARING

      public static final int MAXIMUM_BEARING
      지도에서 표현할 수 있는 최대 베어링 각도.
      See Also:

    • DEFAULT_DEFAULT_CAMERA_ANIMATION_DURATION

      public static final int DEFAULT_DEFAULT_CAMERA_ANIMATION_DURATION
      카메라 애니메이션의 기본 지속 시간. 밀리초 단위.
      See Also:

    • DEFAULT_INDOOR_FOCUS_RADIUS_DP

      @Dimension(unit=0) public static final int DEFAULT_INDOOR_FOCUS_RADIUS_DP
      기본 실내지도 영역 포커스 반경. DP 단위.
      See Also:

    • DEFAULT_PICK_TOLERANCE_DP

      @Dimension(unit=0) public static final int DEFAULT_PICK_TOLERANCE_DP
      지도 클릭 시 피킹되는 Pickable의 기본 클릭 허용 반경. DP 단위.
      See Also:

    • DEFAULT_SCROLL_GESTURES_FRICTION

      public static final float DEFAULT_SCROLL_GESTURES_FRICTION
      기본 스크롤 제스처 마찰 계수.
      See Also:

    • DEFAULT_ZOOM_GESTURES_FRICTION

      public static final float DEFAULT_ZOOM_GESTURES_FRICTION
      기본 줌 제스처 마찰 계수.
      See Also:

    • DEFAULT_ROTATE_GESTURES_FRICTION

      public static final float DEFAULT_ROTATE_GESTURES_FRICTION
      기본 회전 제스처 마찰 계수.
      See Also:

    • DEFAULT_CAMERA_POSITION

      @NonNull public static final CameraPosition DEFAULT_CAMERA_POSITION
      지도의 기본 카메라 위치.

    • DEFAULT_BACKGROUND_COLOR_LIGHT

      @ColorInt public static final int DEFAULT_BACKGROUND_COLOR_LIGHT
      기본 밝은 배경색.
      See Also:

    • DEFAULT_BACKGROUND_COLOR_DARK

      @ColorInt public static final int DEFAULT_BACKGROUND_COLOR_DARK
      기본 어두운 배경색.
      See Also:

    • DEFAULT_BACKGROUND_COLOR

      @Deprecated @ColorInt public static final int DEFAULT_BACKGROUND_COLOR
      Deprecated.
      DEFAULT_BACKGROUND_COLOR_LIGHT 또는 DEFAULT_BACKGROUND_COLOR_DARK를 사용하세요.
      기본 배경색.
      See Also:

    • DEFAULT_BACKGROUND_DRWABLE_LIGHT

      @DrawableRes public static final int DEFAULT_BACKGROUND_DRWABLE_LIGHT
      기본 밝은 배경 이미지. R.drawable.navermap_default_background_light.

    • DEFAULT_BACKGROUND_DRWABLE_DARK

      @DrawableRes public static final int DEFAULT_BACKGROUND_DRWABLE_DARK
      기본 어두운 배경 이미지. R.drawable.navermap_default_background_dark.

  • Method Details

    • isDestroyed

      public boolean isDestroyed()
      이 객체의 지도가 소멸했는지 여부를 반환합니다. MapFragment의 MapFragment.onDestroyView() 또는 MapView의 MapView.onDestroy()가 호출되면 지도가 소멸됩니다. 지도가 소멸되면 메서드를 호출하거나 오버레이를 추가해도 기능이 동작하지 않으며 오류가 로깅됩니다.
      Returns:
      지도가 소멸한 경우 true, 그렇지 않을 경우 false.

    • forceRefresh

      public void forceRefresh()
      지도 화면을 강제로 새로고침합니다. 실시간 교통정보 등 지도 화면에 나타나는 실시간성 데이터는 적시에 자동으로 새로고침되므로 이 메서드를 별도로 호출할 필요가 없습니다.

    • getContext

      @NonNull public android.content.Context getContext()
      이 지도에 해당하는 Context 객체를 반환합니다.
      Returns:
      Context 객체

    • getUiSettings

      @NonNull public UiSettings getUiSettings()
      이 지도의 UiSettings 객체를 반환합니다. 항상 같은 객체가 반환됩니다.
      Returns:
      UiSettings 객체.

    • getProjection

      @NonNull public Projection getProjection()
      이 지도의 Projection 객체를 반환합니다. 항상 같은 객체가 반환됩니다.
      Returns:
      Projection 객체.

    • getCustomStyleId

      @Nullable public String getCustomStyleId()
      커스텀 스타일 ID를 반환합니다.

      기본값은 커스텀 스타일을 사용하지 않음을 의미하는 null입니다.
      Returns:
      커스텀 스타일 ID. null일 경우 커스텀 스타일을 사용하지 않음.

    • setCustomStyleId

      public void setCustomStyleId(@Nullable String customStyleId)
      커스텀 스타일 ID를 지정합니다. setCustomStyleId(customStyleId, null)과 동일합니다.

      기본값은 커스텀 스타일을 사용하지 않음을 의미하는 null입니다.
      Parameters:
      customStyleId - 커스텀 스타일 ID. null일 경우 커스텀 스타일을 사용하지 않음.

    • setCustomStyleId

      public void setCustomStyleId(@Nullable String customStyleId, @Nullable NaverMap.OnCustomStyleLoadCallback callback)
      커스텀 스타일 ID를 지정합니다. callback을 지정할 경우 커스텀 스타일이 로드되면 callback의 NaverMap.OnCustomStyleLoadCallback.onCustomStyleLoaded()가, 실패하면 NaverMap.OnCustomStyleLoadCallback.onCustomStyleLoadFailed(Exception)가 호출됩니다.

      기본값은 커스텀 스타일을 사용하지 않음을 의미하는 null입니다.
      Parameters:
      customStyleId - 커스텀 스타일 ID. null일 경우 커스텀 스타일을 사용하지 않음.
      callback - 커스텀 스타일 로딩에 대한 콜백.

    • getLocale

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

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

    • setLocale

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

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

    • getCameraPosition

      @NonNull public CameraPosition getCameraPosition()
      지도의 콘텐츠 영역 중심에 대한 카메라 위치를 반환합니다.
      Returns:
      카메라 위치.

    • getContentBounds

      @NonNull public com.naver.maps.geometry.LatLngBounds getContentBounds()
      지도의 콘텐츠 영역에 대한 LatLngBounds를 반환합니다. 콘텐츠 패딩이 모두 0이면 getCoveringBounds()와 동일한 영역이, 콘텐츠 패딩이 지정되어 있으면 getCoveringBounds()에서 콘텐츠 패딩을 제외한 영역이 반환됩니다.
      Returns:
      콘텐츠 영역에 대한 LatLngBounds.
      See Also:

    • getContentRegion

      @NonNull @Size(5L) public com.naver.maps.geometry.LatLng[] getContentRegion()
      지도의 콘텐츠 영역에 대한 좌표열을 반환합니다. 좌표열은 네 개의 좌표로 구성된 사각형으로 표현됩니다. 단, 반환되는 배열의 크기는 5이며, 첫 번째 원소와 마지막 원소가 동일한 지점을 가리킵니다. 콘텐츠 패딩이 모두 0이면 getCoveringRegion()과 동일한 사각형이, 콘텐츠 패딩이 지정되어 있으면 getCoveringRegion()에서 콘텐츠 패딩을 제외한 사각형이 반환됩니다.
      Returns:
      콘텐츠 영역에 대한 사각형 좌표열.
      See Also:

    • getCoveringBounds

      @NonNull public com.naver.maps.geometry.LatLngBounds getCoveringBounds()
      콘텐츠 패딩을 포함한 지도의 뷰 전체 영역에 대한 LatLngBounds를 반환합니다.
      Returns:
      뷰 전체 영역에 대한 LatLngBounds.

    • getCoveringRegion

      @NonNull @Size(5L) public com.naver.maps.geometry.LatLng[] getCoveringRegion()
      콘텐츠 패딩을 포함한 지도의 뷰 전체 영역에 대한 좌표열을 반환합니다. 좌표열은 네 개의 좌표로 구성된 사각형으로 표현됩니다. 단, 반환되는 배열의 크기는 5이며, 첫 번째 원소와 마지막 원소가 동일한 지점을 가리킵니다.
      Returns:
      뷰 전체 영역에 대한 사각형 좌표열.

    • getCoveringTileIds

      @NonNull public long[] getCoveringTileIds()
      콘텐츠 패딩을 포함한 지도의 뷰 전체를 완전히 덮는 타일 ID의 목록을 반환합니다.
      Returns:
      타일 ID의 목록.
      See Also:

    • getCoveringTileIdsAtZoom

      @NonNull public long[] getCoveringTileIdsAtZoom(int zoom)
      콘텐츠 패딩을 포함한 지도의 뷰 전체를 완전히 덮는 zoom 레벨 타일 ID의 목록을 반환합니다.
      Parameters:
      zoom - 줌 레벨.
      Returns:
      타일 ID의 목록.
      See Also:

    • setCameraPosition

      public void setCameraPosition(@NonNull CameraPosition cameraPosition)
      카메라의 위치를 변경합니다. 만약 카메라 이동 애니메이션이 진행 중이었다면 취소되고, 진행 중인 CameraUpdate 객체의 CameraUpdate.CancelCallback.onCameraUpdateCancel() 및 NaverMap.OnCameraChangeListener.onCameraChange(int, boolean)가 호출됩니다.
      Parameters:
      cameraPosition - 새로운 카메라 위치.

    • moveCamera

      public void moveCamera(@NonNull CameraUpdate update)
      카메라를 이동합니다. 만약 카메라 이동 애니메이션이 진행 중이었다면 취소되고, 진행 중인 CameraUpdate 객체의 CameraUpdate.CancelCallback.onCameraUpdateCancel() 및 NaverMap.OnCameraChangeListener.onCameraChange(int, boolean)가 호출됩니다.
      Parameters:
      update - CameraUpdate 객체.

    • cancelTransitions

      public void cancelTransitions()
      현재 진행 중인 카메라 이동 애니메이션을 취소합니다. 진행 중인 CameraUpdate 객체의 CameraUpdate.CancelCallback.onCameraUpdateCancel() 및 NaverMap.OnCameraChangeListener.onCameraChange(int, boolean)가 호출됩니다.

      cancelTransitions(CameraUpdate.REASON_DEVELOPER)과 동일합니다.

    • cancelTransitions

      public void cancelTransitions(int reason)
      현재 진행 중인 카메라 이동 애니메이션을 취소합니다. 진행 중인 CameraUpdate 객체의 CameraUpdate.CancelCallback.onCameraUpdateCancel() 및 NaverMap.OnCameraChangeListener.onCameraChange(int, boolean)가 호출됩니다.
      Parameters:
      reason - 취소의 원인. NaverMap.OnCameraChangeListener.onCameraChange(int, boolean)의 reason 파라메터로 전달됩니다.

    • getDefaultCameraAnimationDuration

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

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

    • setDefaultCameraAnimationDuration

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

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

    • getExtent

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

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

    • setExtent

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

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

    • getMinZoom

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

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

    • setMinZoom

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

      기본값은 MINIMUM_ZOOM입니다.
      Parameters:
      minZoom - 최소 줌 레벨.

    • getMaxZoom

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

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

    • setMaxZoom

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

      기본값은 MAXIMUM_ZOOM입니다.
      Parameters:
      maxZoom - 최대 줌 레벨.

    • getMaxTilt

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

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

    • setMaxTilt

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

      기본값은 MAXIMUM_TILT입니다.
      Parameters:
      maxTilt - 최대 기울기 각도.

    • getMapType

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

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

    • setMapType

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

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

    • getEnabledLayerGroups

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

    • isLayerGroupEnabled

      public boolean isLayerGroupEnabled(@NonNull String group)
      레이어 그룹이 활성화되어 있는지 여부를 반환합니다.
      Parameters:
      group - 레이어 그룹의 이름.
      Returns:
      활성화된 경우 true, 그렇지 않을 경우 false.

    • setLayerGroupEnabled

      public void setLayerGroupEnabled(@NonNull String group, boolean enabled)
      레이어 그룹을 활성화할지 여부를 지정합니다.
      Parameters:
      group - 레이어 그룹의 이름.
      enabled - 활성화할 경우 true, 그렇지 않을 경우 false.

    • isDark

      public boolean isDark()
      지도가 어두운지 여부를 반환합니다. 야간 모드가 활성화되어 있거나 지도의 유형이 NaverMap.MapType.Satellite 또는 NaverMap.MapType.Hybrid일 경우 어두운 것으로 간주됩니다.
      Returns:
      어두울 경우 true, 그렇지 않을 경우 false.

    • isLiteModeEnabled

      public boolean isLiteModeEnabled()
      라이트 모드가 활성화되어 있는지 여부를 반환합니다. 라이트 모드가 활성화되면 지도의 로딩이 빨라지고 메모리 소모가 감소합니다. 그러나 다음과 같은 제약이 생깁니다. 기본값은 false입니다.
      Returns:
      활성화된 경우 true, 그렇지 않을 경우 false.

    • setLiteModeEnabled

      public void setLiteModeEnabled(boolean enabled)
      라이트 모드를 활성화할지 여부를 지정합니다. 라이트 모드가 활성화되면 지도의 로딩이 빨라지고 메모리 소모가 감소합니다. 그러나 다음과 같은 제약이 생깁니다. 기본값은 false입니다.
      Parameters:
      enabled - 활성화할 경우 true, 그렇지 않을 경우 false.

    • isNightModeEnabled

      public boolean isNightModeEnabled()
      야간 모드가 활성화되어 있는지 여부를 반환합니다. 야간 모드가 활성화되면 지도 스타일이 어둡게 바뀝니다. 지도 유형이 야간 모드를 지원하지 않으면 야간 모드를 활성화하더라도 아무 변화가 일어나지 않습니다.

      기본값은 false입니다.
      Returns:
      활성화된 경우 true, 그렇지 않을 경우 false.

    • setNightModeEnabled

      public void setNightModeEnabled(boolean enabled)
      야간 모드를 활성화할지 여부를 지정합니다. 야간 모드가 활성화되면 지도 스타일이 어둡게 바뀝니다. 지도 유형이 야간 모드를 지원하지 않으면 야간 모드를 활성화하더라도 아무 변화가 일어나지 않습니다.

      기본값은 false입니다.
      Parameters:
      enabled - 활성화할 경우 true, 그렇지 않을 경우 false.

    • getBuildingHeight

      @FloatRange(from=0.0, to=1.0) public float getBuildingHeight()
      건물의 3D 높이 배율을 반환합니다. 배율이 0일 경우 지도를 기울이더라도 건물이 2D로 나타납니다.

      기본값은 1입니다.
      Returns:
      건물의 3D 높이 배율. 0~1 범위.

    • setBuildingHeight

      public void setBuildingHeight(@FloatRange(from=0.0,to=1.0) float buildingHeight)
      건물의 3D 높이 배율을 지정합니다. 배율이 0일 경우 지도를 기울이더라도 건물이 2D로 나타납니다.

      기본값은 1입니다.
      Parameters:
      buildingHeight - 건물의 3D 높이 배율. 0~1 범위.

    • getLightness

      @FloatRange(from=-1.0, to=1.0) public float getLightness()
      배경의 명도 계수를 반환합니다. 계수가 -1일 경우 명도 최소치인 검정색으로, 1일 경우 명도 최대치인 흰색으로 표시됩니다. 오버레이에는 적용되지 않습니다.

      기본값은 0입니다.
      Returns:
      배경의 명도 계수. -1~1 범위.

    • setLightness

      public void setLightness(@FloatRange(from=-1.0,to=1.0) float lightness)
      배경의 명도 계수를 지정합니다. 계수가 -1일 경우 명도 최소치인 검정색으로, 1일 경우 명도 최대치인 흰색으로 표시됩니다. 오버레이에는 적용되지 않습니다.

      기본값은 0입니다.
      Parameters:
      lightness - 배경의 명도 계수. -1~1 범위.

    • getSymbolScale

      @FloatRange(from=0.0, to=2.0) public float getSymbolScale()
      심벌의 크기 배율을 반환합니다. 배율이 0.5일 경우 절반, 2일 경우 두 배의 크기로 표시됩니다.

      기본값은 1입니다.
      Returns:
      심벌의 크기 배율. 0~2 범위.

    • setSymbolScale

      public void setSymbolScale(@FloatRange(from=0.0,to=2.0) float scale)
      심벌의 크기 배율을 지정합니다. 배율이 0.5일 경우 절반, 2일 경우 두 배의 크기로 표시됩니다.

      기본값은 1입니다.
      Parameters:
      scale - 심벌의 크기 배율. 0~2 범위.

    • getSymbolPerspectiveRatio

      @FloatRange(from=0.0, to=1.0) public float getSymbolPerspectiveRatio()
      지도를 기울일 때 적용되는 심벌의 원근 계수를 반환합니다. 계수가 1일 경우 배경 지도와 동일한 비율로 멀리 있는 심벌은 작아지고 가까이 있는 심벌은 커지며, 0에 가까울수록 원근 효과가 감소합니다.

      기본값은 1입니다.
      Returns:
      심벌의 원근 계수. 0~1 범위.

    • setSymbolPerspectiveRatio

      public void setSymbolPerspectiveRatio(@FloatRange(from=0.0,to=1.0) float ratio)
      지도를 기울일 때 적용되는 심벌의 원근 계수를 지정합니다. 계수가 1일 경우 배경 지도와 동일한 비율로 멀리 있는 심벌은 작아지고 가까이 있는 심벌은 커지며, 0에 가까울수록 원근 효과가 감소합니다.

      기본값은 1입니다.
      Parameters:
      ratio - 심벌의 원근 계수. 0~1 범위.

    • isIndoorEnabled

      public boolean isIndoorEnabled()
      실내지도 활성화 여부를 반환합니다. 활성화하면 카메라가 일정 이상 확대되고 실내지도가 있는 영역에 포커스될 경우 자동으로 해당 영역에 대한 실내지도가 나타납니다.

      기본값은 false입니다.
      Returns:
      활성화된 경우 true, 그렇지 않은 경우 false.

    • setIndoorEnabled

      public void setIndoorEnabled(boolean enabled)
      실내지도 활성화 여부를 지정합니다. 활성화하면 카메라가 일정 이상 확대되고 실내지도가 있는 영역에 포커스될 경우 자동으로 해당 영역에 대한 실내지도가 나타납니다.

      기본값은 false입니다.
      Parameters:
      enabled - 활성화할 경우 true, 그렇지 않을 경우 false.

    • getIndoorFocusRadius

      public int getIndoorFocusRadius()
      실내지도 영역의 포커스 유지 반경을 반환합니다. 지정할 경우 카메라의 위치가 포커스 유지 반경을 완전히 벗어날 때까지 영역에 대한 포커스가 유지됩니다.

      기본값은 DEFAULT_INDOOR_FOCUS_RADIUS_DP를 픽셀로 환산한 값입니다.
      Returns:
      실내지도 영역 포커스 유지 반경. 픽셀 단위.

    • setIndoorFocusRadius

      public void setIndoorFocusRadius(@Px int radius)
      실내지도 영역의 포커스 유지 반경을 지정합니다. 지정할 경우 카메라의 위치가 포커스 유지 반경을 완전히 벗어날 때까지 영역에 대한 포커스가 유지됩니다.

      기본값은 DEFAULT_INDOOR_FOCUS_RADIUS_DP를 픽셀로 환산한 값입니다.
      Parameters:
      radius - 실내지도 영역 포커스 유지 반경. 픽셀 단위.

    • requestIndoorView

      public void requestIndoorView(@Nullable IndoorView indoorView)
      실내지도 뷰를 나타내도록 요청합니다. 이 메서드를 호출하더라도 실내지도 뷰가 즉시 나타나는 것이 보장되지 않으며, 요청된 실내지도 뷰를 포함하는 영역이 포커스되어야 그 뷰가 나타납니다. 단, 요청된 실내지도 뷰를 포함하는 영역이 이미 포커스되어 있을 경우 즉시 그 뷰가 나타납니다.
      Parameters:
      indoorView - 실내지도 뷰. 요청을 취소할 경우 null.

    • getIndoorSelection

      @Nullable public IndoorSelection getIndoorSelection()
      선택된 실내지도 구역 및 층을 반환합니다.
      Returns:
      선택된 실내지도 구역 및 층에 대한 IndoorSelection 객체.

    • addOnIndoorSelectionChangeListener

      public void addOnIndoorSelectionChangeListener(@NonNull NaverMap.OnIndoorSelectionChangeListener listener)
      선택된 실내지도 구역 및 층의 변경에 대한 이벤트 리스너를 등록합니다.
      Parameters:
      listener - 등록할 이벤트 리스너 객체.

    • removeOnIndoorSelectionChangeListener

      public void removeOnIndoorSelectionChangeListener(@NonNull NaverMap.OnIndoorSelectionChangeListener listener)
      선택된 실내지도 구역 및 층의 변경에 대한 이벤트 리스너를 해제합니다.
      Parameters:
      listener - 해제할 이벤트 리스너 객체.

    • getBackgroundColor

      @ColorInt public int getBackgroundColor()
      지도의 배경색을 반환합니다. 배경은 해당 지역의 지도 데이터가 없거나 로딩 중일 때 나타납니다.
      Returns:
      배경색.

    • setBackgroundColor

      public void setBackgroundColor(@ColorInt int color)
      지도의 배경색을 지정합니다. 배경은 해당 지역의 지도 데이터가 없거나 로딩 중일 때 나타납니다.
      Parameters:
      color - 배경색.

    • setBackgroundResource

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

    • setBackground

      public void setBackground(@Nullable android.graphics.drawable.Drawable drawable)
      지도의 배경 이미지를 지정합니다. 배경은 해당 지역의 지도 데이터가 없거나 로딩 중일 때 나타납니다. drawable이 null일 경우 setBackgroundColor(int)를 이용해 지정된 배경색이 사용됩니다.
      Parameters:
      drawable - 배경 이미지.

    • setBackgroundBitmap

      public void setBackgroundBitmap(@Nullable android.graphics.Bitmap bitmap)
      지도의 배경 비트맵을 지정합니다. 배경은 해당 지역의 지도 데이터가 없거나 로딩 중일 때 나타납니다. bitmap이 null일 경우 setBackgroundColor(int)를 이용해 지정된 배경색이 사용됩니다.
      Parameters:
      bitmap - 배경 비트맵.

    • pickAll

      @NonNull public List<Pickable> pickAll(@NonNull android.graphics.PointF point)
      특정 화면 좌표에 나타난 모든 오버레이 및 심벌을 가져옵니다. 목록은 가장 위에 그려진 요소부터 가장 아래에 그려진 요소의 순으로 정렬됩니다.

      pickAll(point, 0)과 동일합니다.
      Parameters:
      point - 화면 좌표.
      Returns:
      오버레이 및 심벌의 목록. point에 존재하는 오버레이 또는 심벌이 없을 경우 빈 목록.

    • pickAll

      @NonNull public List<Pickable> pickAll(@NonNull android.graphics.PointF point, @Px int radius)
      특정 화면 좌표 주변 radius 픽셀 내에 나타난 모든 오버레이 및 심벌을 가져옵니다. 목록은 가장 위에 그려진 요소부터 가장 아래에 그려진 요소의 순으로 정렬됩니다.
      Parameters:
      point - 화면 좌표.
      radius - point를 기준으로 한 반경. 픽셀 단위.
      Returns:
      오버레이 및 심벌의 목록. point 주변 radius 픽셀 내에 존재하는 오버레이 또는 심벌이 없을 경우 빈 목록.

    • getLocationOverlay

      @NonNull public LocationOverlay getLocationOverlay()
      이 지도의 LocationOverlay 객체를 반환합니다. 항상 같은 객체가 반환됩니다.
      Returns:
      LocationOverlay 객체.

    • getLocationTrackingMode

      @NonNull public LocationTrackingMode getLocationTrackingMode()
      위치 추적 모드를 반환합니다.

      기본값은 LocationTrackingMode.None입니다.
      Returns:
      위치 추적 모드.

    • setLocationTrackingMode

      public void setLocationTrackingMode(@NonNull LocationTrackingMode mode)
      위치 추적 모드를 지정합니다. 위치 소스가 null일 경우 호출하더라도 아무런 변화가 일어나지 않습니다. LocationTrackingMode.None이 아닌 값으로 지정할 경우 위치 추적 기능이 활성화됩니다.

      기본값은 LocationTrackingMode.None입니다.
      Parameters:
      mode - 위치 추적 모드.

    • getLocationSource

      @Nullable public LocationSource getLocationSource()
      위치 소스를 반환합니다.

      기본값은 null입니다.
      Returns:
      위치 소스.

    • setLocationSource

      public void setLocationSource(@Nullable LocationSource source)
      위치 소스를 지정합니다. null로 지정할 경우 위치 추적 모드가 LocationTrackingMode.None이 됩니다.

      기본값은 null입니다.
      Parameters:
      source - 위치 소스.

    • addOnLocationChangeListener

      public void addOnLocationChangeListener(@NonNull NaverMap.OnLocationChangeListener listener)
      사용자의 위치 변경에 대한 이벤트 리스너를 등록합니다.
      Parameters:
      listener - 등록할 이벤트 리스너 객체.

    • removeOnLocationChangeListener

      public void removeOnLocationChangeListener(@NonNull NaverMap.OnLocationChangeListener listener)
      사용자의 위치 변경에 대한 이벤트 리스너를 해제합니다.
      Parameters:
      listener - 해제할 이벤트 리스너 객체.

    • getHeight

      @Px public int getHeight()
      지도 뷰의 화면상 너비를 반환합니다.
      Returns:
      지도 뷰의 화면상 너비. 픽셀 단위.

    • getWidth

      @Px public int getWidth()
      지도 뷰의 화면상 높이를 반환합니다.
      Returns:
      지도 뷰의 화면상 높이. 픽셀 단위.

    • getContentWidth

      @Px public int getContentWidth()
      패딩을 제외한 지도 뷰의 화면상 너비를 반환합니다.
      Returns:
      패딩을 제외한 지도 뷰의 화면상 너비. 픽셀 단위.

    • getContentHeight

      @Px public int getContentHeight()
      패딩을 제외한 지도 뷰의 높이를 반환합니다.
      Returns:
      패딩을 제외한 지도 뷰의 화면상 높이. 픽셀 단위.

    • getContentRect

      @NonNull public android.graphics.Rect getContentRect()
      패딩을 제외한 지도 뷰의 화면상 영역을 반환합니다.
      Returns:
      패딩을 제외한 지도 뷰의 화면상 영역.

    • getContentPadding

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

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

    • setContentPadding

      public void setContentPadding(@Px int left, @Px int top, @Px int right, @Px int bottom)
      지도의 콘텐츠 패딩을 지정합니다. 패딩에 해당하는 부분은 지도의 콘텐츠 영역에서 제외됩니다.

      setContentPadding(left, top, right, bottom, CameraUpdate.REASON_CONTENT_PADDING)과 동일합니다.
      Parameters:
      left - 왼쪽 패딩. 픽셀 단위.
      top - 위쪽 패딩. 픽셀 단위.
      right - 오른쪽 패딩. 픽셀 단위.
      bottom - 아래쪽 패딩. 픽셀 단위.

    • setContentPadding

      public void setContentPadding(@Px int left, @Px int top, @Px int right, @Px int bottom, int reason)
      지도의 콘텐츠 패딩을 지정합니다. 패딩에 해당하는 부분은 지도의 콘텐츠 영역에서 제외됩니다.

      setContentPadding(left, top, right, bottom, false, reason)과 동일합니다.
      Parameters:
      left - 왼쪽 패딩. 픽셀 단위.
      top - 위쪽 패딩. 픽셀 단위.
      right - 오른쪽 패딩. 픽셀 단위.
      bottom - 아래쪽 패딩. 픽셀 단위.
      reason - 카메라 이동의 원인.

    • setContentPadding

      public void setContentPadding(@Px int left, @Px int top, @Px int right, @Px int bottom, boolean keepCameraTarget)
      지도의 콘텐츠 패딩을 지정합니다. 패딩에 해당하는 부분은 지도의 콘텐츠 영역에서 제외됩니다.

      setContentPadding(left, top, right, bottom, keepCameraTarget, CameraUpdate.REASON_CONTENT_PADDING)과 동일합니다.
      Parameters:
      left - 왼쪽 패딩. 픽셀 단위.
      top - 위쪽 패딩. 픽셀 단위.
      right - 오른쪽 패딩. 픽셀 단위.
      bottom - 아래쪽 패딩. 픽셀 단위.
      keepCameraTarget - 카메라의 좌표를 유지할지 여부. 유지할 경우 true, 그렇지 않을 경우 false.

    • setContentPadding

      public void setContentPadding(@Px int left, @Px int top, @Px int right, @Px int bottom, boolean keepCameraTarget, int reason)
      지도의 콘텐츠 패딩을 지정합니다. 패딩에 해당하는 부분은 지도의 콘텐츠 영역에서 제외됩니다.

      keepCameraTarget에 따라 카메라의 좌표 또는 지도의 영역이 유지됩니다.
      • true인 경우: 카메라의 좌표를 유지하며 콘텐츠 영역을 변경합니다. 따라서 화면에 나타나는 지도의 전체 영역이 변경됩니다. 카메라에 변화가 없으므로 NaverMap.OnCameraChangeListener.onCameraChange(int, boolean) 이벤트는 발생하지 않습니다.
      • false인 경우: 화면에 나타나는 지도의 전체 영역을 유지하며 콘텐츠 영역을 변경합니다. 따라서 카메라의 좌표는 새로운 콘텐츠 영역의 중심을 가리키도록 변경되며, reason으로 지정한 원인으로 NaverMap.OnCameraChangeListener.onCameraChange(int, boolean) 이벤트가 발생합니다.
      Parameters:
      left - 왼쪽 패딩. 픽셀 단위.
      top - 위쪽 패딩. 픽셀 단위.
      right - 오른쪽 패딩. 픽셀 단위.
      bottom - 아래쪽 패딩. 픽셀 단위.
      keepCameraTarget - 카메라의 좌표를 유지할지 여부. 유지할 경우 true, 그렇지 않을 경우 false.
      reason - 카메라 이동의 원인. keepCameraTarget이 false일 경우에만 유효합니다.

    • setFpsLimit

      @UiThread public void setFpsLimit(@IntRange(from=0L) int fps)
      지도의 최대 초당 프레임 수(FPS, frames per second)를 지정합니다.

      기본값은 제한을 두지 않음을 의미하는 0입니다.
      Parameters:
      fps - 최대 초당 프레임 수.

    • getFpsLimit

      @UiThread public int getFpsLimit()
      지도의 최대 초당 프레임 수(FPS, frames per second)를 반환합니다.

      기본값은 제한을 두지 않음을 의미하는 0입니다.
      Returns:
      최대 초당 프레임 수.

    • addOnCameraChangeListener

      public void addOnCameraChangeListener(@NonNull NaverMap.OnCameraChangeListener listener)
      카메라의 움직임에 대한 이벤트 리스너를 등록합니다.
      Parameters:
      listener - 등록할 이벤트 리스너 객체.

    • removeOnCameraChangeListener

      public void removeOnCameraChangeListener(@NonNull NaverMap.OnCameraChangeListener listener)
      카메라의 움직임에 대한 이벤트 리스너를 해제합니다.
      Parameters:
      listener - 해제할 이벤트 리스너 객체.

    • addOnCameraIdleListener

      public void addOnCameraIdleListener(@NonNull NaverMap.OnCameraIdleListener listener)
      카메라의 움직임이 끝난 경우에 대한 이벤트 리스너를 등록합니다.
      Parameters:
      listener - 등록할 이벤트 리스너 객체.

    • removeOnCameraIdleListener

      public void removeOnCameraIdleListener(@NonNull NaverMap.OnCameraIdleListener listener)
      카메라의 움직임이 끝난 경우에 대한 이벤트 리스너를 해제합니다.
      Parameters:
      listener - 해제할 이벤트 리스너 객체.

    • isCameraIdlePending

      public boolean isCameraIdlePending()
      카메라 움직임 종료 이벤트의 발생을 지연하도록 되어있는지 여부를 반환합니다. 지연하도록 지정되면 카메라 움직임 종료 이벤트가 발생해야 하는 순간이 오더라도 이벤트가 발생하지 않으며, 이후 지연하지 않도록 다시 지정되면 그 즉시 지연되었던 이벤트가 발생할 수 있습니다.

      기본값은 false입니다.
      Returns:
      지연된 경우 true, 그렇지 않은 경우 false.

    • setCameraIdlePending

      public void setCameraIdlePending(boolean cameraIdlePending)
      카메라 움직임 종료 이벤트의 발생을 지연할지 여부를 지정합니다. 지연하도록 지정하면 카메라 움직임 종료 이벤트가 발생해야 하는 순간이 오더라도 이벤트가 발생하지 않으며, 이후 지연하지 않도록 다시 지정하면 그 즉시 지연되었던 이벤트가 발생할 수 있습니다.

      기본값은 false입니다.
      Parameters:
      cameraIdlePending - 카메라 움직임 종료 이벤트의 발생을 지연할지 여부. 지연할 경우 true, 그렇지 않을 경우 false.

    • isLoaded

      public boolean isLoaded()
      지도가 최초 로딩되었는지 여부를 반환합니다.
      Returns:
      지도가 최초 로딩되었을 경우 true, 그렇지 않을 경우 false.

    • addOnLoadListener

      public void addOnLoadListener(@NonNull NaverMap.OnLoadListener listener)
      지도의 최초 로딩에 대한 이벤트 리스너를 등록합니다.
      Parameters:
      listener - 등록할 이벤트 리스너 객체.

    • removeOnLoadListener

      public void removeOnLoadListener(@NonNull NaverMap.OnLoadListener listener)
      지도 로딩에 대한 이벤트 리스너를 해제합니다.
      Parameters:
      listener - 해제할 이벤트 리스너 객체.

    • isFullyRendered

      public boolean isFullyRendered()
      모든 데이터가 렌더링되었는지 여부를 반환합니다.
      Returns:
      모든 데이터가 렌더링되었으면 true, 그렇지 않을 경우 false.

    • isRenderingStable

      public boolean isRenderingStable()
      지도에 추가 렌더링이 필요하지 않은지 여부를 반환합니다.
      Returns:
      추가 렌더링이 필요하지 않다면 true, 그렇지 않을 경우 false.

    • addOnMapRenderedListener

      public void addOnMapRenderedListener(@NonNull NaverMap.OnMapRenderedListener listener)
      지도 렌더링에 대한 이벤트 리스너를 등록합니다.
      Parameters:
      listener - 등록할 이벤트 리스너 객체.

    • removeOnMapRenderedListener

      public void removeOnMapRenderedListener(@NonNull NaverMap.OnMapRenderedListener listener)
      지도 렌더링에 대한 이벤트 리스너를 해제합니다.
      Parameters:
      listener - 해제할 이벤트 리스너 객체.

    • addOnOptionChangeListener

      public void addOnOptionChangeListener(@NonNull NaverMap.OnOptionChangeListener listener)
      지도 옵션 변경에 대한 이벤트 리스너를 등록합니다.
      Parameters:
      listener - 등록할 이벤트 리스너 객체.

    • removeOnOptionChangeListener

      public void removeOnOptionChangeListener(@NonNull NaverMap.OnOptionChangeListener listener)
      지도 옵션 변경에 대한 이벤트 리스너를 해제합니다.
      Parameters:
      listener - 해제할 이벤트 리스너 객체.

    • getOnMapClickListener

      @Nullable public NaverMap.OnMapClickListener getOnMapClickListener()
      클릭 이벤트 리스너를 반환합니다.
      Returns:
      이벤트 리스너 객체. 지정된 이벤트 리스너가 없을 경우 null.

    • setOnMapClickListener

      public void setOnMapClickListener(@Nullable NaverMap.OnMapClickListener listener)
      클릭 이벤트 리스너를 지정합니다. 사용자가 지도를 클릭하면 listener의 NaverMap.OnMapClickListener.onMapClick(PointF, LatLng)이 호출됩니다. 단, 오버레이나 심벌이 클릭 이벤트를 소비한 경우 지도까지 이벤트가 전달되지 않습니다.
      Parameters:
      listener - 이벤트 리스너 객체. null일 경우 이벤트 리스너가 해제됩니다.

    • getOnMapLongClickListener

      @Nullable public NaverMap.OnMapLongClickListener getOnMapLongClickListener()
      롱 클릭 이벤트 리스너를 반환합니다.
      Returns:
      이벤트 리스너 객체. 지정된 이벤트 리스너가 없을 경우 null.

    • setOnMapLongClickListener

      public void setOnMapLongClickListener(@Nullable NaverMap.OnMapLongClickListener listener)
      롱 클릭 이벤트 리스너를 지정합니다. 사용자가 지도를 롱 클릭하면 listener의 NaverMap.OnMapLongClickListener.onMapLongClick(PointF, LatLng)이 호출됩니다.
      Parameters:
      listener - 이벤트 리스너 객체. null일 경우 이벤트 리스너가 해제됩니다.

    • getOnMapDoubleTapListener

      @Nullable public NaverMap.OnMapDoubleTapListener getOnMapDoubleTapListener()
      지도에 지정된 더블 탭 이벤트 리스너 객체를 반환합니다.
      Returns:
      이벤트 리스너 객체. 지정된 이벤트 리스너가 없을 경우 null.

    • setOnMapDoubleTapListener

      public void setOnMapDoubleTapListener(@Nullable NaverMap.OnMapDoubleTapListener listener)
      더블 탭 이벤트 리스너를 지정합니다. 사용자가 지도를 더블 탭하면 listener의 NaverMap.OnMapDoubleTapListener.onMapDoubleTap(PointF, LatLng)이 호출됩니다.
      Parameters:
      listener - 이벤트 리스너 객체. null일 경우 이벤트 리스너가 해제됩니다.

    • getOnMapTwoFingerTapListener

      @Nullable public NaverMap.OnMapTwoFingerTapListener getOnMapTwoFingerTapListener()
      지도에 지정된 두 손가락 탭 이벤트 리스너 객체를 반환합니다.
      Returns:
      이벤트 리스너 객체. 지정된 이벤트 리스너가 없을 경우 null.

    • setOnMapTwoFingerTapListener

      public void setOnMapTwoFingerTapListener(@Nullable NaverMap.OnMapTwoFingerTapListener listener)
      두 손가락 탭 리스너를 지정합니다. 사용자가 지도를 두 손가락 탭하면 listener의 NaverMap.OnMapTwoFingerTapListener.onMapTwoFingerTap(PointF, LatLng)이 호출됩니다.
      Parameters:
      listener - 이벤트 리스너 객체. null일 경우 이벤트 리스너가 해제됩니다.

    • getOnSymbolClickListener

      @Nullable public NaverMap.OnSymbolClickListener getOnSymbolClickListener()
      지도에 지정된 심벌 클릭 이벤트 리스너 객체를 반환합니다.
      Returns:
      이벤트 리스너 객체. 지정된 이벤트 리스너가 없을 경우 null.

    • setOnSymbolClickListener

      public void setOnSymbolClickListener(@Nullable NaverMap.OnSymbolClickListener listener)
      심벌 클릭 이벤트 리스너를 지정합니다. 사용자가 지도 심벌을 클릭하면 listener의 NaverMap.OnSymbolClickListener.onSymbolClick(Symbol)이 호출됩니다.
      Parameters:
      listener - 이벤트 리스너 객체.

    • takeSnapshot

      public void takeSnapshot(@NonNull NaverMap.SnapshotReadyCallback callback)
      컨트롤을 포함한 현재 지도의 스냅숏을 촬영합니다. 스냅숏이 촬영되면 callback의 NaverMap.SnapshotReadyCallback.onSnapshotReady(Bitmap)가 호출됩니다. takeSnapshot(true, callback)과 동일합니다.
      Parameters:
      callback - 콜백 객체.

    • takeSnapshot

      public void takeSnapshot(boolean showControls, @NonNull NaverMap.SnapshotReadyCallback callback)
      현재 지도의 스냅숏을 촬영합니다. 스냅숏이 촬영되면 callback의 NaverMap.SnapshotReadyCallback.onSnapshotReady(Bitmap)가 호출됩니다.
      Parameters:
      showControls - 컨트롤 노출 여부. 노출할 경우 true, 그렇지 않을 경우 false.
      callback - 콜백 객체.