地图（二）之MapKit

MapKit

用于地图展示，例如大头针，路线，覆盖层展示等（着重界面展示）

一、MKMapView

MapKit通过MKMapView来展示地图

• 常用属性

//初始化地图视图
_mapView = [[MKMapView alloc] init];
//设置地图显示类型
 _mapView.mapType = MKMapTypeStandard;
//设置用户定位追踪方式
_mapView.userTrackingMode = MKUserTrackingModeFollowWithHeading;
//设置是否可缩放
_mapView.zoomEnabled = YES;
//设置是否可滚动
_mapView.scrollEnabled = YES;
//设置是否可旋转
_mapView.rotateEnabled = YES;
//iOS9之后
if(@available(iOS 9.0, *)){
    //设置是否显示指南针
    _mapView.showsCompass = YES;
    //设置是否显示比例尺
    _mapView.showsScale = YES;
    //设置是否显示交通
    _mapView.showsTraffic = YES;
    //设置是否显示建筑
    _mapView.showsBuildings = YES;
}
//设置地图的中心地点
self.mapView.centerCoordinate = userLocation.location.coordinate;
//设置地图的显示区域
self.mapView.region = MKCoordinateRegionMake(self.mapView.centerCoordinate, MKCoordinateSpanMake(0.1, 0.1));
//设置代理
_mapView.delegate = self;

• 常见代理方法

//调用非常频繁,不断监测用户的当前位置;每次调用,都会把用户的最新位置(userLocation参数)传进来
-(void)mapView:(MKMapView*)mapViewdidUpdateUserLocation: (MKUserLocation *)userLocation;
//地图的显示区域即将发生改变的时候调用
-(void)mapView:(MKMapView*)mapView regionWillChangeAnimated: (BOOL)animated;
//地图的显示区域已经发生改变的时候调用
-(void)mapView:(MKMapView *)mapView regionDidChangeAnimated:(BOOL)animated;

MKUserLocation

是一个大头针的模型，包含以下属性

// 地理位置信息
@property (readonly, nonatomic, nullable) CLLocation *location;
// 显示在用户位置上的标题
@property (nonatomic, copy, nullable) NSString *title;
//显示在用户位置上的副标题
@property (nonatomic, copy, nullable) NSString *subtitle;

二、大头针实现

MKAnnotation

官方文档告诉我们，所有标注的类必须遵守这个协议。所以可以了解，标注这个概念在逻辑属性和视图上是分开的。
MKAnnotation的属性有

@protocol MKAnnotation 
@property (nonatomic, readonly) CLLocationCoordinate2D coordinate;//地理坐标位置
@optional
@property (nonatomic, readonly, copy) NSString *title;//标题
@property (nonatomic, readonly, copy) NSString *subtitle;//副标题
//拖动时调用
- (void)setCoordinate:(CLLocationCoordinate2D)newCoordinate;
@end

MKPointAnnotation

这是系统提供的一个标注类，可以用来实现一个简单的标注，只能显示标题和副标题。

MKAnnotationView

MKAnnotationView类定义了标注视图的一些基本特性。通过继承MKAnnotationView类，可以实现自定义大头针。
常用属性

//大头针模型
@property (nonatomic, strong) id  annotation;
//显示的图片
@property (nonatomic, strong) UIImage *image;
//是否显示标注
@property (nonatomic) BOOL canShowCallout;
//标注的偏移量
@property (nonatomic) CGPoint calloutOffset;
//标注右边显示什么控件
@property (strong, nonatomic) UIView *rightCalloutAccessoryView;
//标注左边显示什么控件
@property (strong, nonatomic) UIView *leftCalloutAccessoryView;
//标注下面显示什么控件（iOS9.0）
@property (nonatomic, strong) UIView *detailCalloutAccessoryView

MKPinAnnotationView

MKPinAnnotationView类是MKAnnotationView的子类，用来显示系统标准的标注视图(pin　view)。
MKPinAnnotationView比MKAnnotationView多了2个属性

//大头针颜色
@property (nonatomic) MKPinAnnotationColor pinColor;
//大头针第一次显示时是否从天而降
@property (nonatomic) BOOL animatesDrop;

三、MKMapItem导航

// 根据两个地标对象进行调用系统导航
- (void)beginNavWithBeginPlacemark:(CLPlacemark *)beginPlacemark andEndPlacemark:(CLPlacemark *)endPlacemark
{
    // 创建起点:根据 CLPlacemark 地标对象创建 MKPlacemark 地标对象
    MKPlacemark *itemP1 = [[MKPlacemark alloc] initWithPlacemark:beginPlacemark];
    MKMapItem *item1 = [[MKMapItem alloc] initWithPlacemark:itemP1];

    // 创建终点:根据 CLPlacemark 地标对象创建 MKPlacemark 地标对象
    MKPlacemark *itemP2 = [[MKPlacemark alloc] initWithPlacemark:endPlacemark];
    MKMapItem *item2 = [[MKMapItem alloc] initWithPlacemark:itemP2];

    NSDictionary *launchDic = @{
                                // 设置导航模式参数
                                MKLaunchOptionsDirectionsModeKey : MKLaunchOptionsDirectionsModeDriving,
                                // 设置地图类型
                                MKLaunchOptionsMapTypeKey : @(MKMapTypeHybridFlyover),
                                // 设置是否显示交通
                                MKLaunchOptionsShowsTrafficKey : @(YES),

                                };
    // 根据 MKMapItem 数组 和 启动参数字典 来调用系统地图进行导航
    [MKMapItem openMapsWithItems:@[item1, item2] launchOptions:launchDic];
}

四、MKMapCamera地图街景

// 创建视角中心坐标
CLLocationCoordinate2D center = CLLocationCoordinate2DMake(23.132931, 113.375924);
// 创建3D视角
MKMapCamera *camera = [MKMapCamera cameraLookingAtCenterCoordinate:center fromEyeCoordinate:CLLocationCoordinate2DMake(center.latitude + 0.001, center.longitude + 0.001) eyeAltitude:1];
// 设置到地图上显示
self.mapView.camera = camera;

五、MKMapSnapshotter地图截图

// 截图附加选项
    MKMapSnapshotOptions *options = [[MKMapSnapshotOptions alloc] init];
    // 设置截图区域(在地图上的区域,作用在地图)
    options.region = self.mapView.region;
//    options.mapRect = self.mapView.visibleMapRect;

    // 设置截图后的图片大小(作用在输出图像)
    options.size = self.mapView.frame.size;
    // 设置截图后的图片比例（默认是屏幕比例， 作用在输出图像）
    options.scale = [[UIScreen mainScreen] scale];

    MKMapSnapshotter *snapshotter = [[MKMapSnapshotter alloc] initWithOptions:options];
    [snapshotter startWithCompletionHandler:^(MKMapSnapshot * _Nullable snapshot, NSError * _Nullable error) {
        if (error) {
            NSLog(@"截图错误：%@",error.localizedDescription);
        }else
        {
            // 设置屏幕上图片显示
            self.snapshootImageView.image = snapshot.image;
            // 将图片保存到指定路径
            NSData *data = UIImagePNGRepresentation(snapshot.image);
            [data writeToFile:@"path/snap.png" atomically:YES];
        }
    }];

参考：完整项目资料下载