GeOnDT for JS API

Class: U2dPolygon

U2dPolygon

~extends U2dGeometry
2D 지도 위에 다각형 영역을 그리는 클래스입니다.
넣은 좌표를 순서대로 이은 뒤 마지막 점과 첫 점을 자동으로 이어 닫힌 영역을 만들며, 구역·범위·면적을 표현합니다.

좌표는 지도 좌표계(EPSG:3857)로 다룹니다. 위경도(EPSG:4326)로 넣으려면 setPosition에 좌표계를 지정하거나 transformPoint로 먼저 변환합니다. 만들 때는 좌표가 비어 있으므로, 생성한 뒤 setPosition이나 addPosition으로 좌표를 넣어야 영역이 그려집니다.

new U2dPolygon(opt)

2D 다각형 도형을 생성합니다.
채우기·외곽선 스타일과 OpenLayers Feature를 함께 만들며, 좌표는 비어 있는 상태로 시작합니다. 만든 뒤 setPosition이나 addPosition으로 좌표를 세 개 이상 넣어야 화면에 영역이 나타납니다.

Name	Type	Default	Description
`opt`	U2dPolygon~U2dPolygonCO	{}	optional 이름·채우기 색·외곽선 색·외곽선 두께·검색 제외·편집 잠금 등 생성 옵션

Members

type'Polygon'

도형의 종류를 나타내는 문자열입니다.
이 클래스는 항상 'Polygon'이며, 여러 종류의 2D 도형을 함께 다룰 때 어떤 도형인지 구분하는 데 사용합니다.

Methods

getArea()number

다각형이 덮는 넓이를 반환합니다.
꼭짓점을 평면 위의 점으로 보고 계산하며, 지구의 곡률은 반영하지 않습니다. 아직 도형이 만들어지지 않았으면 0을 반환합니다.

Returns:

Type	Description
number	지도 좌표계(EPSG:3857)의 좌표 단위를 제곱한 넓이. 이 좌표계는 적도에서만 1단위가 1미터이고 고위도로 갈수록 늘어나므로, 실제 면적으로 쓰려면 위도에 맞게 보정합니다

getCenter()Array.<number>

다각형을 감싸는 경계 상자의 한가운데 좌표를 반환합니다.
경계 상자 기준이므로 모양이 한쪽으로 치우쳐 있으면 무게중심과는 다릅니다. 라벨을 놓을 자리를 정할 때 사용합니다.

Returns:

Type	Description
Array.<number>	경계 상자 중심의 지도 좌표 `[x, y]` (EPSG:3857). 아직 도형이 만들어지지 않았으면 빈 배열

setPosition(ary, srs)

다각형의 꼭짓점 좌표를 통째로 바꿉니다.
넘긴 좌표를 srs가 가리키는 좌표계에서 지도 좌표계(EPSG:3857)로 하나씩 바꾼 뒤 반영합니다. 이미 지도 좌표로 가지고 있다면 srs에 'EPSG:3857'을 넣어 변환 없이 그대로 쓸 수 있습니다. 마지막 점과 첫 점은 자동으로 이어지므로 첫 점을 끝에 다시 넣지 않아도 됩니다.

바깥쪽 테두리 하나만 사용합니다. ary에 배열을 여러 개 넣어도 첫 번째 것만 반영되고 나머지는 버려집니다.

Name	Type	Default	Description
`ary`	Triple_Array.<number>		꼭짓점 좌표를 테두리별로 묶은 배열 `[[[x, y], ...]]`. 기본 좌표계에서는 `[[[경도, 위도], ...]]`입니다
`srs`	string	'EPSG:4326'	optional 넘긴 좌표가 어떤 좌표계인지 나타내는 코드

Type Definitions

U2dPolygonCOobject

~extends U2dGeometry~U2dGeometryCO
U2dPolygon 생성자에 넘기는 옵션입니다.
다각형의 좌표는 여기에 넣지 않고, 만든 뒤 setPosition이나 addPosition으로 넣습니다.

Properties:

Name	Type	Argument	Default	Description
`name`	string	<optional>		도형을 구분하는 이름. 레이어에서 도형을 찾을 때 쓰며, 넣지 않거나 빈 문자열이면 무작위 GUID 문자열이 자동으로 만들어집니다
`fillColor`	string	<optional>	'rgba(255,255,255,0.4)'	다각형 내부를 채우는 색상. CSS 색 문자열로 적으며 `rgba()`로 투명도를 함께 지정할 수 있습니다
`strokeColor`	string	<optional>	'#3399CC'	다각형 외곽선의 색상. CSS 색 문자열로 적습니다
`strokeWidth`	number	<optional>	1.25	다각형 외곽선의 두께 (픽셀)
`excludeSearch`	boolean	<optional>	false	지도에서 도형을 찾을 때 이 다각형을 검색 대상에서 뺄지 여부
`nonChanged`	boolean	<optional>	false	다각형을 편집하지 못하게 잠글지 여부. 켜면 스타일과 색상·두께를 바꾸는 함수가 값을 바꾸지 않고 그대로 넘어갑니다