（八十）MapKit放置系统默认大头针和自定义大头针

Posted 2023-02-15 我们都曾拥有最美的时光

有关MapView的显示和定位在上一节已经说明，这一节说明如何在地图上放置大头针，以及设置点击大头针的视图。

【系统默认大头针】

mapView上放置大头针的方法是调用其addAnnotation:方法，需要注意的是，传入的是模型而不是大头针视图。

- (void)addAnnotation:(id <MKAnnotation>)annotation;

通过这个方法，我们可以清楚的看到，annotation模型需要遵循MKAnnotation协议，我们打开这个协议，可以看到如下的内容：

@protocol MKAnnotation <NSObject>

// Center latitude and longitude of the annotation view.
// The implementation of this property must be KVO compliant.
@property (nonatomic, readonly) CLLocationCoordinate2D coordinate;

@optional

// Title and subtitle for use by selection UI.
@property (nonatomic, readonly, copy) NSString *title;
@property (nonatomic, readonly, copy) NSString *subtitle;

// Called as a result of dragging an annotation view.
- (void)setCoordinate:(CLLocationCoordinate2D)newCoordinate NS_AVAILABLE(10_9, 4_0);

@end

因此我们应当定义一个模型，按照协议定义这些属性，其中coordinate是必须定义的，因为大头针必须有位置。

模型类遵循MKAnnocation协议，命名为MyAnnotation，如下：

#import <Foundation/Foundation.h>
#import <MapKit/MapKit.h>

@interface MyAnnotation : NSObject<MKAnnotation>
 /**
 *  大头针的位置
 */
@property (nonatomic, assign) CLLocationCoordinate2D coordinate;
/**
 *  大头针标题
 */
@property (nonatomic, copy) NSString *title;
/**
 *  大头针的子标题
 */
@property (nonatomic, copy) NSString *subtitle;
@end

#import "MyAnnotation.h"

@implementation MyAnnotation

@end

然后就可以通过定义模型，调用addAnnotation:方法添加一枚大头针，例如我们通过Button，随机添加一枚大头针：

- (IBAction)addPin:(id)sender 
    
    MyAnnotation *anno = [[MyAnnotation alloc] init];
    anno.title = @"title";
    anno.subtitle = @"subtitle";
    CLLocationDegrees latitude = 36.821119 + arc4random_uniform(20);
    CLLocationDegrees longtitude = 116.750112 + arc4random_uniform(20);
    anno.coordinate = CLLocationCoordinate2DMake(latitude, longtitude);
    
    [self.mapView addAnnotation:anno];

其中的title和subtitle是点击大头针时显示的气泡上的标题和副标题。

大头针的显示原理和tableView显示cell是类似的，一旦调用addAnnotation:方法，就会调用mapView:viewForAnnotationView:方法，这个方法中应当从缓存池取出一个大头针视图，或者如果缓存池中没有新建一个大头针视图，然后返回。

与tableView的区别是，如果直接返回nil，则会按照系统的样式返回大头针。

需要注意的是，如果不返回nil，要对不同类型的大头针进行处理，不要忘了用户的位置指示圆点也属于一种大头针，如果只是单单的设置大头针，连用户位置也会是一颗针而不是圆点。

判断方法很简单，因为用户位置大头针由系统创建，因此传入的模型肯定不是我们自己的模型MyAnnotation，只要判断传入的模型是不是这个类，如果不是，则返回nil，代表按照系统默认样式，创建圆点。

要创建大头针，使用的是MKPinAnnotationView，如果使用MKAnnotationView，是不带图片的，无法直接显示。

- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id<MKAnnotation>)annotation
    
    static NSString *ID = @"anno";
    // 如果返回nil，系统会按照默认方式显示，如果自定义，是无法直接显示的，并且点击大头针之后不会显示标题，需要自己手动设置显示
    // 如果想要直接显示，应该调用MKPinAnnotationView
    MKPinAnnotationView *annoView = (MKPinAnnotationView *)[mapView dequeueReusableAnnotationViewWithIdentifier:ID];
    
    if (annoView == nil) 
        annoView = [[MKPinAnnotationView alloc] initWithAnnotation:nil reuseIdentifier:ID];
        // 大头针属性
        annoView.animatesDrop = YES; // 设置大头针坠落的动画
        annoView.canShowCallout = YES; // 设置点击大头针是否显示气泡
        annoView.calloutOffset = CGPointMake(0, 0); // 设置大头针气泡的偏移
        // 设置大头针气泡的左右视图、可以为任意UIView
        annoView.leftCalloutAccessoryView = [UIButton buttonWithType:UIButtonTypeContactAdd];
        annoView.rightCalloutAccessoryView = [[UISwitch alloc] init];
        [annoView setPinColor:MKPinAnnotationColorPurple]; // 设置大头针颜色
    
    
    // 设置大头针的图片，如果是直接创建MKPin，则无效。
    //annoView.image = [UIImage imageNamed:@"pin"];
    
    annoView.annotation = annotation;
    
    // 如果是用户位置，应当显示默认的圆点而不是大头针，因此应当判断是否是MyAnnotation
    if(![annoView.annotation isKindOfClass:[MyAnnotation class]])
        return nil;
    
    
    return annoView;
    

【自定义大头针】

自定义大头针需要使用MKAnnotationView，自己指定image，没有坠落动画，其他没有区别。

 (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id<MKAnnotation>)annotation
    
    static NSString *ID = @"anno";
    // 如果返回nil，系统会按照默认方式显示，如果自定义，是无法直接显示的，并且点击大头针之后不会显示标题，需要自己手动设置显示
    // 如果想要直接显示，应该调用MKPinAnnotationView
    MKAnnotationView *annoView = [mapView dequeueReusableAnnotationViewWithIdentifier:ID];
    
    if (annoView == nil) 
        annoView = [[MKPinAnnotationView alloc] initWithAnnotation:nil reuseIdentifier:ID];
        // 大头针属性
        //annoView.animatesDrop = YES; // MKPinAnnotaionView才有效，设置大头针坠落的动画
        annoView.canShowCallout = YES; // 设置点击大头针是否显示气泡
        annoView.calloutOffset = CGPointMake(0, 0); // 设置大头针气泡的偏移
        // 设置大头针气泡的左右视图、可以为任意UIView
        annoView.leftCalloutAccessoryView = [UIButton buttonWithType:UIButtonTypeContactAdd];
        annoView.rightCalloutAccessoryView = [[UISwitch alloc] init];
        //[annoView setPinColor:MKPinAnnotationColorPurple]; // MKPinAnnotaionView才有效，设置大头针的颜色
    
    
    // 设置大头针的图片
    annoView.image = [UIImage imageNamed:@"pin"];
    
    annoView.annotation = annotation;
    
    // 如果是用户位置，应当显示默认的圆点而不是大头针，因此应当判断是否是MyAnnotation
    if(![annoView.annotation isKindOfClass:[MyAnnotation class]])
        return nil;
    
    
    return annoView;
    

【MVC封装annotationView的注意点】

annotation要传入模型，在重写的set方法里，注意调用父类的set方法，先设置公共属性，再设置自己所特有的。

有一个细节，默认set方法的传入模型是id<MKAnnotaion>类型，在使用时还需要强转类型，为了方便，我们直接把类型改为MyAnnotation，因为OC在调用方法时发送的消息只包括方法名和冒号、描述，因此类型不属于方法名的一部分，可以修改。

- (void)setAnnotation:(MyAnnotation *)annotation
   [super setAnnotation:annotation];
   // 设置特有的属性，例如图片、左右视图等。