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

Namespace: naver.maps

naver. maps

NAVER 지도 API v3의 모든 객체를 담는 네임스페이스입니다.

Classes

AroundControl
BicycleLayer
CadastralLayer
CanvasMapType
CanvasTile
Circle
CustomControl
Data
Ellipse
Feature
FlightSpot
Geometry
GroundOverlay
ImageMapType
ImageTile
InfoWindow
KVO
KVOArray
LabelLayer
LatLng
LatLngBounds
Layer
LogoControl
Map
MapDataControl
MapTypeControl
MapTypeRegistry
Marker
NaverMapTypeOptions
OverlayView
Panorama
Point
PointBounds
Polygon
Polyline
Rectangle
ScaleControl
Size
StreetLayer
Tile
TrafficLayer
ZoomControl

StaticObjects

EPSG3857
EPSG3857Coord
Event
Service
TM128
TM128Coord
TransCoord
UTMK
UTMK_NAVER
UTMK_NAVERCoord
UTMKCoord

Namespaces

naver.maps.drawing
naver.maps.visualization

Members


<static, readonly> Animation

Animation 객체는 Marker의 애니메이션을 정의하는 속성을 나타냅니다.

Type:
Properties
Name Type Default Description
BOUNCE number 1

마커를 튀깁니다. 이 애니메이션은 애니메이션을 중지할 때까지 지속됩니다.

DROP number 2

마커를 지도 위쪽에서 떨어뜨립니다. 이 애니메이션은 한 번만 동작합니다.


<static, readonly> jsContentLoaded

NAVER 지도 API v3의 서브 모듈을 포함한 모든 JavaScript 콘텐츠의 로드 상태를 나타냅니다. 모든 콘텐츠를 로드하면 true로 설정됩니다.

Type:
Default Value
  • false

<static, readonly> MapTypeId

MapTypeId 객체는 NAVER 지도 유형의 id 컬렉션입니다.

Type:
Properties
Name Type Description
NORMAL string

일반 지도 유형 id로 일반 이미지 지도를 보여주는 지도 유형입니다.

TERRAIN string

지형도 유형 id로 지형의 높낮이를 함께 보여주는 지도 유형입니다.

SATELLITE string

위성 지도 유형 id로 위성 이미지 지도를 보여주는 지도 유형입니다.

HYBRID string

겹쳐보기 지도 유형 id로 위성 이미지 지도 위에 주요 도로와 주기를 함께 보여주는 지도 유형입니다.


<static> onJSContentLoaded

NAVER 지도 API v3의 서브 모듈을 포함한 모든 JavaScript 콘텐츠가 로드되었을 때 호출되는 이벤트 핸들러입니다.

Type:

<static, readonly> PointingIcon

PointingIcon 객체는 폴리라인의 끝 점의 강조 아이콘을 사전에 정의한 것입니다.

Type:
Properties
Name Type Default Description
OPEN_ARROW number 1

open-arrow한쪽이 열린 화살표입니다.

BLOCK_ARROW number 2

open-arrow모두 막힌 화살표입니다.

CIRCLE number 3

open-arrow원입니다.

DIAMOND number 4

open-arrow마름모입니다.


<static, readonly> Position

Position 객체는 요소의 위치 정보를 나타냅니다. 설정할 수 있는 위치는 아래와 같습니다.
position-desc

Type:
Properties
Name Type Default Description
CENTER number 0

요소를 중앙에 배치합니다.

TOP_LEFT number 1

요소를 왼쪽 위에 배치합니다. 요소는 왼쪽 위에서 가운데를 향해 쌓입니다.

TOP_CENTER number 2

요소를 위쪽 가운데에 배치합니다.

TOP_RIGHT number 3

요소를 오른쪽 위에 배치합니다. 요소는 오른쪽 위에서 가운데를 향해 쌓입니다.

LEFT_CENTER number 4

요소를 왼쪽 가운데에 배치합니다.

LEFT_TOP number 5

요소를 왼쪽 위에 배치합니다. 요소는 왼쪽 위에서 아래를 향해 쌓입니다.

LEFT_BOTTOM number 6

요소를 왼쪽 아래에 배치합니다. 요소는 왼쪽 아래에서 위를 향해 쌓입니다.

RIGHT_TOP number 7

요소를 오른쪽 위에 배치합니다. 요소는 오른쪽 위에서 아래를 향해 쌓입니다.

RIGHT_CENTER number 8

요소를 오른쪽 가운데에 배치합니다.

RIGHT_BOTTOM number 9

요소를 오른쪽 아래에 배치합니다. 요소는 오른쪽 아래에서 위를 향해 쌓입니다.

BOTTOM_LEFT number 10

요소를 왼쪽 아래에 배치합니다. 요소는 왼쪽 아래에서 가운데를 향해 쌓입니다.

BOTTOM_CENTER number 11

요소를 아래쪽 가운데에 배치합니다.

BOTTOM_RIGHT number 12

요소를 오른쪽 아래에 배치합니다. 요소는 오른쪽 아래에서 가운데를 향해 쌓입니다.


<static, readonly> SymbolPath

SymbolPath 객체는 SymbolIconpath를 사전에 정의한 것입니다.

Type:
Properties
Name Type Default Description
BACKWARD_CLOSED_ARROW number 1

뒤쪽을 가리키며, 모두 막힌 화살표입니다.

BACKWARD_OPEN_ARROW number 2

뒤쪽을 가리키며, 한쪽이 열린 화살표입니다.

CIRCLE number 3

원입니다.

FORWARD_CLOSED_ARROW number 4

앞쪽을 가리키며, 모두 막힌 화살표입니다.

FORWARD_OPEN_ARROW number 5

앞쪽을 가리키며, 한쪽이 열린 화살표입니다.


<static, readonly> SymbolStyle

SymbolStyle객체는 SymbolIconstyle을 사전에 정의한 것입니다.

Type:
Properties
Name Type Default Description
CIRCLE string circle

원 아이콘을 생성하며, SymbolIconradius 속성을 필수로 지정해야 합니다.

PATH string path

폴리라인 아이콘을 생성하며, SymbolIconpath 속성을 필수로 지정해야 합니다.

CLOSED_PATH string closedPath

폴리곤 아이콘을 생성하며, SymbolIconpath 속성을 필수로 지정해야 합니다.

Type Definitions


MapOptions

MapOptions 객체는 지도를 정의하는 옵션을 나타냅니다.

Type:
Properties
Name Type Default Description
background string

지도 요소의 배경으로 사용할 이미지 URL 또는 CSS 색상값입니다.

baseTileOpacity number

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

bounds Bounds | BoundsLiteral null

지도의 초기 좌표 경계입니다. 이 값을 설정하면 지도 옵션 중 centerzoom 옵션을 무시하고, 지정한 좌표 경계에 맞게 지도를 생성합니다.

center Coord | CoordLiteral 서울시청

지도의 초기 중심 좌표입니다. 기본값은 서울 시청 좌표(37.5666103, 126.9783882)입니다.

disableDoubleClickZoom boolean false

사용자가 지도 위에서 마우스 버튼을 더블 클릭해 지도를 확대하는 기능의 사용 여부입니다.

disableDoubleTapZoom boolean false

사용자가 지도 위에서 한 손가락으로 더블 탭해 지도를 확대하는 기능의 사용 여부입니다.

disableKineticPan boolean true

사용자가 지도를 드래그했을 때 관성 효과(사용자가 동작을 끝낸 후에도 계속되는 지도의 움직임)의 사용 여부입니다.

disableTwoFingerTapZoom boolean false

사용자가 지도 위에서 두 손가락으로 두 번 탭해 지도를 축소하는 기능의 사용 여부입니다.

draggable boolean true

마우스 또는 손가락을 이용한 지도 이동(패닝) 허용 여부입니다.

keyboardShortcuts boolean true

키보드 방향 키를 이용한 지도 이동(패닝) 허용 여부입니다.

logoControl boolean true

NAVER 로고 컨트롤의 표시 여부입니다. (항상 노출로 변경)

logoControlOptions LogoControlOptions

NAVER 로고 컨트롤의 옵션입니다.

mapDataControl boolean true

지도 데이터 저작권 컨트롤의 표시 여부입니다.

mapDataControlOptions MapDataControlOptions

지도 데이터 저작권 컨트롤의 옵션입니다.

mapTypeControl boolean false

지도 유형 컨트롤의 표시 여부입니다.

mapTypeControlOptions MapTypeControlOptions

지도 유형 컨트롤의 옵션입니다.

mapTypeId string NORMAL

지도의 초기 지도 유형 id입니다.

mapTypes naver.maps.MapTypeRegistry

지도 유형의 컬렉션을 포함하는 객체입니다. 이 값을 설정하지 않으면 사전에 정의된 NAVER 지도의 기본 지도 유형으로 설정합니다.

maxBounds Bounds | BoundsLiteral null

지도에서 보이는 최대 좌표 경계입니다. 지도의 중심 좌표는 지정한 최대 좌표 경계 내에서만 설정할 수 있습니다.

maxZoom number

지도의 최대 줌 레벨입니다. 이 값을 설정하지 않으면 지정된 초기 지도 유형의 최고 줌 레벨로 설정합니다.

minZoom number

지도의 최소 줌 레벨입니다. 이 값을 설정하지 않으면 지정된 초기 지도 유형의 최저 줌 레벨로 설정합니다.

padding padding

지도 뷰포트의 안쪽 여백(패딩)입니다. 단위는 화면 픽셀이며, 기본값은 {top: 0, right: 0, bottom: 0, left: 0}입니다.

pinchZoom boolean true

핀치 제스처를 이용한 지도 확대/축소 허용 여부입니다.

resizeOrigin naver.maps.Position CENTER

지도 크기 조정 시 고정할 원점입니다.

scaleControl boolean true

지도 축척 컨트롤의 표시 여부입니다.

scaleControlOptions ScaleControlOptions

지도 축척 컨트롤의 옵션입니다.

scrollWheel boolean true

마우스 스크롤 휠을 이용한 지도 확대/축소 허용 여부입니다.

size naver.maps.Size | SizeLiteral

지도의 초기 크기입니다. 이 값을 설정하지 않으면, 지도 DOM 요소의 CSS 크기에 따라 지도 크기가 자동으로 조정됩니다.

overlayZoomEffect null | string null

도형, 마커 등 오버레이의 줌 효과 적용 대상입니다. 적용할 대상의 창(pane) 이름을 문자열로 지정합니다. 이 값이 all이면 모든 오버레이에 줌 효과가 적용됩니다. 오버레이의 개수가 많을 때는 성능에 영향을 줄 수 있으므로 주의해서 사용해야 합니다.

tileSpare number 0

지도의 크기보다 여유있게 로딩할 타일의 개수를 지정합니다.

tileTransition boolean true

지도 타일을 전환할 때 페이드 인 효과(타일이 서서히 나타나는 것)의 사용 여부입니다.

tileDuration number

지도 타일을 전환할 때 페이드 인 효과(타일이 서서히 나타나는 것)의 지속 시간 입니다. (밀리초), 기본값은 300~600ms입니다.

zoom number 16

지도의 초기 줌 레벨입니다.

zoomControl boolean false

줌 컨트롤의 표시 여부입니다.

zoomControlOptions ZoomControlOptions

줌 컨트롤의 옵션입니다.

zoomOrigin Coord | CoordLiteral null

줌 효과 시 고정하여 적용할 기준 좌표입니다. 해당 좌표가 현재 지도 화면 밖에 위치해 있으면 기본 기준 좌표를 적용합니다.

blankTileImage null | string null

빈 타일 이미지 URL을 설정할 수 있는 옵션입니다. 기본값은 투명 gif 입니다.