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

Class: naver.maps.Layer

naver.maps. Layer

Layer 클래스는 지도 위에 올리는 레이어의 기본 클래스입니다. NAVER 지도 API v3에서 제공하는 모든 레이어(자전거, 교통 상황 지도 등)는 이 클래스를 상속받아 구현했습니다.

API에서 기본적으로 제공하는 레이어 외에 지도 유형과 마찬가지로 사용자 정의 레이어를 만들 수 있습니다.
자세한 설명은 Layers 튜토리얼을 참고합니다.

new naver.maps.Layer(name, MapTypeRegistry, options)

지정한 이름과 지도 유형 컬렉션을 사용하는 레이어 객체를 생성합니다.

Parameters
Name Type Description
name string

레이어 이름

MapTypeRegistry naver.maps.MapTypeRegistry

지도 유형의 컬렉션

options LayerOptions

레이어 옵션

Tutorials

Extends

Methods

getLayerType()

레이어의 지도 유형을 반환합니다.

Fires
Returns
Type Description
naver.maps.MapType

레이어의 지도 유형

getLayerTypeId()

레이어의 지도 유형 id를 반환합니다.

Returns
Type Description
string

레이어의 지도 유형 id

getMap()

현재 레이어가 추가된 지도 객체를 반환합니다.

Returns
Type Description
naver.maps.Map | null

지도 객체

getOpacity()

레이어 타일의 불투명도를 반환합니다.
불투명도값의 범위는 0~1이며, 기본값은 1입니다.

Returns
Type Description
number

0~1 사이의 실수.

getPaneElement()

레이어의 지도 타일이 렌더링된 창(pane)의 HTML 요소를 반환합니다.

Returns
Type Description
HTMLElement

레이어 HTML 요소

refresh(noEffect)

레이어를 새로 고칩니다.

Parameters
Name Type Argument Description
noEffect boolean <optional>

효과 적용 여부

setLayerTypeId(typeId)

레이어의 지도 유형을 설정합니다.

반드시 MapTypeRegistry 객체에 등록된 지도 유형 id를 사용합니다.

Parameters
Name Type Description
typeId string

지도 유형 id

Fires

setMap(map)

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

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

지도 객체

setOpacity(opacity)

레이어 타일의 불투명도를 설정합니다.
불투명도값의 범위는 0~1이며, 기본값은 1입니다.

Parameters
Name Type Description
opacity number

불투명도. 0~1 사이의 실수.

Type Definitions


LayerOptions

LayerOptions 객체는 Layer를 정의하는 옵션을 나타냅니다.
(기본 지도 타일과 합쳐서 표현하는 방법으로 변경되어 옵션을 지원하지 않습니다. 곧 문서에서 제거될 예정입니다.)

Type:
Properties
Name Type Default Description
hd boolean false

고해상도 이미지 타일의 사용 여부입니다.

overlayMap boolean false

이 값이 true이면 레이어를 타일로 간주합니다. 즉, 타일과 동일한 레벨에 위치하므로 지도 요소 구조상 제일 아래에 위치하며, 타일과 동일한 줌 효과가 적용됩니다. 이 값이 false이면 레이어를 별도의 창(pane)으로 간주합니다. 생성한 순서대로 지도 요소 구조에 추가되므로 레이어의 zIndex 값에 따라서는 오버레이보다 위에 위치할 수도 있습니다.

zIndex number 0

레이어의 우선순위입니다. 이 값이 높을수록 다른 레이어보다 위에 표시됩니다. 오버레이 창의 zIndex는 100으로 설정되어 있으므로 이 값이 100보다 크면 오버레이 위로 레이어가 추가됩니다. 단, 레이어가 오버레이보다 위에 있을 때는 오버레이의 이벤트를 사용하지 못하니 주의해야 합니다.