지도API v3 레퍼런스
작성자 : 타돌이
번호 : 65
(2010-08-04 19:49)
추천 : 0
조회 : 55259

목차

Map

생성자 설명
new daum.maps.Map(Node node, Object options) 새로운 지도를 만든다.
  • node - 지도가 위치할 HTML 엘리먼트
    options 객체의 구성은 다음과 같다.
  • LatLng center - 중심 좌표 (필수)
  • number level - 확대 수준 (기본값: 3)
  • MapTypeId mapTypeId - 지도 종류 (기본값: 일반 지도)
  • draggable boolean - 마우스로 드래그하여 시점을 변경 가능한지의 여부
  • scrollwheel boolean - 휠로 확대 및 축소 가능 여부

메소드 설명
void setCenter(LatLng latLng) 중심 좌표를 지정한다.
LatLng getCenter() 중심 좌표를 반환한다.
void setLevel(number level) 확대 수준을 지정한다. 0부터 11까지의 정수이며, 작을수록 확대된다.
number getLevel() 확대 수준을 반환한다. 0부터 11까지의 정수이며, 작을수록 확대된다.
void setMapTypeId(MapTypeId mapTypeId) 지도 종류를 지정한다.
MapTypeId getMapTypeId() 지도 종류를 반환한다.
void setBounds(LatLngBounds bounds) 주어진 영역이 지도 화면 안에 전부 나타날 수 있도록 중심 좌표와 확대 수준을 조정한다.
LatLngBounds getBounds() 보여주고있는 영역을 반환한다.
void panTo(LatLng latLng) 중심 좌표를 지정한 좌표로 부드럽게 이동한다.
만약 이동할 거리가 지도 화면의 크기보다 클 경우 애니메이션 없이 이동한다.
void addControl(Node control, ControlPosition position) 컨트롤을 추가한다.
  • control - 추가하고자하는 컨트롤의 엘리먼트
  • position - 컨트롤의 위치
void removeControl(Node control, ControlPosition position) 컨트롤을 제거한다.
  • control - 제거하고자하는 컨트롤의 엘리먼트
  • position - 컨트롤의 위치
void relayout() 지도 엘리먼트의 크기를 변경한 후에는 반드시 이 함수를 호출해야 한다.
단, window의 resize 이벤트에 대해서는 자동으로 호출한다.

이벤트 인자 설명
center_changed - 중심 좌표가 변경되면 발생한다.
zoom_changed - 확대 수준이 변경되면 발생한다.
bounds_changed - 영역이 변경되면 발생한다.
click MouseEvent 클릭을 하면 발생한다.
dblclick MouseEvent 더블클릭을 하면 발생한다.
rightclick MouseEvent 오른쪽 버튼을 클릭하면 발생한다.
mousemove MouseEvent 마우스 커서를 이동하면 발생한다.
dragstart - 드래그를 시작할 때 발생한다.
drag - 드래그를 하는 동안 발생한다.
dragend - 드래그가 끝날 때 발생한다.
idle - 중심 좌표나 확대 수준이 변경되면 발생한다.
단, 애니메이션 도중에는 발생하지 않는다.

daum.maps.MapTypeId 인터페이스

속성 설명
ROADMAP 일반 지도를 의미한다.
SKYVIEW 스카이뷰 지도를 의미한다.
HYBRID 스카이뷰에 레이블이 추가된 지도를 의미한다.

daum.maps.ControlPosition 인터페이스

속성 설명
TOP 위 가운데를 의미한다. 아래로 쌓인다.
TOPLEFT 왼쪽 위를 의미한다. 오른쪽으로 쌓인다.
TOPRIGHT 오른쪽 위를 의미한다. 왼쪽으로 쌓인다.
LEFT 왼쪽 위를 의미한다. 아래로 쌓인다.
주의: 왼쪽 중앙을 의미하는 것이 아니다.
RIGHT 오른쪽 위를 의미한다. 아래로 쌓인다.
주의: 오른쪽 중앙을 의미하는 것이 아니다.
BOTTOMLEFT 왼쪽 아래를 의미한다. 오른쪽으로 쌓인다.
BOTTOM 아래 가운데를 의미한다. 위로 쌓인다.
BOTTOMRIGHT 오른쪽 아래를 의미한다. 왼쪽으로 쌓인다.

Point

생성자 설명
new daum.maps.Point(number x, number y) 화면 좌표 정보를 담고 있는 객체를 생성한다.

속성 설명
number x x축 값
number y y축 값

메소드 설명
boolean equals(Point point) 같은 좌표인지 판별한다.
string toString() 좌표를 표현하는 문자열을 반환한다.

Size

생성자 설명
new daum.maps.Size(number width, number height) 크기 정보를 담고 있는 객체를 생성한다.

속성 설명
number width 가로 길이
number height 세로 길이

메소드 설명
boolean equals(Size size) 두 크기가 같은지 판별한다.
string toString() 크기를 표현하는 문자열을 반환한다.

LatLng

생성자 설명
new daum.maps.LatLng(number latitude, number longitude) WGS84 좌표계에서의 좌표 정보를 담고 있는 객체를 표현한다.
  • latitude - 위도
  • longitude - 경도

메소드 설명
number getLat() 위도
number getLng() 경도
boolean equals(LatLng latLng) 두 좌표가 같은지 판별한다.
string toString() 좌표를 표현하는 문자열을 반환한다.

LatLngBounds

생성자 설명
new daum.maps.LatLngBounds([LatLng latLng1, LatLng latLng2]) WGS84 좌표계에서의 사각형 영역을 표현한다.
인자로 지정한 두 좌표를 포함하는 가장 작은 사각형을 표현하게 되며,
만약 인자를 주지 않으면 빈 영역을 의미한다.

메소드 설명
LatLng getSouthWest() 영역의 남서쪽 좌표를 반환한다.
LatLng getNorthEast() 영역의 북동쪽 좌표를 반환한다.
boolean isEmpty() 영역이 비었는지 판별한다.
void extend(LatLng latLng) 주어진 좌표가 포함되도록 영역을 확장한다.
boolean contain(LatLng latLng) 영역에 주어진 좌표가 포함되는지 판별한다.
boolean equals(LatLng latLng) 영역이 같은지 판별한다.
string toString() 영역을 표현하는 문자열을 반환한다.

ZoomControl

생성자 설명
new daum.maps.ZoomControl() 확대·축소 컨트롤을 생성한다.

MapTypeControl

생성자 설명
new daum.maps.MapTypeControl() 지도 종류를 선택할 수 있는 컨트롤을 생성한다.

Marker

생성자 설명
new daum.maps.Marker(Object options) 마커를 생성한다.
options 객체의 구성은 다음과 같다.

메소드 설명
void setMap(Map map) 지도에 마커를 올린다. null을 지정하면 마커를 제거한다.
Map getMap() 마커가 올라있는 지도를 반환한다.
void setImage(MarkerImage image) 새 MarkerImage를 지정한다.
MarkerImage getImage() MarkerImage를 반환한다.
void setPosition(LatLng latLng) 좌표를 지정한다.
LatLng getPosition() 좌표를 반환한다.
void setZIndex(number zIndex) Z-index를 지정한다.
number getZIndex() Z-index를 반환한다.
void setVisible(boolean visible) 표시 여부를 지정한다.
boolean getVisible() 표시 여부를 반환한다.
void setTitle(string title) 툴팁을 지정한다.
string getTitle() 툴팁을 반환한다.
void setDraggable(boolean draggable) 드래그 가능 여부를 지정한다.
boolean getDraggable() 드래그 가능 여부를 반환한다.

이벤트 인자 설명
click - 마커를 클릭하면 발생한다.
mouseover - 마커에 마우스 커서를 올리면 발생한다.
mouseout - 마우스 커서가 마커에서 벗어나면 발생한다.
rightclick - 마커를 오른쪽 버튼으로 클릭하면 발생한다.
dragstart - 드래그를 시작하면 발생한다.
dragend - 드래그를 종료하면 발생한다.

MarkerImage

생성자 설명
new daum.maps.MarkerImage(string src, Size size [, Object options]) 마커에 사용할 이미지를 생성한다.
  • src - 이미지 주소
  • size - 마커의 크기
    options 객체의 구성은 다음과 같다.
  • Point offset - 마커의 좌표에 일치시킬 이미지 안의 좌표 (기본값: 이미지의 가운데 아래)
  • string shape - 마커의 클릭 가능한 영역의 모양
  • string coords - 마커의 클릭 가능한 영역을 표현하는 좌표값
  • Size spriteSize - 스프라이트 이미지의 전체 크기
  • Point spriteOrigin - 스프라이트 이미지 중 사용할 영역의 좌상단 좌표
    shape와 values의 값은 각각 <area>의 shape와 coords 속성에 대응한다.
    자세한 내용은 http://www.w3.org/TR/html5/the-map-element.html#attr-area-shape

    을 참조한다.

InfoWindow

생성자 설명
new daum.maps.InfoWindow(Object options) 인포윈도우를 생성한다.
options 객체의 구성은 다음과 같다.
  • position LatLng - 좌표
  • content Node& #124;string - 엘리먼트 또는 HTML 문자열 형태의 내용
  • disableAutoPan boolean - 인포윈도우를 열 때 지도가 자동으로 패닝하지 않을지의 여부 (기본값: false)

메소드 설명
void open(Map map [, Marker marker]) 지도에 인포윈도우를 올린다.
marker가 주어지면, 해당 마커에서 열린 효과를 낸다.
void close() 인포윈도우를 제거한다.
Map getMap() 인포윈도우가 올라있는 지도를 반환한다.
void setPosition(LatLng latLng) 좌표를 지정한다.
LatLng getPosition() 좌표를 반환한다.
void setContent(Node& #124;string content) 내용을 지정한다. 엘리먼트 또는 HTML 문자열을 지정할 수 있다.
Node getContent() 내용을 엘리먼트 형태로 반환한다.

Polyline

생성자 설명
new daum.maps.Polyline(Object options) 폴리라인을 생성한다.
options 객체의 구성은 다음과 같다.
  • path Array.<LatLng> - 폴리라인을 구성하는 좌표의 배열
  • number strokeWeight - 픽셀 단위의 선 두께 (기본값: 3)
  • string strokeColor - #xxxxxx 형태의 선 색 (기본값: '#F10000')
  • number strokeOpacity - 선 불투명도 (0-1) (기본값: 0.6)
  • string fillColor - #xxxxxx 형태의 채움 색 (기본값: '#F10000')
  • number fillOpacity - 채움 불투명도 (0-1) (기본값: 0)
  • boolean endArrow - 화살표 여부

메소드 설명
void setMap(Map map) 지도에 폴리라인을 올린다. null을 지정하면 폴리라인을 제거한다.
Map getMap() 폴리라인이 올라있는 지도를 반환한다.
void setPath(Array.<LatLng> path) 좌표의 배열을 지정한다.
Array.<LatLng> getPath() 좌표의 배열을 반환한다.
number getLength() 총 길이를 m(미터)단위로 반환한다.

이벤트 인자 설명
mouseover - 폴리라인에 마우스 커서를 올리면 발생한다.
mouseout - 마우스 커서가 폴리라인에서 벗어나면 발생한다.
mousedown - 폴리라인에서 마우스 버튼을 누르면 발생한다.

Polygon

생성자 설명
new daum.maps.Polygon(Object options) 폴리곤을 생성한다.
options 객체의 구성은 다음과 같다.
  • path Array.<LatLng> - 폴리곤을 구성하는 좌표의 배열
  • number strokeWeight - 픽셀 단위의 선 두께 (기본값: 3)
  • string strokeColor - #xxxxxx 형태의 선 색 (기본값: '#F10000')
  • number strokeOpacity - 선 불투명도 (0-1) (기본값: 0.6)
  • string fillColor - #xxxxxx 형태의 채움 색 (기본값: '#F10000')
  • number fillOpacity - 채움 불투명도 (0-1) (기본값: 0)

메소드 설명
void setMap(Map map) 지도에 폴리곤을 올린다. null을 지정하면 폴리곤을 제거한다.
Map getMap() 폴리곤이 올라있는 지도를 반환한다.
void setPath(Array.<LatLng> path) 좌표의 배열을 지정한다.
Array.<LatLng> getPath() 좌표의 배열을 반환한다.
number getLength() 총 길이를 m(미터)단위로 반환한다.
number getArea() 영역의 넓이를 ㎡(제곱미터)단위로 반환한다.

이벤트 인자 설명
mouseover - 폴리곤에 마우스 커서를 올리면 발생한다.
mouseout - 마우스 커서가 폴리곤에서 벗어나면 발생한다.
mousedown - 폴리곤에서 마우스 버튼을 누르면 발생한다.

Circle

생성자 설명
new daum.maps.Circle(Object options) 원을 생성한다.
options 객체의 구성은 다음과 같다.
  • LatLng center - 중심 좌표
  • number radius - 미터 단위의 반지름
  • number strokeWeight - 픽셀 단위의 선 두께 (기본값: 3)
  • string strokeColor - #xxxxxx 형태의 선 색 (기본값: '#F10000')
  • number strokeOpacity - 선 불투명도 (0-1) (기본값: 0.6)
  • string fillColor - #xxxxxx 형태의 채움 색 (기본값: '#F10000')
  • number fillOpacity - 채움 불투명도 (0-1) (기본값: 0)

메소드 설명
void setMap(Map map) 지도에 원을 올린다. null을 지정하면 원을 제거한다.
Map getMap() 원이 올라있는 지도를 반환한다.
void setPosition(LatLng latLng) 좌표를 지정한다.
LatLng getPosition() 좌표를 반환한다.
void setRadius(number radius) 반지름을 지정한다.
number getRadius() 반지름을 반환한다.
LatLngBounds getBounds() 원을 포함하는 최소의 사각형 영역을 구한다.

daum.maps.event 네임스페이스

함수 설명
void daum.maps.event.addListener(EventTarget target, string type, function handler) 지도 객체의 이벤트 처리를 시작한다.
  • target - 이벤트를 지원하는 다음 지도 API 객체
  • type - 이벤트 이름
  • handler - 이벤트를 처리할 함수
void daum.maps.event.removeListener(EventTarget target, string type, function handler) 지도 객체의 이벤트 처리를 중단한다.
  • target - 이벤트를 지원하는 다음 지도 API 객체
  • type - 이벤트 이름
  • handler - 이벤트를 처리하던 함수

daum.maps.MouseEvent 인터페이스

속성 설명
LatLng latLng 지도 좌표
Point point 화면 좌표

Roadview

생성자 설명
new daum.maps.Roadview(Node node) 새 로드뷰를 만든다.

메소드 설명
void setPanoId(string panoId, LatLng position) 파노라마 ID를 지정한다. 지도 좌표도 함께 넘겨야 한다.
string getPanoId() 파노라마 ID를 반환한다.
void setViewpoint(RoadviewViewpoint viewpoint) 시점을 지정한다.
RoadviewViewpoint getViewpoint() 시점을 반환한다.
LatLng getPosition() 지도 좌표를 반환한다.
void relayout() 로드뷰 엘리먼트의 크기를 변경한 후에는 반드시 이 함수를 호출해야 한다.
단, window의 resize 이벤트에 대해서는 자동으로 호출한다.

이벤트 인자 설명
init - 로드뷰가 초기화를 끝내면 발생한다.
panoid_changed - 파노라마 ID가 바뀌면 발생한다.
viewpoint_changed - 시점이 바뀌면 발생한다.
position_changed - 지도 좌표가 바뀌면 발생한다.

daum.maps.RoadviewViewpoint 인터페이스

속성 설명
number pan 가로 각도. 0부터 360 사이의 값으로 북쪽부터 시계방향으로 대응한다.
number tilt 세로 각도. -90부터 90 사이의 값으로 위쪽부터 아래쪽으로 대응한다.
number zoom 확대 수준. -3부터 3 사이의 정수이다.

RoadviewClient

생성자 설명
new daum.maps.RoadviewClient() 로드뷰 데이터를 다룬다.

메소드 설명
void getNearestPanoId(LatLng latLng, number radius, function callback) 특정 좌표에서 반경 내 가장 가까운 로드뷰 파노라마 ID를 구한다.
  • latLng - 좌표
  • radius - 반경 (미터 단위)
  • callback - 첫 번째 인자로 파노라마 ID가 넘어온다. 결과가 없으면 null이 반환된다.

RoadviewOverlay

생성자 설명
new daum.maps.RoadviewOverlay() 로드뷰 선을 그린다.

메소드 설명
void setMap(Map map) 지도에 선을 그린다. null을 지정하면 선을 제거한다.
Map getMap() 로드뷰 선이 그려져있는 지도를 반환한다.

AbstractOverlay

생성자 설명
new daum.maps.AbstractOverlay() 사용자 오버레이 객체를 만들 때 사용한다. 자세한 내용은 안내 페이지를 참고한다.

메소드 설명
void setMap(Map map) 지도에 오버레이를 올린다. null을 지정하면 오버레이를 제거한다.
Map getMap() 오버레이가 올라있는 지도를 반환한다.
void onAdd() 지도에 올릴 때 호출된다.
void onRemove() 지도에서 제거할 때 호출된다.
MapPanels getPanels() 붙어있는 지도의 패널을 반환한다.
MapProjection getProjection() 붙어있는 지도의 좌표 변환 객체를 반환한다.
void draw() 위치를 재조정할 필요가 있을 때 호출된다.

daum.maps.MapPanels 인터페이스

지도의 패널을 담당한다.

속성 설명
Node overlayLayer 오버레이를 올릴 수 있는 HTML 엘리먼트를 반환한다.

daum.maps.MapProjection 인터페이스

지도와 화면 사이의 좌표 변환을 담당한다.

메소드 설명
Point pointFromCoords(LatLng latLng) 지도 좌표에 해당하는 CSS 좌표를 반환한다.

지도API , DevDocs  
댓글이 없습니다.