MapKit

  • MapKit :用于地图展示,例如大头针,路线、覆盖层展示等(着重界面展示)

  • MapKit框架数据类型的前缀都是MK

  • MapKit框架有一个比较重要的UI控件:MKMapView,专门用于地图显示

MapKit框架使用

  • 导入MapKit框架
#import <MapKit/MapKit.h>

追踪显示用户的位置

  • 在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;

大头针

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

大头针的基本操作

添加一个大头针
- (void)addAnnotation:(id <MKAnnotation>)annotation;

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

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

移除多个大头针
- (void)removeAnnotations:(NSArray *)annotations;
  • 注意:(id )annotation参数是指:大头针模型对象,用来封装大头针的数据,比如大头针的位置、标题、子标题等数据

自定义大头针

  • 很多情况下,需要自定义大头针的显示样式,比如显示一张图片,设置MKMapView的代理,实现下面的代理方法,返回大头针控件
(MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id <MKAnnotation>)annotation;
  • 根据传进来的(id )annotation参数创建并返回对应的大头针控件。

  • 注意:

  • 每次在地图上添加一个大头针就会调用一次。

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

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

MKPinAnnotationView

  • MKPinAnnotationView是MKAnnotationView的子类。
  • MKPinAnnotationView比MKAnnotationView多了2个属性。
@property (nonatomic) MKPinAnnotationColor pinColor;// 大头针颜色
@property (nonatomic) BOOL animatesDrop; // 大头针第一次显示时是否从天而降

MapKit

  • MapKit :用于地图展示,例如大头针,路线、覆盖层展示等(着重界面展示)

  • MapKit框架数据类型的前缀都是MK

  • MapKit框架有一个比较重要的UI控件:MKMapView,专门用于地图显示

MapKit框架使用

  • 导入MapKit框架
#import <MapKit/MapKit.h>

追踪显示用户的位置

  • 在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;

大头针

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

大头针的基本操作

添加一个大头针
- (void)addAnnotation:(id <MKAnnotation>)annotation;

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

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

移除多个大头针
- (void)removeAnnotations:(NSArray *)annotations;
  • 注意:(id )annotation参数是指:大头针模型对象,用来封装大头针的数据,比如大头针的位置、标题、子标题等数据

自定义大头针

  • 很多情况下,需要自定义大头针的显示样式,比如显示一张图片,设置MKMapView的代理,实现下面的代理方法,返回大头针控件
(MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id <MKAnnotation>)annotation;
  • 根据传进来的(id )annotation参数创建并返回对应的大头针控件。

  • 注意:

  • 每次在地图上添加一个大头针就会调用一次。

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

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

MKPinAnnotationView

  • MKPinAnnotationView是MKAnnotationView的子类。
  • MKPinAnnotationView比MKAnnotationView多了2个属性。
@property (nonatomic) MKPinAnnotationColor pinColor;// 大头针颜色
@property (nonatomic) BOOL animatesDrop; // 大头针第一次显示时是否从天而降

results matching ""

    No results matching ""