Package com.naver.maps.map.util

Class TileCoverHelper

java.lang.Object

com.naver.maps.map.util.TileCoverHelper

@UiThread
public class TileCoverHelper
extends java.lang.Object

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

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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	TileCoverHelper.Listener	타일 목록에 변경이 일어남에 대한 이벤트 리스너 인터페이스.

Constructor Summary

Constructors

Constructor	Description
TileCoverHelper()	생성자.

Method Summary

Modifier and Type	Method	Description
TileCoverHelper.Listener	getListener()	이벤트 리스너를 반환합니다.
NaverMap	getMap()	지도 객체를 반환합니다.
int	getMaxZoom()	최대 줌 레벨을 반환합니다.
int	getMinZoom()	최소 줌 레벨을 반환합니다.
boolean	isUpdateOnChange()	타일 목록을 갱신할 때 NaverMap.OnCameraIdleListener 대신 NaverMap.OnCameraChangeListener를 사용할지 여부를 반환합니다.
void	setListener(TileCoverHelper.Listener listener)	실패 이벤트 리스너를 지정합니다.
void	setMap(NaverMap map)	지도 객체를 지정합니다.
void	setMaxZoom(int maxZoom)	최대 줌 레벨을 지정합니다.
void	setMinZoom(int minZoom)	최소 줌 레벨을 지정합니다.
void	setUpdateOnChange(boolean updateOnChange)	타일 목록을 갱신할 때 NaverMap.OnCameraIdleListener 대신 NaverMap.OnCameraChangeListener를 사용할지 여부를 지정합니다.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TileCoverHelper

public TileCoverHelper()

생성자.

Method Detail

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 - 지도 객체.