NAVER Maps API v3

Members

OVERLAY_TYPE_ORDER_IN_HOUSE

정렬 순서는 Tile-Map-API 가이드에서 SubType (세부 지도 유형) 순서대로 정렬한다.
https://oss.navercorp.com/Maps/tilemap/wiki/Tile-Map-API-%ED%98%B8%EC%B6%9C-%EA%B0%80%EC%9D%B4%EB%93%9C

Methods

isDefaultMapType()

사외용이며 기본 MapType을 사용하는지 체크
minZoom과 maxBounds를 국내로 제한하기 위해 사용. 커스텀의 경우 제한하지 않습니다.

limitMaxBounds()

사외 버전은 지도 영역을 PC Web MaxBounds 로 제한하기 위한 코드

limitMinZoom()

사외 버전은 국내(zoom level 6 이상)로 제한 합니다.

Type Definitions

any

모든 데이터 형식을 표현합니다.

Type:

array

배열(Array) 객체를 표현합니다.

Type:

array

ArrayOfBounds

지도 좌표 경계의 배열입니다.

Type:

Array.<naver.maps.PointBounds> | Array.<naver.maps.LatLngBounds>

ArrayOfBoundsLiteral

지도 좌표 경계 리터럴의 배열입니다.

Type:

Array.<PointBoundsLiteral> | Array.<LatLngBoundsLiteral>

ArrayOfCoords

지도 좌표의 배열입니다.

Type:

Array.<naver.maps.Point> | Array.<naver.maps.LatLng>

ArrayOfCoordsLiteral

지도 좌표 리터럴의 배열입니다.

Type:

Array.<PointLiteral> | Array.<LatLngLiteral>

boolean

true 또는 false 값(Boolean)을 표현합니다.

Bounds

지도 좌표 경계 객체입니다.

Type:

naver.maps.PointBounds | naver.maps.LatLngBounds

BoundsLiteral

지도 좌표 경계 리터럴 객체입니다. new naver.maps.PointBounds나 new naver.maps.LatLngBounds를 대신하여 사용할 수 있습니다.

Type:

PointBoundsLiteral | LatLngBoundsLiteral

Coord

지도 좌표 객체입니다.

Type:

naver.maps.Point | naver.maps.LatLng

CoordLiteral

지도 좌표 리터럴 객체입니다. new naver.maps.Point나 new naver.maps.LatLng를 대신하여 사용할 수 있습니다.

Type:

PointLiteral | LatLngLiteral

DOMEvent

HTMLElement에서 발생하는 원시(native) 형태의 DOMEvent 객체입니다.

Type:

event

DOMEventListener

DOM에서 이벤트 알림을 받기 위해 리스너를 등록하면 반환되는 DOM 이벤트 리스너 객체입니다.

Type:

object

Properties

Name	Type	Description
`eventName`	string	등록된 이벤트의 이름입니다.
`listener`	function	등록된 이벤트의 핸들러입니다.
`target`	HTMLElement	이벤트가 등록된 대상 요소입니다.

DrawingOverlay

그리기 도구 서브 모듈을 이용해 생성되는 오버레이 객체입니다.

그리기 도구 서브 모듈은 로드되는 경우 OverlayView를 확장하여 편집 가능한 오버레이 클래스를 구현합니다.
그리기 도구 서브 모듈을 로드하지 않은 경우 아래의 속성은 오버레이 객체 내에 존재하지 않습니다.

Type:

naver.maps.Rectangle | naver.maps.Ellipse | naver.maps.Polyline | naver.maps.Polygon | naver.maps.Marker

Properties

Name	Type	Description
`id`	string	헤당 오버레이의 `id`입니다.
`name`	string	해당 오버레이의 유형입니다. 'rectangle', 'ellipse' 등이 있습니다.
`setEditable`	function	오버레이의 `editable` 속성을 정의합니다. `editable` 속성이 참일 경우 편집 상태이고, 거짓일 경우 일반 상태입니다. `setEditable` 메서드의 인수로 `editable` 속성(`boolean`)과 `controlPointOptions` 속성(편집 제어점 속성)을 전달할 수 있습니다. 두 번째 인수인 `controlPointOptions` 속성을 생락한 경우 기본값으로 표시됩니다.

Example

// 그리기 도구 서브 모듈이 로드된 상태

var controlPointOptions = {
        anchorPointOptions: {
            radius: 6,
            fillColor: '#ff0000',
            strokeColor: '#0000ff',
            strokeWeight: 2
        },
        midPointOptions: {
            radius: 6,
            fillColor: '#ff0000',
            strokeColor: '#0000ff',
            strokeWeight: 2,
            fillOpacity: 0.5
        }
    };

// 임의의 오버레이
overlay.setEditable(true, controlPointOptions);

FitBoundsOptions

CSS의 position을 나타내는 것과 같은 방식으로 특정 방향에 설정되는 안쪽 여백(margin)값을 나타냅니다.

Type:

object

Properties

Name	Type	Description
`top`	number	위
`right`	number	오른쪽
`bottom`	number	아래
`left`	number	왼쪽
`maxZoom`	number	fitBounds 적용 시 허용되는 최대 줌 입니다.

function()

JavaScript 함수(Function)를 표현합니다.

GeoJSON

GeoJSON 객체는 지리 공간 데이터를 기반으로 지도 위에 점, 선, 도형 등을 표현하는 데이터 구조를 정의합니다.

이 타입의 객체는 Feature, FeatureCollection 또는 geometry로 표현할 수 있으며, 각 Feature에서 표현할 수 있는 geometry의 형태는 다음과 같습니다.

Point
LineString
Polygon
MultiPoint
MultiLineString
MultiPolygon
GeometryCollection

Feature는 geometry 객체와 부가적인 속성을 포함하며, FeatureCollection은 feature의 목록이라고 할 수 있습니다.

Type:

object

Tutorials

데이터 레이어

See

http://geojson.org/geojson-spec.html

Example

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": { "type": "Point", "coordinates": [102.0, 0.5] },
            "properties": { "prop0": "value0" }
        }, {
            "type": "Feature",
            "geometry": {
                "type": "LineString",
                "coordinates": [
                    [102.0, 0.0], [103.0, 1.0], [104.0, 0.0], [105.0, 1.0]
                ]
            },
            "properties": {
                "prop0": "value0",
                "prop1": 0.0
            }
        }, {
            "type": "Feature",
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [100.0, 0.0], [101.0, 0.0], [101.0, 1.0],
                        [100.0, 1.0], [100.0, 0.0]
                    ]
                ]
            },
            "properties": {
                "prop0": "value0",
                "prop1": {"this": "that"}
            }
        }
    ]
}

GPX

GPX는 인터넷에서 GPS 데이터를 다양한 응용 프로그램과 웹 서비스 사이에서 교환하는 데 사용되는 파일 형식입니다.

현재 지원하는 요소는 다음과 같습니다.

Line Paths (wpt, rte, trk)
Line Styles (color, opacity, width, linecap, pattern)
bounds, name, time, desc, cmt, type, sym

Type:

object

Tutorials

데이터 레이어

See

http://www.topografix.com/gpx.asp

Example

<gpx creator="GPS Visualizer http://www.gpsvisualizer.com/" version="1.0">
    <wpt lat="45.41000" lon="-121.71349">
        <ele>1777</ele>
        <name>Wy'East Basin</name>
    </wpt>
</gpx>

HTMLElement

HTML DOM 노드를 표현합니다.

Type:

HTMLElement

ImageData

HTML Canvas 요소를 렌더링하는 데 사용될 이미지 데이터(ImageData)를 표현합니다.

Type:

ImageData

KeyboardEvent

지도에서 키보드 이벤트 발생 시 전달되는 키보드 이벤트 객체입니다.

Type:

event

Properties

Name	Type	Description
`keyboardEvent`	DOMEvent	이벤트가 발생한 시점의 DOM 이벤트 객체입니다.

KML

KML(Keyhole Markup Language)은 Google 어스, Google 지도 및 Google 모바일 지도에서 지리 데이터를 표시하는 데 쓰이는 XML 기반의 마크업 언어 스키마입니다.

현재 지원하는 요소는 다음과 같습니다.

Point, LineString, LinearRing, Polygon, MultiGeometry, gx:Track, gx:MultiTrack
Style (LineStyle, PolyStyle)
LatLonAltBox
name, address, description, visibility

Type:

object

Tutorials

데이터 레이어

See

https://developers.google.com/kml/documentation/kml_tut?hl=ko

Example

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
    <Placemark>
        <name>Simple placemark</name>
        <description>Attached to the ground. Intelligently places itself at the height of the underlying terrain.</description>
        <Point>
            <coordinates>-122.0822035425683,37.42228990140251,0</coordinates>
        </Point>
    </Placemark>
</kml>

KVOArrayOfCoords

지도 좌표의 KVO 배열입니다.

Type:

naver.maps.KVOArray.<naver.maps.Point> | naver.maps.KVOArray.<naver.maps.LatLng>

LatLngBoundsLiteral

지도 좌표 경계 리터럴 객체입니다. new naver.maps.LatLngBounds를 대신하여 사용할 수 있습니다.

Type:

PointBoundsLiteral | LatLngBoundsObjectLiteral

LatLngBoundsObjectLiteral

north, east, south, west를 키로 사용하는 위경도 좌표 객체입니다.

Type:

object

Properties

Name	Type	Description
`north`	number	위도 최대 좌표입니다.
`east`	number	경도 최대 좌표입니다.
`south`	number	위도 최소 좌표입니다.
`west`	number	경도 최소 좌표입니다.

Example

var min = {x: 126.5322317, y: 33.3572421},
    max = {x: 126.5364907, y: 33.3608829};

var bounds = {north: max.y, east: max.x, south: min.y, west: min.x};

LatLngLiteral

지도 좌표 리터럴 객체입니다. new naver.maps.LatLng를 대신하여 사용할 수 있습니다.

Type:

PointLiteral | LatLngObjectLiteral

LatLngObjectLiteral

lat, lng를 키로 사용하는 위경도 좌표 객체입니다.

Type:

object

Properties

Name	Type	Description
`lat`	number	위도 좌표입니다.
`lng`	number	경도 좌표입니다.

Example

var x = 126.5322317,
    y = 33.3572421;

var coord = {lat: y, lng: x};

LayerRegistry

지도 레이어의 컬렉션을 포함하는 객체입니다.

Type:

naver.maps.KVO

Properties

Name	Type	Description
`getLayerNames`	function	등록된 모든 레이어의 이름을 배열로 반환합니다.

MapEventListener

NAVER 지도 API v3 내의 일부 객체에서 제공하는 마우스와 키보드, 터치, KVO(Key Value Observing) 상태 변경 등의 이벤트 알림을 받기 위해 리스너를 등록하면 반환되는 지도 이벤트 리스너 객체입니다.

Type:

object

Properties

Name	Type	Description
`eventName`	string	등록된 이벤트의 이름입니다.
`listener`	function	등록된 이벤트의 핸들러입니다.
`listenerId`	string	등록된 이벤트의 ID입니다.
`target`	object	이벤트가 등록된 대상 객체입니다.

MapType

지도 유형 객체입니다.

Type:

naver.maps.ImageMapType | object

margin

CSS의 position을 나타내는 것과 같은 방식으로 특정 방향에 설정되는 안쪽 여백(margin)값을 나타냅니다.

Type:

object

Properties

Name	Type	Description
`top`	number	위
`right`	number	오른쪽
`bottom`	number	아래
`left`	number	왼쪽
`maxZoom`	number	fitBounds 적용 시 허용되는 최대 줌 입니다.

null

null 값을 표현합니다.

Type:

null

number

정수와 실수를 포함하는 숫자(Number)를 표현합니다.

Type:

number

object

JavaScript의 Object를 표현합니다.

Type:

object

padding

CSS의 position을 나타내는 것과 같은 방식으로 특정 방향에 설정되는 바깥쪽 여백(padding) 값을 나타냅니다.

Type:

object

Properties

Name	Type	Description
`top`	number	위
`right`	number	오른쪽
`bottom`	number	아래
`left`	number	왼쪽

PointArrayLiteral

x, y 순서대로 선언된 좌표 배열입니다.

Type:

array

Examples

var x = 126.5322317,
    y = 33.3572421;

var coord = [x, y];

var coord = [10, 10];

PointBoundsArrayLiteral

minX, minY, maxX, maxY 순서대로 선언된 좌표 경계의 배열입니다.

Type:

array

Examples

var min = [126.5322317, 33.3572421],
    max = [126.5364907, 33.3608829];

var bounds = [min[0], min[1], max[0], max[1]];

var min = [0, 0],
    max = [200, 200];

var bounds = [min[0], min[1], max[0], max[1]];

PointBoundsLiteral

지도 좌표 경계 리터럴 객체입니다. new naver.maps.PointBounds를 대신하여 사용할 수 있습니다.

Type:

PointBoundsArrayLiteral | PointBoundsObjectLiteral

PointBoundsObjectLiteral

minX, minY, maxX, maxY를 키로 사용하는 좌표 경계 객체입니다.

Type:

object

Properties

Name	Type	Description
`MinX`	number	최소 좌표의 x 좌표입니다.
`MinY`	number	최소 좌표의 y 좌표입니다.
`MaxX`	number	최대 좌표의 x 좌표입니다.
`MaxY`	number	최대 좌표의 y 좌표입니다.

Example

var min = [126.5322317, 33.3572421],
    max = [126.5364907, 33.3608829];

var bounds = {minX: min[0], minY: min[1], maxX: max[0], maxY:max[1]};

PointerEvent

지도와 오버레이에서 발생한 마우스 또는 터치 이벤트 발생 시 전달되는 포인터 이벤트 객체입니다.

Type:

event

Properties

Name	Type	Argument	Description
`coord`	Coord		이벤트가 발생한 위치의 지도 좌표입니다.
`point`	naver.maps.Point		이벤트가 발생한 위치의 세계 좌표입니다.
`offset`	naver.maps.Point		이벤트가 발생한 위치의 픽셀 좌표입니다.
`originalEvent`	DOMEvent		이벤트가 발생한 시점의 DOM 이벤트 객체입니다.
`pointerEvent`	DOMEvent		이벤트가 발생한 시점의 DOM 이벤트 객체입니다.
`overlay`	naver.maps.OverlayView	<optional>	이벤트가 발생한 오버레이 객체입니다.

PointLiteral

지도 좌표 리터럴 객체입니다. new naver.maps.Point를 대신하여 사용할 수 있습니다.

Type:

PointArrayLiteral | PointObjectLiteral

PointObjectLiteral

x, y를 키로 사용하는 좌표 객체입니다.

Type:

object

Properties

Name	Type	Description
`x`	number	x 좌표입니다.
`y`	number	y 좌표입니다.

Examples

var x = 126.5322317,
    y = 33.3572421;

var coord = {x: x, y: y};

var coord = {x: 10, y: 10};

SizeArrayLiteral

width, height 순서대로 선언된 크기 배열입니다.

Type:

array

Example

var width = 10,
    height = 5;

var sizeArray = [width, height];

SizeLiteral

2차원 평면의 크기 리터럴입니다. new naver.maps.Size를 대신하여 사용할 수 있습니다.

Type:

SizeArrayLiteral | SizeObjectLiteral

SizeObjectLiteral

width, height를 키로 사용하는 크기 객체입니다.

Type:

object

Properties

Name	Type	Description
`width`	number	너비
`height`	number	높이

Example

var width = 10,
    height = 5;

var SizeObjectLiteral = {width: width, height: height};

string

문자열(String)을 표현합니다.

Type:

string

TransitionOptions

지도의 이동 효과에 사용할 옵션입니다.

Type:

object

Properties

Name	Type	Argument	Default	Description
`duration`	number	<optional>		이동 효과가 실행되는 시간(ms)입니다. 각 이동 함수마다 기본값이 다르게 설정되어 있습니다. (`morph` 500ms, `panTo` / `panToBounds` 1000ms)
`easing`	string	<optional>	"easeOutCubic"	이동 효과에 사용할 `easing` 방식입니다. `linear`, `easeOutCubic`, `easeInCubic`만 지원합니다.

Types

Members

OVERLAY_TYPE_ORDER_IN_HOUSE

Methods

isDefaultMapType()

limitMaxBounds()

limitMinZoom()

Type Definitions

any

Type:

array

Type:

ArrayOfBounds

Type:

ArrayOfBoundsLiteral

Type:

ArrayOfCoords

Type:

ArrayOfCoordsLiteral

Type:

boolean

Bounds

Type:

BoundsLiteral

Type:

Coord

Type:

CoordLiteral

Type:

DOMEvent

Type:

DOMEventListener

Type:

Properties

DrawingOverlay

Type:

Properties

Example

FitBoundsOptions

Type:

Properties

function()

GeoJSON

Type:

Example

GPX

Type:

Example

HTMLElement

Type:

ImageData

Type:

KeyboardEvent

Type:

Properties

KML

Type:

Example

KVOArrayOfCoords

Type:

LatLngBoundsLiteral

Type:

LatLngBoundsObjectLiteral

Type:

Properties

Example

LatLngLiteral

Type:

LatLngObjectLiteral

Type:

Properties

Example

LayerRegistry

Type:

Properties

MapEventListener

Type:

Properties

MapType

Type: