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

Types

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:

ArrayOfBounds

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

Type:

ArrayOfBoundsLiteral

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

Type:

ArrayOfCoords

지도 좌표의 배열입니다.

Type:

ArrayOfCoordsLiteral

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

Type:

boolean

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


Bounds

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

Type:

BoundsLiteral

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

Type:

Coord

지도 좌표 객체입니다.

Type:

CoordLiteral

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

Type:

DOMEvent

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

Type:
  • event

DOMEventListener

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

Type:
Properties
Name Type Description
eventName string

등록된 이벤트의 이름입니다.

listener function

등록된 이벤트의 핸들러입니다.

target HTMLElement

이벤트가 등록된 대상 요소입니다.


DrawingOverlay

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

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

Type:
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:
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

Featuregeometry 객체와 부가적인 속성을 포함하며, FeatureCollectionfeature의 목록이라고 할 수 있습니다.

Type:
Tutorials
See
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:
Tutorials
See
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:

ImageData

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

Type:

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:
Tutorials
See
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:

LatLngBoundsLiteral

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

Type:

LatLngBoundsObjectLiteral

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

Type:
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:

LatLngObjectLiteral

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

Type:
Properties
Name Type Description
lat number

위도 좌표입니다.

lng number

경도 좌표입니다.

Example
var x = 126.5322317,
    y = 33.3572421;

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

LayerRegistry

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

Type:
Properties
Name Type Description
getLayerNames function

등록된 모든 레이어의 이름을 배열로 반환합니다.


MapEventListener

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

Type:
Properties
Name Type Description
eventName string

등록된 이벤트의 이름입니다.

listener function

등록된 이벤트의 핸들러입니다.

listenerId string

등록된 이벤트의 ID입니다.

target object

이벤트가 등록된 대상 객체입니다.


MapType

지도 유형 객체입니다.

Type:

margin

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

Type:
Properties
Name Type Description
top number

right number

오른쪽

bottom number

아래

left number

왼쪽

maxZoom number

fitBounds 적용 시 허용되는 최대 줌 입니다.


null

null 값을 표현합니다.

Type:

number

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

Type:

object

JavaScript의 Object를 표현합니다.

Type:

padding

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

Type:
Properties
Name Type Description
top number

right number

오른쪽

bottom number

아래

left number

왼쪽


PointArrayLiteral

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

Type:
Examples
var x = 126.5322317,
    y = 33.3572421;

var coord = [x, y];
var coord = [10, 10];

PointBoundsArrayLiteral

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

Type:
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:

PointBoundsObjectLiteral

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

Type:
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:

PointObjectLiteral

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

Type:
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:
Example
var width = 10,
    height = 5;

var sizeArray = [width, height];

SizeLiteral

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

Type:

SizeObjectLiteral

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

Type:
Properties
Name Type Description
width number

너비

height number

높이

Example
var width = 10,
    height = 5;

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

string

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

Type:

TransitionOptions

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

Type:
Properties
Name Type Argument Default Description
duration number <optional>
500

이동 효과가 실행되는 시간(ms)입니다.

easing string <optional>
"easeOutCubic"

이동 효과에 사용할 easing 방식입니다.

linear, easeOutCubic, easeInCubic만 지원합니다.