Package com.naver.maps.map.overlay
Class PolylineOverlay
- java.lang.Object
-
- com.naver.maps.map.overlay.Overlay
-
- com.naver.maps.map.overlay.PolylineOverlay
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
PolylineOverlay.LineCap
끝 지점의 모양.static class
PolylineOverlay.LineJoin
연결점의 모양.-
Nested classes/interfaces inherited from class com.naver.maps.map.overlay.Overlay
Overlay.InvalidBoundsException, Overlay.InvalidCoordinateException, Overlay.OnClickListener
-
-
Field Summary
Fields Modifier and Type Field Description static int
DEFAULT_GLOBAL_Z_INDEX
기본 전역 Z 인덱스.
-
Constructor Summary
Constructors Constructor Description PolylineOverlay()
기본 생성자.PolylineOverlay(List<LatLng> coords)
좌표열을 지정하는 생성자.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description LatLngBounds
getBounds()
오버레이가 차지하는 영역을 반환합니다.PolylineOverlay.LineCap
getCapType()
끝 지점의 모양을 반환합니다.int
getColor()
색상을 반환합니다.List<LatLng>
getCoords()
좌표열을 반환합니다.int
getGlobalZIndex()
전역 Z 인덱스를 반환합니다.PolylineOverlay.LineJoin
getJoinType()
연결점의 모양을 반환합니다.int[]
getPattern()
점선 패턴을 반환합니다.int
getWidth()
두께를 반환합니다.void
setCapType(PolylineOverlay.LineCap capType)
끝 지점의 모양을 지정합니다.void
setColor(int color)
색상을 지정합니다.void
setCoords(List<LatLng> coords)
좌표열을 지정합니다.void
setGlobalZIndex(int globalZIndex)
전역 Z 인덱스를 지정합니다.void
setJoinType(PolylineOverlay.LineJoin joinType)
연결점의 모양을 지정합니다.void
setMap(NaverMap map)
오버레이를map
에 추가합니다.void
setPattern(int... pattern)
점선 패턴을 지정합니다.void
setWidth(int width)
두께를 지정합니다.-
Methods inherited from class com.naver.maps.map.overlay.Overlay
getMap, getMaxZoom, getMinZoom, getOnClickListener, getTag, getZIndex, isAdded, isMaxZoomInclusive, isMinZoomInclusive, isVisible, performClick, setMaxZoom, setMaxZoomInclusive, setMinZoom, setMinZoomInclusive, setOnClickListener, setTag, setVisible, setZIndex
-
-
-
-
Field Detail
-
DEFAULT_GLOBAL_Z_INDEX
public static final int DEFAULT_GLOBAL_Z_INDEX
기본 전역 Z 인덱스.- See Also:
setGlobalZIndex(int)
, Constant Field Values
-
-
Constructor Detail
-
PolylineOverlay
public PolylineOverlay()
기본 생성자.
-
PolylineOverlay
public PolylineOverlay(@NonNull List<LatLng> coords)
- Parameters:
coords
- 좌표열.- Throws:
IllegalArgumentException
-coords
의 크기가2
미만일 경우 발생.
-
-
Method Detail
-
setMap
public void setMap(@Nullable NaverMap map)
오버레이를map
에 추가합니다.map
에null
을 지정하면 지도에서 제거됩니다.
폴리라인을 지도에 추가하기 전에는 반드시setCoords(List)
로 좌표열을 지정해야 합니다. 그렇지 않을 경우IllegalStateException
이 발생합니다.- Overrides:
setMap
in classOverlay
- Parameters:
map
- 오버레이를 추가할 지도 객체.- Throws:
IllegalStateException
-coords
를 지정하지 않았을 경우 발생.
-
getGlobalZIndex
public int getGlobalZIndex()
전역 Z 인덱스를 반환합니다. 여러 오버레이가 화면에서 겹쳐지면 전역 Z 인덱스가 큰 오버레이가 작은 오버레이를 덮습니다. 또한 값이0
이상이면 오버레이가 심벌 위에,0
미만이면 심벌 아래에 그려집니다.
기본값은DEFAULT_GLOBAL_Z_INDEX
입니다.- Overrides:
getGlobalZIndex
in classOverlay
- Returns:
- 전역 Z 인덱스.
-
setGlobalZIndex
public void setGlobalZIndex(int globalZIndex)
전역 Z 인덱스를 지정합니다. 여러 오버레이가 화면에서 겹쳐지면 전역 Z 인덱스가 큰 오버레이가 작은 오버레이를 덮습니다. 또한 값이0
이상이면 오버레이가 심벌 위에,0
미만이면 심벌 아래에 그려집니다.
기본값은DEFAULT_GLOBAL_Z_INDEX
입니다.- Overrides:
setGlobalZIndex
in classOverlay
- Parameters:
globalZIndex
- 전역 Z 인덱스.
-
setCoords
@UiThread public void setCoords(@NonNull List<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 LatLngBounds getBounds()
오버레이가 차지하는 영역을 반환합니다.setCoords(List)
로 지정한 좌표열의 영역과 동일합니다.
기본값은 빈(LatLngBounds.isEmpty()
가true
인) 영역입니다.- Returns:
- 영역.
-
setWidth
@UiThread public void setWidth(@Px int width)
두께를 지정합니다.
기본값은5
입니다.- Parameters:
width
- 두께. 픽셀 단위.
-
getColor
@UiThread public int getColor()
- Returns:
- 색상.
-
setColor
@UiThread public void setColor(int color)
- Parameters:
color
- 색상.
-
getPattern
@NonNull @UiThread public int[] getPattern()
점선 패턴을 반환합니다. 패턴은 픽셀 단위의 배열로 표현되며, 각각2n
번째 요소는 실선의 길이,2n + 1
번째 요소는 공백의 길이를 의미합니다. 빈 배열일 경우 실선이 됩니다.
기본값은 빈 배열입니다.- Returns:
- 점선 패턴.
-
setPattern
@UiThread public void setPattern(int... pattern)
점선 패턴을 지정합니다. 패턴은 픽셀 단위의 배열로 표현되며, 각각2n
번째 요소는 실선의 길이,2n + 1
번째 요소는 공백의 길이를 의미합니다. 빈 배열일 경우 실선이 됩니다.
기본값은 빈 배열입니다.- Parameters:
pattern
- 점선 패턴.
-
getCapType
@NonNull @UiThread public PolylineOverlay.LineCap getCapType()
- Returns:
- 끝 모양.
-
setCapType
@UiThread public void setCapType(PolylineOverlay.LineCap capType)
- Parameters:
capType
- 끝 모양.
-
getJoinType
@NonNull @UiThread public PolylineOverlay.LineJoin getJoinType()
- Returns:
- 연결점 모양.
-
setJoinType
@UiThread public void setJoinType(PolylineOverlay.LineJoin joinType)
- Parameters:
joinType
- 연결점 모양.
-
-