Package com.naver.maps.map.overlay

Class PolylineOverlay

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

  • Field Details

  • Constructor Details

    • PolylineOverlay

      public PolylineOverlay()
      기본 생성자.

    • PolylineOverlay

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

  • Method Details

    • setMap

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

      폴리라인을 지도에 추가하기 전에는 반드시 setCoords(List)로 좌표열을 지정해야 합니다. 그렇지 않을 경우 IllegalStateException이 발생합니다.
      Overrides:
      setMap in class Overlay
      Parameters:
      map - 오버레이를 추가할 지도 객체.
      Throws:
      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 List<com.naver.maps.geometry.LatLng> getCoords()
      좌표열을 반환합니다.
      Returns:
      좌표열.

    • setCoords

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

    • getBounds

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

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

    • getWidth

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

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

    • setWidth

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

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

    • getColor

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

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

    • setColor

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

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

    • getPattern

      @NonNull @Size(multiple=2L) @UiThread public int[] getPattern()
      점선 패턴을 반환합니다. 패턴은 픽셀 단위의 배열로 표현되며, 각각 2n번째 요소는 실선의 길이, 2n + 1번째 요소는 공백의 길이를 의미합니다. 빈 배열일 경우 실선이 됩니다.

      기본값은 빈 배열입니다.
      Returns:
      점선 패턴.

    • setPattern

      @UiThread public void setPattern(@Size(multiple=2L) int... pattern)
      점선 패턴을 지정합니다. 패턴은 픽셀 단위의 배열로 표현되며, 각각 2n번째 요소는 실선의 길이, 2n + 1번째 요소는 공백의 길이를 의미합니다. 빈 배열일 경우 실선이 됩니다.

      기본값은 빈 배열입니다.
      Parameters:
      pattern - 점선 패턴.

    • getCapType

      @NonNull @UiThread public PolylineOverlay.LineCap getCapType()
      끝 지점의 모양을 반환합니다.

      기본값은 PolylineOverlay.LineCap.Butt입니다.
      Returns:
      끝 모양.

    • setCapType

      @UiThread public void setCapType(PolylineOverlay.LineCap capType)
      끝 지점의 모양을 지정합니다.

      기본값은 PolylineOverlay.LineCap.Butt입니다.
      Parameters:
      capType - 끝 모양.

    • getJoinType

      @NonNull @UiThread public PolylineOverlay.LineJoin getJoinType()
      연결점의 모양을 반환합니다.

      기본값은 PolylineOverlay.LineJoin.Miter입니다.
      Returns:
      연결점 모양.

    • setJoinType

      @UiThread public void setJoinType(PolylineOverlay.LineJoin joinType)
      연결점의 모양을 지정합니다.

      기본값은 PolylineOverlay.LineJoin.Miter입니다.
      Parameters:
      joinType - 연결점 모양.