Package com.naver.maps.map.overlay

Class CircleOverlay

java.lang.Object
com.naver.maps.map.overlay.Overlay
com.naver.maps.map.overlay.CircleOverlay
All Implemented Interfaces:
Pickable
public final class CircleOverlay extends Overlay
지도에 원을 나타내는 오버레이.

  • Field Details

  • Constructor Details

    • CircleOverlay

      public CircleOverlay()
      기본 생성자.

    • CircleOverlay

      public CircleOverlay(@NonNull com.naver.maps.geometry.LatLng center, @FloatRange(from=0.0) double radius)
      중심점과 반경을 지정하는 생성자. 만약 center가 유효하지 않은(LatLng.isValid()가 false인) 좌표라면 Overlay.InvalidCoordinateException이 발생합니다.
      Parameters:
      center - 중심점.
      radius - 반경. 미터 단위.
      Throws:
      Overlay.InvalidCoordinateException - center가 유효하지 않은 경우 발생.

  • Method Details

    • setMap

      public void setMap(@Nullable NaverMap map)
      오버레이를 map에 추가합니다. map에 null을 지정하면 지도에서 제거됩니다.

      서클 오버레이를 지도에 추가하기 전에는 반드시 setCenter(LatLng)로 중심점을 지정해야 합니다. 그렇지 않을 경우 Overlay.InvalidCoordinateException이 발생합니다.
      Overrides:
      setMap in class Overlay
      Parameters:
      map - 오버레이를 추가할 지도 객체.
      Throws:
      Overlay.InvalidCoordinateException - position을 지정하지 않은 경우 발생.

    • getGlobalZIndex

      public int getGlobalZIndex()
      전역 Z 인덱스를 반환합니다. 여러 오버레이가 화면에서 겹쳐지면 전역 Z 인덱스가 큰 오버레이가 작은 오버레이를 덮습니다. 또한 값이 0 이상이면 오버레이가 심벌 위에, 0 미만이면 심벌 아래에 그려집니다.

      기본값은 DEFAULT_GLOBAL_Z_INDEX입니다.
      Overrides:
      getGlobalZIndex in class Overlay
      Returns:
      전역 Z 인덱스.

    • setGlobalZIndex

      public void setGlobalZIndex(int globalZIndex)
      전역 Z 인덱스를 지정합니다. 여러 오버레이가 화면에서 겹쳐지면 전역 Z 인덱스가 큰 오버레이가 작은 오버레이를 덮습니다. 또한 값이 0 이상이면 오버레이가 심벌 위에, 0 미만이면 심벌 아래에 그려집니다.

      기본값은 DEFAULT_GLOBAL_Z_INDEX입니다.
      Overrides:
      setGlobalZIndex in class Overlay
      Parameters:
      globalZIndex - 전역 Z 인덱스.

    • getCenter

      @NonNull @UiThread public com.naver.maps.geometry.LatLng getCenter()
      중심점을 반환합니다.

      기본값은 유효하지 않은(LatLng.isValid()가 false인) 좌표입니다.
      Returns:
      좌표.

    • setCenter

      @UiThread public void setCenter(@NonNull com.naver.maps.geometry.LatLng center)
      중심점을 지정합니다. 원을 지도에 추가하기 전에 반드시 이 메서드를 호출해 좌표를 지정해야 합니다. 만약 center가 유효하지 않은(LatLng.isValid()가 false인) 좌표라면 Overlay.InvalidCoordinateException이 발생합니다.
      Parameters:
      center - 중심점.
      Throws:
      Overlay.InvalidCoordinateException - center가 유효하지 않은 경우 발생.

    • getRadius

      @FloatRange(from=0.0) @UiThread public double getRadius()
      반경을 반환합니다. 반경이 0일 경우 오버레이가 그려지지 않습니다.

      기본값은 1000입니다.
      Returns:
      반경. 미터 단위.

    • setRadius

      @UiThread public void setRadius(@FloatRange(from=0.0) double radius)
      반경을 지정합니다. 반경이 0일 경우 오버레이가 그려지지 않습니다.

      기본값은 1000입니다.
      Parameters:
      radius - 반경. 미터 단위.

    • getBounds

      @NonNull @UiThread public com.naver.maps.geometry.LatLngBounds getBounds()
      오버레이가 차지하는 영역을 반환합니다.

      기본값은 빈(LatLngBounds.isEmpty()가 true인) 영역입니다.
      Returns:
      영역.

    • getColor

      @ColorInt @UiThread public int getColor()
      색상을 반환합니다.

      기본값은 Color.WHITE입니다.
      Returns:
      원의 색상.

    • setColor

      @UiThread public void setColor(@ColorInt int color)
      색상을 지정합니다.

      기본값은 Color.WHITE입니다.
      Parameters:
      color - 원의 색상.

    • getOutlineWidth

      @Px @UiThread public int getOutlineWidth()
      테두리의 두께를 반환합니다. 0일 경우 테두리가 그려지지 않습니다.

      기본값은 0입니다.
      Returns:
      두께. 픽셀 단위.

    • setOutlineWidth

      @UiThread public void setOutlineWidth(@Px int width)
      테두리의 두께를 설정합니다. 0일 경우 테두리가 그려지지 않습니다.

      기본값은 0입니다.
      Parameters:
      width - 두께. 픽셀 단위.

    • getOutlineColor

      @ColorInt @UiThread public int getOutlineColor()
      테두리의 색상을 반환합니다.

      기본값은 Color.BLACK입니다.
      Returns:
      테두리의 색상.

    • setOutlineColor

      @UiThread public void setOutlineColor(@ColorInt int color)
      테두리의 색상을 지정합니다.

      기본값은 Color.BLACK입니다.
      Parameters:
      color - 테두리의 색상.