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

Class: naver.maps.visualization.HeatMap

naver.maps.visualization. HeatMap

HeatMap 클래스는 열지도를 정의합니다. 가중치가 있는 지점 목록을 이용할 때는 가중치를 0.1~1로 정규화하고, 해당 값을 열지도를 표현하는 점의 영향력 강도(세기)로 사용합니다. 가중치가 없는 지점 목록을 이용할 때는 기본값 1을 열지도를 표현하는 점의 영향력 강도(세기)로 사용합니다.

new naver.maps.visualization.HeatMap(heatMapOptions)

Parameters
Name Type Argument Description
heatMapOptions HeatMapOptions <optional>

열지도 옵션

Tutorials

Methods

getColorMap()

열지도의 색상 스펙트럼을 반환합니다.

Returns
Type Description
naver.maps.visualization.SpectrumStyle

열지도 색상 스펙트럼

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
HeatMapOptions | any

열지도 옵션

redraw()

열지도를 새로 그립니다.

setColorMap(colormap, inReverse)

열지도의 색상 스펙트럼을 설정합니다.

Parameters
Name Type Description
colormap naver.maps.visualization.SpectrumStyle

열지도 색상 스펙트럼

inReverse boolean

반전된 색상 설정 여부입니다. 이 값이 true이면 설정한 색상 스펙트럼의 반전을 이용합니다.

setData(data)

열지도의 데이터를 설정합니다. 새로 추가된 데이터는 naver.maps.visualization.HeatMap#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 HeatMapOptions

열지도 옵션

Type Definitions


HeatMapOptions

HeatMapOptions 객체는 HeatMap을 정의하는 옵션을 나타냅니다.

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.6

열지도의 불투명도입니다. 값의 범위는 0~1입니다.

radius number <optional>
10

열지도를 표현하는 점의 영향력을 나타내는 반지름입니다. 단위는 픽셀입니다.

colorMap naver.maps.visualization.SpectrumStyle <optional>
RAINBOW

열지도의 색상 스펙트럼입니다.