MapKit框架

一、MapKit框架使用前提

  1. 导入MapKit框架
  2. 导入MapKit的主头文件
    #import
  3. 如果是storyboard中用到了地图,必须手动导入MapKit框架,否则会报下面的错误:
    Terminating app due to uncaught exception 'NSInvalidUnarchiveOperationException', reason: 'Could not instantiate class named MKMapView'
  4. 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的下列方法,可以设置地图显示的位置和区域:

  1. 设置地图的中心点位置
@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;

六、大头针

钉在某个具体位置,用来标识这个位置上有特定的事物(比如这个位置上有家餐馆)。

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

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

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

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

注意:(id )annotation参数是指:大头针模型对象,用来封装大头针的数据,比如大头针的位置、标题、子标题等数据。

2.自定义大头针
很多情况下,需要自定义大头针的显示样式,比如显示一张图片。
设置MKMapView的代理,实现下面的代理方法,返回大头针控件。

- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id )annotation;

根据传进来的(id )annotation参数创建并返回对应的大头针控件。

注意:

  • 每次在地图上添加一个大头针就会调用一次。
  • 如果自定义大头针控件返回nil,系统会按照自己默认的方式显示。
  • 自定义大头针控件的方式和自定义表格创建的方式一样,都是刚开始的时候从缓冲池中读取,如果缓存池中没有,就会创建出一个新的。
  • 不能把模型写死,因为annotationView == nil调用有限,每次都会从缓存池中获取。
  • 默认情况下,MKAnnotationView是不能显示的,如果想自定义大头针可以使用MKAnnotationView的子类MKPinAnnotationView。
  • 对用户当前位置的大头针特殊处理,如果不是自定义的大头针控件,就返回nil。
  • 如果你是使用的MKPinAnnotationView创建的大头针,那么设置的图片无效,因为系统会做一些操作,覆盖掉我们自己的设置
  • 标识用户位置的蓝色发光圆点,它也是一个大头针,当显示这个大头针时,也会调用代理方法,因此,需要在代理方法中分清楚(id )annotation参数代表自定义的大头针还是蓝色发光圆点

3.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; // 标注左边显示什么控件

4.MKPinAnnotationView
MKPinAnnotationView是MKAnnotationView的子类。
MKPinAnnotationView比MKAnnotationView多了2个属性。

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

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

你可能感兴趣的:(MapKit框架)