Render your own Heatmaps with HeatMapRenderer

Heatmaps (aka Density Maps) are a neat way to visualize geo data – and these days there are everyhwere – from Starbucks WiFi heatmaps to The Dealmap Local Deals maps! While they are so popular, I was surprised to learn that there are not many (FREE) tools available to generate your own Google Maps ready Heatmap. So I have developed a simple utility,  called HeatMapRenderer, that can be used to generate Google Maps Ready heatmap tiles from any geo dataset that has latitude and longitude values.
This utility is built for Windows based machines (with .NET 3.5) and is written in C#. If there is a need and if there is a community that is willing to build on top of what I have I don’t mind posting it as an open source, but for now its closed source with extensibility model built into it. Think of HeatmapRenderer as a simple rendering engine you can plug-and-play different data sources to render from. Each data source will have its own adaptor – an adaptor is responsible for reading the latitude/longitude data by implementing a simple interface. HeatMapRender natively supports CSV adaptor, so if you can dump your geodata into a CSV file you can use the Heatmaprender instantly. I will write a follow-up on how to extend and write your own adaptors in my next post.
So for now, let’s assume you have your latitude/longitude data in a CSV file. And that the column index for latitude and logitude are 0 and 1. Now you need to add a config section like below in the HeatmapRenderer.exe.config file (from the download):

<add name="us-starbucks"
   sourcetype =”HeatMapRenderer.Sources.SimpleCSVSource, HeatMapRenderer.Sources”

Once you add a config section as shown above, all you need to do to generate the heatmap tiles, is to type in a command like below:

HeatmapRenderer.exe us-starbucks

As you can see its very straight forward, here is a bit more about the config values:

name = unique name so that you can identify and run the tile generation job.
sourcetype = This is the source adaptor. If you have a CSV file, then you can use the built in CSV source adaptor, and of course you can build your own adaptor too (more on that later)
sourceconnectionstring = points to the CSV file (or if you have a MySql data source this should be the connection string etc);
sourcearguments = if you have a CSV you identify lat/long column index values – you can use this field to send any data that is required for your own adaptor.
palettefilepath = default heatmap palette – you can generate your own palette if needed (the download has a palette file included)
pointradius = default 5pixels. you can reduce or increase the point radius based on your scenarios.
minmaplevel = usually 1. levels map to google maps zoom levels. so 1 is very very high-level map (at world map level)
maxmaplevel = usually determined by your app. but in this case 10. around 15 if you want some-what street level heatmaps
outpath = where to store the heatmap tiles generated – local disk path

Once the tiles are generated, you can easily integrate the tiles into a Google maps mashup using the following steps:
1. First upload your tiles to a web server where they can be accessed w/o any authentication.
2. Then use the code below to integrate

var map = new GMap2(document.getElementById(“map_canvas”));
map.setCenter(new GLatLng(38.86252601314520,-76.96975322980910), 2);
var myCopyright = new GCopyrightCollection(“© Chandu Thota”);
myCopyright.addCopyright(new GCopyright(‘Chandu Thota’, new GLatLngBounds(new GLatLng(-90,-180), new GLatLng(90,180)), 0,’2010’));
var gtl = new GTileLayer(myCopyright);
gtl.getTileUrl = function(tile,zoom) {
var t = “http:///&#8221; + zoom + tile.x + tile.y + “.png”;
return t;
gtl.isPng = function() { return true;};
gtl.getOpacity = function() { return 0.5; }
var tilelayer = new GTileLayerOverlay(gtl);

That’s it!
You can download the full package with exe, sample adaptor code, palette and sample data files (Starbucks locations and DC crime locations).
Let me know if you find this tool useful.

function _trackdownload(){ try { var _pt = _gat._getTracker(“UA-168784-1”); _pt._trackPageview(‘/downloads/heatmaprenderer’); } catch(err) {} }

3 thoughts on “Render your own Heatmaps with HeatMapRenderer”

  1. Does not work in my case.
    It looks like the generator generates images in x-y space while the getTileUrl requests them in tile space? Anyway if I alerts the tile.x and tile.y I get no matches with the generated files. In the declaration:

    var t = “http:///” + zoom + tile.x + tile.y + “.png”;

    also are no '-', while there are in the generated filenames. Do I miss something??

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s