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

Class: naver.maps.GroundOverlay

naver.maps. GroundOverlay

GroundOverlay 클래스는 지도 위에 올리는 사각형 이미지 오버레이를 정의합니다.

new naver.maps.GroundOverlay(url, bounds, options)

Parameters
Name Type Argument Description
url string

이미지 URL

bounds Bounds | BoundsLiteral

좌표 경계

options GroundOverlayOptions <optional>

지상 오버레이 옵션

Tutorials

Extends

Methods

getBounds()

지상 오버레이의 좌표 경계를 반환합니다.

Returns
Type Description
Bounds

경계 좌표

getMap()

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

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

Map 객체

getOpacity()

지상 오버레이의 불투명도를 반환합니다.

Returns
Type Description
number

불투명도

getUrl()

지상 오버레이의 이미지 URL을 반환합니다.

Returns
Type Description
string

이미지 URL

setMap(map)

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

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

오버레이를 추가할 Map 객체

Inherited From

setOpacity(opacity)

지상 오버레이의 불투명도를 설정합니다.

Parameters
Name Type Description
opacity number

불투명도

setUrl(url)

지상 오버레이의 이미지 URL을 설정합니다.

Parameters
Name Type Description
url string

이미지 URL

Type Definitions


GroundOverlayOptions

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

Type:
Properties
Name Type Argument Default Description
clickable boolean <optional>
true

지상 오버레이의 클릭 허용 여부입니다. 이 값이 false이면 지상 오버레이는 사용자 인터랙션을 받지 않습니다.

map naver.maps.Map | null <optional>

지상 오버레이를 표시할 지도 객체입니다.

opacity number <optional>
1

지상 오버레이의 불투명도입니다. 01 사이의 값을 사용합니다.

crossOrigin string <optional>

이미지에 crossOrigin 속성을 추가할지 여부입니다. 이미지의 픽셀 데이터에 액세스하려면 이 속성이 필요합니다. CORS 설정

Events

click

Parameters
Name Type Description
pointerEvent PointerEvent

사용자가 지상 오버레이에서 마우스 왼쪽 버튼을 클릭했을 때 이벤트가 발생합니다.

dblclick

Parameters
Name Type Description
pointerEvent PointerEvent

사용자가 지상 오버레이에서 마우스 왼쪽 버튼을 더블 클릭했을 때 이벤트가 발생합니다.