Get a Maps Demo Key: Try out select Maps JavaScript API and Places UI Kit features at no cost with a Maps Demo Key—no billing information required.

Heatmaps

[フレーム]

HeatmapLayer class

google.maps.visualization.HeatmapLayer class

A layer that provides a client-side rendered heatmap, depicting the intensity of data at geographical points.

This class extends MVCObject .

Access by calling const {HeatmapLayer} = await google.maps.importLibrary("visualization").
See Libraries in the Maps JavaScript API.

Constructor

HeatmapLayer
HeatmapLayer([opts])
Parameters:
Creates a new instance of HeatmapLayer.

Methods

getData
getData()
Parameters: None
Returns the data points currently displayed by this heatmap.
getMap
getMap()
Parameters: None
Return Value: Map|undefined
setData
setData(data)
Return Value: None
Sets the data points to be displayed by this heatmap.
setMap
setMap(map)
Parameters:
  • map: Map optional
Return Value: None
Renders the heatmap on the specified map. If map is set to null, the heatmap will be removed.
setOptions
setOptions(options)
Parameters:
Return Value: None
Inherited: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll

HeatmapLayerOptions interface

google.maps.visualization.HeatmapLayerOptions interface

This object defines the properties that can be set on a HeatmapLayer object.

Properties

data optional
The data points to display. Required.
dissipating optional
Type: boolean optional
Specifies whether heatmaps dissipate on zoom. By default, the radius of influence of a data point is specified by the radius option only. When dissipating is disabled, the radius option is interpreted as a radius at zoom level 0.
gradient optional
Type: Array<string> optional
The color gradient of the heatmap, specified as an array of CSS color strings. All CSS3 colors are supported except for extended named colors.
map optional
Type: Map optional
The map on which to display the layer.
maxIntensity optional
Type: number optional
The maximum intensity of the heatmap. By default, heatmap colors are dynamically scaled according to the greatest concentration of points at any particular pixel on the map. This property allows you to specify a fixed maximum.
opacity optional
Type: number optional
Default: 0.6
The opacity of the heatmap, expressed as a number between 0 and 1.
radius optional
Type: number optional
The radius of influence for each data point, in pixels.

WeightedLocation interface

google.maps.visualization.WeightedLocation interface

A data point entry for a heatmap. This is a geographical data point with a weight attribute.

Properties

location
Type: LatLng
The location of the data point.
weight
Type: number
The weighting value of the data point.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026年09月01日 UTC.