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

지도에 선을 나타내는 오버레이.

Nested Class Summary

Nested Classes

Modifier and Type	Class and 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 and Description
static int	DEFAULT_GLOBAL_Z_INDEX 기본 전역 Z 인덱스.

Constructor Summary

Constructors

Constructor and Description
PolylineOverlay() 기본 생성자.
PolylineOverlay(List<LatLng> coords) 좌표열을 지정하는 생성자.

Method Summary

Modifier and Type	Method and 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

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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)

좌표열을 지정하는 생성자. 만약 coords의 크기가 2 미만이면 IllegalArgumentException이 발생합니다.

Parameters:

coords - 좌표열.

Throws:

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:

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<LatLng> getCoords()

좌표열을 반환합니다.

Returns:

좌표열.

setCoords

@UiThread
public void setCoords(@NonNull
                                List<LatLng> coords)

좌표열을 지정합니다. 만약 coords의 크기가 2 미만이면 IllegalArgumentException이 발생합니다. coords에 null이거나 유효하지 않은(LatLng.isValid()가 false인) 좌표가 있다면 InvalidCoordinateException이 발생합니다.

Parameters:

coords - 좌표열.

Throws:

IllegalArgumentException - coords의 크기가 2 미만일 경우 발생.

InvalidCoordinateException - coords에 유효하지 않은 좌표가 있을 경우 발생.

getBounds

@NonNull
 @UiThread
public 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

@UiThread
public int getColor()

색상을 반환합니다.

기본값은 Color.BLACK입니다.

Returns:

색상.

setColor

@UiThread
public void setColor(int color)

색상을 지정합니다.

기본값은 Color.BLACK입니다.

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()

끝 지점의 모양을 반환합니다.

기본값은 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 - 연결점 모양.