一、MapKit框架使用前提
- 导入MapKit框架
- 导入MapKit的主头文件
#import <MapKit/MapKit.h> - 如果是storyboard中用到了地图，必须手动导入MapKit框架,否则会报下面的错误:
Terminating app due to uncaught exception 'NSInvalidUnarchiveOperationException', reason: 'Could not instantiate class named MKMapView' - MapKit框架中所有的数据类型的前缀都是以MK开头；MapKit有一个非常重要的UI控件：MKMapView，专门用于地图显示。
二、追踪显示用户的位置
在CoreLocation框架中，使用startUpdatingLocation方法，来定位用户。而在MapKit框架中，设置MapView的userTrackingMode属性跟踪显示用户的当前位置。
如果在iOS8中，想要定位必须设置用户主动要求用户授权，而且必须在info.plist文件中配置一项属性才能弹出允许授权的窗口。
在iOS7中，直接设置MapView的userTrackingMode属性就可以跟踪显示用户的当前位置。
- MkUserTrackingModeNone：不跟踪用户的位置
- MKUserTrackingModeFollow：跟踪并在地图上显示用户的当前位置。
- MKUserTrackingModeFollowWithHeading：跟踪并在地图上显示用户的当前位置，地图会随用户的前进方向进行旋转。
三、设置地图类型
可以设置MKMapView的mapViewType（枚举）设置地图类型
- MKMapTypeStandard:普通地图（默认）
- MKMapTypeSatellite：卫星云图
- MKMapTypeHybrid：普通地图覆盖与卫星云图之上。
四、MKMapView的常见代理方法
MKMapView可以设置一个代理对象，用来监听地图的相关行为。
/
* 每次更新到用户的位置就会调用(调用不频繁, 只有位置改变才会调用)
*
* @param mapView 促发事件的控件
* @param userLocation 大头针模型
*/
- (void)mapView:(MKMapView *)mapView didUpdateUserLocation:(MKUserLocation *)userLocation {
/*
地图上蓝色的点就称之为大头针
大头针可以拥有标题/子标题/位置信息
大头针上显示什么内容由大头针模型确定(MKUserLocation)
*/
// 利用反地理编码获取位置之后设置标题
[self.geocoder reverseGeocodeLocation:userLocation.location completionHandler:^(NSArray *placemarks, NSError *error) {
CLPlacemark *placemark = [placemarks firstObject];
NSLog(@"获取地理位置成功 name = %@ locality = %@",placemark.name, placemark.locality);
userLocation.title = placemark.name;
userLocation.subtitle = placemark.locality;
}];
// 移动地图到当前用户所在位置
// 获取用户当前所在位置的经纬度, 并且设置为地图的中心点
[self.customMapView setCenterCoordinate:userLocation.location.coordinate
animated:YES];
// 设置地图显示的区域
// 获取用户的位置
CLLocationCoordinate2D center = userLocation.location.coordinate;
// 指定经纬度的跨度
MKCoordinateSpan span = MKCoordinateSpanMake(0.009310,0.007812);
// 将用户当前的位置作为显示区域的中心点, 并且指定需要显示的跨度范围
MKCoordinateRegion region = MKCoordinateRegionMake(center, span);
// 设置显示区域
[self.customMapView setRegion:region animated:YES];
}
/**
* 地图的区域即将改变时调用
- (void)mapView:(MKMapView *)mapView regionWillChangeAnimated:(BOOL)animated {
NSLog(@"地图的区域即将改变时调用");
}
/**
* 地图的区域改变完成时调用
*/
- (void)mapView:(MKMapView *)mapView regionDidChangeAnimated:(BOOL)animated {
NSLog(@"地图的区域改变完成时调用");
NSLog(@"%f %f", self.customMapView.region.span.latitudeDelta, self.customMapView.region.span.longitudeDelta);
}
五、设置地图的显示
通过MKMapView的下列方法，可以设置地图显示的位置和区域：
- 设置地图的中心点位置
@property (nonatomic) CLLocationCoordinate2D centerCoordinate;
-(void)setCenterCoordinate(CLLocationCoordinate2D)coordinate animated (BOOL)animated;
2.设置地图的显示区域
@property (nonatomic) MKCoordinateRegion region;
- (void)setRegion:(MKCoordinateRegion)region animated:(BOOL)animated;
MKCoordinateRegion是一个用来表示区域的结构体，定义如下:
typedef struct {
CLLocationCoordinate2D center; // 区域的中心点位置
MKCoordinateSpan span; // 区域的跨度
} MKCoordinateRegion;
MKCoordinateSpan的定义:
typedef struct {
CLLocationDegrees latitudeDelta; // 纬度跨度
CLLocationDegrees longitudeDelta; // 经度跨度
} MKCoordinateSpan;
六、大头针
钉在某个具体位置，用来标识这个位置上有特定的事物（比如这个位置上有家餐馆）。
- 大头针的基本操作
添加一个大头针
- (void)addAnnotation:(id <MKAnnotation>)annotation;
添加多个大头针
- (void)addAnnotations:(NSArray *)annotations;
移除一个大头针
- (void)removeAnnotation:(id<MKAnnotation>)annotation;
移除多个大头针
- (void)removeAnnotations:(NSArray *)annotations;
注意：(id <MKAnnotation>)annotation参数是指：大头针模型对象，用来封装大头针的数据，比如大头针的位置、标题、子标题等数据。
2.自定义大头针
很多情况下，需要自定义大头针的显示样式，比如显示一张图片。
设置MKMapView的代理，实现下面的代理方法，返回大头针控件。
- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id <MKAnnotation>)annotation;
根据传进来的(id <MKAnnotation>)annotation参数创建并返回对应的大头针控件。
注意：
- 每次在地图上添加一个大头针就会调用一次。
- 如果自定义大头针控件返回nil，系统会按照自己默认的方式显示。
- 自定义大头针控件的方式和自定义表格创建的方式一样，都是刚开始的时候从缓冲池中读取，如果缓存池中没有，就会创建出一个新的。
- 不能把模型写死，因为annotationView == nil调用有限，每次都会从缓存池中获取。
- 默认情况下，MKAnnotationView是不能显示的，如果想自定义大头针可以使用MKAnnotationView的子类MKPinAnnotationView。
- 对用户当前位置的大头针特殊处理，如果不是自定义的大头针控件，就返回nil。
- 如果你是使用的MKPinAnnotationView创建的大头针，那么设置的图片无效，因为系统会做一些操作，覆盖掉我们自己的设置
- 标识用户位置的蓝色发光圆点，它也是一个大头针，当显示这个大头针时，也会调用代理方法，因此，需要在代理方法中分清楚(id <MKAnnotation>)annotation参数代表自定义的大头针还是蓝色发光圆点
3.MKAnnotationView
地图上的大头针控件是MKAnnotationView
@property (nonatomic, strong) id <MKAnnotation> annotation; // 大头针模型
@property (nonatomic, strong) UIImage *image; // 显示的图片
@property (nonatomic) BOOL canShowCallout; // 是否显示标注
@property (nonatomic) CGPoint calloutOffset; // 标注的偏移量
@property (strong, nonatomic) UIView *rightCalloutAccessoryView; // 标注右边显示什么控件
@property (strong, nonatomic) UIView *leftCalloutAccessoryView; // 标注左边显示什么控件
4.MKPinAnnotationView
MKPinAnnotationView是MKAnnotationView的子类。
MKPinAnnotationView比MKAnnotationView多了2个属性。
@property (nonatomic) MKPinAnnotationColor pinColor;// 大头针颜色
@property (nonatomic) BOOL animatesDrop; // 大头针第一次显示时是否从天而降
