Class TileCoverHelper

java.lang.Object
com.naver.maps.map.util.TileCoverHelper

@UiThread public class TileCoverHelper extends Object
지도 화면을 커버하는 타일의 목록을 관리하며 변경이 일어나면 이벤트를 발생시키는 유틸리티 클래스.

setListener(Listener)로 이벤트 리스너를 지정하고 setMap(NaverMap)으로 지도 객체를 지정하면 지도 화면을 커버하는 타일의 목록이 변경될 때마다 TileCoverHelper.Listener.onTileChanged(List, List)가 호출됩니다. 화면에 추가된 타일 영역에 대해서 데이터를 가져오고 제거된 타일 영역의 데이터는 제거하는 등의 작업을 할 경우, 이 클래스를 사용하면 전체 타일 대신 변경사항이 있는 타일만을 처리하면 되므로 NaverMap.getCoveringTileIds()를 직접 사용하는 것에 비해 효율적입니다.
  • Constructor Details

    • TileCoverHelper

      public TileCoverHelper()
      생성자.
  • Method Details

    • getMinZoom

      @IntRange(from=0L, to=21L) public int getMinZoom()
      최소 줌 레벨을 반환합니다.

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

      public void setMinZoom(@IntRange(from=0L,to=21L) int minZoom)
      최소 줌 레벨을 지정합니다.

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

      @IntRange(from=0L, to=21L) public int getMaxZoom()
      최대 줌 레벨을 반환합니다.

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

      public void setMaxZoom(@IntRange(from=0L,to=21L) int maxZoom)
      최대 줌 레벨을 지정합니다.

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

      public boolean isUpdateOnChange()
      타일 목록을 갱신할 때 NaverMap.OnCameraIdleListener 대신 NaverMap.OnCameraChangeListener를 사용할지 여부를 반환합니다. NaverMap.OnCameraChangeListener를 사용하면 목록이 더 빠르게 갱신되지만 성능이 하락합니다.
      Returns:
      NaverMap.OnCameraChangeListener를 사용할 경우 true, NaverMap.OnCameraIdleListener를 사용할 경우 false.
    • setUpdateOnChange

      public void setUpdateOnChange(boolean updateOnChange)
      타일 목록을 갱신할 때 NaverMap.OnCameraIdleListener 대신 NaverMap.OnCameraChangeListener를 사용할지 여부를 지정합니다. NaverMap.OnCameraChangeListener를 사용하면 목록이 더 빠르게 갱신되지만 성능이 하락합니다.
      Parameters:
      updateOnChange - NaverMap.OnCameraChangeListener를 사용할 경우 true, NaverMap.OnCameraIdleListener를 사용할 경우 false.
    • getListener

      @Nullable public TileCoverHelper.Listener getListener()
      이벤트 리스너를 반환합니다.
      Returns:
      이벤트 리스너 객체. 지정된 이벤트 리스너가 없을 경우 null.
    • setListener

      public void setListener(@Nullable TileCoverHelper.Listener listener)
      실패 이벤트 리스너를 지정합니다.
      Parameters:
      listener - 이벤트 리스너 객체. null일 경우 이벤트 리스너가 해제됩니다.
    • getMap

      @Nullable public NaverMap getMap()
      지도 객체를 반환합니다.
      Returns:
      지도 객체.
    • setMap

      public void setMap(@Nullable NaverMap map)
      지도 객체를 지정합니다.
      Parameters:
      map - 지도 객체.