DTMHeatmap

A fast, easy-to-use heatmap with MapKit integration

Showing:

Popularity

Downloads/wk

0

GitHub Stars

83

Maintenance

Last Commit

4yrs ago

Contributors

5

Package

Dependencies

0

License

MIT

Categories

Readme

DTMHeatmap

A heatmap for iOS, implemented as an MKOverlay to provide seamless integration with MapKit.

This project is based on https://github.com/ryanolsonk/HeatMapDemo. It has been updated to improve performance and add a "diff" mode. https://github.com/gpolak/LFHeatMap was also referenced.

Modes

Standard

This mode is a standard heatmap and should produce the same results as the original HeatMapDemo project, but more quickly.

Diff

This mode compares two sets of data to visualize which areas have "heated up" and which have "cooled down". Increased activity is shown with warm colors, decreased activity is shown with cool colors.

Installation

CocoaPods

Add pod 'DTMHeatmap' to your Podfile

Carthage

Add github "dataminr/DTMHeatmap" to your Cartfile

Usage

Using DTMHeatmap is relatively straightforward. After installing using the instructions above: 0. Register as a delegate of your map view

  1. Create an instance of DTMHeatmap
  2. Provide data in the form of a dictionary mapping MKMapPoint (wrapped in NSValue using [NSValue value:&point withObjCType:@encode(MKMapPoint)]) to weights
  3. Add the heatmap as an overlay to your map view.

In the simplest form, the code looks something like this:

- (void)viewDidLoad
{
    self.mapView.delegate = self;

    // Create DTMHeatmap
    self.heatmap = [DTMHeatmap new];
    [self.heatmap setData:myData];
    [self.mapView addOverlay:self.heatmap];

    // or...
    // Create DTMDiffHeatmap
    self.diffHeatmap = [DTMDiffHeatmap new];
    [self.diffHeatmap setBeforeData:beforeData
                          afterData:afterData];
    [self.mapView addOverlay:self.diffHeatmap];
}

- (MKOverlayRenderer *)mapView:(MKMapView *)mapView
            rendererForOverlay:(id<MKOverlay>)overlay
{
    return [[DTMHeatmapRenderer alloc] initWithOverlay:overlay];
}

As you can see, the only difference between the stanard heatmap API and that of the diff heatmap is that the diff heatmap requires two sets of data – before and after.

Example Project

A sample project (DTMHeatmapExample) has been provided to demonstrate basic usage. There are currently four visualization options:

  • Standard: shows US locations of McDonald's as a regular heatmap
  • Week 1: shows Sacramento crime data for the first week of January 2006 as a regular heatmap
  • Week 3: shows Sacramento crime data for the third week of January 2006 as a regular heatmap
  • Diff: compares the data from Week 3 to Week 1 as a diff heatmap. As one might expect, the diff is fairly random. If you can recommend a better dataset, please let me know :)

Data Sources

McDonald's Locations

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100