HACClusterMapViewController
HACClusterMapViewController class is written in Objective-C and facilitates the use of maps when they have many pins that show. Will require us to come up with an ultra quick data structure built for the task. We will need to build it in C for it to be performant. This version 2.2 has been derived from the original authors version 2.0 , adding more flexibility in the delegates and the display of the annotations as well as correcting some issues.
##Requirements and Dependencies
- iOS >= 7.0
- ARC enabled
- CoreLocation Framework
- MKMapKit Framework
##Installation
####CocoaPods:
pod 'HACClusterMapViewController'
####Carthage:
github "litoarias/HACClusterMapViewController"
####Manual install:
- Copy
HACQuadTree.hHACQuadTree.mHACManagerQuadTree.hHACManagerQuadTree.mHAClusterAnnotation.hHAClusterAnnotation.mHAClusterAnnotationView.hHAClusterAnnotationView.mandHACMKMapView.hHACMKMapView.mto your project - Manual install HACClusterMapViewController
##Usage
Import in your .h HACMKMapView
#import "HACMKMapView.h"Map IBOutlet
For using Interface Builder, set class in your MKMapView HACMKMapView and make IBOutlet of your map, and put name to IBOutlet for example mapView.
Delegate for using methods
@interface MapViewController () <HACMKMapViewDelegate>
- (void)viewDidLoad {
[super viewDidLoad];
self.mapView.mapDelegate = self;
}Creat tree struct
It is easy to use , you must create the following structure in a loop.
NSArray *data = @[
@{kLatitude:@48.47352, kLongitude:@3.87426, kTitle : @"Title 1", kSubtitle : @"", kIndex : @0},
@{kLatitude:@52.59758, kLongitude:@-1.93061, kTitle : @"Title 2", kSubtitle : @"Subtitle 2", kIndex : @1},
@{kLatitude:@48.41370, kLongitude:@3.43531, kTitle : @"Title 3", kSubtitle : @"Subtitle 3", kIndex : @2},
@{kLatitude:@48.31921, kLongitude:@18.10184, kTitle : @"Title 4", kSubtitle : @"Subtitle 4", kIndex : @3},
@{kLatitude:@47.84302, kLongitude:@22.81101, kTitle : @"Title 5", kSubtitle : @"Subtitle 5", kIndex : @4},
@{kLatitude:@60.88622, kLongitude:@26.83792, kTitle : @"Title 6", kSubtitle : @"" , kIndex : @5}
];
We send build
The last step would be to call the driver father and pass the array as a parameter to start the process
[self.mapView.coordinateQuadTree buildTreeWithArray:data];Delegate methods
With delegate methods we can set custom images of annotations or know what index of object be reference.
-(void)viewForAnnotationView:(HAClusterAnnotationView *)annotationView annotation:(HAClusterAnnotation *)annotation{
if (annotation.index % 2 == 0) {
annotationView.image = [UIImage imageNamed:@"pin_museum"];
}else{
annotationView.image = [UIImage imageNamed:@"pin_coffee"];
}
}
-(void)didSelectAnnotationView:(HAClusterAnnotation *)annotation{
NSLog(@"You ara select annotation index %ld", (long)annotation.index);
}
Customize
Programmatically
self.mapView.backgroundAnnotation = [UIColor redColor];
self.mapView.borderAnnotation = [UIColor whiteColor];
self.mapView.textAnnotation = [UIColor whiteColor];
self.mapView.compassFrame = CGRectMake(10, 10, 25, 25);
self.mapView.legalFrame = CGRectMake(CGRectGetWidth([UIScreen mainScreen].bounds)-50, CGRectGetHeight([UIScreen mainScreen].bounds)-50, 50, 50);Interface Builder
Enjoy :D
Contributing
- Fork it ( https://github.com/[my-github-username]/HACClusterMapViewController/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request