Item page
CodePen
Sandbox Download

Magnitude 4.0 earthquakes and greater from 1970 to 2019, with brighter areas indicating a greater concentration of earthquakes.

What is bloom?

Bloom is a layer effect that brightens symbols representing a layer’s features, making them appear to glow. This has an additive effect so areas where more features overlap will have a brighter and more intense glow. This makes bloom an effective way for visualizing dense datasets.

How bloom works

The bloom effect is controlled with three parameters and looks best on dark backgrounds.

bloom(strength, radius, threshold)

ParameterDescription
strengthDetermines the intensity of the bloom effect as a factor or percentage. The higher the strength, the brighter the glow.
radiusDetermines the spread of light in the accepted range 0px-1px. Default value is 0. Negative values are not allowed. Leaves the features inside the radius untouched.
thresholdColors with this brightness value or higher will have the bloom effect applied.

The bloom effect can be sensitive to scale, density, and color. Effectively using bloom is often done through trial and error. The parameters that work well for one layer are often not suitable for other layers.

Examples

Points

Item page
CodePen
Sandbox Download
Magnitude 4.0 earthquakes and greater from nearly 50 years reveal dense patterns through bloom.
Bloom - magnitude 4.0 earthquakes
20 collapsed lines
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
<title>Bloom - magnitude 4.0 earthquakes</title>
<!-- Load the ArcGIS Maps SDK for JavaScript from CDN -->
<script type="module" src="https://js.arcgis.com/5.2/"></script>
<style>
html,
body {
height: 100%;
margin: 0;
}
</style>
</head>
<body>
<arcgis-map item-id="39a036d7d762416e833499f94db679e5">
<arcgis-zoom slot="top-left"></arcgis-zoom>
<arcgis-expand slot="top-right">
<arcgis-legend></arcgis-legend>
</arcgis-expand>
</arcgis-map>
2 collapsed lines
</body>
</html>

Lines

Item page
CodePen
Sandbox Download
Florida highways use bloom to make thick and overlapping traffic lines appear brighter than thin, isolated lines.
Bloom - Florida annual average daily traffic
20 collapsed lines
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
<title>Bloom - Florida annual average daily traffic</title>
<!-- Load the ArcGIS Maps SDK for JavaScript from CDN -->
<script type="module" src="https://js.arcgis.com/5.2/"></script>
<style>
html,
body {
height: 100%;
margin: 0;
}
</style>
</head>
<body>
<arcgis-map item-id="ef0cc5d2a7be4d76b10d438b8234fe9a">
<arcgis-zoom slot="top-left"></arcgis-zoom>
<arcgis-expand slot="top-right">
<arcgis-legend></arcgis-legend>
</arcgis-expand>
</arcgis-map>
2 collapsed lines
</body>
</html>

API support

The following table describes the geometry and view types that are suited well for each visualization technique.

  • Full support
  • Partial support
  • No support
2D3DPointsLinesPolygonsMeshClient-sideServer-side
  1. Feature reduction selection not supported
  2. Only by feature reduction selection
  3. Only by scale-driven filter