Package com.naver.maps.map.overlay

Class CircleOverlay

  • All Implemented Interfaces:
    Pickable
    public final class CircleOverlay
extends Overlay
    지도에 원을 나타내는 오버레이.

    • Constructor Detail

      • CircleOverlay

        public CircleOverlay()
        기본 생성자.

    • Method Detail

      • 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 LatLng getCenter()
        중심점을 반환합니다.

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

      • setCenter

        @UiThread
public void setCenter​(@NonNull
                      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 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 - 테두리의 색상.