new naver.maps.Polygon(options)
Parameters
Name | Type | Argument | Description |
---|---|---|---|
options |
PolygonOptions |
<optional> |
도형 옵션 |
- Tutorials
Extends
Methods
-
getAreaSize()
-
도형의 전체 면적을 제곱미터 단위로 반환합니다.
Returns
Type Description number
면적
-
getBounds()
-
도형의 좌표 경계를 반환합니다.
Returns
Type Description Bounds
좌표 경계
-
getClickable()
-
도형의 클릭 허용 여부를 반환합니다.
Returns
Type Description boolean
클릭 허용 여부
-
getDrawingRect()
-
도형이 그려지는 영역의 경계 좌표를 반환합니다. 기준 좌표는 세계 좌표를 화면 픽셀로 변환한 픽셀 좌표입니다. 좌표 체계에 대한 자세한 설명은 Projections and Coordinate Systems의 좌표 체계를 참고합니다.
Returns
Type Description Bounds
경계 좌표
-
getMap()
-
현재 오버레이가 추가된
Map
객체를 반환합니다.- Inherited From
Returns
Type Description naver.maps.Map | null
Map
객체 -
getOptions(key)
-
도형의 모든 옵션 또는 특정 옵션을 반환합니다.
Parameters
Name Type Argument Description key
string <optional>
가져올 옵션 이름
Returns
Type Description PolygonOptions | any
도형 옵션
-
getPath()
-
첫 번째 도형의 좌표 목록을 반환합니다.
Returns
Type Description ArrayOfCoords | KVOArrayOfCoords
첫 번째 도형의 좌표 목록
-
getPaths()
-
모든 도형의 좌표 목록을 반환합니다.
Returns
Type Description Array.<ArrayOfCoords> | KVOArray.<KVOArrayOfCoords>
모든 도형의 좌표 목록
-
getStyles(key)
-
도형의 모든 스타일 또는 특정 스타일의 값을 반환합니다.
Parameters
Name Type Argument Description key
string <optional>
가져올 스타일 이름
Returns
Type Description PolygonOptions | any
도형 스타일
-
getVisible()
-
도형의 노출 여부를 반환합니다.
Returns
Type Description boolean
노출 허용 여부
-
getZIndex()
-
도형의 쌓임 순서를 반환합니다.
Returns
Type Description number
쌓임 순서
-
setClickable(clickable)
-
도형의 클릭 허용 여부를 설정합니다.
Parameters
Name Type Description clickable
boolean 클릭 허용 여부
Fires
-
setMap(map)
-
오버레이를 지도에 추가합니다. 인수로 null을 전달하면 오버레이를 지도에서 제거합니다.
Parameters
Name Type Description map
naver.maps.Map | null 오버레이를 추가할
Map
객체- Inherited From
-
setOptions(options)
-
도형의 옵션을 변경하거나 새로 설정합니다.
Parameters
Name Type Description options
PolygonOptions 도형 옵션
Fires
-
setOptions(key, value)
-
도형의 옵션을 변경하거나 새로 설정합니다.
Parameters
Name Type Description key
string 도형 옵션 이름
value
any 도형 옵션값
Fires
-
setPath(path)
-
도형의 좌표 목록을 설정합니다.
Parameters
Name Type Description path
ArrayOfCoords | KVOArrayOfCoords | ArrayOfCoordsLiteral 도형 좌표 목록
-
setPaths(paths)
-
도형의 좌표 목록을 설정합니다.
Parameters
Name Type Description paths
Array.<ArrayOfCoords> | KVOArray.<KVOArrayOfCoords> | Array.<ArrayOfCoordsLiteral> 도형 좌표 목록. 여러 개의
path
로 구성됩니다. -
setStyles(key, value)
-
도형의 스타일을 변경하거나 새로 설정합니다.
Parameters
Name Type Description key
string 도형 스타일 이름
value
any 도형 스타일값
-
setStyles(options)
-
도형의 스타일을 변경하거나 새로 설정합니다.
Parameters
Name Type Description options
PolygonOptions 도형 스타일
-
setVisible(visible)
-
도형의 노출 허용 여부를 설정합니다.
Parameters
Name Type Description visible
boolean 노출 허용 여부
Fires
-
setZIndex(zIndex)
-
도형의 쌓임 순서를 설정합니다.
Parameters
Name Type Description zIndex
number 쌓임 순서
Fires
Type Definitions
-
PolygonOptions
-
PolygonOptions
객체는Polygon
을 정의하는 옵션을 나타냅니다.Type:
- solid
- shortdash
- shortdot
- shortdashdot
- shortdashdotdot
- dot
- dash
- longdash
- dashdot
- longdashdot
- longdashdotdot
Properties
Name Type Argument Default Description map
naver.maps.Map <optional>
도형이 그려질 지도 객체입니다.
paths
Array.<ArrayOfCoords> | KVOArray.<KVOArrayOfCoords> | Array.<ArrayOfCoordsLiteral> 도형의 좌표 목록입니다.
strokeWeight
number <optional>
1 도형의 선 두께입니다.
strokeOpacity
number <optional>
1 도형의 선 불투명도입니다. 값의 범위는
0~1
입니다.strokeColor
string <optional>
#007EEA 도형의 선 색상입니다. CSS 색상 표현법으로 설정합니다.
strokeStyle
string <optional>
solid 도형의 선 스타일입니다.
strokeLineCap
string <optional>
butt 도형에 사용되는 선의 마감 스타일입니다. SVG의 stroke-linecap 스타일 표준을 따릅니다.
사용 가능한 값은
butt
,flat
(butt와 동일),round
,square
입니다.아래 그림의 왼쪽부터 순서대로
butt
,round
,square
입니다.
strokeLineJoin
string <optional>
miter 도형에 사용되는 선들이 맞닿는 부분의 마감 스타일입니다. SVG의 stroke-linejoin 스타일 표준을 따릅니다.
사용 가능한 값은
miter
,round
,bevel
입니다.아래 그림의 위부터 순서대로
miter
,round
,bevel
입니다.
fillColor
string <optional>
none 도형 영역을 채울 색상입니다. CSS 색상 표현법으로 설정합니다.
fillOpacity
number <optional>
1 도형 영역을 채울 색상의 불투명도입니다. 값의 범위는
0~1
입니다.clickable
boolean <optional>
false 도형의 클릭 허용 여부입니다. 이 값이
true
이면 도형은 마우스, 터치 이벤트를 받을 수 있습니다. 그렇지 않으면 이벤트를 받지 못합니다.visible
boolean <optional>
true 도형의 노출 허용 여부입니다.
zIndex
number <optional>
0 도형의 쌓임 순서입니다.
Events
-
click
-
Parameters
Name Type Description pointerEvent
PointerEvent 사용자가 도형에서 마우스 왼쪽 버튼을 클릭했을 때 이벤트가 발생합니다.
-
clickable_changed
-
Parameters
Name Type Description clickable
boolean 도형의 클릭 허용 여부 옵션이 변경되면 이벤트가 발생합니다.
-
dblclick
-
Parameters
Name Type Description pointerEvent
PointerEvent 사용자가 도형에서 마우스 왼쪽 버튼을 더블 클릭했을 때 이벤트가 발생합니다.
-
mousedown
-
Parameters
Name Type Description pointerEvent
PointerEvent 사용자가 도형에서 마우스 버튼을 누를 때 이벤트가 발생합니다.
-
mouseout
-
Parameters
Name Type Description pointerEvent
PointerEvent 사용자의 마우스 포인터가 도형의 경계를 벗어날 때 이벤트가 발생합니다.
-
mouseover
-
Parameters
Name Type Description pointerEvent
PointerEvent 사용자의 마우스 포인터가 도형의 경계에 들어올 때 이벤트가 발생합니다.
-
mouseup
-
Parameters
Name Type Description pointerEvent
PointerEvent 사용자가 도형에서 마우스 버튼을 놓을 때 이벤트가 발생합니다.
-
visible_changed
-
Parameters
Name Type Description visible
boolean 도형의 노출 허용 여부 옵션이 변경되면 이벤트가 발생합니다.
-
zIndex_changed
-
Parameters
Name Type Description zIndex
number 도형의 쌓임 순서 옵션이 변경되면 이벤트가 발생합니다.