Area

Area

사용자가 설정한 영역의 면적을 측정하기 위한 클래스로 측정 단위(meter, mile)에 따라 결과가 표시된다.

Constructor

new Area()

객체 초기 상태를 설정한다.

Methods

addCoordinates()

경위도(Degree) 좌표 배열값을 기준으로 면적 측정 결과를 표시한다.
setUnit 함수를 호출해야 측정결과가 화면에 도시된다.

Example
// 좌표 배열값을 입력하여 면적을 계산한다.
let geoCoordinates = [];
geoCoordinates.push([126.5,37.5]);
geoCoordinates.push([127.5,38.5]);
geoCoordinates.push([128.5,37.5]);
window.area.addCoordinates(geoCoordinates);
window.area.setUnit('meter'); //meter, mile지원

clear()

객체 삭제

createArea()

면적 측정을 활성화하고 측정을 시작한다.

Example
window.eventManager.setMapMode('terrainAnalysis');
window.area.createArea();

forcedCompletion()

면적 측정을 강제로 종료한다.

getArea() → {string}

면적 측정 결과값을 얻어온다. 측정 면적은 1,000,000 m² 보다 클경우 km²로 환산되며 측정 단위는 meter와 mile을 지원한다.

Returns:

면적 측정 결과값을 리턴한다.

Type
string

getFillColor() → {color}

면적측정 채움색상 설정값을 반환한다.

Returns:

면적 채움 색상 반환

Type
color

getLineColor()

면적측정 선 색상 설정값을 반환한다.

Returns:

선 색상 반환

getSegmentLength() → {number}

면적 측정시 세그먼트 갯수를 반환한다.

Returns:

면적 측정 세그먼트 갯수 반환

Type
number

getTextVisible() → {bool}

면적 측정시 텍스트 표시여부 상태값을 반환한다.

Returns:

면적 측정 텍스트 표시여부 반환

Type
bool

getUnit() → {string}

면적 측정 단위를 리턴한다.

Returns:

면적 측정 단위를 리턴(meter, mile로 관리)한다.

Type
string

getVisible()

면적 측정시 표시여부 상태값을 반환한다.

Returns:

면적 측정 표시여부 반환

setFillColor(val)

면적측정 채움색상을 설정한다.

Example
window.area.setFillColor('rgba(255, 255, 0, 0.1)'); //면적측정 채움 색상 설정
Parameters:
Name Type Description
val number

면적 측정시 채움 색상 설정

setLineColor(val)

면적측정 선 색상을 설정한다.

Example
window.area.setLineColor('rgba(255, 255, 0, 0.8)'); //면적측정 라인 색상 설정
Parameters:
Name Type Description
val number

면적 측정시 선 색상 설정('#ff0000'와 'rgba(255, 255, 0, 0.8)' 설정 가능)

setSegmentRemove(index) → {number}

면적 측정 객체들 중에 해당 세그먼트만을 삭제한다.

Example
//0번째 객체 삭제 테스트
 let length = window.area.getSegmentLength();
 if(length > 2) {
     window.area.setSegmentRemove(0);
}
Parameters:
Name Type Description
index number

면적 측정시 해당 세그먼트 인덱스 값 설정

Returns:

인덱스 범위를 초과할 경우 함수 종료

Type
number

setSegmentRemoveAll()

면적 측정시 모든 세그먼트를 삭제한다.

Example
//모든 객체 삭제
window.area.setSegmentRemoveAll();

setTextVisible(val)

면적 측정시 텍스트 표시여부를 설정한다.

Parameters:
Name Type Description
val number

면적 측정 텍스트 표시여부 설정

setUnit(unit)

면적 측정 단위를 설정한다.

Parameters:
Name Type Default Description
unit string meter

측정 단위 설정(meter, mile로 설정 가능)

setVisible(val)

면적 측정시 표시여부를 설정한다.

Example
window.area.setVisible(true); //면적측정 표시 여부
Parameters:
Name Type Description
val number

면적 측정 표시 여부 설정