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

Class: naver.maps.TrafficLayer

naver.maps. TrafficLayer

TrafficLayer 클래스는 교통 정보 관련 오버레이를 하나의 지도 유형으로 나타내는 레이어를 정의합니다.

new naver.maps.TrafficLayer(option)

Parameters
Name Type Argument Description
option TrafficLayerOptions <optional>

레이어 옵션

Properties
Name Type Description
name string

레이어 이름입니다. 이 레이어의 이름은 traffic입니다.

Tutorials

Extends

Methods

endAutoRefresh()

자동 새로 고침을 종료합니다.

getLayerType()

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

Inherited From
Fires
Returns
Type Description
naver.maps.MapType

레이어의 지도 유형

getLayerTypeId()

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

Inherited From
Returns
Type Description
string

레이어의 지도 유형 id

getMap()

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

Inherited From
Returns
Type Description
naver.maps.Map | null

지도 객체

getOpacity()

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

Inherited From
Returns
Type Description
number

0~1 사이의 실수.

getPaneElement()

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

Inherited From
Returns
Type Description
HTMLElement

레이어 HTML 요소

refresh(noEffect)

레이어를 새로 고칩니다.

Parameters
Name Type Argument Description
noEffect boolean <optional>

효과 적용 여부

Inherited From

setLayerTypeId(typeId)

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

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

Parameters
Name Type Description
typeId string

지도 유형 id

Inherited From
Fires

setMap(map)

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

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

지도 객체

Inherited From

setOpacity(opacity)

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

Parameters
Name Type Description
opacity number

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

Inherited From

startAutoRefresh()

자동 새로 고침을 시작합니다. 이 레이어의 interval 옵션이 0보다 크면 자동으로 호출됩니다.

Type Definitions


TrafficLayerOptions

TrafficLayerOptions 객체는 TrafficLayer를 정의하는 옵션을 나타냅니다.

Type:
Properties
Name Type Default Description
interval number 300000

교통 상황을 자동으로 갱신하는 시간 간격(ms)입니다. 이 값이 0이면 자동으로 갱신하지 않습니다. 최소값은 5분입니다.

overlayMap boolean true

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

zIndex number 2

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