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(options)

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

Parameters
Name Type Description
options DotMapOptions

점지도 옵션

setOptions(key, value)

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

Parameters
Name Type Description
key string

점지도 옵션 이름

value any

점지도 옵션 값

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 색상 표현법으로 설정합니다.