iOS开发之MapKit

1、概述

MapKit框架使用前提：

导入框架：

导入主头文件：

#import <MapKit/MapKit.h>

MapKit框架使用须知：

MapKit框架中所有数据类型的前缀都是MK。

MapKit有一个比较重要的UI控件 ：MKMapView，专门用于地图显示。

2、跟踪显示用户的位置

设置MKMapView的userTrackingMode属性可以跟踪显示用户的当前位置：

MKUserTrackingModeNone ：不跟踪用户的位置

MKUserTrackingModeFollow ：跟踪并在地图上显示用户的当前位置

MKUserTrackingModeFollowWithHeading ：跟踪并在地图上显示用户的当前位置，地图会跟随用户的前进方向进行旋转

下图是跟踪效果：

蓝色发光圆点就是用户的当前位置。

蓝色发光原点，专业术语叫做“大头针”。

3、地图的类型

可以通过设置MKMapView的mapViewType设置地图类型：

MKMapTypeStandard ：普通地图（左图）

MKMapTypeSatellite ：卫星云图 （中图）

MKMapTypeHybrid ：普通地图覆盖于卫星云图之上（右图）

4、MKMapView的代理

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

常见的代理方法有：

- (void)mapView:(MKMapView *)mapView didUpdateUserLocation:

(MKUserLocation *)userLocation;

调用非常频繁，不断监测用户的当前位置

每次调用，都会把用户的最新位置（userLocation参数）传进来

-(void)mapView:(MKMapView *)mapView regionWillChangeAnimated:

(BOOL)animated;

地图的显示区域即将发生改变的时候调用

- (void)mapView:(MKMapView *)mapView regionDidChangeAnimated:

(BOOL)animated;

地图的显示区域已经发生改变的时候调用

5、MKUserLocation

MKUserLocation其实是个大头针模型，包括以下属性。

@property (nonatomic, copy) NSString *title;

显示在大头针上的标题

@property (nonatomic, copy) NSString *subtitle;

显示在大头针上的子标题

@property (readonly, nonatomic) CLLocation *location;

地理位置信息

6、设置地图的显示

通过MKMapView的下列方法，可以设置地图显示的位置和区域。

设置地图的中心点位置：

@property (nonatomic) CLLocationCoordinate2D centerCoordinate;

-(void)setCenterCoordinate:(CLLocationCoordinate2D)coordinate animated:(BOOL)animated;

设置地图的显示区域：

@property (nonatomic) MKCoordinateRegion region;

-(void)setRegion:(MKCoordinateRegion)region animated:

(BOOL)animated;

例如：

- (void)mapView:(MKMapView *)mapView didUpdateUserLocation:

(MKUserLocation *)userLocation

{

userLocation.title = @"天朝帝都";

userLocation.subtitle = @"是个非常牛逼的地方！";

CLLocationCoordinate2D center = userLocation.location.coordinate;

// 设置地图的显示范围

MKCoordinateSpan span = MKCoordinateSpanMake(0.021321, 0.019366);//数值越小地图放的越大（地理位置越详细），位置越精确

MKCoordinateRegion region = MKCoordinateRegionMake(center, span);//设置地图中心点为当前定位到的位置

[mapView setRegion:region animated:YES];

}

7、MKCoordinateRegion结构体

MKCoordinateRegion是一个用来表示区域的结构体，定义如下：

typedef struct {

CLLocationCoordinate2D center; // 区域的中心点位置

MKCoordinateSpan span; // 区域的跨度

} MKCoordinateRegion;

MKCoordinateSpan的定义：

typedef struct {

CLLocationDegrees latitudeDelta; // 纬度跨度

CLLocationDegrees longitudeDelta; // 经度跨度

} MKCoordinateSpan;

8、大头针的基本操作

添加一个大头针

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

添加多个大头针

- (void)addAnnotations:(NSArray *)annotations;

移除一个大头针

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

移除多个大头针

- (void)removeAnnotations:(NSArray *)annotations;

(id <MKAnnotation>)annotation参数是什么东西？

大头针模型对象：用来封装大头针的数据，比如大头针的位置、标题、子标题等数据

9、大头针模型

新建一个大头针模型类

#import <MapKit/MapKit.h>

@interface MJTuangouAnnotation : NSObject <MKAnnotation>

/** 坐标位置 */

@property (nonatomic, assign) CLLocationCoordinate2D coordinate;

/** 标题 */

@property (nonatomic, copy) NSString *title;

/** 子标题 */

@property (nonatomic, copy) NSString *subtitle;

@end

10、添加大头针

MJTuangouAnnotation *anno = [[MJTuangouAnnotation alloc] init];

anno.title = @"这是位置";

anno.subtitle = @“这是位置描述";

anno.coordinate = CLLocationCoordinate2DMake(40, 116);

[self.mapView addAnnotation:anno];

例如，点击屏幕MKMapView哪里，就在哪里添加一个大头针：

首先，要遵守代理协议：MKMapViewDelegate

- (void)viewDidLoad

{

[super viewDidLoad];

// 1.跟踪用户位置(显示用户的具体位置)

self.mapView.userTrackingMode = MKUserTrackingModeFollow;

// 2.设置代理

self.mapView.delegate = self;

// 3.监听mapView的点击事件

[self.mapView addGestureRecognizer:[[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(tapMapView:)]];

}

/**

*  监听mapView的点击

*/

- (void)tapMapView:(UITapGestureRecognizer *)tap

{

// 1.获得用户在mapView点击的位置（x，y）

CGPoint point = [tap locationInView:tap.view];

// 2.将数学坐标 转为 地理经纬度坐标

CLLocationCoordinate2D coordinate = [self.mapView convertPoint:point toCoordinateFromView:self.mapView];

// 3.创建大头针模型，添加大头针到地图上

MJAnnotation *anno = [[MJAnnotation alloc] init];

anno.coordinate = coordinate;//设置大头针的经纬坐标

anno.title = @"这是位置";

anno.subtitle = @"这是位置描述";

[self.mapView addAnnotation:anno];//添加大头针

}

由于系统自带的大头针MKAnnotation的属性都是只读的，不能改变其属性，也就是说不能设置其位置、title等，解决办法为自定义MKAnnotation，重写其属性，将它的需要用到的属性改为可写的。方法为新建普通类MJAnnotation，使它遵守MKAnnotation协议，导入框架头文件<MapKit/MapKit.h>，然后在MJAnnotation.h文件中重写属性，不用动MJAnnotation.m文件。如下：

#import <Foundation/Foundation.h>

#import <MapKit/MapKit.h>

@interface MJAnnotation : NSObject <MKAnnotation>

@property (nonatomic, assign) CLLocationCoordinate2D coordinate;

//原来为@property (nonatomic, readonly) CLLocationCoordinate2D coordinate;

@property (nonatomic, copy) NSString *title;

//原来为@property (nonatomic, readonly, copy) NSString *title;

@property (nonatomic, copy) NSString *subtitle;

//原来为@property (nonatomic,readonly copy) NSString *subtitle;

@end

11、自定义大头针

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

自定义大头针步骤：

第一步：自定义大头针（MKAnnotation）

MJTuangouAnnotation.h文件如下（不需要动.m文件）：

#import <Foundation/Foundation.h>

#import <MapKit/MapKit.h>

@interface MJTuangouAnnotation : NSObject <MKAnnotation>

@property (nonatomic, assign) CLLocationCoordinate2D coordinate;

@property (nonatomic, copy) NSString *title;

@property (nonatomic, copy) NSString *subtitle;

@property (nonatomic, copy) NSString *icon;//这条属性不是系统自带的，是我们手动添加的

@end

第二步：使控制器遵守MKMapViewDelegate协议，并将控制器设置为MKMapView的代理

self.mapView.delegate = self;

第三步：实现下面的代理方法，返回大头针控件

- (MKAnnotationView *)mapView:(MKMapView *)mapView

viewForAnnotation:(id <MKAnnotation>)annotation;

例如：

- (void)viewDidLoad

{

[super viewDidLoad];

// 1.美食

MJTuangouAnnotation *anno0 = [[MJTuangouAnnotation alloc] init];

anno0.title = @"xxx大饭店";

anno0.subtitle = @"全场一律15折，会员20折";

anno0.coordinate = CLLocationCoordinate2DMake(39, 115);

anno0.icon = @"eat";

[self.mapView addAnnotation:anno0];

// 2.电影

MJTuangouAnnotation *anno1 = [[MJTuangouAnnotation alloc] init];

anno1.title = @"xxx影院";

anno1.subtitle = @"最新大片：美国队长2，即将上映。。。";

anno1.coordinate = CLLocationCoordinate2DMake(29, 110);

anno1.icon = @"movie";

[self.mapView addAnnotation:anno1];

self.mapView.delegate = self;//设置代理

}

- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id<MKAnnotation>)annotation

{

if (![annotation isKindOfClass:[MJTuangouAnnotation class]]) return nil;//使自定义的大头针能和系统默认大头针共存，如果不加此行代码，定位的时候会出现系统icon属性没有找到的属性，因为该属性不是系统包含的，是我们手动添加的。

static NSString *ID = @"tuangou";

// 从缓存池中取出可以循环利用的大头针view

MKAnnotationView *annoView =

[mapView dequeueReusableAnnotationViewWithIdentifier:ID];

if (annoView == nil) {

annoView=[[MKAnnotationView alloc] initWithAnnotation:

annotation reuseIdentifier:ID];

// 设置是否显示标题和子标题

annoView.canShowCallout = YES;

// 设置大头针描述的偏移量

annoView.calloutOffset = CGPointMake(0, -10);

// 设置大头针描述右边的控件

annoView.rightCalloutAccessoryView =

[UIButton buttonWithType:UIButtonTypeContactAdd];

// 设置大头针描述左边的控件

annoView.leftCalloutAccessoryView =

[UIButton buttonWithType:UIButtonTypeDetailDisclosure];

}

// 传递模型

annoView.annotation = annotation;

// 设置图片，要手动设置图片而不用手动设置标题是因为标题是自带属性，而icon是我们添加的属性。

MJTuangouAnnotation *tuangouAnno = annotation;

annoView.image = [UIImage imageNamed:tuangouAnno.icon];

return annoView;//返回nil则显示默认大头针

}

第四步：根据传进来的(id <MKAnnotation>)annotation参数创建并返回对应的大头针控件。

【备注】代理方法的使用注意:

如果返回nil，显示出来的大头针就采取系统的默认样式。

标识用户位置的蓝色发光圆点，它也是一个大头针，当显示这个大头针时，也会调用代理方法。

因此，需要在代理方法中分清楚(id <MKAnnotation>)annotation参数代表自定义的大头针还是蓝色发光圆点。

12、MKAnnotationView

地图上的大头针控件是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;

标注左边显示什么控件

11、    MKPinAnnotationView

MKPinAnnotationView是MKAnnotationView的子类。

MKPinAnnotationView比MKAnnotationView多了2个属性：

@property (nonatomic) MKPinAnnotationColor pinColor;

大头针颜色

@property (nonatomic) BOOL animatesDrop;

大头针第一次显示时是否从天而降