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

Class: naver.maps.Tile

naver.maps. Tile

Tile 클래스는 한 장의 지도 타일을 정의합니다.

new naver.maps.Tile(element, tileOptions)

Parameters
Name Type Argument Description
element HTMLElement

지도 타일에 해당하는 HTML 요소

tileOptions TileOptions <optional>

타일의 옵션

Extends

Methods

appendTo(parentNode)

지정한 parentNode에 타일 HTML 요소를 추가합니다.

Parameters
Name Type Description
parentNode HTMLElement

타일이 추가될 HTML 요소

cancelFadeIn()

진행 중인 페이드 인(타일이 서서히 나타나는) 효과를 즉시 중지하고, 본래의 불투명도를 설정합니다.

destroy()

타일 객체를 완전히 삭제합니다.

fadeIn(callback, startOpacity)

페이드 인(타일이 서서히 나타나는) 효과를 실행합니다.

Parameters
Name Type Argument Default Description
callback function

페이드 인 효과가 완료되었을 때 실행할 콜백 함수입니다.

startOpacity number <optional>
0

페이드 인 효과의 시작 불투명도입니다.

getDuration()

타일의 fadeIn 효과 지속시간을 반환합니다.

Returns
Type Description
number

타일의 fadeIn animation duration

getElement()

타일의 HTML 요소를 반환합니다.

Returns
Type Description
HTMLElement

타일의 HTML 요소

getOffset()

타일의 오프셋(위치)을 반환합니다.

Returns
Type Description
naver.maps.Point

타일의 오프셋

getOpacity()

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

Returns
Type Description
number

0~1 사이의 실수.

getSize()

타일의 크기를 반환합니다.

Returns
Type Description
naver.maps.Size

타일의 크기

getTileIndex()

타일 인덱스를 반환합니다.

Returns
Type Description
TileIndex

타일 인덱스

getZIndex()

타일의 쌓임 순서를 반환합니다.

Returns
Type Description
number

타일의 쌓임 순서

hide()

타일을 숨깁니다.

load(tileOptions, loaded)

타일을 불러옵니다.

Parameters
Name Type Argument Description
tileOptions TileOptions <optional>

타일의 옵션

loaded function

이벤트 알림 이전에 실행할 함수

remove()

타일의 HTML 요소를 지도에서 삭제합니다.

reset(mapType, zoom, tileOptions)

지정한 mapType에 맞게 타일을 재설정합니다.

Parameters
Name Type Argument Description
mapType naver.maps.MapType

재설정할 지도 유형

zoom number

타일 재설정 시 적용할 지도의 줌 레벨

tileOptions TileOptions <optional>

타일의 옵션

setBlank()

타일의 내용물을 비워 공백으로 만듭니다.

setDuration(duration)

타일의 fadeIn 효과 지속시간을 설정합니다.
단위는 밀리초 (millisecond), 기본값은 300~600ms 입니다.

Parameters
Name Type Description
duration number

타일의 fadeIn animation duration

setOffset(x, y)

타일이 표시될 오프셋(위치)을 지정합니다.

Parameters
Name Type Description
x number

타일의 x축 오프셋

y number

타일의 y축 오프셋

setOffset(offset)

타일이 표시될 오프셋(위치)을 지정합니다.

Parameters
Name Type Description
offset naver.maps.Point

타일의 오프셋

setOpacity(opacity)

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

Parameters
Name Type Description
opacity number

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

setSize(size)

타일의 크기를 설정합니다.

Parameters
Name Type Description
size naver.maps.Size

타일의 크기

setTileIndex(tileIndex)

타일 인덱스를 설정합니다.

Parameters
Name Type Description
tileIndex TileIndex

타일 인덱스

setZIndex(zIndex)

타일의 쌓임 순서를 설정합니다.

Parameters
Name Type Description
zIndex number

타일의 쌓임 순서

show()

타일을 보이게 합니다.

Type Definitions


TileIndex

TileIndex 객체는 각 타일링 시스템에서 x축과 y축에 대한 인덱스를 나타냅니다.

Type:
Properties
Name Type Description
xIndex number

x축의 인덱스

yIndex number

y축의 인덱스


TileOptions

TileOptions 객체는 naver.maps.Tile을 정의하는 데 필요한 옵션을 나타냅니다.

Type:
Properties
Name Type Argument Default Description
opacity number <optional>
1

타일의 불투명도

duration number <optional>

타일의 fadeIn 효과 지속 시간 (밀리초 단위)

transition boolean <optional>
true

타일 로드 시 fadeIn 효과의 사용 여부입니다.

offset naver.maps.Point <optional>

타일의 오프셋입니다.

zIndex number <optional>
0

타일의 쌓임 순서입니다.

size naver.maps.Size <optional>

타일의 크기입니다.

pane HTMLElement <optional>

타일이 추가될 HTML 요소입니다.

Events

loaded

타일의 로드가 완료되면 이벤트가 발생합니다.

Parameters
Name Type Description
tile naver.maps.Tile

로드가 완료된 타일 객체

offset_changed

타일의 오프셋(위치)이 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
offset naver.maps.Point

타일의 오프셋

opacity_changed

타일의 불투명도가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
opacity number

타일의 불투명도

pane_changed

타일이 추가된 HTML 요소가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
paneElement HTMLElement

타일이 추가된 HTML 요소

size_changed

타일의 크기가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
size naver.maps.Size

타일의 크기

tileIndex_changed

타일의 인덱스가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
tileIndex TileIndex

타일의 인덱스

zIndex_changed

타일의 쌓임 순서가 변경되면 이벤트가 발생합니다.

Parameters
Name Type Description
zIndex number

타일의 쌓임 순서