Heatmaps

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-03-02 UTC.