logo
Tutorials Examples naver map js api v3 네이버 지도 API MapSystemProjection

Interface: MapSystemProjection

naver.maps. MapSystemProjection

MapSystemProjection은 현재 설정된 지도 유형의 Projection을 가공해 지도 내부에서 사용하는 투영 객체입니다. 이 객체를 이용하면 지도 좌표와 세계 좌표, 화면 픽셀 좌표를 서로 변환할 수 있습니다.

이 인터페이스는 Map 인스턴스의 getProjection 메서드를 이용해 가져올 수 있으며, 직접 초기화해서 사용할 수 없습니다.

Tutorials

Extends

Methods

factor(zoom)

특정 줌 레벨에서 한 축의 타일 개수를 반환합니다.

Parameters
Name Type Description
zoom number

줌 레벨

Returns
Type Description
number

타일의 개수

fromCoordToOffset(coord)

지정한 지도 좌표에 해당하는 픽셀 단위의 offset 좌표를 반환합니다.

Parameters
Name Type Description
coord Coord

지도 좌표

Returns
Type Description
naver.maps.Point

offset 좌표

fromCoordToPoint(coord)

지정한 지도 좌표에 해당하는 세계 좌표를 반환합니다.

Parameters
Name Type Description
coord Coord

지도 좌표

Returns
Type Description
naver.maps.Point

세계 좌표

fromOffsetToCoord(offset)

지정한 픽셀 단위의 offset 좌표에 해당하는 지도 좌표를 반환합니다.

Parameters
Name Type Description
offset naver.maps.Point

offset 좌표

Returns
Type Description
Coord

지도 좌표

fromOffsetToPoint(offset)

지정한 픽셀 단위의 offset 좌표에 해당하는 세계 좌표를 반환합니다.

Parameters
Name Type Description
offset naver.maps.Point

offset 좌표

Returns
Type Description
naver.maps.Point

세계 좌표

fromPointToCoord(point)

지정한 세계 좌표에 해당하는 지도 좌표를 반환합니다.

Parameters
Name Type Description
point naver.maps.Point

세계 좌표

Returns
Type Description
Coord

지도 좌표

fromPointToOffset(point)

지정한 세계 좌표에 해당하는 픽셀 단위의 offset 좌표를 반환합니다.

Parameters
Name Type Description
point naver.maps.Point

세계 좌표

Returns
Type Description
naver.maps.Point

offset 좌표

getDestinationCoord(fromCoord, angle, meter)

지정한 좌표에서 북쪽을 기준으로 지정한 각도(시계 방향)와 거리만큼 떨어진 위치의 지도 좌표를 반환합니다.

Projection 내에 getDestinationCoord 메서드를 구현해야 합니다. 네이버 지도 API에서 제공하는 EPSG3857, UTMK, UTMK_NAVER 지도 투영 객체에는 구현되어 있습니다.

Parameters
Name Type Description
fromCoord Coord

기준이 되는 지도 좌표

angle number

지정한 좌표에서 북쪽을 기준으로 한 시계 방향의 각도(0-북, 90-동, 180-남, 270-서). 이 값이 0이면 현재의 좌표에서 북쪽을 가리키며, 90이면 동쪽을 가리킵니다.

meter number

지정한 좌표에서 구하려는 좌표까지의 거리(미터)

Returns
Type Description
Coord

새로운 지도 좌표

getDistance(coord1, coord2)

지정한 두 지도 좌표 간의 거리를 반환합니다. 단위는 미터입니다.

Projection 내에 getDistance 메서드를 구현해야 합니다. 네이버 지도 API에서 제공하는 EPSG3857, UTMK, UTMK_NAVER 지도 투영 객체에는 구현되어 있습니다.

Parameters
Name Type Description
coord1 Coord

지도 좌표

coord2 Coord

지도 좌표

Returns
Type Description
number

거리

getProjectionName()

현재의 지도 시스템이 적용된 지도 투영 객체(Projection)의 이름을 반환합니다.

Returns
Type Description
number

지도 투영 객체의 이름

scaleDown(operand, zoom)

지정한 피연산자를 줌 레벨의 타일 개수만큼 나누어 축소한 후 반환합니다.

Parameters
Name Type Description
operand number | naver.maps.Point | naver.maps.Size

확장할 피연산자

zoom number

줌 레벨

Returns
Type Description
numver | naver.maps.Point | naver.maps.Size

축소된 값 또는 객체

scaleUp(operand, zoom)

지정한 피연산자를 줌 레벨의 타일 개수만큼 곱해 확대한 후 반환합니다.

Parameters
Name Type Description
operand number | naver.maps.Point | naver.maps.Size

확장할 피연산자

zoom number

줌 레벨

Returns
Type Description
numver | naver.maps.Point | naver.maps.Size

확대된 값 또는 객체