@lugg/maps 0.2.0-alpha.8 → 1.0.0-beta.0

package/ios/core/AppleMapProvider.mm

@@ -0,0 +1,1029 @@
+#import "AppleMapProvider.h"
+#import "../LuggMarkerView.h"
+#import "../LuggPolygonView.h"
+#import "../LuggPolylineView.h"
+#import "../extensions/MKMapView+Zoom.h"
+#import "MKPolylineAnimator.h"
+
+@interface AppleMarkerAnnotation : NSObject <MKAnnotation>
+@property(nonatomic, assign) CLLocationCoordinate2D coordinate;
+@property(nonatomic, copy, nullable) NSString *title;
+@property(nonatomic, copy, nullable) NSString *subtitle;
+@property(nonatomic, strong) LuggMarkerView *markerView;
+@property(nonatomic, weak) MKAnnotationView *annotationView;
+@end
+
+@implementation AppleMarkerAnnotation
+@end
+
+@implementation LuggAppleMapViewContent
+@end
+
+@interface AppleMapProvider () <
+    LuggMarkerViewDelegate, LuggPolylineViewDelegate, LuggPolygonViewDelegate,
+    UIGestureRecognizerDelegate>
+@end
+
+@implementation AppleMapProvider {
+  LuggAppleMapViewContent *_mapView;
+  BOOL _isMapReady;
+  BOOL _isDragging;
+  double _minZoom;
+  double _maxZoom;
+  NSMapTable<id<MKOverlay>, LuggPolylineView *> *_overlayToPolylineMap;
+  NSMapTable<id<MKOverlay>, LuggPolygonView *> *_overlayToPolygonMap;
+  UITapGestureRecognizer *_tapGesture;
+  UILongPressGestureRecognizer *_longPressGesture;
+  // Edge insets animation
+  CADisplayLink *_edgeInsetsDisplayLink;
+  UIEdgeInsets _edgeInsetsFrom;
+  UIEdgeInsets _edgeInsetsTo;
+  CFTimeInterval _edgeInsetsAnimationStart;
+  CFTimeInterval _edgeInsetsAnimationDuration;
+}
+
+@synthesize delegate = _delegate;
+
+- (instancetype)init {
+  if (self = [super init]) {
+    _overlayToPolylineMap = [NSMapTable strongToWeakObjectsMapTable];
+    _overlayToPolygonMap = [NSMapTable strongToWeakObjectsMapTable];
+  }
+  return self;
+}
+
+- (BOOL)isMapReady {
+  return _isMapReady;
+}
+
+- (MKMapView *)mapView {
+  return _mapView;
+}
+
+#pragma mark - MapProvider
+
+- (void)initializeMapInView:(UIView *)wrapperView
+          initialCoordinate:(CLLocationCoordinate2D)coordinate
+                initialZoom:(double)zoom {
+  if (_mapView)
+    return;
+
+  _mapView = [[LuggAppleMapViewContent alloc] initWithFrame:wrapperView.bounds];
+  _mapView.autoresizingMask =
+      UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+  _mapView.delegate = self;
+  _mapView.insetsLayoutMarginsFromSafeArea = NO;
+
+  [self applyZoomRange];
+
+  _tapGesture =
+      [[UITapGestureRecognizer alloc] initWithTarget:self
+                                              action:@selector(handleTap:)];
+  _tapGesture.cancelsTouchesInView = NO;
+  _tapGesture.delegate = self;
+  [_mapView addGestureRecognizer:_tapGesture];
+
+  _longPressGesture = [[UILongPressGestureRecognizer alloc]
+      initWithTarget:self
+              action:@selector(handleLongPress:)];
+  _longPressGesture.delegate = self;
+  [_mapView addGestureRecognizer:_longPressGesture];
+
+  [_tapGesture requireGestureRecognizerToFail:_longPressGesture];
+
+  [wrapperView addSubview:_mapView];
+
+  MKCoordinateRegion region = [_mapView regionForCenterCoordinate:coordinate
+                                                        zoomLevel:zoom];
+  [_mapView setRegion:region animated:NO];
+
+  _isMapReady = YES;
+
+  [_delegate mapProviderDidReady];
+}
+
+- (void)destroy {
+  [self stopEdgeInsetsAnimation];
+  if (_tapGesture) {
+    [_mapView removeGestureRecognizer:_tapGesture];
+    _tapGesture = nil;
+  }
+  if (_longPressGesture) {
+    [_mapView removeGestureRecognizer:_longPressGesture];
+    _longPressGesture = nil;
+  }
+  [_mapView removeFromSuperview];
+  _mapView = nil;
+  _isMapReady = NO;
+}
+
+#pragma mark - Props
+
+- (void)setZoomEnabled:(BOOL)enabled {
+  _mapView.zoomEnabled = enabled;
+}
+
+- (void)setScrollEnabled:(BOOL)enabled {
+  _mapView.scrollEnabled = enabled;
+}
+
+- (void)setRotateEnabled:(BOOL)enabled {
+  _mapView.rotateEnabled = enabled;
+}
+
+- (void)setPitchEnabled:(BOOL)enabled {
+  _mapView.pitchEnabled = enabled;
+}
+
+- (void)setUserLocationEnabled:(BOOL)enabled {
+  _mapView.showsUserLocation = enabled;
+}
+
+- (void)setTheme:(NSInteger)theme {
+  switch (theme) {
+  case 1: // Dark
+    _mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleDark;
+    break;
+  case 0: // Light
+    _mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;
+    break;
+  default: // System
+    _mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleUnspecified;
+    break;
+  }
+}
+
+- (void)setMinZoom:(double)minZoom {
+  _minZoom = minZoom;
+  [self applyZoomRange];
+}
+
+- (void)setMaxZoom:(double)maxZoom {
+  _maxZoom = maxZoom;
+  [self applyZoomRange];
+}
+
+- (void)setEdgeInsets:(UIEdgeInsets)edgeInsets
+        oldEdgeInsets:(UIEdgeInsets)oldEdgeInsets {
+  CGFloat oldOffsetX = (oldEdgeInsets.left - oldEdgeInsets.right) / 2.0;
+  CGFloat oldOffsetY = (oldEdgeInsets.top - oldEdgeInsets.bottom) / 2.0;
+  CGFloat newOffsetX = (edgeInsets.left - edgeInsets.right) / 2.0;
+  CGFloat newOffsetY = (edgeInsets.top - edgeInsets.bottom) / 2.0;
+
+  CGFloat deltaX = newOffsetX - oldOffsetX;
+  CGFloat deltaY = newOffsetY - oldOffsetY;
+
+  _mapView.layoutMargins = edgeInsets;
+
+  if (deltaX != 0 || deltaY != 0) {
+    CLLocationCoordinate2D currentCenter = _mapView.centerCoordinate;
+    CGPoint centerPoint = [_mapView convertCoordinate:currentCenter
+                                        toPointToView:_mapView];
+    CGPoint newPoint =
+        CGPointMake(centerPoint.x - deltaX, centerPoint.y - deltaY);
+    CLLocationCoordinate2D newCenter = [_mapView convertPoint:newPoint
+                                         toCoordinateFromView:_mapView];
+    [_mapView setCenterCoordinate:newCenter animated:NO];
+  }
+}
+
+- (void)setEdgeInsets:(UIEdgeInsets)edgeInsets
+        oldEdgeInsets:(UIEdgeInsets)oldEdgeInsets
+             duration:(double)duration {
+  [self stopEdgeInsetsAnimation];
+
+  if (duration != 0 && _mapView) {
+    double actualDuration = duration < 0 ? 0.3 : duration / 1000.0;
+    _edgeInsetsFrom = oldEdgeInsets;
+    _edgeInsetsTo = edgeInsets;
+    _edgeInsetsAnimationDuration = actualDuration;
+    _edgeInsetsAnimationStart = CACurrentMediaTime();
+
+    _edgeInsetsDisplayLink = [CADisplayLink
+        displayLinkWithTarget:self
+                     selector:@selector(edgeInsetsAnimationTick:)];
+    [_edgeInsetsDisplayLink addToRunLoop:[NSRunLoop mainRunLoop]
+                                 forMode:NSRunLoopCommonModes];
+  } else {
+    [self setEdgeInsets:edgeInsets oldEdgeInsets:oldEdgeInsets];
+  }
+}
+
+- (void)edgeInsetsAnimationTick:(CADisplayLink *)displayLink {
+  CFTimeInterval elapsed = CACurrentMediaTime() - _edgeInsetsAnimationStart;
+  CGFloat progress = MIN(elapsed / _edgeInsetsAnimationDuration, 1.0);
+
+  // Ease out cubic
+  CGFloat t = 1.0 - (1.0 - progress) * (1.0 - progress) * (1.0 - progress);
+
+  UIEdgeInsets current = UIEdgeInsetsMake(
+      _edgeInsetsFrom.top + (_edgeInsetsTo.top - _edgeInsetsFrom.top) * t,
+      _edgeInsetsFrom.left + (_edgeInsetsTo.left - _edgeInsetsFrom.left) * t,
+      _edgeInsetsFrom.bottom +
+          (_edgeInsetsTo.bottom - _edgeInsetsFrom.bottom) * t,
+      _edgeInsetsFrom.right +
+          (_edgeInsetsTo.right - _edgeInsetsFrom.right) * t);
+
+  [self setEdgeInsets:current oldEdgeInsets:_mapView.layoutMargins];
+
+  if (progress >= 1.0) {
+    [self stopEdgeInsetsAnimation];
+  }
+}
+
+- (void)stopEdgeInsetsAnimation {
+  [_edgeInsetsDisplayLink invalidate];
+  _edgeInsetsDisplayLink = nil;
+}
+
+- (CLLocationDistance)cameraDistanceForZoomLevel:(double)zoomLevel {
+  return 128000000.0 / pow(2, zoomLevel);
+}
+
+- (void)applyZoomRange {
+  if (!_mapView)
+    return;
+
+  CLLocationDistance minDistance =
+      _maxZoom > 0 ? [self cameraDistanceForZoomLevel:_maxZoom] : 0;
+  CLLocationDistance maxDistance =
+      _minZoom > 0 ? [self cameraDistanceForZoomLevel:_minZoom] : -1;
+
+  MKMapCameraZoomRange *zoomRange = [[MKMapCameraZoomRange alloc]
+      initWithMinCenterCoordinateDistance:minDistance
+              maxCenterCoordinateDistance:maxDistance];
+  _mapView.cameraZoomRange = zoomRange;
+}
+
+- (LuggPolygonView *)hitTestPolygonAtPoint:(CGPoint)point {
+  CLLocationCoordinate2D tapCoordinate = [_mapView convertPoint:point
+                                           toCoordinateFromView:_mapView];
+  MKMapPoint mapPoint = MKMapPointForCoordinate(tapCoordinate);
+  CGPoint mapPointAsCGP = CGPointMake(mapPoint.x, mapPoint.y);
+
+  NSArray<id<MKOverlay>> *overlays = _mapView.overlays;
+  for (NSInteger i = overlays.count - 1; i >= 0; i--) {
+    id<MKOverlay> overlay = overlays[i];
+    if (![overlay isKindOfClass:[MKPolygon class]])
+      continue;
+
+    LuggPolygonView *polygonView = [_overlayToPolygonMap objectForKey:overlay];
+    if (!polygonView || !polygonView.tappable)
+      continue;
+
+    NSArray<CLLocation *> *coordinates = polygonView.coordinates;
+    if (coordinates.count == 0)
+      continue;
+
+    CGMutablePathRef path = CGPathCreateMutable();
+    for (NSUInteger j = 0; j < coordinates.count; j++) {
+      MKMapPoint mp = MKMapPointForCoordinate(coordinates[j].coordinate);
+      if (j == 0) {
+        CGPathMoveToPoint(path, NULL, mp.x, mp.y);
+      } else {
+        CGPathAddLineToPoint(path, NULL, mp.x, mp.y);
+      }
+    }
+    CGPathCloseSubpath(path);
+
+    for (NSArray<CLLocation *> *hole in polygonView.holes) {
+      for (NSUInteger j = 0; j < hole.count; j++) {
+        MKMapPoint mp = MKMapPointForCoordinate(hole[j].coordinate);
+        if (j == 0) {
+          CGPathMoveToPoint(path, NULL, mp.x, mp.y);
+        } else {
+          CGPathAddLineToPoint(path, NULL, mp.x, mp.y);
+        }
+      }
+      CGPathCloseSubpath(path);
+    }
+
+    BOOL contains = CGPathContainsPoint(path, NULL, mapPointAsCGP, YES);
+    CGPathRelease(path);
+
+    if (contains)
+      return polygonView;
+  }
+  return nil;
+}
+
+- (BOOL)hitTestAnnotationAtPoint:(CGPoint)point {
+  for (id<MKAnnotation> annotation in _mapView.annotations) {
+    MKAnnotationView *view = [_mapView viewForAnnotation:annotation];
+    if (!view)
+      continue;
+    CGPoint local = [view convertPoint:point fromView:_mapView];
+    if ([view pointInside:local withEvent:nil])
+      return YES;
+  }
+  return NO;
+}
+
+- (void)handleTap:(UITapGestureRecognizer *)gesture {
+  if (gesture.state != UIGestureRecognizerStateEnded)
+    return;
+
+  CGPoint point = [gesture locationInView:_mapView];
+
+  if ([self hitTestAnnotationAtPoint:point])
+    return;
+
+  LuggPolygonView *polygonView = [self hitTestPolygonAtPoint:point];
+  if (polygonView) {
+    [polygonView emitPressEvent];
+  } else {
+    CLLocationCoordinate2D coordinate = [_mapView convertPoint:point
+                                          toCoordinateFromView:_mapView];
+    [_delegate mapProviderDidPress:coordinate.latitude
+                         longitude:coordinate.longitude
+                                 x:point.x
+                                 y:point.y];
+  }
+}
+
+- (void)handleLongPress:(UILongPressGestureRecognizer *)gesture {
+  if (gesture.state != UIGestureRecognizerStateBegan)
+    return;
+
+  CGPoint point = [gesture locationInView:_mapView];
+  CLLocationCoordinate2D coordinate = [_mapView convertPoint:point
+                                        toCoordinateFromView:_mapView];
+  [_delegate mapProviderDidLongPress:coordinate.latitude
+                           longitude:coordinate.longitude
+                                   x:point.x
+                                   y:point.y];
+}
+
+- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
+    shouldRecognizeSimultaneouslyWithGestureRecognizer:
+        (UIGestureRecognizer *)otherGestureRecognizer {
+  return YES;
+}
+
+#pragma mark - MKMapViewDelegate
+
+- (BOOL)isUserInteracting {
+  UIView *mapContainerView = _mapView.subviews.firstObject;
+  for (UIGestureRecognizer *gesture in mapContainerView.gestureRecognizers) {
+    if (gesture.state == UIGestureRecognizerStateBegan ||
+        gesture.state == UIGestureRecognizerStateChanged) {
+      return YES;
+    }
+  }
+  return NO;
+}
+
+- (void)mapView:(MKMapView *)mapView regionWillChangeAnimated:(BOOL)animated {
+  _isDragging = [self isUserInteracting];
+  if (_isDragging) {
+    for (LuggPolylineView *polylineView in _overlayToPolylineMap
+             .objectEnumerator) {
+      MKPolylineAnimator *renderer =
+          (MKPolylineAnimator *)polylineView.renderer;
+      [renderer pause];
+    }
+  }
+}
+
+- (void)mapViewDidChangeVisibleRegion:(MKMapView *)mapView {
+  [_delegate mapProviderDidMoveCamera:mapView.centerCoordinate.latitude
+                            longitude:mapView.centerCoordinate.longitude
+                                 zoom:mapView.zoomLevel
+                              gesture:_isDragging];
+}
+
+- (void)mapView:(MKMapView *)mapView regionDidChangeAnimated:(BOOL)animated {
+  BOOL wasDragging = _isDragging;
+  _isDragging = NO;
+  if (wasDragging) {
+    for (LuggPolylineView *polylineView in _overlayToPolylineMap
+             .objectEnumerator) {
+      MKPolylineAnimator *renderer =
+          (MKPolylineAnimator *)polylineView.renderer;
+      [renderer resume];
+    }
+  }
+  [_delegate mapProviderDidIdleCamera:mapView.centerCoordinate.latitude
+                            longitude:mapView.centerCoordinate.longitude
+                                 zoom:mapView.zoomLevel
+                              gesture:wasDragging];
+}
+
+- (MKAnnotationView *)mapView:(MKMapView *)mapView
+            viewForAnnotation:(id<MKAnnotation>)annotation {
+  if (![annotation isKindOfClass:[AppleMarkerAnnotation class]]) {
+    return nil;
+  }
+
+  AppleMarkerAnnotation *markerAnnotation = (AppleMarkerAnnotation *)annotation;
+  LuggMarkerView *markerView = markerAnnotation.markerView;
+
+  if (!markerView) {
+    return nil;
+  }
+
+  if (!markerView.hasCustomView) {
+    MKMarkerAnnotationView *markerAnnotationView =
+        [[MKMarkerAnnotationView alloc] initWithAnnotation:annotation
+                                           reuseIdentifier:nil];
+    markerAnnotationView.canShowCallout = YES;
+    markerAnnotationView.displayPriority = MKFeatureDisplayPriorityRequired;
+    markerAnnotationView.layer.zPosition = markerView.zIndex;
+    markerAnnotationView.zPriority = markerView.zIndex;
+    markerAnnotationView.draggable = markerView.draggable;
+    [self addCenterTapGesture:markerAnnotationView];
+    markerAnnotation.annotationView = markerAnnotationView;
+    return markerAnnotationView;
+  }
+
+  MKAnnotationView *annotationView =
+      [[MKAnnotationView alloc] initWithAnnotation:annotation
+                                   reuseIdentifier:nil];
+  annotationView.canShowCallout = YES;
+  annotationView.displayPriority = MKFeatureDisplayPriorityRequired;
+  annotationView.layer.zPosition = markerView.zIndex;
+  annotationView.zPriority = markerView.zIndex;
+  annotationView.draggable = markerView.draggable;
+  [self addCenterTapGesture:annotationView];
+
+  if (!markerView.rasterize) {
+    UIView *iconView = markerView.iconView;
+    [iconView removeFromSuperview];
+    [annotationView addSubview:iconView];
+  }
+
+  [self applyMarkerStyle:markerView annotationView:annotationView];
+  markerAnnotation.annotationView = annotationView;
+
+  return annotationView;
+}
+
+- (MKOverlayRenderer *)mapView:(MKMapView *)mapView
+            rendererForOverlay:(id<MKOverlay>)overlay {
+  if ([overlay isKindOfClass:[MKPolyline class]]) {
+    LuggPolylineView *polylineView =
+        [_overlayToPolylineMap objectForKey:overlay];
+    MKPolyline *polyline = (MKPolyline *)overlay;
+
+    if (polylineView) {
+      NSArray<UIColor *> *colors = polylineView.strokeColors;
+
+      MKPolylineAnimator *renderer =
+          [[MKPolylineAnimator alloc] initWithPolyline:polyline];
+      renderer.lineWidth = polylineView.strokeWidth;
+      renderer.strokeColor = colors.firstObject;
+      if (colors.count > 1) {
+        renderer.strokeColors = colors;
+      }
+      renderer.animatedOptions = polylineView.animatedOptions;
+      renderer.animated = polylineView.animated;
+      polylineView.renderer = renderer;
+      return renderer;
+    }
+
+    MKPolylineRenderer *renderer =
+        [[MKPolylineRenderer alloc] initWithPolyline:polyline];
+    return renderer;
+  }
+
+  if ([overlay isKindOfClass:[MKPolygon class]]) {
+    LuggPolygonView *polygonView = [_overlayToPolygonMap objectForKey:overlay];
+    MKPolygon *polygon = (MKPolygon *)overlay;
+
+    MKPolygonRenderer *renderer =
+        [[MKPolygonRenderer alloc] initWithPolygon:polygon];
+    if (polygonView) {
+      renderer.fillColor = polygonView.fillColor;
+      renderer.strokeColor = polygonView.strokeColor;
+      renderer.lineWidth = polygonView.strokeWidth;
+      polygonView.renderer = renderer;
+    }
+    return renderer;
+  }
+
+  return nil;
+}
+
+- (void)mapView:(MKMapView *)mapView
+    didSelectAnnotationView:(MKAnnotationView *)view {
+  if (![view.annotation isKindOfClass:[AppleMarkerAnnotation class]])
+    return;
+
+  AppleMarkerAnnotation *annotation = (AppleMarkerAnnotation *)view.annotation;
+  LuggMarkerView *markerView = annotation.markerView;
+
+  if (markerView) {
+    CGPoint point = [_mapView convertCoordinate:markerView.coordinate
+                                  toPointToView:_mapView];
+    [markerView emitPressEventWithPoint:point];
+  }
+}
+
+- (void)mapView:(MKMapView *)mapView
+        annotationView:(MKAnnotationView *)view
+    didChangeDragState:(MKAnnotationViewDragState)newState
+          fromOldState:(MKAnnotationViewDragState)oldState {
+  if (![view.annotation isKindOfClass:[AppleMarkerAnnotation class]])
+    return;
+
+  AppleMarkerAnnotation *annotation = (AppleMarkerAnnotation *)view.annotation;
+  LuggMarkerView *markerView = annotation.markerView;
+  if (!markerView)
+    return;
+
+  CLLocationCoordinate2D coord = annotation.coordinate;
+  CGPoint point = [_mapView convertCoordinate:coord toPointToView:_mapView];
+
+  switch (newState) {
+  case MKAnnotationViewDragStateStarting:
+    [markerView updateCoordinate:coord];
+    [markerView emitDragStartEventWithPoint:point];
+    [view setDragState:MKAnnotationViewDragStateDragging animated:YES];
+    break;
+  case MKAnnotationViewDragStateDragging:
+    [markerView updateCoordinate:coord];
+    [markerView emitDragChangeEventWithPoint:point];
+    break;
+  case MKAnnotationViewDragStateEnding:
+    [markerView updateCoordinate:coord];
+    [markerView emitDragEndEventWithPoint:point];
+    [view setDragState:MKAnnotationViewDragStateNone animated:YES];
+    break;
+  case MKAnnotationViewDragStateCanceling:
+    [view setDragState:MKAnnotationViewDragStateNone animated:YES];
+    break;
+  default:
+    break;
+  }
+}
+
+- (void)addCenterTapGesture:(MKAnnotationView *)view {
+  UITapGestureRecognizer *tap = [[UITapGestureRecognizer alloc]
+      initWithTarget:self
+              action:@selector(handleAnnotationTap:)];
+  tap.cancelsTouchesInView = NO;
+  [view addGestureRecognizer:tap];
+}
+
+- (void)handleAnnotationTap:(UITapGestureRecognizer *)gesture {
+  MKAnnotationView *view = (MKAnnotationView *)gesture.view;
+  if ([view.annotation isKindOfClass:[AppleMarkerAnnotation class]]) {
+    AppleMarkerAnnotation *annotation =
+        (AppleMarkerAnnotation *)view.annotation;
+    [_mapView setCenterCoordinate:annotation.coordinate animated:YES];
+  }
+}
+
+#pragma mark - MarkerViewDelegate
+
+- (void)markerViewDidLayout:(LuggMarkerView *)markerView {
+  AppleMarkerAnnotation *annotation =
+      (AppleMarkerAnnotation *)markerView.marker;
+  if (annotation) {
+    [self updateAnnotationViewFrame:annotation];
+  }
+}
+
+- (void)markerViewDidUpdate:(LuggMarkerView *)markerView {
+  AppleMarkerAnnotation *annotation =
+      (AppleMarkerAnnotation *)markerView.marker;
+
+  if (!annotation)
+    return;
+
+  annotation.coordinate = markerView.coordinate;
+  annotation.title = markerView.title;
+  annotation.subtitle = markerView.markerDescription;
+
+  MKAnnotationView *annotationView = annotation.annotationView;
+  if (annotationView) {
+    annotationView.draggable = markerView.draggable;
+    annotationView.layer.zPosition = markerView.zIndex;
+    annotationView.zPriority = markerView.zIndex;
+  }
+
+  [self updateAnnotationViewFrame:annotation];
+}
+
+#pragma mark - PolylineViewDelegate
+
+- (void)polylineViewDidUpdate:(LuggPolylineView *)polylineView {
+  [self syncPolylineView:polylineView];
+}
+
+#pragma mark - PolygonViewDelegate
+
+- (void)polygonViewDidUpdate:(LuggPolygonView *)polygonView {
+  [self syncPolygonView:polygonView];
+}
+
+#pragma mark - Marker Management
+
+- (void)addMarkerView:(LuggMarkerView *)markerView {
+  markerView.delegate = self;
+
+  AppleMarkerAnnotation *annotation = [[AppleMarkerAnnotation alloc] init];
+  annotation.markerView = markerView;
+  markerView.marker = annotation;
+
+  if (_mapView) {
+    [_mapView addAnnotation:annotation];
+  }
+
+  [self markerViewDidUpdate:markerView];
+}
+
+- (void)removeMarkerView:(LuggMarkerView *)markerView {
+  markerView.delegate = nil;
+
+  AppleMarkerAnnotation *annotation =
+      (AppleMarkerAnnotation *)markerView.marker;
+
+  if (annotation) {
+    annotation.annotationView.transform = CGAffineTransformIdentity;
+    annotation.markerView = nil;
+    annotation.annotationView = nil;
+    [_mapView removeAnnotation:annotation];
+    markerView.marker = nil;
+  }
+  [markerView resetIconViewTransform];
+}
+
+- (void)syncMarkerView:(LuggMarkerView *)markerView {
+  [self markerViewDidUpdate:markerView];
+}
+
+- (void)applyMarkerStyle:(LuggMarkerView *)markerView
+          annotationView:(MKAnnotationView *)annotationView {
+  annotationView.transform = CGAffineTransformIdentity;
+
+  UIView *iconView = markerView.iconView;
+  CGRect frame = iconView.frame;
+  if (frame.size.width <= 0 || frame.size.height <= 0)
+    return;
+
+  CGFloat scale = markerView.scale;
+  CGPoint anchor = markerView.anchor;
+
+  if (markerView.rasterize) {
+    annotationView.image = [markerView createScaledIconImage];
+  } else {
+    iconView.layer.anchorPoint = anchor;
+    iconView.transform = CGAffineTransformMakeScale(scale, scale);
+    iconView.frame =
+        CGRectMake(frame.size.width * (0.5 - anchor.x) * (scale - 1),
+                   frame.size.height * (0.5 - anchor.y) * (scale - 1),
+                   frame.size.width, frame.size.height);
+  }
+
+  annotationView.bounds =
+      CGRectMake(0, 0, frame.size.width * scale, frame.size.height * scale);
+  annotationView.centerOffset =
+      CGPointMake(frame.size.width * scale * (anchor.x - 0.5),
+                  -frame.size.height * scale * (anchor.y - 0.5));
+  annotationView.transform =
+      CGAffineTransformMakeRotation(markerView.rotate * M_PI / 180.0);
+}
+
+- (void)updateAnnotationViewFrame:(AppleMarkerAnnotation *)annotation {
+  MKAnnotationView *annotationView = annotation.annotationView;
+  LuggMarkerView *markerView = annotation.markerView;
+
+  if (!annotationView || !markerView)
+    return;
+
+  [self applyMarkerStyle:markerView annotationView:annotationView];
+}
+
+#pragma mark - Polyline Management
+
+- (void)addPolylineView:(LuggPolylineView *)polylineView {
+  polylineView.delegate = self;
+  [self addPolylineOverlayToMap:polylineView];
+}
+
+- (void)removePolylineView:(LuggPolylineView *)polylineView {
+  polylineView.delegate = nil;
+  MKPolyline *polyline = (MKPolyline *)polylineView.polyline;
+  if (polyline) {
+    [_overlayToPolylineMap removeObjectForKey:polyline];
+    [_mapView removeOverlay:polyline];
+    polylineView.polyline = nil;
+  }
+}
+
+- (void)syncPolylineView:(LuggPolylineView *)polylineView {
+  if (!_mapView)
+    return;
+
+  MKPolylineAnimator *renderer = (MKPolylineAnimator *)polylineView.renderer;
+  MKPolyline *oldPolyline = (MKPolyline *)polylineView.polyline;
+
+  NSArray<CLLocation *> *coordinates = polylineView.coordinates;
+  if (coordinates.count == 0) {
+    if (renderer) {
+      renderer.animated = NO;
+    }
+    if (oldPolyline) {
+      [_overlayToPolylineMap removeObjectForKey:oldPolyline];
+      [_mapView removeOverlay:oldPolyline];
+      polylineView.polyline = nil;
+      polylineView.renderer = nil;
+    }
+    return;
+  }
+
+  CLLocationCoordinate2D *coords = (CLLocationCoordinate2D *)malloc(
+      sizeof(CLLocationCoordinate2D) * coordinates.count);
+  for (NSUInteger i = 0; i < coordinates.count; i++) {
+    coords[i] = coordinates[i].coordinate;
+  }
+  MKPolyline *newPolyline =
+      [MKPolyline polylineWithCoordinates:coords count:coordinates.count];
+  free(coords);
+
+  polylineView.polyline = newPolyline;
+  [_overlayToPolylineMap setObject:polylineView forKey:newPolyline];
+
+  if (renderer && oldPolyline) {
+    [_overlayToPolylineMap removeObjectForKey:oldPolyline];
+    [_mapView removeOverlay:oldPolyline];
+    [self insertOverlay:newPolyline withZIndex:polylineView.zIndex];
+    [renderer updatePolyline:newPolyline];
+    renderer.lineWidth = polylineView.strokeWidth;
+    renderer.strokeColor = polylineView.strokeColors.firstObject;
+    renderer.strokeColors =
+        polylineView.strokeColors.count > 1 ? polylineView.strokeColors : nil;
+    renderer.animatedOptions = polylineView.animatedOptions;
+    renderer.animated = polylineView.animated;
+    return;
+  }
+
+  if (oldPolyline) {
+    [_overlayToPolylineMap removeObjectForKey:oldPolyline];
+    [_mapView removeOverlay:oldPolyline];
+  }
+  [self insertOverlay:newPolyline withZIndex:polylineView.zIndex];
+}
+
+- (void)addPolylineOverlayToMap:(LuggPolylineView *)polylineView {
+  if (!_mapView)
+    return;
+
+  NSArray<CLLocation *> *coordinates = polylineView.coordinates;
+  if (coordinates.count == 0)
+    return;
+
+  CLLocationCoordinate2D *coords = (CLLocationCoordinate2D *)malloc(
+      sizeof(CLLocationCoordinate2D) * coordinates.count);
+  for (NSUInteger i = 0; i < coordinates.count; i++) {
+    coords[i] = coordinates[i].coordinate;
+  }
+
+  MKPolyline *polyline = [MKPolyline polylineWithCoordinates:coords
+                                                       count:coordinates.count];
+  free(coords);
+
+  polylineView.polyline = polyline;
+  [_overlayToPolylineMap setObject:polylineView forKey:polyline];
+  [self insertOverlay:polyline withZIndex:polylineView.zIndex];
+}
+
+#pragma mark - Polygon Management
+
+- (void)addPolygonView:(LuggPolygonView *)polygonView {
+  polygonView.delegate = self;
+  [self addPolygonOverlayToMap:polygonView];
+}
+
+- (void)removePolygonView:(LuggPolygonView *)polygonView {
+  polygonView.delegate = nil;
+  MKPolygon *polygon = (MKPolygon *)polygonView.polygon;
+  if (polygon) {
+    [_overlayToPolygonMap removeObjectForKey:polygon];
+    [_mapView removeOverlay:polygon];
+    polygonView.polygon = nil;
+  }
+}
+
+- (void)syncPolygonView:(LuggPolygonView *)polygonView {
+  if (!_mapView)
+    return;
+
+  MKPolygon *oldPolygon = (MKPolygon *)polygonView.polygon;
+
+  NSArray<CLLocation *> *coordinates = polygonView.coordinates;
+  if (coordinates.count == 0) {
+    if (oldPolygon) {
+      [_overlayToPolygonMap removeObjectForKey:oldPolygon];
+      [_mapView removeOverlay:oldPolygon];
+      polygonView.polygon = nil;
+      polygonView.renderer = nil;
+    }
+    return;
+  }
+
+  CLLocationCoordinate2D *coords = (CLLocationCoordinate2D *)malloc(
+      sizeof(CLLocationCoordinate2D) * coordinates.count);
+  for (NSUInteger i = 0; i < coordinates.count; i++) {
+    coords[i] = coordinates[i].coordinate;
+  }
+  NSArray<MKPolygon *> *interiorPolygons =
+      [self interiorPolygonsFromHoles:polygonView.holes];
+  MKPolygon *newPolygon = [MKPolygon polygonWithCoordinates:coords
+                                                      count:coordinates.count
+                                           interiorPolygons:interiorPolygons];
+  free(coords);
+
+  polygonView.polygon = newPolygon;
+  [_overlayToPolygonMap setObject:polygonView forKey:newPolygon];
+
+  MKPolygonRenderer *renderer = (MKPolygonRenderer *)polygonView.renderer;
+  if (renderer && oldPolygon) {
+    [_overlayToPolygonMap removeObjectForKey:oldPolygon];
+    [_mapView removeOverlay:oldPolygon];
+    [self insertOverlay:newPolygon withZIndex:polygonView.zIndex];
+    polygonView.renderer = nil;
+    return;
+  }
+
+  if (oldPolygon) {
+    [_overlayToPolygonMap removeObjectForKey:oldPolygon];
+    [_mapView removeOverlay:oldPolygon];
+  }
+  [self insertOverlay:newPolygon withZIndex:polygonView.zIndex];
+}
+
+- (void)addPolygonOverlayToMap:(LuggPolygonView *)polygonView {
+  if (!_mapView)
+    return;
+
+  NSArray<CLLocation *> *coordinates = polygonView.coordinates;
+  if (coordinates.count == 0)
+    return;
+
+  CLLocationCoordinate2D *coords = (CLLocationCoordinate2D *)malloc(
+      sizeof(CLLocationCoordinate2D) * coordinates.count);
+  for (NSUInteger i = 0; i < coordinates.count; i++) {
+    coords[i] = coordinates[i].coordinate;
+  }
+
+  NSArray<MKPolygon *> *interiorPolygons =
+      [self interiorPolygonsFromHoles:polygonView.holes];
+  MKPolygon *polygon = [MKPolygon polygonWithCoordinates:coords
+                                                   count:coordinates.count
+                                        interiorPolygons:interiorPolygons];
+  free(coords);
+
+  polygonView.polygon = polygon;
+  [_overlayToPolygonMap setObject:polygonView forKey:polygon];
+  [self insertOverlay:polygon withZIndex:polygonView.zIndex];
+}
+
+- (NSArray<MKPolygon *> *)interiorPolygonsFromHoles:
+    (NSArray<NSArray<CLLocation *> *> *)holes {
+  if (holes.count == 0)
+    return @[];
+
+  NSMutableArray<MKPolygon *> *interiorPolygons = [NSMutableArray array];
+  for (NSArray<CLLocation *> *hole in holes) {
+    if (hole.count == 0)
+      continue;
+    CLLocationCoordinate2D *holeCoords = (CLLocationCoordinate2D *)malloc(
+        sizeof(CLLocationCoordinate2D) * hole.count);
+    for (NSUInteger i = 0; i < hole.count; i++) {
+      holeCoords[i] = hole[i].coordinate;
+    }
+    MKPolygon *interiorPolygon = [MKPolygon polygonWithCoordinates:holeCoords
+                                                             count:hole.count];
+    free(holeCoords);
+    [interiorPolygons addObject:interiorPolygon];
+  }
+  return [interiorPolygons copy];
+}
+
+- (void)insertOverlay:(id<MKOverlay>)overlay withZIndex:(NSInteger)zIndex {
+  if (zIndex == 0) {
+    [_mapView addOverlay:overlay];
+    return;
+  }
+
+  NSArray<id<MKOverlay>> *overlays = _mapView.overlays;
+  NSInteger insertIndex = overlays.count;
+
+  for (NSInteger i = 0; i < overlays.count; i++) {
+    NSInteger existingZIndex = 0;
+    LuggPolylineView *existingPolylineView =
+        [_overlayToPolylineMap objectForKey:overlays[i]];
+    LuggPolygonView *existingPolygonView =
+        [_overlayToPolygonMap objectForKey:overlays[i]];
+    if (existingPolylineView) {
+      existingZIndex = existingPolylineView.zIndex;
+    } else if (existingPolygonView) {
+      existingZIndex = existingPolygonView.zIndex;
+    } else {
+      continue;
+    }
+    if (existingZIndex > zIndex) {
+      insertIndex = i;
+      break;
+    }
+  }
+
+  [_mapView insertOverlay:overlay atIndex:insertIndex];
+}
+
+#pragma mark - Lifecycle
+
+- (void)pauseAnimations {
+  for (LuggPolylineView *polylineView in _overlayToPolylineMap
+           .objectEnumerator) {
+    MKPolylineAnimator *renderer = (MKPolylineAnimator *)polylineView.renderer;
+    [renderer pause];
+  }
+}
+
+- (void)resumeAnimations {
+  for (LuggPolylineView *polylineView in _overlayToPolylineMap
+           .objectEnumerator) {
+    MKPolylineAnimator *renderer = (MKPolylineAnimator *)polylineView.renderer;
+    [renderer resume];
+  }
+}
+
+#pragma mark - Commands
+
+- (void)moveCamera:(double)latitude
+         longitude:(double)longitude
+              zoom:(double)zoom
+          duration:(double)duration {
+  if (!_mapView)
+    return;
+
+  double targetZoom = zoom > 0 ? zoom : _mapView.zoomLevel;
+
+  if (duration < 0) {
+    [_mapView
+        setCenterCoordinate:CLLocationCoordinate2DMake(latitude, longitude)
+                  zoomLevel:targetZoom
+                   animated:YES];
+  } else if (duration > 0) {
+    CLLocationCoordinate2D center =
+        CLLocationCoordinate2DMake(latitude, longitude);
+    MKCoordinateRegion region = [_mapView regionForCenterCoordinate:center
+                                                          zoomLevel:targetZoom];
+    [UIView animateWithDuration:duration / 1000.0
+                     animations:^{
+                       [self->_mapView setRegion:region animated:NO];
+                     }];
+  } else {
+    [_mapView
+        setCenterCoordinate:CLLocationCoordinate2DMake(latitude, longitude)
+                  zoomLevel:targetZoom
+                   animated:NO];
+  }
+}
+
+- (void)fitCoordinates:(NSArray *)coordinates
+         edgeInsetsTop:(double)edgeInsetsTop
+        edgeInsetsLeft:(double)edgeInsetsLeft
+      edgeInsetsBottom:(double)edgeInsetsBottom
+       edgeInsetsRight:(double)edgeInsetsRight
+              duration:(double)duration {
+  if (!_mapView || coordinates.count == 0)
+    return;
+
+  CLLocationCoordinate2D *coords = (CLLocationCoordinate2D *)malloc(
+      sizeof(CLLocationCoordinate2D) * coordinates.count);
+  for (NSUInteger i = 0; i < coordinates.count; i++) {
+    NSDictionary *coord = coordinates[i];
+    coords[i] = CLLocationCoordinate2DMake([coord[@"latitude"] doubleValue],
+                                           [coord[@"longitude"] doubleValue]);
+  }
+
+  MKMapRect mapRect = MKMapRectNull;
+  for (NSUInteger i = 0; i < coordinates.count; i++) {
+    MKMapPoint point = MKMapPointForCoordinate(coords[i]);
+    MKMapRect pointRect = MKMapRectMake(point.x, point.y, 0, 0);
+    mapRect = MKMapRectUnion(mapRect, pointRect);
+  }
+  free(coords);
+
+  UIEdgeInsets insets = UIEdgeInsetsMake(edgeInsetsTop, edgeInsetsLeft,
+                                         edgeInsetsBottom, edgeInsetsRight);
+
+  if (duration < 0) {
+    [_mapView setVisibleMapRect:mapRect edgePadding:insets animated:YES];
+  } else if (duration > 0) {
+    [UIView animateWithDuration:duration / 1000.0
+                     animations:^{
+                       [self->_mapView setVisibleMapRect:mapRect
+                                             edgePadding:insets
+                                                animated:NO];
+                     }];
+  } else {
+    [_mapView setVisibleMapRect:mapRect edgePadding:insets animated:NO];
+  }
+}
+
+@end