NAMapKit
Lets you drop pins or custom annotations onto a standard UIImage or a tiled NATiledImageView. Includes callouts, multi-colored pins, animation, zoom and gestures support.
Get started by running pod try NAMapKit in your terminal.
Usage
Default Annotations
Create a NAMapView in a view controller.
NAMapView *mapView = [[NAMapView alloc] initWithFrame:self.view.bounds];
mapView.backgroundColor = [UIColor colorWithRed:0.000f green:0.475f blue:0.761f alpha:1.000f];
mapView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
mapView.minimumZoomScale = 0.5f;
mapView.maximumZoomScale = 1.5f;
[mapView displayMap:[UIImage imageNamed:@"australia"]];
[self.view addSubview:mapView];
Add NADotAnnotation annotations.
NADotAnnotation *dot = [NADotAnnotation annotationWithPoint:CGPointMake(543.0f, 489.0f)];
[mapView addAnnotation:dot animated:NO];
Custom Annotations
The implementation of NADotAnnotation places a red semi-transparent dot on the map. For custom annotations, subclass NAAnnotation and implement createViewOnMapView that returns a custom annotation view. You could also implement a custom animation to drop an annotation onto the map by implementing addToMapView, or center the annotation depending on your custom logic by overriding updatePosition.
You can find a complete custom annotation example of multi-colored pins in NAPinAnnotation.h/.m and a popup menu demo in NAPinAnnotationsPopupMenuDemoViewController.h/.m.
Delegates
You can capture finger taps and zoom changes by registering a mapViewDelegate with the map. The delegate must implement the NAMapViewDelegate protocol.
@implementation DemoViewController
- (void)viewDidLoad
{
// Register the view controller as the map's delegate
self.mapView.mapViewDelegate = self;
}
- (void)mapView:(NAMapView *)mapView tappedOnAnnotation:(NAPinAnnotation *)annotation
{
// Invoked when a user taps an annotation
}
- (void)mapView:(NAMapView *)mapView hasChangedZoomLevel:(CGFloat)level
{
// Invoked when the map zoom level changes
}
@end
See NAAnnotationDemoViewController.m for a complete example.
Tiled Maps
NAMapKit comes with NATiledImageMapView, which supports tiled maps. A typical organization for deep zoom map tiles consists of a folder for each zoom level and individual JPG files for each tile. You can see an example of such files here. NAMapKit uses ARTiledImageView. You can generate tiles using dzt or any other tool listed with the OpenSeadragon project.
For a complete example of a tiled map, see NATiledImageDemoViewController.m.
Custom Gestures
NAMapKit exposes it's two double tap gestures so that you can use delaysTouchesBegan to prioritise the double tap over a map point tap. Or to just replace them entirely yourself.
Notes
If you are using Interface Builder, you can add a UIScrollView to your XIB and change the class to NAMapView to use the framework.
License
This project is licensed under the MIT license.
Attribution
When using this code please include the following attribution:
Includes NAMapKit code developed by Neil Ang, Tony Arnold, Daniel Doubrovkine and Orta Therox.
![exposed imageView so that i can retrieve CGPoints using [gesture locationInView:mapView.imageView]](https://avatars.githubusercontent.com/u/6367998?v=4)
4.2k Jan 9, 2023
135 Dec 26, 2022
162 Nov 16, 2022
0 Oct 19, 2021
2 Jul 1, 2022
73 Dec 26, 2022
0 Dec 30, 2021
48 Aug 13, 2022
5 Nov 12, 2021
1.5k Jan 2, 2023
53 Feb 5, 2022
3 Dec 16, 2022
502 Dec 25, 2022
117 Sep 2, 2022
4.5k Dec 23, 2022
6 Oct 15, 2022
91 Dec 4, 2022
96 Dec 18, 2022