地图MapKit

一、简介

1、
在移动互联网时代，移动app能解决用户的很多生活琐事，比如
周边：找餐馆、找KTV、找电影院等等
导航：根据用户设定的起点和终点，进行路线规划，并指引用户如何到达

在上述应用中，都用到了定位和地图功能，在iOS开发中，要想加入这2大功能，必须基于2个框架进行开发
CoreLocation ：用于地理定位，地理编码，区域监听等（着重功能实现）
MapKit ：用于地图展示，例如大头针，路线、覆盖层展示等（着重界面展示）

2、MapKit框架的使用
MapKit框架使用前提
导入框架(Xcode5之后可以省略,前提:在代码里面使用了框架中某个类创建了一个对象)

导入主头文件
#import

MapKit框架使用须知
MapKit框架中所有数据类型的前缀都是MK
MapKit有一个比较重要的UI控件 ：MKMapView，专门用于地图显示

二、地图的基本使用

1、地图的类型
可以通过设置MKMapView的 mapType 设置地图类型
MKMapTypeStandard ：普通地图（左图）
MKMapTypeSatellite ：卫星云图 （中图）
MKMapTypeHybrid ：混合模式（普通地图覆盖于卫星云图之上 ）
MKMapTypeSatelliteFlyover： 3D立体卫星 （iOS9.0）
MKMapTypeHybridFlyover： 3D立体混合 （iOS9.0）

2、设置地图的其他属性
操作项：
是否可缩放 zoomEnabled
是否可滚动 scrollEnabled
是否可旋转 rotateEnabled
显示项：
是否显示指南针 showsCompass （iOS9.0）
是否显示比例尺 showsScale （iOS9.0）
是否显示交通 showsTraffic （iOS9.0）
是否显示建筑 showsBuildings

使用注意
设置对应的属性时，注意该属性是从哪个系统版本开始引入的，做好不同系统版本的适配

三、跟踪显示用户的位置

1、显示用户的位置
设置MKMapView的showsUserLocation属性可以显示用户的当前位置

下图是显示效果
蓝色发光圆点就是用户的当前位置
蓝色发光圆点，专业术语叫做“大头针”

注意：iOS8.0之后，显示用户位置需要用户进行定位授权

2、追踪用户的位置
设置MKMapView的userTrackingMode属性可以跟踪显示用户的当前位置
MKUserTrackingModeNone ：不跟踪用户的位置
MKUserTrackingModeFollow ：跟踪并在地图上显示用户的当前位置
MKUserTrackingModeFollowWithHeading ：跟踪并在地图上显示用户的当前位置，地图会跟随用户的前进方向进行旋转

注意：iOS8.0之后，追踪用户位置需要用户进行定位授权

备注：
iOS8.0-，地图不会自动滚动到用户所在位置
iOS8.0+，地图会自动放大到合适比例，并显示出用户位置

四、设置地图的显示

1、设置地图的显示
通过MKMapView的下列方法，可以设置地图显示的位置和区域
设置地图的中心点位置
@property (nonatomic) CLLocationCoordinate2D centerCoordinate;
- (void)setCenterCoordinate:(CLLocationCoordinate2D)coordinate animated:(BOOL)animated;

设置地图的显示区域
@property (nonatomic) MKCoordinateRegion region;
- (void)setRegion:(MKCoordinateRegion)region animated:(BOOL)animated;

2、MKCoordinateRegion
MKCoordinateRegion是一个用来表示区域的结构体，定义如下
typedef struct {
CLLocationCoordinate2D center; // 区域的中心点位置
MKCoordinateSpan span; // 区域的跨度
} MKCoordinateRegion;

MKCoordinateSpan的定义
typedef struct {
CLLocationDegrees latitudeDelta; // 纬度跨度
CLLocationDegrees longitudeDelta; // 经度跨度
} MKCoordinateSpan;

五、MKMapView的代理

MKMapView可以设置一个代理对象，用来监听地图的相关行为

常见的代理方法有
- (void)mapView:(MKMapView *)mapView didUpdateUserLocation:(MKUserLocation *)userLocation;
一个位置更改默认只会调用一次，不断监测用户的当前位置
每次调用，都会把用户的最新位置（userLocation参数）传进来

- (void)mapView:(MKMapView *)mapView regionWillChangeAnimated:(BOOL)animated;
地图的显示区域即将发生改变的时候调用

- (void)mapView:(MKMapView *)mapView regionDidChangeAnimated:(BOOL)animated;
地图的显示区域已经发生改变的时候调用

2、MKUserLocation 大头针模型
MKUserLocation其实是个大头针模型，包括以下属性
@property (nonatomic, copy) NSString *title;
显示在大头针上的标题

@property (nonatomic, copy) NSString *subtitle;
显示在大头针上的子标题

@property (readonly, nonatomic) CLLocation *location;
地理位置信息(大头针钉在什么地方?)

3、位置、地标、大头针总概览

六、大头针

1、简介
地图上的大头针
钉在某个具体位置，用来标识这个位置上有特定的事物（比如这个位置上有家餐馆）

2、大头针的基本操作
添加一个大头针
- (void)addAnnotation:(id )annotation;

添加多个大头针
- (void)addAnnotations:(NSArray *)annotations;

移除一个大头针
- (void)removeAnnotation:(id )annotation;

移除多个大头针
- (void)removeAnnotations:(NSArray *)annotations;

(id )annotation参数是什么东西？
大头针模型对象：用来封装大头针的数据，比如大头针的位置、标题、子标题等数据

/** 坐标位置 */
@property (nonatomic, assign) CLLocationCoordinate2D coordinate;
/** 标题 */
@property (nonatomic, copy) NSString *title;
/** 子标题 */
@property (nonatomic, copy) NSString *subtitle;

3、大头针使用实例
MJTuangouAnnotation *anno = [[MJTuangouAnnotation alloc] init];
anno.title = @“广州小蛮腰";
anno.subtitle = @“哎呦，不错哦！";
anno.coordinate = CLLocationCoordinate2DMake(23.132, 113.345);
[self.mapView addAnnotation:anno];

4、自定义大头针
很多情况下，需要自定义大头针的显示样式，比如显示一张图片

如何自定义大头针
设置MKMapView的代理
实现下面的代理方法，返回大头针控件
- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id )annotation;
根据传进来的(id )annotation参数创建并返回对应的大头针控件

代理方法的使用注意
如果返回nil，显示出来的大头针就采取系统的默认样式
标识用户位置的蓝色发光圆点，它也是一个大头针，当显示这个大头针时，也会调用代理方法
因此，需要在代理方法中分清楚(id )annotation参数代表自定义的大头针还是蓝色发光圆点

5、自定义大头针实例
- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id)annotation
{
// 判断annotation的类型
if (![annotation isKindOfClass:[MJTuangouAnnotation class]]) return nil;

// 创建MKAnnotationView
static NSString *ID = @"tuangou";
MKAnnotationView *annoView = [mapView dequeueReusableAnnotationViewWithIdentifier:ID];
if (annoView == nil) {
annoView = [[MKAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:ID];
annoView.canShowCallout = YES;
}
// 传递模型数据
annoView.annotation = annotation;

// 设置图片
MJTuangouAnnotation *tuangouAnnotation = annotation;
annoView.image = [UIImage imageNamed:tuangouAnnotation.icon];

return annoView;
}

七、MKAnnotationView

1、地图上的大头针控件是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;
标注左边显示什么控件

@property (nonatomic, strong) UIView *detailCalloutAccessoryView
标注下面显示什么控件（iOS9.0）

2、MKPinAnnotationView
MKPinAnnotationView是MKAnnotationView的子类
MKPinAnnotationView比MKAnnotationView多了2个属性

@property (nonatomic) MKPinAnnotationColor pinColor;
大头针颜色

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

八、利用系统App导航/数字版街景/地图快照截图

1、MKMapItem调用系统APP进行导航主要方法
[MKMapItem openMapsWithItems:items launchOptions:md];

示例代码
// 根据两个地标对象进行调用系统导航
- (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];

2、MKMapCamera地图街景
主要方法
self.mapView.camera = camera;

示例代码
// 创建视角中心坐标
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;

3、MKMapSnapshotter地图截图
主要方法
[snapshotter startWithCompletionHandler:^(MKMapSnapshot * _Nullable snapshot, NSError * _Nullable error) { }];

示例代码
// 截图附加选项
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:@"/Users/wangshunzi/Desktop/snap.png" atomically:YES];
}
}];

4、MapKit框架-获取导航路线信息
MKDirections获取导航路线信息
主要方法
[directions calculateDirectionsWithCompletionHandler:
^(MKDirectionsResponse * _Nullable response, NSError * _Nullable error) {

}];

5、绘制导航路线
主要方法
/**
注意：这里不像添加大头针那样，只要我们添加了大头针模型，默认就会在地图上添加系统的大头针视图
添加覆盖层，需要我们实现对应的代理方法，在代理方法中返回对应的覆盖层
*/
[self.mapView addOverlay:overlay];
调用了以上方法后,会调用以下代理方法获取对应的渲染涂层
-(MKOverlayRenderer *)mapView:(MKMapView *)mapView rendererForOverlay:(id)overlay

地图 MapKit