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

Class: naver.maps.visualization.DotMap

naver.maps.visualization. DotMap

DotMap 클래스는 점지도를 정의합니다. 가중치가 있는 지점 목록을 이용할 때는 가중치를 1 ~ {반지름}로 정규화하고, 해당 값을 점지도를 표현하는 점의 반지름으로 사용합니다. 가중치가 없는 지점 목록을 이용할 때는 반지름을 점지도를 표현하는 점의 반지름으로 사용합니다.

new naver.maps.visualization.DotMap(dotMapOptions)

Parameters
Name Type Argument Description
dotMapOptions DotMapOptions <optional>

점지도 옵션

Tutorials

Methods

getData()

점지도의 데이터를 반환합니다.

Returns
Type Description
Array.<naver.maps.LatLng> | Array.<PointArrayLiteral>

점지도의 데이터

getMap()

현재 점지도가 추가된 Map 객체를 반환합니다.

Returns
Type Description
naver.maps.Map | null

Map 객체

getOptions(key)

점지도의 모든 옵션 또는 특정 옵션을 반환합니다.

Parameters
Name Type Argument Description
key string <optional>

가져올 옵션 이름

Returns
Type Description
DotMapOptions | any

점지도 옵션

redraw()

점지도를 새로 그립니다.

setData(data)

점지도의 데이터를 설정합니다. 새로 추가된 데이터는 naver.maps.visualization.DotMap#redraw 메서드를 호출해야 반영됩니다.

Parameters
Name Type Description
data Array.<naver.maps.LatLng> | Array.<PointArrayLiteral>

점지도의 데이터

setMap(map)

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

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

점지도를 추가할 Map 객체

setOptions(key, value)

점지도의 옵션을 변경하거나 새로 설정합니다.

Parameters
Name Type Description
key string

점지도 옵션 이름

value any

점지도 옵션 값

setOptions(options)

점지도의 옵션을 변경하거나 새로 설정합니다.

Parameters
Name Type Description
options DotMapOptions

점지도 옵션

Type Definitions


DotMapOptions

DotMapOptions 객체는 DotMap을 정의하는 옵션을 나타냅니다.

Type:
Properties
Name Type Argument Default Description
map naver.maps.Map

점지도가 그려질 지도 객체입니다.

data Array.<naver.maps.LatLng> | Array.<PointArrayLiteral> | Array.<naver.maps.visualization.WeightedLocation>

점지도의 지점 목록입니다.

opacity number <optional>
0.5

점지도의 불투명도입니다. 0 ~ 1의 값을 입력합니다.

radius number <optional>
5

점지도를 표현하는 점의 반지름입니다. 단위는 픽셀입니다.

strokeWeight number <optional>
1

점지도를 표현하는 점의 선 두께입니다.

strokeColor string <optional>
white

점지도를 표현하는 점의 선 색상입니다. CSS 색상 표현법으로 설정합니다.

strokeLineCap string <optional>
butt

점지도를 표현하는 점의 선 마감 스타일입니다. SVG의 stroke-linecap 스타일 표준을 따릅니다.

사용 가능한 값으로는 butt, flat(butt와 동일), round 그리고 square가 있습니다.

아래 그림의 왼쪽부터 순서대로 butt, round, square입니다.
stroke-linecap

strokeLineJoin string <optional>
miter

점지도를 표현하는 점의 선들이 맞닿는 부분에 대한 마감 스타일입니다. SVG의 stroke-linejoin 스타일 표준을 따릅니다.

사용 가능한 값으로는 miter, round 그리고 bevel이 있습니다.

아래 그림의 위부터 순서대로 miter, round, bevel입니다.
stroke-linejoin

fillColor string <optional>
red

점지도를 표현하는 점의 영역을 채울 색상입니다. CSS 색상 표현법으로 설정합니다.