Package com.naver.maps.map.overlay
Class PolygonOverlay
- java.lang.Object
-
- com.naver.maps.map.overlay.Overlay
-
- com.naver.maps.map.overlay.PolygonOverlay
-
-
Nested Class Summary
-
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 PolygonOverlay()
기본 생성자.PolygonOverlay(java.util.List<LatLng> coords)
좌표열을 지정하는 생성자.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description LatLngBounds
getBounds()
오버레이가 차지하는 영역을 반환합니다.int
getColor()
면의 색상을 반환합니다.java.util.List<LatLng>
getCoords()
좌표열을 반환합니다.int
getGlobalZIndex()
전역 Z 인덱스를 반환합니다.java.util.List<java.util.List<LatLng>>
getHoles()
내부 홀의 목록을 반환합니다.int
getOutlineColor()
테두리의 색상을 반환합니다.int
getOutlineWidth()
테두리의 두께를 반환합니다.void
setColor(int color)
면의 색상을 지정합니다.void
setCoords(java.util.List<LatLng> coords)
좌표열을 지정합니다.void
setGlobalZIndex(int globalZIndex)
전역 Z 인덱스를 지정합니다.void
setHoles(java.util.List<java.util.List<LatLng>> holes)
내부 홀의 목록을 지정합니다.void
setMap(NaverMap map)
오버레이를map
에 추가합니다.void
setOutlineColor(int color)
테두리의 색상을 지정합니다.void
setOutlineWidth(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
-
PolygonOverlay
public PolygonOverlay()
기본 생성자.
-
PolygonOverlay
public PolygonOverlay(@NonNull java.util.List<LatLng> coords)
좌표열을 지정하는 생성자. 만약coords
의 크기가3
미만이면IllegalArgumentException
이 발생합니다.- Parameters:
coords
- 좌표열.- Throws:
java.lang.IllegalArgumentException
-coords
의 크기가3
미만일 경우 발생.
-
-
Method Detail
-
setMap
public void setMap(@Nullable NaverMap map)
오버레이를map
에 추가합니다.map
에null
을 지정하면 지도에서 제거됩니다.
PolygonOverlay
를 지도에 추가하기 전에는 반드시setCoords(List)
로 좌표열을 지정해야 합니다. 그렇지 않을 경우IllegalStateException
이 발생합니다.
-
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 인덱스.
-
getCoords
@UiThread @NonNull public java.util.List<LatLng> getCoords()
좌표열을 반환합니다.- Returns:
- 좌표열.
-
setCoords
@UiThread public void setCoords(@NonNull java.util.List<LatLng> coords)
좌표열을 지정합니다. 만약coords
의 크기가3
미만이면IllegalArgumentException
이 발생합니다.coords
에null
이거나 유효하지 않은(LatLng.isValid()
가false
인) 좌표가 있다면Overlay.InvalidCoordinateException
이 발생합니다.- Parameters:
coords
- 좌표열.- Throws:
java.lang.IllegalArgumentException
-coords
의 크기가3
미만일 경우 발생.Overlay.InvalidCoordinateException
-coords
에 유효하지 않은 좌표가 있을 경우 발생.
-
getBounds
@NonNull @UiThread public LatLngBounds getBounds()
오버레이가 차지하는 영역을 반환합니다.setCoords(List)
로 지정한 좌표열의 영역과 동일합니다.
기본값은 빈(LatLngBounds.isEmpty()
가true
인) 영역입니다.- Returns:
- 영역.
-
getHoles
@NonNull @UiThread public java.util.List<java.util.List<LatLng>> getHoles()
내부 홀의 목록을 반환합니다.- Returns:
- 내부 홀 목록.
-
setHoles
@UiThread public void setHoles(@NonNull java.util.List<java.util.List<LatLng>> holes)
내부 홀의 목록을 지정합니다. 각 홀의 좌표열은 폴리곤의 외곽 좌표열과 반대 방향으로 감겨 있어야 합니다. 즉, 외곽 좌표열이 시계 방향이라면 내부 홀의 좌표열은 시계 반대 방향이어야 합니다. 빈 목록을 지정할 경우 내부 홀이 없는 폴리곤이 그려집니다. 만약 각 홀의 크기가2
미만이면IllegalArgumentException
이 발생합니다. 각 홀에null
이거나 유효하지 않은(LatLng.isValid()
가false
인) 좌표가 있다면Overlay.InvalidCoordinateException
이 발생합니다.- Parameters:
holes
- 내부 홀 목록.- Throws:
java.lang.IllegalArgumentException
- 각 홀의 크기가2
미만일 경우 발생.Overlay.InvalidCoordinateException
- 각 홀에 유효하지 않은 좌표가 있을 경우 발생.
-
getColor
@UiThread public int getColor()
면의 색상을 반환합니다.
기본값은Color.WHITE
입니다.- Returns:
- 면의 색상.
-
setColor
@UiThread public void setColor(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
@UiThread public int getOutlineColor()
테두리의 색상을 반환합니다.
기본값은Color.BLACK
입니다.- Returns:
- 테두리의 색상.
-
setOutlineColor
@UiThread public void setOutlineColor(int color)
테두리의 색상을 지정합니다.
기본값은Color.BLACK
입니다.- Parameters:
color
- 테두리의 색상.
-
-