Dms - Documentation

Dms

new Dms()

경위도 좌표를 십진수(decimal degrees) 혹은 도분초(degree, minutes, seconds) 형식으로 변환하는 클래스이다.

Members

(static) separator

도분초(degree, minutes, second) 및 방위표시 식별을 위한 구분자를 설정할 수 있으며 일반적으로 '\u202f'(narrow no-break space)를 권장한다.

Example

var p = new LatLon(37.2, 126.33);  // 37°12′00.0″N, 126°19′48.0″E
Dms.separator = '\u202f';          // 구분자 적용(narrow no-break space)
var pʹ = new LatLon(37.2, 127.33); // 37° 12′ 00.0″ N, 127° 19′ 48.0″ E

Methods

(static) compassPoint(bearing, precision) → {string}

방위각에 대한 방위문자를 반환한다.

Example

var point = Dms.compassPoint(24);    // 변환결과 : 'NNE'
var point = Dms.compassPoint(24, 1); // 변환결과 : 'N'

Parameters:

Name	Type	Default	Description
`bearing`	number		북쪽 기준
`precision`	number	`3`	정밀도(1 : 4점 기준(N/E/S/W)) / 2 : 8점 기준(N/NE/E/SE...) / 3 : 16점 기준(N/NNE/NE/ENE...))

Returns:

방위표시 문자를 반환한다.

Type: string

(static) parseDMS(dmsStr) → {number}

도분초(degree, minutes, seconds) 좌표값을 십진수로 변환한다. 도분초(degree, minutes, seconds) 입력값은 방위표시 없이 +/- 형식과 북위(N), 남위(S), 동경(E), 서경(W)의 방위표시 방식을 모두 지원한다.

Example

var lat = Dms.parseDMS('37° 28′ 40.12″ N');
var lon = Dms.parseDMS('126° 00′ 05.31″ E');
var p1 = new LatLon(lat, lon); //변환결과 : 37.4778°N, 126.0015°E

Parameters:

Name	Type	Description
`dmsStr`	string \| number	도분초(degree, minutes, seconds) 형식의 좌표값

Returns:

십진수(decimal number) 형식의 좌표값을 반환한다.

Type: number

(static) toBrng(deg, format, dp) → {string}

십진수(decimal degrees) 좌표값에 대한 방위각 계산한다.

Parameters:

Name	Type	Default	Description
`deg`	number		십진수(decimal degree) 형식의 좌표값
`format`	string	`dms`	도, 도+분, 도+분+초에 대한 리턴 형식 설정('d', 'dm', 'dms') 가능
`dp`	number	`0\|2\|4`	0 : dms, 2 : dm, 4 : d 형식으로 설정 가능

Returns:

설정된 형식에 따른 방위각을 반환한다.

Type: string

(static) toLat(deg, format, dp) → {string}

십진수(decimal degrees) 형식의 위도를 도분초(degree, minutes, seconds)형식의 위도로 변환한다.

Parameters:

Name	Type	Default	Description
`deg`	number		십진수(decimal degree) 형식의 위도값
`format`	string	`dms`	도, 도+분, 도+분+초에 대한 리턴 형식 설정('d', 'dm', 'dms') 가능
`dp`	number	`0\|2\|4`	0 : dms, 2 : dm, 4 : d 형식으로 설정 가능

Returns:

설정된 형식에 따른 도분초 위도값을 반환한다.

Type: string

(static) toLon(deg, format, dp) → {string}

십진수(decimal degrees) 형식의 경도를 도분초(degree, minutes, seconds)형식의 경도로 변환한다.

Parameters:

Name	Type	Default	Description
`deg`	number		십진수(decimal degree) 형식의 경도값
`format`	string	`dms`	도, 도+분, 도+분+초에 대한 리턴 형식 설정('d', 'dm', 'dms') 가능
`dp`	number	`0\|2\|4`	0 : dms, 2 : dm, 4 : d 형식으로 설정 가능

Returns:

설정된 형식에 따른 도분초 위도값을 반환한다.

Type: string