Package com.naver.maps.map

Class 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 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​(double zoom)
        카메라의 줌 레벨을 zoom으로 변경하도록 지정합니다.
        Parameters:
        zoom - 지정할 줌 레벨.
        Returns:
        객체 자신.

      • zoomBy

        @NonNull
public CameraUpdateParams zoomBy​(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​(double tilt)
        카메라의 기울기 각도를 tilt로 변경하도록 지정합니다.
        Parameters:
        tilt - 기울기 각도. 도 단위.
        Returns:
        객체 자신.

      • tiltBy

        @NonNull
public CameraUpdateParams tiltBy​(double delta)
        카메라의 기울기 각도를 delta만큼 변경하도록 지정합니다. 양수로 지정하면 지도가 기울어지고 음수로 지정하면 수직에 가까워집니다.
        Parameters:
        delta - 기울기 각도의 변화량. 도 단위.
        Returns:
        객체 자신.

      • rotateTo

        @NonNull
public CameraUpdateParams rotateTo​(double bearing)
        카메라의 베어링 각도를 bearing으로 변경하도록 지정합니다.
        Parameters:
        bearing - 베어링 각도. 도 단위.
        Returns:
        객체 자신.

      • rotateBy

        @NonNull
public CameraUpdateParams rotateBy​(double delta)
        카메라의 베어링 각도를 delta만큼 변경하도록 지정합니다.
        Parameters:
        delta - 베어링 각도의 변화량. 도 단위.
        Returns:
        객체 자신.