Package com.naver.maps.map

Class CameraUpdateParams

java.lang.Object
com.naver.maps.map.CameraUpdateParams
public final class CameraUpdateParams extends Object
카메라를 이동할 지점에 대한 다양한 정보를 나타내는 클래스. 주로 CameraUpdate를 만들기 위한 파라미터로 사용됩니다.

target, zoom, tilt, rotate 등 카메라의 위치에 대한 네 가지 속성을 나타내는 것은 CameraPosition과 유사하지만, CameraPosition은 하나의 절대적인 카메라 위치를 나타내는 데 반해 CameraUpdateParams는 상대적인 변화를 줄 수 있습니다. 이를 위해 하나의 속성에 각각 두 종류의 메서드를 제공합니다.
  • xxxTo(): 속성을 절대적인 값으로 지정합니다.
  • xxxBy(): 속성을 현재 지도의 CameraPosition에 상대적인 값으로 지정합니다.
동일한 속성에 대해 xxxTo() 계열의 메서드와 xxxBy() 계열의 메서드를 모두 호출하면 앞선 호출은 무시됩니다.
See Also:

  • Constructor Details

    • CameraUpdateParams

      public CameraUpdateParams()
      기본 생성자.

  • Method Details

    • scrollTo

      @NonNull public CameraUpdateParams scrollTo(@NonNull com.naver.maps.geometry.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:
      객체 자신.