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

Class: naver.maps.OverlayView

naver.maps. OverlayView

OverlayView 클래스는 오버레이를 만들 때 구현해야 할 여러 메서드를 정의하는 추상 클래스입니다. NAVER 지도 API v3에서 제공하는 모든 오버레이(마커, 정보 창 등)는 이 클래스를 상속받아 구현되었습니다.

사용자 정의 오버레이를 만들려면 이 클래스를 상속받아 구현해야 합니다. 이때 다음 메서드는 반드시 재정의해야 합니다.

  • onAdd: 지도에 오버레이를 추가할 때 호출됩니다.
  • onRemove: 지도에서 오버레이를 제거할 때 호출됩니다.
  • draw: 지도에 오버레이를 그릴 때 호출됩니다.

new naver.maps.OverlayView()

Tutorials
  • Tutorial: CustomOverlay

Extends

Methods

<abstract> draw()

지도에 오버레이를 그릴 때 호출됩니다. 지도의 창(pane) 위에 원하는 오버레이를 그리고, 배치하는 기능을 구현합니다.

getContainerTopLeft()

현재 지도 컨테이너 요소의 left, top 픽셀값을 반환합니다.

Returns
Type
naver.maps.Point

getMap()

현재 오버레이가 추가된 Map 객체를 반환합니다.

Returns
Type Description
naver.maps.Map | null

Map 객체

getPanes()

오버레이 요소를 추가할 수 있는 지도의 창(pane) 요소 집합 객체를 반환합니다.

Returns
Type Description
MapPanes

MapPanes 객체

getProjection()

지도 좌표, 화면 좌표 간에 변환할 수 있는 MapSystemProjection 객체를 반환합니다. 반환된 객체를 이용해 지도 위의 원하는 위치에 오버레이를 배치할 수 있습니다.

Returns
Type Description
naver.maps.MapSystemProjection

MapSystemProjection 객체

<abstract> onAdd()

지도에 오버레이를 추가할 때 호출됩니다. 오버레이 요소를 Map 객체의 창(pane) 요소에 추가하는 기능을 구현합니다. MapPanes 중 적합한 창 요소에 오버레이 요소를 추가합니다.

<abstract> onRemove()

지도에서 오버레이를 제거할 때 호출됩니다. 오버레이 요소를 Map 객체의 창(pane) 요소에서 제거하는 기능을 구현합니다.

setMap(map)

오버레이를 지도에 추가합니다. 인수로 null을 전달하면 오버레이를 지도에서 제거합니다.

Parameters
Name Type Description
map naver.maps.Map | null

오버레이를 추가할 Map 객체