iOS核心笔记—MapKit框架-基础

1、MapKit框架简介：

✨了解：MapKit框架使用须知：①、MapKit框架中所有的数据类型的前缀都是MK；②、需要导入#import <MapKit/MapKit.h>头文件；③、MapKit框架中有一个非常重要的UI控件：MKMapView，专门用于地图显示，例如：大头针、路线、覆盖层展示等（着重界面展示）。

1-1、地图设置：

1-1-1、设置地图显示类型：

地图类型：

✨备注：通过MKMapView的mapType属性可以设置地图类型，iOS9.0新出的属性在我国不能使用。

1-1-2、设置地图控制项：

地图控制项：

✨备注：通过设置这些属性，可以控制地图的旋转、缩放、移动等操作行为。

1-1-3、设置地图显示项：

地图显示项：

✨了解：地图上的指南针、比例尺、建筑物、POI点都可以控制是否显示。

1-2、使用注意：

✨注意-1：从iOS7.0开始可以不用手动导入框架，使用MapKit框架中的类创建对象时便会隐式的导入MapKit框架；但是，如果是直接从storyboard中拖入MKMapView控件，则需要手动导入MapKit框架，否则，运行时将报无法正常创建mapView的错误。

---

✨注意-2：加载地图数据需要联网。

2、大头针基本使用：

✨重要：大头针在mapView上显示的任何数据都是由其对应的大头针数据模型所决定的。

2-1、显示用户位置：

.#import "ViewController.h"
.#import <MapKit/MapKit.h>
.
.@interface ViewController () <MKMapViewDelegate>
./** 地图控件 */
.@property (weak, nonatomic) IBOutlet MKMapView *mapView;
./** 位置管理者对象 */
.@property (strong, nonatomic) CLLocationManager *mgr;
.
.@end
.
.@implementation ViewController
.
.- (void)viewDidLoad {
.    [super viewDidLoad];
.
.    // 1. 创建位置管理者对象
.    self.mgr = [CLLocationManager new];
.
.    // 2. 请求定位授权
.    if ([self.mgr respondsToSelector:@selector(requestWhenInUseAuthorization)]) {
.        [self.mgr requestWhenInUseAuthorization];
.    }
.
.    // 3. 设置用户跟踪模式, 以便在mapView中显示用户的位置
.//    self.mapView.userTrackingMode = MKUserTrackingModeFollow;
.    self.mapView.userTrackingMode = MKUserTrackingModeFollowWithHeading;
.
.    // 4. 设置mapView的代理, 监听mapView上用户的移动
.    self.mapView.delegate = self;
.}
.
.#pragma mark - MKMapViewDelegate
.
./**
36. mapView中用户位置更新完毕调用
37. */
.- (void)mapView:(MKMapView *)mapView didUpdateUserLocation:(MKUserLocation *)userLocation{
.    NSLog(@"%@", userLocation.location);
.}
.
.@end

✨备注：显示自定义大头针标题：在mapView代理方法中，结合反地理编码；将大头针模型中的location属性反地理编码，以便获取详细的地标对象（CLPlacemark）；再从地标对象中获取具体的位置信息，将具体的位置信息设置到大头针模型属性中，以便大头针展示。这里有几个注意点：①、从大头针数据模型中取出位置对象（CLLocation），再将位置对象进行反地理编码获取包含详细地址信息的地标对象（CLPlacemark）；再将地标对象中的详细地址信息设置到大头针数据模型中，将来大头针控件便能将大头针数据模型中的数据显示在mapView上面。

显示用户位置模式：

MKUserLocation（模型）：

✨备注：MKUserLocation对应的是显示用户位置的“蓝色光圈”大头针数据模型，其所有属性都为readonly。

2-2、模拟追踪显示用户位置：

✨重要：设置以用户所在位置为mapView中心点，因为，用户当前所在位置相对于mapView来说是固定的（即：不能移动用户的位置到mapView现有显示区域的中心点，移动用户位置至mapView现有显示区域中心点去显示用户位置便没有任何意义）；所以，在不移动用户位置的前提下在mapView的显示区域的中心点位置显示用户当前所在位置便需要依靠改变mapView的显示区域来完成。切记：是改变mapView的显示区域，以达到在mapView的中心点位置显示用户位置；千万不要误认为是修改用户的位置。

.#import "ViewController.h"
.#import <MapKit/MapKit.h>
.
.@interface ViewController () <MKMapViewDelegate>
./** 地图控件 */
.@property (weak, nonatomic) IBOutlet MKMapView *mapView;
./** 位置管理者对象 */
.@property (strong, nonatomic) CLLocationManager *mgr;
.
.@end
.
.@implementation ViewController
.
.- (void)viewDidLoad {
.    [super viewDidLoad];
.
.    // 1. 创建位置管理者对象
.    self.mgr = [CLLocationManager new];
.
.    // 2. 请求定位授权
.    if ([self.mgr respondsToSelector:@selector(requestWhenInUseAuthorization)]) {
.        [self.mgr requestWhenInUseAuthorization];
.    }
.
.    // 3. 设置用户跟踪模式, 以便在mapView中显示用户的位置
.    self.mapView.userTrackingMode = MKUserTrackingModeFollowWithHeading;
.
.    // 4. 设置mapView的代理, 监听mapView上用户的移动
.    self.mapView.delegate = self;
.}
.
./**
33. 设置用户当前所在位置为mapView显示区域中心点坐标
34. mapView显示区域 : 当前展示在手机屏幕中的区域即为显示区域
35. */
.- (IBAction)backMapCenter:(UIButton *)sender {
.    // MARK: - 方式一 : 设置mapView的centerCoordinate属性,
.    // 只能改变mapView中心点坐标, 无法改变跨度
.//    self.mapView.centerCoordinate = self.mapView.userLocation.location.coordinate;
.    // 带动画的方式
.    [self.mapView setCenterCoordinate:self.mapView.userLocation.location.coordinate animated:YES];
.
.    // MARK: - 方式二 : 设置mapView的region属性
.    // 能同时改变mapView的中心点位置、显示区域的跨度
.    // 1. 创建显示区域中心点坐标
.    CLLocationCoordinate2D center = self.mapView.userLocation.location.coordinate;
.
.    // 2. 设置显示区域的跨度
.    MKCoordinateSpan span = MKCoordinateSpanMake(0.01, 0.01);
.
.    // 3. 动画设置用户位置为mapView中心点位置
.    [self.mapView setRegion:MKCoordinateRegionMake(center, span) animated:YES];
.}
.
./**
56. mapView显示区域会调用该方法, 在该方法中能够获取mapView系统的跨度
57. */
.- (void)mapView:(MKMapView *)mapView regionDidChangeAnimated:(BOOL)animated{
.    NSLog(@"latitudeDelta : %lf, longitudeDelta : %lf", mapView.region.span.latitudeDelta, mapView.region.span.longitudeDelta);
.}
.@end

✨说明：设置用户当前所在位置为中心点的两种方式：①、直接修改mapView的centerCoordinate属性，直接将用户所在位置设置为该属性的值，但是，这种方式一旦修改mapView的显示跨度、用户所在位置之后，虽然能将用户所在位置设置为mapView中心点位置，但是，mapView的显示区域跨度无法还原（即：如果没有手动还原mapView的显示区域跨度，那么，跨度将一直保持在改变之后的值），即：该方式不能合理改变显示跨度；②、设置mapView的region属性，因为region属性包含两个成员center、span，通过设置该属性能够将用户当前所在位置设置为mapView的显示区域中心点位置，而且还能同时设置mapView显示区域的跨度。注意：如果需要动画将用户所在位置设置为mapView的中心点坐标应当使用属性对应的带有动画的set方法，而不是直接设置用户的属性。

---

✨补充：当mapView的显示区域发生变化后，会调用mapView:regionDidChangeAnimated:代理方法，在该代理方法中可以通过mapView.region.span.longitudeDelta、mapView.region.span.latitudeDelta分别获取系统的经纬度跨度；这样，在我们设置用户当前所在位置为mapView中心点坐标的时候便可以使用系统的跨度，在mapView的中心点坐标修改之后，mapView显示区域的跨度为系统跨度；避免每次修改mapView的中心点坐标的时候导致mapView显示区域的跨度不一致。

2-3、缩放地图：

✨了解：放大、缩小地图，实质是修改mapView的region.span的值；是对应方向上的跨度发生变化。

./**
2. 放大地图, 实质是减小跨度值
3. */
.- (IBAction)zoomInClick:(UIButton *)sender {
.    // 1. 修改跨度
.    CLLocationDegrees latitudeDelta = self.mapView.region.span.latitudeDelta * 0.5;
.    CLLocationDegrees longitudeDelta = self.mapView.region.span.longitudeDelta * 0.5;
.
.    // 2. 重置mapView的region
.    self.mapView.region = MKCoordinateRegionMake(self.mapView.region.center, MKCoordinateSpanMake(latitudeDelta, longitudeDelta));
.}
.
./**
14. 缩小地图, 实质是增大跨度值
15. */
.- (IBAction)zoomOutClick:(UIButton *)sender {
.    // 1. 修改跨度
.    CLLocationDegrees latitudeDelta = self.mapView.region.span.latitudeDelta * ;
.    CLLocationDegrees longitudeDelta = self.mapView.region.span.longitudeDelta * ;
.
.    // 2. 重置mapView的region
.    self.mapView.region = MKCoordinateRegionMake(self.mapView.region.center, MKCoordinateSpanMake(latitudeDelta, longitudeDelta));
.}

✨步骤：①、跨度倍数处理；②、重设region属性。

3、自定义大头针：

3-1、自定义大头针数据模型：

✨重要：所有自定义大头针数据模型必须遵守MKAnnotation协议。

详细步骤：

✨重要：为什么要删除readonly？因为，要设置大头针相关属性，如果不删除readonly，那么，大头针数据模型中所有的属性都为只读的，将来使用该模型添加到mapView中时，无法显示数据。

自定义大头针数据模型：

.#import <Foundation/Foundation.h>
.#import <MapKit/MapKit.h>
.
.@interface MyAnnotationModel : NSObject <MKAnnotation>
./** 大头针位置 */
.@property (nonatomic) CLLocationCoordinate2D coordinate;
./** 大头针标题 */
.@property (nonatomic, copy, nullable) NSString *title;
./** 大头针子标题 */
.@property (nonatomic, copy, nullable) NSString *subtitle;
.
.@end

使用自定义大头针数据模型：

.#import "ViewController.h"
.#import <MapKit/MapKit.h>
.#import "MyAnnotationModel.h"
.
.@interface ViewController ()
./** 地图视图 */
.@property (weak, nonatomic) IBOutlet MKMapView *mapView;
.
.@end
.
.@implementation ViewController
.
.- (void)viewDidLoad {
.    [super viewDidLoad];
.
.    // 1. 创建大头针数据模型
.    MyAnnotationModel *model = [MyAnnotationModel new];
.
.    // 2. 设置大头针数据模型属性
.    model.coordinate = CLLocationCoordinate2DMake(, );
.    model.title = @"帝都";
.    model.subtitle = @"充满魅力的城市";
.
.    // 3. 添加到mapView
.    [self.mapView addAnnotation:model];
.}
.
.- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event{
.    // 1. 获取触摸点坐标
.    CGPoint point = [[touches anyObject] locationInView:self.mapView];
.
.    // 2. 将点转换为经纬度
.    CLLocationCoordinate2D coordinate = [self.mapView convertPoint:point toCoordinateFromView:self.mapView];
.
.    // 3. 创建自定义大头针数据模型
.    MyAnnotationModel *model = [MyAnnotationModel new];
.
.    // 4. 设置大头针数据模型相关属性
.    model.coordinate = coordinate;
.    model.title = @"圣安东尼奥";
.    model.subtitle = @"诸葛维奇_马刺队";
.
.    // 5. 添加到mapView
.    [self.mapView addAnnotation:model];
.}
.
.@end

✨说明：注意通过mapView的convertPoint:toCoordinateFromView:方法能够将触摸在屏幕上的点转换为mapView上面的经纬度。

3-2、自定义大头针视图：

✨重要：与大头针视图相关的类：MKAnnotationView、MKPinAnnotationView；当往mapView中添加“大头针数据模型”时，便会来到mapView的mapView:viewForAnnotation:代理方法询问代理该“返回大头针视图”；当该代理方法没有实现、或者返回“nil”时，大头针视图默认交由系统自动处理，系统会根据实际需求决定是返回显示用户位置的“蓝色光圈”、或者返回其他样式的大头针视图。

详细步骤：

✨注意：在代理方法中，使用MKAnnotationView创建大头针视图并返回；将来mapView中显示大头针视图时，默认不显示，因为，大头针视图没有颜色。

.#import "ViewController.h"
.#import <MapKit/MapKit.h>
.#import "MyAnnotationModel.h"
.
.@interface ViewController () <MKMapViewDelegate>
./** 地图视图 */
.@property (weak, nonatomic) IBOutlet MKMapView *mapView;
./** 位置管理者对象 */
.@property (strong, nonatomic) CLLocationManager *mgr;
.
.@end
.
.@implementation ViewController
.
.- (void)viewDidLoad {
.    [super viewDidLoad];
.
.    // MARK: - 定位授权
.    // 1. 创建位置管理者对象
.    self.mgr = [CLLocationManager new];
.
.    // 2. 请求授权, 使用如下形式进行授权操作, 等价于已经做好版本适配操作
.    // 因为, iOS8.0之前, 位置管理者对象没有requestWhenInUseAuthorization方法
.    if ([self.mgr respondsToSelector:@selector(requestWhenInUseAuthorization)]) {
.        [self.mgr requestWhenInUseAuthorization];
.    }
.
.    // MARK: - 添加大头针
.    // 1. 创建大头针数据模型
.    MyAnnotationModel *model = [MyAnnotationModel new];
.
.    // 2. 设置大头针数据模型属性
.    model.coordinate = CLLocationCoordinate2DMake(, );
.    model.title = @"帝都";
.    model.subtitle = @"充满魅力的城市";
.
.    // 3. 添加到mapView
.    [self.mapView addAnnotation:model];
.
.    // MARK: - 设置mapView相关属性
.    self.mapView.userTrackingMode = MKUserTrackingModeFollow;  // 显示用户位置
.    self.mapView.delegate = self;  // 设置代理
.}
.
.- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event{
.    // 1. 获取触摸点坐标
.    CGPoint point = [[touches anyObject] locationInView:self.mapView];
.
.    // 2. 将点转换为经纬度
.    CLLocationCoordinate2D coordinate = [self.mapView convertPoint:point toCoordinateFromView:self.mapView];
.
.    // 3. 创建自定义大头针数据模型
.    MyAnnotationModel *model = [MyAnnotationModel new];
.
.    // 4. 设置大头针数据模型相关属性
.    model.coordinate = coordinate;
.    model.title = @"圣安东尼奥";
.    model.subtitle = @"诸葛维奇_马刺队";
.
.    // 5. 添加到mapView
.    [self.mapView addAnnotation:model];
.}
.
./**
65. 当mapView添加"大头针数据模型"时, 便会来到该方法返回"大头针视图"
66. 没有实现该代理方法、或者返回为nil, 表示大头针视图类型由系统决定
67.
68. @param mapView 地图视图
69. @param annotation 大头针数据模型
70. @return 大头针视图
71. */
.- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id<MKAnnotation>)annotation{
.    // 0. 显示系统类型大头针视图
.    if ([annotation isKindOfClass:[MKUserLocation class]]) {
.        // 返回nil, 表示大头针视图类型由系统决定
.        return nil;
.    }
.
.    // 1. 定义静态重用标识
.    static NSString *ID = @"annotation";
.
.    // 2. 从缓存池中查找可重用的大头针视图
.    // MKAnnotationView : 该类型大头针视图默认image属性为nil, 不显示
.    // MKPinAnnotationView : 为MKAnnotationView的子类, 默认为红色
.//    MKAnnotationView *annot = [self.mapView dequeueReusableAnnotationViewWithIdentifier:ID];
.    MKPinAnnotationView *pin = (MKPinAnnotationView *)[self.mapView dequeueReusableAnnotationViewWithIdentifier:ID];
.
.    // 3. 判断缓存池是否有可重用的大头针视图
.    if (pin == nil) {
.        pin = [[MKPinAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:ID];
.
.        // MARK: - 设置大头针视图属性
.        // 1. 设置颜色
.        // pinTintColor : iOS9.0设置大头针视图颜色属性
.        // pinColor : iOS9.0之前设置大头针颜色属性
.        pin.pinTintColor =  [UIColor colorWithRed:((float)arc4random_uniform() / 255.0) green:((float)arc4random_uniform() / 255.0) blue:((float)arc4random_uniform() / 255.0) alpha:1.0];
.
.        // 2. 设置动画掉落
.//        pin.animatesDrop = YES;
.    }
.
.    // 4. 返回大头针视图
.    return pin;
.}
.@end

✨注意：自定义大头针视图时，为避免覆盖显示用户位置“蓝色光圈”；需要对大头针数据模型进行判断：mapView中显示用户位置的“蓝色光圈”也是一种大头针视图，其对应的数据模型类型为：MKUserLocation。所以，当我们实现代理方法返回自定义大头针视图时，一定要对“蓝色光圈”大头针视图进行判断；避免自定义大头针视图覆盖“蓝色光圈”（即：如果在代理方法中未加判断，直接返回自定义大头针视图；将来在mapView中添加“大头针数据模型”时，mapView中显示的所有的大头针视图全都为自定义类型的大头针视图；显示用户位置的“蓝色光圈”也被自定义大头针视图给覆盖）。

✨补充-1：在mapView中，当我们需要显示用户位置时，等价于需要定位当前用户所在位置；所以，在iOS8.0之后需要进行定位授权操作；否则，无法显示用户位置。备注：授权操作两步曲：①、配置plist文件相应的键值对，key为NSLocationWhenInUseUsageDescription/NSLocationAlwaysUsageDescription；②、使用代码请求授权，位置管理者对象调用requestWhenInUseAuthorization/requestAlwaysAuthorization方法请求授权。二者缺一不可。

✨补充-2：MKAnnotationView的image属性可以设置大头针视图的图片，当我们自定义大头针视图时，默认该属性的值为nil。

✨补充-3：自定义大头针视图，使用MKAnnotationView，让大头针视图显示自定义图片，根据MVC思想，在大头针数据模型中新增image属性，在代理方法中，根据大头针数据模型的image属性创建图片并设置为自定义大头针视图的image。注意：一个大头针对应一个大头针数据模型。增加一个大头针视图，只需要增加一个大头针数据模型；删除一个大头针，只需要删除一个大头针数据模型。

4、模拟系统大头针掉落动画效果：

✨重要：自定义大头针视图，并模拟系统大头针掉落动画效果。其原理时在大头针未显示之前将大头针视图移动至屏幕上方外面，然后，再以动画的形式将大头针从屏幕外面移动至屏幕中指定位置；所有操作都在mapView的mapView:didAddAnnotationViews:方法中完成。模拟系统大头针动画调用效果的本质：是在mapView的代理方法中，动态改变大头针视图的frame。

4-1、详细步骤：

4-2、示例代码：

.#import "ViewController.h"
.#import "MyAnnotationModel.h"
.#import "MyAnnotationView.h"
.
.#import <MapKit/MapKit.h>
.
.@interface ViewController () <MKMapViewDelegate>
./** 地图视图 */
.@property (weak, nonatomic) IBOutlet MKMapView *mapView;
./** 位置管理者对象 */
.@property (strong, nonatomic) CLLocationManager *mgr;
.
.@end
.
.@implementation ViewController
.
.- (void)viewDidLoad {
.    [super viewDidLoad];
.
.    // MARK: - 请求授权
.    // 1. 创建位置管理者对象
.    self.mgr = [CLLocationManager new];
.
.    // 2. 请求授权
.    if ([self.mgr respondsToSelector:@selector(requestWhenInUseAuthorization)]) {
.        [self.mgr requestWhenInUseAuthorization];
.    }
.
.    // MARK: - 设置mapView属性
.//    self.mapView.userTrackingMode = MKUserTrackingModeFollow;
.    self.mapView.delegate = self;
.}
.
.- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event{
.    // MARK: - 大头针一
.    MyAnnotationModel *model1 = [MyAnnotationModel new];
.    model1.coordinate = CLLocationCoordinate2DMake(, );
.    model1.title = @"帝都";
.    model1.subtitle = @"充满魔力的城市";
.    model1.icon = @"苍老师";
.    [self.mapView addAnnotation:model1];
.
.    // MARK: - 大头针二
.    MyAnnotationModel *model2 = [MyAnnotationModel new];
.    model2.coordinate = CLLocationCoordinate2DMake(, );
.    model2.title = @"东莞";
.    model2.subtitle = @"充满美丽的城市";
.    model2.icon = @"自拍照";
.    [self.mapView addAnnotation:model2];
.}
.
.
.#pragma mark - <MKMapViewDelegate>
./**
55. 当往mapView中添加数据模型时, 便会来到此代理方法中返回大头针视图
56. 通常在该方法中自定义大头针视图, 该方法返回nil默认大头针视图类型由系统处理
57.
58. @param mapView 地图
59. @param annotation 大头针模型
60. @return 大头针视图
61. */
.- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id<MKAnnotation>)annotation{
.    // 1. 如果是"蓝色光圈", 则由系统决定
.    if ([annotation isKindOfClass:[MKUserLocation class]]) {
.        return nil;
.    }
.
.    // 2. 创建大头针视图
.    MyAnnotationView *annotationView = [MyAnnotationView annotationViewWithMapView:mapView];
.
.    // 3. 返回大头针视图
.    return annotationView;
.}
.
./**
76. 大头针视图还未显示时会调用该方法
77.
78. @param mapView 地图
79. @param views 所有大头针视图
80. */
.- (void)mapView:(MKMapView *)mapView didAddAnnotationViews:(NSArray<MKAnnotationView *> *)views{
.    // 如果没有大头针视图, 则直接返回
.    if (views.count == ) {
.        return ;
.    }
.
.    // 遍历大头针视图数组, 添加掉落动画
.    for (MKAnnotationView *annotView in views) {
.        // 1. 如果是"蓝色光圈", 则不需要添加动画
.        if ([annotView.annotation isKindOfClass:[MKUserLocation class]]) {
.            continue;  // 记住: 此处是使用continue, 因为还需要进行下一次遍历操作
.        }
.
.        // 2. 记录大头针显示位置
.        CGRect endFrame = annotView.frame;
.
.        // 3. 改变大头针的frame
.        annotView.frame = CGRectMake(annotView.frame.origin.x, -, annotView.bounds.size.width, annotView.bounds.size.height);
.
.        // 4. 动画还原大头针至原定显示位置
.        [UIView animateWithDuration:3.0 animations:^{
.            annotView.frame = endFrame;
.        }];
.    }
.}
.
.@end

5、封装自定义大头针视图：

示例代码一：大头针视图内部实现

.#import "MyAnnotationView.h"
.#import "MyAnnotationModel.h"
.
.@implementation MyAnnotationView
.
.+ (instancetype)annotationViewWithMapView:(MKMapView *)mapView{
.    // 1. 定义静态重用标识
.    static NSString *ID = @"annotationView";
.
.    // 2. 从缓存池中查找
.    MyAnnotationView *annotationView = (MyAnnotationView *)[mapView dequeueReusableAnnotationViewWithIdentifier:ID];
.
.    // 3. 判断缓存池中是否有可重用的大头针视图
.    if (annotationView == nil) {
.        annotationView = [[MyAnnotationView alloc] initWithAnnotation:nil reuseIdentifier:ID];
.    }
.
.    // 4. 返回大头针视图
.    return annotationView;
.}
.
./**
23. 无论外界是否有使用到大头针的模型属性, 系统都会自动调用该方法
24. 重写该方法之后, 一定要调用super方法; 否则, 程序直接崩溃
25. */
.- (void)setAnnotation:(id<MKAnnotation>)annotation{
.    [super setAnnotation:annotation];
.
.    // 4.1. 设置大头针图片, 一旦自定义大头针视图, image默认为: nil
.    MyAnnotationModel *model = annotation;  // 强转
.    self.image = [UIImage imageNamed:model.icon];
.
.    // 4.2 显示标题/子标题, 自定义大头针视图默认为: NO, 将不显示标题/子标题/辅助视图
.    self.canShowCallout = YES;
.
.    // 4.3 左右辅助视图
.    self.leftCalloutAccessoryView = [UISwitch new];
.    self.rightCalloutAccessoryView = [UISwitch new];
.
.    // 4.4 iOS9.0 新增属性: 标题下面可以设置详细视图, 设置该属性之后将会覆盖子标题
.    self.detailCalloutAccessoryView = [UISwitch new];
.}
.
.@end

示例代码二：外界使用：

.#import "ViewController.h"
.#import "MyAnnotationModel.h"
.#import "MyAnnotationView.h"
.
.#import <MapKit/MapKit.h>
.
.@interface ViewController () <MKMapViewDelegate>
./** 地图视图 */
.@property (weak, nonatomic) IBOutlet MKMapView *mapView;
./** 位置管理者对象 */
.@property (strong, nonatomic) CLLocationManager *mgr;
.
.@end
.
.@implementation ViewController
.
.- (void)viewDidLoad {
.    [super viewDidLoad];
.
.    // MARK: - 请求授权
.    // 1. 创建位置管理者对象
.    self.mgr = [CLLocationManager new];
.
.    // 2. 请求授权
.    if ([self.mgr respondsToSelector:@selector(requestWhenInUseAuthorization)]) {
.        [self.mgr requestWhenInUseAuthorization];
.    }
.
.    // MARK: - 设置mapView属性
.//    self.mapView.userTrackingMode = MKUserTrackingModeFollow;
.    self.mapView.delegate = self;
.}
.
.- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event{
.    // MARK: - 大头针一
.    MyAnnotationModel *model1 = [MyAnnotationModel new];
.    model1.coordinate = CLLocationCoordinate2DMake(, );
.    model1.title = @"帝都";
.    model1.subtitle = @"充满魔力的城市";
.    model1.icon = @"苍老师";
.    [self.mapView addAnnotation:model1];
.
.    // MARK: - 大头针二
.    MyAnnotationModel *model2 = [MyAnnotationModel new];
.    model2.coordinate = CLLocationCoordinate2DMake(, );
.    model2.title = @"东莞";
.    model2.subtitle = @"充满美丽的城市";
.    model2.icon = @"自拍照";
.    [self.mapView addAnnotation:model2];
.}
.
./**
53. 当往mapView中添加数据模型时, 便会来到此代理方法中返回大头针视图
54. 通常在该方法中自定义大头针视图, 该方法返回nil默认大头针视图类型由系统处理
55.
56. @param mapView 地图
57. @param annotation 大头针模型
58. @return 大头针视图
59. */
.- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id<MKAnnotation>)annotation{
.    // 1. 如果是"蓝色光圈", 则由系统决定
.    if ([annotation isKindOfClass:[MKUserLocation class]]) {
.        return nil;
.    }
.
.    // 2. 创建大头针视图
.    MyAnnotationView *annotationView = [MyAnnotationView annotationViewWithMapView:mapView];
.
.    // 3. 返回大头针视图
.    return annotationView;
.}
.
.@end

✨说明-1：自定义大头针视图，点击大头针时，除了显示标题、子标题外；可以通过设置MKAnnotationView的leftCalloutAccessoryView、rightCalloutAccessoryView属性，可以在标题的左侧显示辅助视图。注意：当我们自定义大头针视图时，MKAnnotationView的canShowCallout属性默认为：NO；该属性值为NO时，左辅助视图不显示，所以，如果我们想实现自定义大头针视图显示左、右辅助视图时，必须设置canShowCallout属性的值为YES，否则，标题、子标题、左右辅助视图都将不会显示。

✨说明-2：MKAnnotationView在iOS9.0新增detailCalloutAccessoryView属性，该属性用以展示详细信息，一旦设置该属性之后，子标题将不再显示。

✨说明-3：封装创建自定义大头针视图，在外界提供一个创建自定义大头针视图的类方法即可。

✨说明-4：封装大头针view与封装cell的过程几乎一模一样，唯一一个地方不一样的是封装大头针view可以不用给大头针view传递数据模型；直接在外界使用大头针视图，在自定义大头针view的内部系统会自动调用模型的set方法；给大头针view设置数据，如果重写模型的set方法，一定要调用super；否则，程序将直接崩溃；在重写的模型set方法中我们可以将一些大头针view的通用设置封装进去（例如：给大头针设置图片），快速创建大头针view的方法只需要传入mapView即可。