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
확대된 값 또는 객체