Package com.naver.maps.map.overlay

Class ArrowheadPathOverlay

  • All Implemented Interfaces:
    Pickable
    public final class ArrowheadPathOverlay
extends Overlay
    화살표 형태로 방향 또는 회전 지점을 나타내는 오버레이. 경로선 오버레이와 마찬가지로 좌표열을 나타내지만 진척률을 지정할 수 없고, 끝 지점에 삼각형 모양의 머리가 추가됩니다.

    • Constructor Detail

      • ArrowheadPathOverlay

        public ArrowheadPathOverlay()
        기본 생성자.

      • ArrowheadPathOverlay

        public ArrowheadPathOverlay​(@NonNull @Size(min=2L)
                            java.util.List<LatLng> coords)
        좌표열을 지정하는 생성자. 만약 coords의 크기가 2 미만이면 IllegalArgumentException이 발생합니다.
        Parameters:
        coords - 좌표열.
        Throws:
        java.lang.IllegalArgumentException - coords의 크기가 2 미만일 경우 발생.

    • Method Detail

      • setMap

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

        화살표를 지도에 추가하기 전에는 반드시 setCoords(List)로 좌표열을 지정해야 합니다. 그렇지 않을 경우 IllegalStateException이 발생합니다.
        Overrides:
        setMap in class Overlay
        Parameters:
        map - 오버레이를 추가할 지도 객체.
        Throws:
        java.lang.IllegalStateException - coords를 지정하지 않았을 경우 발생.

      • 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 인덱스.

      • getCoords

        @NonNull
@UiThread
public java.util.List<LatLng> getCoords()
        좌표열을 반환합니다.
        Returns:
        점 목록.

      • setCoords

        @UiThread
public void setCoords​(@NonNull @Size(min=2L)
                      java.util.List<LatLng> coords)
        좌표열을 지정합니다. 만약 coords의 크기가 2 미만이면 IllegalArgumentException이 발생합니다. coords에 null이거나 유효하지 않은(LatLng.isValid()가 false인) 좌표가 있다면 Overlay.InvalidCoordinateException이 발생합니다.
        Parameters:
        coords - 좌표열.
        Throws:
        java.lang.IllegalArgumentException - coords의 크기가 2 미만일 경우 발생.
        Overlay.InvalidCoordinateException - coords에 유효하지 않은 좌표가 있을 경우 발생.

      • getBounds

        @NonNull
@UiThread
public LatLngBounds getBounds()
        오버레이가 차지하는 영역을 반환합니다. setCoords(List)로 지정한 좌표열의 영역과 동일합니다.

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

      • getWidth

        @Px
@UiThread
public int getWidth()
        두께를 반환합니다.

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

      • setWidth

        @UiThread
public void setWidth​(@Px
                     int width)
        두께를 지정합니다.

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

      • getHeadSizeRatio

        @UiThread
@FloatRange(from=1.0)
public float getHeadSizeRatio()
        머리 크기의 배율을 반환합니다. 두께에 배율을 곱한 값이 머리의 크기가 됩니다.

        기본값은 2.5입니다.
        Returns:
        머리 크기의 배율.

      • setHeadSizeRatio

        @UiThread
public void setHeadSizeRatio​(@FloatRange(from=1.0)
                             float headSizeRatio)
        머리 크기의 배율을 반환합니다. 두께에 배율을 곱한 값이 머리의 크기가 됩니다.

        기본값은 2.5입니다.
        Parameters:
        headSizeRatio - 머리 크기의 배율.

      • 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()
        외곽선의 두께를 반환합니다.

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

      • setOutlineWidth

        @UiThread
public void setOutlineWidth​(@Px
                            int width)
        외곽선의 두께를 지정합니다.

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

      • getOutlineColor

        @ColorInt
@UiThread
public int getOutlineColor()
        외곽선의 색상을 반환합니다. 외곽선의 색상은 반투명일 수 없으며, 완전히 투명하거나 완전히 불투명해야만 합니다. 색상의 알파가 0이 아닌 경우 완전히 불투명한 것으로 간주됩니다.

        기본값은 Color.BLACK입니다.
        Returns:
        색상.

      • setOutlineColor

        @UiThread
public void setOutlineColor​(@ColorInt
                            int color)
        외곽선의 색상을 지정합니다. 외곽선의 색상은 반투명일 수 없으며, 완전히 투명하거나 완전히 불투명해야만 합니다. 색상의 알파가 0이 아닌 경우 완전히 불투명한 것으로 간주됩니다.

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

      • getElevation

        @Px
@UiThread
public int getElevation()
        엘리베이션을 반환합니다.

        기본값은 0입니다.
        Returns:
        높이. 픽셀 단위.

      • setElevation

        @UiThread
public void setElevation​(@Px
                         int elevation)
        엘리베이션을 지정합니다.

        기본값은 0입니다.
        Parameters:
        elevation - 높이. 픽셀 단위.