react-native-maps 1.7.1 → 2.0.0-beta.10

package/ios/Maps/RNMMapManager.m

@@ -0,0 +1,854 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree. An additional grant
+ * of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+#import "RNMMapManager.h"
+
+#import <React/RCTBridge.h>
+#import <React/RCTUIManager.h>
+#import <React/RCTConvert.h>
+#import <React/RCTConvert+CoreLocation.h>
+#import <React/RCTEventDispatcher.h>
+#import <React/RCTViewManager.h>
+#import <React/UIView+React.h>
+#import "RNMMap.h"
+#import "RNMMapMarker.h"
+#import "RNMMapPolyline.h"
+#import "RNMMapPolygon.h"
+#import "RNMMapCircle.h"
+#import "SMCalloutView.h"
+#import "RNMMapUrlTile.h"
+#import "RNMMapWMSTile.h"
+#import "RNMMapLocalTile.h"
+#import "RNMMapSnapshot.h"
+#import "RCTConvert+RNMMap.h"
+#import "RNMMapOverlay.h"
+#import <MapKit/MapKit.h>
+
+static NSString *const RCTMapViewKey = @"MapView";
+
+
+@interface RNMMapManager() <MKMapViewDelegate, UIGestureRecognizerDelegate>
+
+- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer;
+
+@end
+
+@implementation RNMMapManager{
+   BOOL _hasObserver;
+}
+
+RCT_EXPORT_MODULE(RNMMap)
+
+- (UIView *)view
+{
+    RNMMap *map = [RNMMap new];
+    map.delegate = self;
+
+    map.isAccessibilityElement = NO;
+    map.accessibilityElementsHidden = NO;
+    
+    // MKMapView doesn't report tap events, so we attach gesture recognizers to it
+    UITapGestureRecognizer *tap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(handleMapTap:)];
+    UITapGestureRecognizer *doubleTap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(handleMapDoubleTap:)];
+    [doubleTap setNumberOfTapsRequired:2];
+    [tap requireGestureRecognizerToFail:doubleTap];
+    
+    UILongPressGestureRecognizer *longPress = [[UILongPressGestureRecognizer alloc] initWithTarget:self action:@selector(handleMapLongPress:)];
+    UIPanGestureRecognizer *drag = [[UIPanGestureRecognizer alloc] initWithTarget:self action:@selector(handleMapDrag:)];
+    [drag setMinimumNumberOfTouches:1];
+    // setting this to NO allows the parent MapView to continue receiving marker selection events
+    tap.cancelsTouchesInView = NO;
+    doubleTap.cancelsTouchesInView = NO;
+    longPress.cancelsTouchesInView = NO;
+    
+    doubleTap.delegate = self;
+    
+    // disable drag by default
+    drag.enabled = NO;
+    drag.delegate = self;
+  
+    [map addGestureRecognizer:tap];
+    [map addGestureRecognizer:doubleTap];
+    [map addGestureRecognizer:longPress];
+    [map addGestureRecognizer:drag];
+
+    return map;
+}
+
+RCT_EXPORT_VIEW_PROPERTY(boundary, MKMapCameraBoundary*)
+RCT_EXPORT_VIEW_PROPERTY(cacheEnabled, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(compassOffset, CGPoint)
+RCT_EXPORT_VIEW_PROPERTY(followsUserLocation, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(handlePanDrag, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(isAccessibilityElement, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(kmlSrc, NSString)
+RCT_EXPORT_VIEW_PROPERTY(legalLabelInsets, UIEdgeInsets)
+RCT_EXPORT_VIEW_PROPERTY(loadingBackgroundColor, UIColor)
+RCT_EXPORT_VIEW_PROPERTY(loadingEnabled, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(loadingIndicatorColor, UIColor)
+RCT_EXPORT_VIEW_PROPERTY(mapPadding, UIEdgeInsets)
+RCT_EXPORT_VIEW_PROPERTY(mapType, MKMapType)
+RCT_EXPORT_VIEW_PROPERTY(maxDelta, CGFloat)
+RCT_EXPORT_VIEW_PROPERTY(maxZoomLevel, CGFloat)
+RCT_EXPORT_VIEW_PROPERTY(minDelta, CGFloat)
+RCT_EXPORT_VIEW_PROPERTY(minZoomLevel, CGFloat)
+RCT_EXPORT_VIEW_PROPERTY(onCalloutPress, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onChange, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onDoublePress, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onLongPress, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onMapReady, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onMarkerDeselect, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onMarkerDrag, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onMarkerDragEnd, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onMarkerDragStart, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onMarkerPress, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onMarkerSelect, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onPanDrag, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onPress, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onUserLocationChange, RCTBubblingEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(pitchEnabled, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(rotateEnabled, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(scrollEnabled, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(showsBuildings, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(showsCompass, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(showsPointsOfInterest, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(showsScale, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(showsTraffic, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(showsUserLocation, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(tintColor, UIColor)
+RCT_EXPORT_VIEW_PROPERTY(userInterfaceStyle, NSString)
+RCT_EXPORT_VIEW_PROPERTY(userLocationAnnotationTitle, NSString)
+RCT_EXPORT_VIEW_PROPERTY(userLocationCalloutEnabled, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(zoomEnabled, BOOL)
+RCT_REMAP_VIEW_PROPERTY(testID, accessibilityIdentifier, NSString)
+RCT_CUSTOM_VIEW_PROPERTY(camera, MKMapCamera*, RNMMap)
+{
+    if (json == nil) return;
+    
+    // don't emit region change events when we are setting the camera
+    BOOL originalIgnore = view.ignoreRegionChanges;
+    view.ignoreRegionChanges = YES;
+    [view setCamera:[RCTConvert MKMapCamera:json] animated:NO];
+    view.ignoreRegionChanges = originalIgnore;
+}
+RCT_CUSTOM_VIEW_PROPERTY(initialCamera, MKMapCamera, RNMMap)
+{
+    if (json == nil) return;
+    
+    // don't emit region change events when we are setting the initialCamera
+    BOOL originalIgnore = view.ignoreRegionChanges;
+    view.ignoreRegionChanges = YES;
+    [view setInitialCamera:[RCTConvert MKMapCamera:json]];
+    view.ignoreRegionChanges = originalIgnore;
+}
+
+RCT_CUSTOM_VIEW_PROPERTY(initialRegion, MKCoordinateRegion, RNMMap)
+{
+    if (json == nil) return;
+
+    // don't emit region change events when we are setting the initialRegion
+    BOOL originalIgnore = view.ignoreRegionChanges;
+    view.ignoreRegionChanges = YES;
+    [view setInitialRegion:[RCTConvert MKCoordinateRegion:json]];
+    view.ignoreRegionChanges = originalIgnore;
+}
+
+RCT_CUSTOM_VIEW_PROPERTY(region, MKCoordinateRegion, RNMMap)
+{
+    if (json == nil) return;
+
+    // don't emit region change events when we are setting the region
+    BOOL originalIgnore = view.ignoreRegionChanges;
+    view.ignoreRegionChanges = YES;
+    [view setRegion:[RCTConvert MKCoordinateRegion:json] animated:NO];
+    view.ignoreRegionChanges = originalIgnore;
+}
+
+#pragma mark exported MapView methods
+
+RCT_EXPORT_METHOD(setCamera:(nonnull NSNumber *)reactTag
+                  camera:(id)json)
+{
+    [self.bridge.uiManager addUIBlock:^(__unused RCTUIManager *uiManager, NSDictionary<NSNumber *, UIView *> *viewRegistry) {
+        id view = viewRegistry[reactTag];
+        if (![view isKindOfClass:[RNMMap class]]) {
+            RCTLogError(@"Invalid view returned from registry, expecting RNMMap, got: %@", view);
+        } else {
+            RNMMap *mapView = (RNMMap *)view;
+
+            // Merge the changes given with the current camera
+            MKMapCamera *camera = [RCTConvert MKMapCameraWithDefaults:json existingCamera:[mapView camera]];
+
+            // don't emit region change events when we are setting the camera
+            BOOL originalIgnore = mapView.ignoreRegionChanges;
+            mapView.ignoreRegionChanges = YES;
+            [mapView setCamera:camera animated:NO];
+            mapView.ignoreRegionChanges = originalIgnore;
+        }
+    }];
+}
+
+#pragma mark Gesture Recognizer Handlers
+
+#define MAX_DISTANCE_PX 10.0f
+- (void)handleMapTap:(UITapGestureRecognizer *)recognizer {
+    RNMMap *map = (RNMMap *)recognizer.view;
+
+    CGPoint tapPoint = [recognizer locationInView:map];
+    CLLocationCoordinate2D tapCoordinate = [map convertPoint:tapPoint toCoordinateFromView:map];
+    MKMapPoint mapPoint = MKMapPointForCoordinate(tapCoordinate);
+    CGPoint mapPointAsCGP = CGPointMake(mapPoint.x, mapPoint.y);
+
+    double maxMeters = [self metersFromPixel:MAX_DISTANCE_PX atPoint:tapPoint forMap:map];
+    float nearestDistance = MAXFLOAT;
+    RNMMapPolyline *nearestPolyline = nil;
+
+    for (id<MKOverlay> overlay in map.overlays) {
+        if([overlay isKindOfClass:[RNMMapPolygon class]]){
+            RNMMapPolygon *polygon = (RNMMapPolygon*) overlay;
+            if (polygon.onPress) {
+                CGMutablePathRef mpr = CGPathCreateMutable();
+
+                for(int i = 0; i < polygon.coordinates.count; i++) {
+                    RNMMapCoordinate *c = polygon.coordinates[i];
+                    MKMapPoint mp = MKMapPointForCoordinate(c.coordinate);
+                    if (i == 0) {
+                        CGPathMoveToPoint(mpr, NULL, mp.x, mp.y);
+                    } else {
+                        CGPathAddLineToPoint(mpr, NULL, mp.x, mp.y);
+                    }
+                }
+
+                if (CGPathContainsPoint(mpr, NULL, mapPointAsCGP, FALSE)) {
+                    id event = @{
+                                @"action": @"polygon-press",
+                                @"coordinate": @{
+                                    @"latitude": @(tapCoordinate.latitude),
+                                    @"longitude": @(tapCoordinate.longitude),
+                                },
+                            };
+                    polygon.onPress(event);
+                }
+
+                CGPathRelease(mpr);
+            }
+        }
+
+        if([overlay isKindOfClass:[RNMMapPolyline class]]){
+            RNMMapPolyline *polyline = (RNMMapPolyline*) overlay;
+            if (polyline.onPress) {
+                float distance = [self distanceOfPoint:MKMapPointForCoordinate(tapCoordinate)
+                                          toPoly:polyline];
+                if (distance < nearestDistance) {
+                    nearestDistance = distance;
+                    nearestPolyline = polyline;
+                }
+            }
+        }
+
+        if ([overlay isKindOfClass:[RNMMapOverlay class]]) {
+            RNMMapOverlay *imageOverlay = (RNMMapOverlay*) overlay;
+            if (MKMapRectContainsPoint(imageOverlay.boundingMapRect, mapPoint)) {
+                if (imageOverlay.onPress) {
+                    id event = @{
+                                 @"action": @"image-overlay-press",
+                                 @"name": imageOverlay.name ?: @"unknown",
+                                 @"coordinate": @{
+                                         @"latitude": @(imageOverlay.coordinate.latitude),
+                                         @"longitude": @(imageOverlay.coordinate.longitude)
+                                         }
+                                 };
+                    imageOverlay.onPress(event);
+                }
+            }
+        }
+
+    }
+
+    if (nearestDistance <= maxMeters) {
+        id event = @{
+                   @"action": @"polyline-press",
+                   @"coordinate": @{
+                       @"latitude": @(tapCoordinate.latitude),
+                       @"longitude": @(tapCoordinate.longitude)
+                   }
+                   };
+        nearestPolyline.onPress(event);
+    }
+
+    if (!map.onPress) return;
+    map.onPress(@{
+            @"coordinate": @{
+                    @"latitude": @(tapCoordinate.latitude),
+                    @"longitude": @(tapCoordinate.longitude),
+            },
+            @"position": @{
+                    @"x": @(tapPoint.x),
+                    @"y": @(tapPoint.y),
+            },
+    });
+
+}
+
+- (void)handleMapDrag:(UIPanGestureRecognizer*)recognizer {
+    RNMMap *map = (RNMMap *)recognizer.view;
+    if (!map.onPanDrag) return;
+
+    CGPoint touchPoint = [recognizer locationInView:map];
+    CLLocationCoordinate2D coord = [map convertPoint:touchPoint toCoordinateFromView:map];
+    map.onPanDrag(@{
+                  @"coordinate": @{
+                          @"latitude": @(coord.latitude),
+                          @"longitude": @(coord.longitude),
+                          },
+                  @"position": @{
+                          @"x": @(touchPoint.x),
+                          @"y": @(touchPoint.y),
+                          },
+                  });
+
+}
+
+- (void)handleMapDoubleTap:(UIPanGestureRecognizer*)recognizer {
+    RNMMap *map = (RNMMap *)recognizer.view;
+    if (!map.onDoublePress) return;
+    
+    CGPoint touchPoint = [recognizer locationInView:map];
+    CLLocationCoordinate2D coord = [map convertPoint:touchPoint toCoordinateFromView:map];
+    map.onDoublePress(@{
+                    @"coordinate": @{
+                            @"latitude": @(coord.latitude),
+                            @"longitude": @(coord.longitude),
+                            },
+                    @"position": @{
+                            @"x": @(touchPoint.x),
+                            @"y": @(touchPoint.y),
+                            },
+                    });
+    
+}
+
+
+- (void)handleMapLongPress:(UITapGestureRecognizer *)recognizer {
+
+    // NOTE: android only does the equivalent of "began", so we only send in this case
+    if (recognizer.state != UIGestureRecognizerStateBegan) return;
+
+    RNMMap *map = (RNMMap *)recognizer.view;
+    if (!map.onLongPress) return;
+
+    CGPoint touchPoint = [recognizer locationInView:map];
+    CLLocationCoordinate2D coord = [map convertPoint:touchPoint toCoordinateFromView:map];
+
+    map.onLongPress(@{
+            @"coordinate": @{
+                    @"latitude": @(coord.latitude),
+                    @"longitude": @(coord.longitude),
+            },
+            @"position": @{
+                    @"x": @(touchPoint.x),
+                    @"y": @(touchPoint.y),
+            },
+    });
+}
+
+#pragma mark MKMapViewDelegate
+
+#pragma mark Polyline stuff
+
+- (MKOverlayRenderer *)mapView:(MKMapView *)mapView rendererForOverlay:(id <MKOverlay>)overlay{
+    if ([overlay isKindOfClass:[RNMMapPolyline class]]) {
+        return ((RNMMapPolyline *)overlay).renderer;
+    } else if ([overlay isKindOfClass:[RNMMapPolygon class]]) {
+        return ((RNMMapPolygon *)overlay).renderer;
+    } else if ([overlay isKindOfClass:[RNMMapCircle class]]) {
+        return ((RNMMapCircle *)overlay).renderer;
+    } else if ([overlay isKindOfClass:[RNMMapUrlTile class]]) {
+        return ((RNMMapUrlTile *)overlay).renderer;
+    } else if ([overlay isKindOfClass:[RNMMapWMSTile class]]) {
+        return ((RNMMapWMSTile *)overlay).renderer;
+    } else if ([overlay isKindOfClass:[RNMMapLocalTile class]]) {
+        return ((RNMMapLocalTile *)overlay).renderer;
+    } else if ([overlay isKindOfClass:[RNMMapOverlay class]]) {
+        return ((RNMMapOverlay *)overlay).renderer;
+    } else if([overlay isKindOfClass:[MKTileOverlay class]]) {
+        return [[MKTileOverlayRenderer alloc] initWithTileOverlay:overlay];
+    } else {
+        return nil;
+    }
+}
+
+
+#pragma mark Annotation Stuff
+
+- (void)mapView:(RNMMap *)mapView didAddAnnotationViews:(NSArray<MKAnnotationView *> *)views
+{
+    if(!mapView.userLocationCalloutEnabled){
+        for(MKAnnotationView* view in views){
+            if ([view.annotation isKindOfClass:[MKUserLocation class]]){
+                [view setEnabled:NO];
+                [view setCanShowCallout:NO];
+                break;
+            }
+        }
+    }
+}
+
+
+- (void)mapView:(RNMMap *)mapView didSelectAnnotationView:(MKAnnotationView *)view
+{
+    if ([view.annotation isKindOfClass:[RNMMapMarker class]]) {
+        [(RNMMapMarker *)view.annotation showCalloutView];
+    } else if ([view.annotation isKindOfClass:[MKUserLocation class]] && mapView.userLocationAnnotationTitle != nil && view.annotation.title != mapView.userLocationAnnotationTitle) {
+        [(MKUserLocation*)view.annotation setTitle: mapView.userLocationAnnotationTitle];
+    }
+
+}
+
+- (void)mapView:(RNMMap *)mapView didDeselectAnnotationView:(MKAnnotationView *)view {
+    if ([view.annotation isKindOfClass:[RNMMapMarker class]]) {
+        [(RNMMapMarker *)view.annotation hideCalloutView];
+    }
+}
+
+- (MKAnnotationView *)mapView:(__unused RNMMap *)mapView viewForAnnotation:(RNMMapMarker *)marker
+{
+    if (![marker isKindOfClass:[RNMMapMarker class]]) {
+        if ([marker isKindOfClass:[MKUserLocation class]] && mapView.userLocationAnnotationTitle != nil) {
+            [(MKUserLocation*)marker setTitle: mapView.userLocationAnnotationTitle];
+            return nil;
+        }
+        return nil;
+    }
+
+    marker.map = mapView;
+    return [marker getAnnotationView];
+}
+
+static int kDragCenterContext;
+
+- (void)mapView:(RNMMap *)mapView
+    annotationView:(MKAnnotationView *)view
+    didChangeDragState:(MKAnnotationViewDragState)newState
+    fromOldState:(MKAnnotationViewDragState)oldState
+{
+    if (![view.annotation isKindOfClass:[RNMMapMarker class]]) return;
+    RNMMapMarker *marker = (RNMMapMarker *)view.annotation;
+
+    BOOL isPinView = [view isKindOfClass:[MKMarkerAnnotationView class]];
+
+    id event = @{
+                 @"id": marker.identifier ?: @"unknown",
+                 @"coordinate": @{
+                         @"latitude": @(marker.coordinate.latitude),
+                         @"longitude": @(marker.coordinate.longitude)
+                         }
+                 };
+
+    if (newState == MKAnnotationViewDragStateEnding || newState == MKAnnotationViewDragStateCanceling) {
+        if (!isPinView) {
+            [view setDragState:MKAnnotationViewDragStateNone animated:NO];
+        }
+        if (mapView.onMarkerDragEnd) mapView.onMarkerDragEnd(event);
+        if (marker.onDragEnd) marker.onDragEnd(event);
+
+       if(_hasObserver) [view removeObserver:self forKeyPath:@"center"];
+        _hasObserver = NO;
+    } else if (newState == MKAnnotationViewDragStateStarting) {
+        // MapKit doesn't emit continuous drag events. To get around this, we are going to use KVO.
+        [view addObserver:self forKeyPath:@"center" options:NSKeyValueObservingOptionNew context:&kDragCenterContext];
+        _hasObserver = YES;
+        if (mapView.onMarkerDragStart) mapView.onMarkerDragStart(event);
+        if (marker.onDragStart) marker.onDragStart(event);
+    }
+}
+
+- (void)observeValueForKeyPath:(NSString *)keyPath
+                      ofObject:(id)object
+                        change:(NSDictionary *)change
+                       context:(void *)context
+{
+    if ([keyPath isEqualToString:@"center"] && [object isKindOfClass:[MKAnnotationView class]]) {
+        MKAnnotationView *view = (MKAnnotationView *)object;
+        RNMMapMarker *marker = (RNMMapMarker *)view.annotation;
+
+        // a marker we don't control might be getting dragged. Check just in case.
+        if (!marker) return;
+
+        RNMMap *map = marker.map;
+
+        // don't waste time calculating if there are no events to listen to it
+        if (!map.onMarkerDrag && !marker.onDrag) return;
+
+        CGPoint position = CGPointMake(view.center.x - view.centerOffset.x, view.center.y - view.centerOffset.y);
+        CLLocationCoordinate2D coordinate = [map convertPoint:position toCoordinateFromView:map];
+
+        id event = @{
+                @"id": marker.identifier ?: @"unknown",
+                @"position": @{
+                        @"x": @(position.x),
+                        @"y": @(position.y),
+                },
+                @"coordinate": @{
+                        @"latitude": @(coordinate.latitude),
+                        @"longitude": @(coordinate.longitude),
+                }
+        };
+
+        if (map.onMarkerDrag) map.onMarkerDrag(event);
+        if (marker.onDrag) marker.onDrag(event);
+
+    } else {
+        // This message is not for me; pass it on to super.
+        [super observeValueForKeyPath:keyPath ofObject:object change:change context:context];
+    }
+}
+
+- (void)mapView:(RNMMap *)mapView didUpdateUserLocation:(MKUserLocation *)location
+{
+    id event = @{@"coordinate": @{
+                         @"latitude": @(location.coordinate.latitude),
+                         @"longitude": @(location.coordinate.longitude),
+                         @"altitude": @(location.location.altitude),
+                         @"timestamp": @(location.location.timestamp.timeIntervalSinceReferenceDate * 1000),
+                         @"accuracy": @(location.location.horizontalAccuracy),
+                         @"altitudeAccuracy": @(location.location.verticalAccuracy),
+                         @"speed": @(location.location.speed),
+                         @"heading": @(location.location.course),
+                         }
+                 };
+    
+    if (mapView.onUserLocationChange) {
+        mapView.onUserLocationChange(event);
+    }
+    
+    if (mapView.followUserLocation) {
+        [mapView setCenterCoordinate:location.coordinate animated:YES];
+    }
+    
+}
+
+- (void)mapViewDidChangeVisibleRegion:(RNMMap *)mapView
+{
+    [self _regionChanged:mapView];
+}
+
+- (void)mapView:(RNMMap *)mapView regionDidChangeAnimated:(__unused BOOL)animated
+{
+    CGFloat zoomLevel = [self zoomLevel:mapView];
+
+    // Don't send region did change events until map has
+    // started rendering, as these won't represent the final location
+    if(mapView.hasStartedRendering){
+        [self _regionChanged:mapView];
+    }
+
+    if (zoomLevel < mapView.minZoomLevel) {
+      [self setCenterCoordinate:[mapView centerCoordinate] zoomLevel:mapView.minZoomLevel animated:TRUE mapView:mapView];
+    }
+    else if (zoomLevel > mapView.maxZoomLevel) {
+      [self setCenterCoordinate:[mapView centerCoordinate] zoomLevel:mapView.maxZoomLevel animated:TRUE mapView:mapView];
+    }
+
+    // Don't send region did change events until map has
+    // started rendering, as these won't represent the final location
+    if (mapView.hasStartedRendering) {
+        [self _emitRegionChangeEvent:mapView continuous:NO];
+    };
+
+    mapView.pendingCenter = mapView.region.center;
+    mapView.pendingSpan = mapView.region.span;
+}
+
+- (void)mapViewWillStartRenderingMap:(RNMMap *)mapView
+{
+    if (!mapView.hasStartedRendering) {
+      mapView.onMapReady(@{});
+      mapView.hasStartedRendering = YES;
+    }
+    [mapView beginLoading];
+}
+
+- (void)mapViewDidFinishRenderingMap:(RNMMap *)mapView fullyRendered:(BOOL)fullyRendered
+{
+    [mapView finishLoading];
+}
+
+#pragma mark Private
+
+- (void)_regionChanged:(RNMMap *)mapView
+{
+    BOOL needZoom = NO;
+    CGFloat newLongitudeDelta = 0.0f;
+    MKCoordinateRegion region = mapView.region;
+    // On iOS 7, it's possible that we observe invalid locations during initialization of the map.
+    // Filter those out.
+    if (!CLLocationCoordinate2DIsValid(region.center)) {
+        return;
+    }
+    // Calculation on float is not 100% accurate. If user zoom to max/min and then move, it's likely the map will auto zoom to max/min from time to time.
+    // So let's try to make map zoom back to 99% max or 101% min so that there are some buffer that moving the map won't constantly hitting the max/min bound.
+    if (mapView.maxDelta > FLT_EPSILON && region.span.longitudeDelta > mapView.maxDelta) {
+        needZoom = YES;
+        newLongitudeDelta = mapView.maxDelta * (1 - RNMMapZoomBoundBuffer);
+    } else if (mapView.minDelta > FLT_EPSILON && region.span.longitudeDelta < mapView.minDelta) {
+        needZoom = YES;
+        newLongitudeDelta = mapView.minDelta * (1 + RNMMapZoomBoundBuffer);
+    }
+    if (needZoom) {
+        region.span.latitudeDelta = region.span.latitudeDelta / region.span.longitudeDelta * newLongitudeDelta;
+        region.span.longitudeDelta = newLongitudeDelta;
+        mapView.region = region;
+    }
+
+    // Continuously observe region changes
+    [self _emitRegionChangeEvent:mapView continuous:YES];
+}
+
+- (void)_emitRegionChangeEvent:(RNMMap *)mapView continuous:(BOOL)continuous
+{
+    if (!mapView.ignoreRegionChanges && mapView.onChange) {
+        MKCoordinateRegion region = mapView.region;
+        if (!CLLocationCoordinate2DIsValid(region.center)) {
+            return;
+        }
+
+#define FLUSH_NAN(value) (isnan(value) ? 0 : value)
+        mapView.onChange(@{
+                @"continuous": @(continuous),
+                @"region": @{
+                        @"latitude": @(FLUSH_NAN(region.center.latitude)),
+                        @"longitude": @(FLUSH_NAN(region.center.longitude)),
+                        @"latitudeDelta": @(FLUSH_NAN(region.span.latitudeDelta)),
+                        @"longitudeDelta": @(FLUSH_NAN(region.span.longitudeDelta)),
+                }
+        });
+    }
+}
+
+/** Returns the distance of |pt| to |poly| in meters
+ *
+ *
+ */
+- (double)distanceOfPoint:(MKMapPoint)pt toPoly:(RNMMapPolyline *)poly
+{
+    double distance = MAXFLOAT;
+    for (int n = 0; n < poly.coordinates.count - 1; n++) {
+
+        MKMapPoint ptA = MKMapPointForCoordinate(poly.coordinates[n].coordinate);
+        MKMapPoint ptB = MKMapPointForCoordinate(poly.coordinates[n + 1].coordinate);
+
+        double xDelta = ptB.x - ptA.x;
+        double yDelta = ptB.y - ptA.y;
+
+        if (xDelta == 0.0 && yDelta == 0.0) {
+            continue;
+        }
+
+        double u = ((pt.x - ptA.x) * xDelta + (pt.y - ptA.y) * yDelta) / (xDelta * xDelta + yDelta * yDelta);
+        MKMapPoint ptClosest;
+        if (u < 0.0) {
+            ptClosest = ptA;
+        }
+        else if (u > 1.0) {
+            ptClosest = ptB;
+        }
+        else {
+            ptClosest = MKMapPointMake(ptA.x + u * xDelta, ptA.y + u * yDelta);
+        }
+
+        distance = MIN(distance, MKMetersBetweenMapPoints(ptClosest, pt));
+    }
+
+    return distance;
+}
+
+
+/** Converts |px| to meters at location |pt| */
+- (double)metersFromPixel:(NSUInteger)px atPoint:(CGPoint)pt forMap:(RNMMap *)mapView
+{
+    CGPoint ptB = CGPointMake(pt.x + px, pt.y);
+
+    CLLocationCoordinate2D coordA = [mapView convertPoint:pt toCoordinateFromView:mapView];
+    CLLocationCoordinate2D coordB = [mapView convertPoint:ptB toCoordinateFromView:mapView];
+
+    return MKMetersBetweenMapPoints(MKMapPointForCoordinate(coordA), MKMapPointForCoordinate(coordB));
+}
+
++ (double)longitudeToPixelSpaceX:(double)longitude
+{
+    return round(MERCATOR_OFFSET + MERCATOR_RADIUS * longitude * M_PI / 180.0);
+}
+
++ (double)latitudeToPixelSpaceY:(double)latitude
+{
+    if (latitude == 90.0) {
+        return 0;
+    } else if (latitude == -90.0) {
+        return MERCATOR_OFFSET * 2;
+    } else {
+        return round(MERCATOR_OFFSET - MERCATOR_RADIUS * logf((1 + sinf(latitude * M_PI / 180.0)) / (1 - sinf(latitude * M_PI / 180.0))) / 2.0);
+    }
+}
+
++ (double)pixelSpaceXToLongitude:(double)pixelX
+{
+    return ((round(pixelX) - MERCATOR_OFFSET) / MERCATOR_RADIUS) * 180.0 / M_PI;
+}
+
++ (double)pixelSpaceYToLatitude:(double)pixelY
+{
+    return (M_PI / 2.0 - 2.0 * atan(exp((round(pixelY) - MERCATOR_OFFSET) / MERCATOR_RADIUS))) * 180.0 / M_PI;
+}
+
+#pragma mark -
+#pragma mark Helper methods
+
+- (MKCoordinateSpan)coordinateSpanWithMapView:(RNMMap *)mapView
+                             centerCoordinate:(CLLocationCoordinate2D)centerCoordinate
+                                 andZoomLevel:(double)zoomLevel
+{
+    // convert center coordiate to pixel space
+    double centerPixelX = [RNMMapManager longitudeToPixelSpaceX:centerCoordinate.longitude];
+    double centerPixelY = [RNMMapManager latitudeToPixelSpaceY:centerCoordinate.latitude];
+
+    // determine the scale value from the zoom level
+    double zoomExponent = RNMMapMaxZoomLevel - zoomLevel;
+    double zoomScale = pow(2, zoomExponent);
+
+    // scale the map’s size in pixel space
+    CGSize mapSizeInPixels = mapView.bounds.size;
+    double scaledMapWidth = mapSizeInPixels.width * zoomScale;
+    double scaledMapHeight = mapSizeInPixels.height * zoomScale;
+
+    // figure out the position of the top-left pixel
+    double topLeftPixelX = centerPixelX - (scaledMapWidth / 2);
+    double topLeftPixelY = centerPixelY - (scaledMapHeight / 2);
+
+    // find delta between left and right longitudes
+    CLLocationDegrees minLng = [RNMMapManager pixelSpaceXToLongitude:topLeftPixelX];
+    CLLocationDegrees maxLng = [RNMMapManager pixelSpaceXToLongitude:topLeftPixelX + scaledMapWidth];
+    CLLocationDegrees longitudeDelta = maxLng - minLng;
+
+    // find delta between top and bottom latitudes
+    CLLocationDegrees minLat = [RNMMapManager pixelSpaceYToLatitude:topLeftPixelY];
+    CLLocationDegrees maxLat = [RNMMapManager pixelSpaceYToLatitude:topLeftPixelY + scaledMapHeight];
+    CLLocationDegrees latitudeDelta = -1 * (maxLat - minLat);
+
+    // create and return the lat/lng span
+    MKCoordinateSpan span = MKCoordinateSpanMake(latitudeDelta, longitudeDelta);
+    return span;
+}
+
+#pragma mark -
+#pragma mark Public methods
+
+- (void)setCenterCoordinate:(CLLocationCoordinate2D)centerCoordinate
+                  zoomLevel:(double)zoomLevel
+                   animated:(BOOL)animated
+                    mapView:(RNMMap *)mapView
+{
+    // clamp large numbers to 28
+    zoomLevel = MIN(zoomLevel, RNMMapMaxZoomLevel);
+
+    // use the zoom level to compute the region
+    MKCoordinateSpan span = [self coordinateSpanWithMapView:mapView centerCoordinate:centerCoordinate andZoomLevel:zoomLevel];
+    MKCoordinateRegion region = MKCoordinateRegionMake(centerCoordinate, span);
+
+    // set the region like normal
+    [mapView setRegion:region animated:animated];
+}
+
+//KMapView cannot display tiles that cross the pole (as these would involve wrapping the map from top to bottom, something that a Mercator projection just cannot do).
+-(MKCoordinateRegion)coordinateRegionWithMapView:(RNMMap *)mapView
+                                centerCoordinate:(CLLocationCoordinate2D)centerCoordinate
+                                    andZoomLevel:(double)zoomLevel
+{
+    // clamp lat/long values to appropriate ranges
+    centerCoordinate.latitude = MIN(MAX(-90.0, centerCoordinate.latitude), 90.0);
+    centerCoordinate.longitude = fmod(centerCoordinate.longitude, 180.0);
+
+    // convert center coordiate to pixel space
+    double centerPixelX = [RNMMapManager longitudeToPixelSpaceX:centerCoordinate.longitude];
+    double centerPixelY = [RNMMapManager latitudeToPixelSpaceY:centerCoordinate.latitude];
+
+    // determine the scale value from the zoom level
+    double zoomExponent = RNMMapMaxZoomLevel - zoomLevel;
+    double zoomScale = pow(2, zoomExponent);
+
+    // scale the map’s size in pixel space
+    CGSize mapSizeInPixels = mapView.bounds.size;
+    double scaledMapWidth = mapSizeInPixels.width * zoomScale;
+    double scaledMapHeight = mapSizeInPixels.height * zoomScale;
+
+    // figure out the position of the left pixel
+    double topLeftPixelX = centerPixelX - (scaledMapWidth / 2);
+
+    // find delta between left and right longitudes
+    CLLocationDegrees minLng = [RNMMapManager pixelSpaceXToLongitude:topLeftPixelX];
+    CLLocationDegrees maxLng = [RNMMapManager pixelSpaceXToLongitude:topLeftPixelX + scaledMapWidth];
+    CLLocationDegrees longitudeDelta = maxLng - minLng;
+
+    // if we’re at a pole then calculate the distance from the pole towards the equator
+    // as MKMapView doesn’t like drawing boxes over the poles
+    double topPixelY = centerPixelY - (scaledMapHeight / 2);
+    double bottomPixelY = centerPixelY + (scaledMapHeight / 2);
+    BOOL adjustedCenterPoint = NO;
+    if (topPixelY > MERCATOR_OFFSET * 2) {
+        topPixelY = centerPixelY - scaledMapHeight;
+        bottomPixelY = MERCATOR_OFFSET * 2;
+        adjustedCenterPoint = YES;
+    }
+
+    // find delta between top and bottom latitudes
+    CLLocationDegrees minLat = [RNMMapManager pixelSpaceYToLatitude:topPixelY];
+    CLLocationDegrees maxLat = [RNMMapManager pixelSpaceYToLatitude:bottomPixelY];
+    CLLocationDegrees latitudeDelta = -1 * (maxLat - minLat);
+
+    // create and return the lat/lng span
+    MKCoordinateSpan span = MKCoordinateSpanMake(latitudeDelta, longitudeDelta);
+    MKCoordinateRegion region = MKCoordinateRegionMake(centerCoordinate, span);
+    // once again, MKMapView doesn’t like drawing boxes over the poles
+    // so adjust the center coordinate to the center of the resulting region
+    if (adjustedCenterPoint) {
+        region.center.latitude = [RNMMapManager pixelSpaceYToLatitude:((bottomPixelY + topPixelY) / 2.0)];
+    }
+
+    return region;
+}
+
+- (double) zoomLevel:(RNMMap *)mapView {
+    MKCoordinateRegion region = mapView.region;
+
+    double centerPixelX = [RNMMapManager longitudeToPixelSpaceX: region.center.longitude];
+    double topLeftPixelX = [RNMMapManager longitudeToPixelSpaceX: region.center.longitude - region.span.longitudeDelta / 2];
+
+    double scaledMapWidth = (centerPixelX - topLeftPixelX) * 2;
+    CGSize mapSizeInPixels = mapView.bounds.size;
+    double zoomScale = scaledMapWidth / mapSizeInPixels.width;
+    double zoomExponent = log(zoomScale) / log(2);
+    double zoomLevel = RNMMapMaxZoomLevel - zoomExponent;
+
+    return zoomLevel;
+}
+
+#pragma mark MKMapViewDelegate - Tracking the User Location
+
+- (void)mapView:(RNMMap *)mapView didFailToLocateUserWithError:(NSError *)error {
+    id event = @{@"error": @{ @"message": error.localizedDescription }};
+    if (mapView.onUserLocationChange) {
+        mapView.onUserLocationChange(event);
+    }
+}
+
+- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer {
+    return YES;
+}
+
+@end