Package com.naver.maps.map

Class CameraUpdateParams

java.lang.Object

com.naver.maps.map.CameraUpdateParams

public final class CameraUpdateParams
extends java.lang.Object

카메라를 이동할 지점에 대한 다양한 정보를 나타내는 클래스. 주로 CameraUpdate를 만들기 위한 파라미터로 사용됩니다.

target, zoom, tilt, rotate 등 카메라의 위치에 대한 네 가지 속성을 나타내는 것은 CameraPosition과 유사하지만, CameraPosition은 하나의 절대적인 카메라 위치를 나타내는 데 반해 CameraUpdateParams는 상대적인 변화를 줄 수 있습니다. 이를 위해 하나의 속성에 각각 두 종류의 메서드를 제공합니다.

• xxxTo(): 속성을 절대적인 값으로 지정합니다.
• xxxBy(): 속성을 현재 지도의 CameraPosition에 상대적인 값으로 지정합니다.

동일한 속성에 대해 xxxTo() 계열의 메서드와 xxxBy() 계열의 메서드를 모두 호출하면 앞선 호출은 무시됩니다.

See Also:

CameraUpdate.withParams(CameraUpdateParams)

Constructor Summary

Constructors

Constructor	Description
CameraUpdateParams()	기본 생성자.

Method Summary

Modifier and Type	Method	Description
CameraUpdateParams	rotateBy(double delta)	카메라의 베어링 각도를 delta만큼 변경하도록 지정합니다.
CameraUpdateParams	rotateTo(double bearing)	카메라의 베어링 각도를 bearing으로 변경하도록 지정합니다.
CameraUpdateParams	scrollBy(android.graphics.PointF delta)	카메라를 현재 위치에서 delta 픽셀만큼 이동하도록 지정합니다.
CameraUpdateParams	scrollTo(LatLng target)	카메라의 좌표를 target으로 변경하도록 지정합니다.
CameraUpdateParams	tiltBy(double delta)	카메라의 기울기 각도를 delta만큼 변경하도록 지정합니다.
CameraUpdateParams	tiltTo(double tilt)	카메라의 기울기 각도를 tilt로 변경하도록 지정합니다.
CameraUpdateParams	zoomBy(double delta)	카메라의 줌 레벨을 delta만큼 변경하도록 지정합니다.
CameraUpdateParams	zoomIn()	카메라의 줌 레벨을 1만큼 증가하도록 지정합니다.
CameraUpdateParams	zoomOut()	카메라의 줌 레벨을 1만큼 감소하도록 지정합니다.
CameraUpdateParams	zoomTo(double zoom)	카메라의 줌 레벨을 zoom으로 변경하도록 지정합니다.

Methods inherited from class java.lang.Object

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

Constructor Detail

CameraUpdateParams

public CameraUpdateParams()

기본 생성자.

Method Detail

scrollTo

@NonNull
public CameraUpdateParams scrollTo(@NonNull
                                   LatLng target)

카메라의 좌표를 target으로 변경하도록 지정합니다.

Parameters:

target - 지정할 좌표.

Returns:

객체 자신.

scrollBy

@NonNull
public CameraUpdateParams scrollBy(@NonNull
                                   android.graphics.PointF delta)

카메라를 현재 위치에서 delta 픽셀만큼 이동하도록 지정합니다.

Parameters:

delta - 이동할 거리. 픽셀 단위.

Returns:

객체 자신.

zoomTo

@NonNull
public CameraUpdateParams zoomTo(@FloatRange(from=0.0,to=21.0)
                                 double zoom)

카메라의 줌 레벨을 zoom으로 변경하도록 지정합니다.

Parameters:

zoom - 지정할 줌 레벨.

Returns:

객체 자신.

zoomBy

@NonNull
public CameraUpdateParams zoomBy(@FloatRange(from=-21.0,to=21.0)
                                 double delta)

카메라의 줌 레벨을 delta만큼 변경하도록 지정합니다. 양수로 지정할 경우 확대, 음수로 지정할 경우 축소됩니다.

Parameters:

delta - 줌 레벨의 변화량.

Returns:

객체 자신.

zoomIn

@NonNull
public CameraUpdateParams zoomIn()

카메라의 줌 레벨을 1만큼 증가하도록 지정합니다.

Returns:

객체 자신.

zoomOut

@NonNull
public CameraUpdateParams zoomOut()

카메라의 줌 레벨을 1만큼 감소하도록 지정합니다.

Returns:

객체 자신.

tiltTo

@NonNull
public CameraUpdateParams tiltTo(@FloatRange(from=0.0,to=63.0)
                                 double tilt)

카메라의 기울기 각도를 tilt로 변경하도록 지정합니다.

Parameters:

tilt - 기울기 각도. 도 단위.

Returns:

객체 자신.

tiltBy

@NonNull
public CameraUpdateParams tiltBy(@FloatRange(from=-63.0,to=63.0)
                                 double delta)

카메라의 기울기 각도를 delta만큼 변경하도록 지정합니다. 양수로 지정하면 지도가 기울어지고 음수로 지정하면 수직에 가까워집니다.

Parameters:

delta - 기울기 각도의 변화량. 도 단위.

Returns:

객체 자신.

rotateTo

@NonNull
public CameraUpdateParams rotateTo(@FloatRange(from=0.0,to=360.0)
                                   double bearing)

카메라의 베어링 각도를 bearing으로 변경하도록 지정합니다.

Parameters:

bearing - 베어링 각도. 도 단위.

Returns:

객체 자신.

rotateBy

@NonNull
public CameraUpdateParams rotateBy(@FloatRange(from=-360.0,to=360.0)
                                   double delta)

카메라의 베어링 각도를 delta만큼 변경하도록 지정합니다.

Parameters:

delta - 베어링 각도의 변화량. 도 단위.

Returns:

객체 자신.