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

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