Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Comparing changes

Choose two branches to see what's changed or to start a new pull request. If you need to, you can also compare across forks.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also compare across forks.
base fork: mapbox/tilemill
head fork: mapbox/tilemill
Checking mergeability… Don't worry, you can still create the pull request.
  • 2 commits
  • 1 file changed
  • 0 commit comments
  • 2 contributors
Commits on May 10, 2012
@ian29 ian29 add heatmap how-to b8986ee
Bonnie Bogle Merge pull request #1470 from mapbox/heatmap
add heatmap how-to
53 _posts/docs/guides/
@@ -0,0 +1,53 @@
+## Designing Heat Maps with TileMill and QGIS
+This is a 10 minute walk through showing how to generate heat maps in QGIS and then display them in TileMill.
+# Working with QGIS
+Make sure you are running at least QGIS >= 1.9. At the time of writing this, this is the development release. Mac users can find it at [kyngchaos](
+Next you'll need to enable the Heatmap Plugin. Open the pane below by selecting Plugins > Manage plugins. In the following pane, check the box for the Heatmap Plugin. _Note: This plugin is only available for QGIS 1.9 and above_. You may need to restart QGIS for these changes to take effect.
+Now add some point data. Data below is from the DC office of Alcoholic Beverages Regulatory Administration, made available by DC's open data portal []( It can be downloaded [here]([here](
+Now go to Raster > Heatmap > Heatmap. You should see a dialog box like this:
+Specify an output filepath (with a .tif extension) and leave the default settings for now. Hit `OK` to generate your heat map. A big gray rectangle will be added to the project as a new layer. To see the different color values, open the properties pane for your new layer. To get a quick and dirty visualization of the different values we'll use one of the QGIS preset color schemes. Under the Style tab, set the Colormap drop down menu to 'Pseudocolor' and hit ok. You should see a map like this:
+Now that you have your map, play around with the colors and other parameters. Defaults are easy, but rarely expose data well. The Heatmap dailog has a great help section that painlessly explains what a 'spatial buffer' and 'decay ratio' are. See an [earlier post]( on working with raster data to come up with your own custom color scheme. If you want to render your map to tiles with TileMill, the GeoTIFF default is one you don't have to change.
+To render in TileMill, open a new project and load your .tiff as a new layer. Get rid of the `#countries` layer, and change the map background so that your carto looks like this:
+ #heatmap {
+ raster-opacity:1;
+ raster-scaling: bilinear;
+ }
+Your map should appear. Just hit upload in the [export]( menu to start sharing your map online. For more info on working with raster data, read docs on [reprojecting geotiffs]( and [working with terrain data]( If you want more inspiration, check out some of previous work like [AJ's](!/aj_ashton) map of [![](](
+## Faking it with TileMill
+TileMill won't generate rasterized heatmaps like the QGIS plugin can, but you can approximate the effect with a few Carto tricks to take advantage of aggregated opacity: low opacity of individual points means that overlap in dense areas has a stronger, more saturated color value.
+<iframe width='450' height='650' frameBorder='0' src=''> </iframe>
+This example uses the original shapefile with just a few lines of [Carto](
+ #abralicenseept [DESCRIPTIO != 'Retailer B']{
+ marker-width:4;
+ marker-fill:#ef0;
+ marker-opacity:.45;
+ marker-line-opacity:0;
+ marker-allow-overlap:true;
+ }
+_Note: This code also omits any locations listed as 'Retailer B' to get rid of grocery stores to better show where bars and nightlife are in DC_
+This approach has the added benefit of retaining the exact locations of individual dots at higher zoom levels, as well as the possibility of feature-specific interactivity. For further styling tips, learn more about [advanced map design](

No commit comments for this range

Something went wrong with that request. Please try again.