iOS地图的显示(大头针)

1.导入主头文件
       #import <MapKit/MapKit.h>
  MapKit框架使用须知
  MapKit框架中所有数据类型的前缀都是MK
  MapKit有一个比较重要的UI控件：MKMapView，专门用于地图显示

2.跟踪显示用户的位置

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

可以通过设置MKMapView的mapType设置地图类型（mapViewType是枚举类型）
MKMapTypeStandard // 普通地图（左图）
MKMapTypeSatellite // 卫星云图 （中图）
MKMapTypeHybrid // 普通地图覆盖于卫星云图之上（右图）
MKMapTypeSatelliteFlyover NS_ENUM_AVAILABLE(10_11, 9_0) // 地形和建筑物的三维模型
MKMapTypeHybridFlyover NS_ENUM_AVAILABLE(10_11, 9_0) // 显示道路和附加元素的Flyover

MKMapView可以设置一个代理对象，用来监听地图的相关行为，常见的代理方法有：

// 一个位置更改默认只会调用一次，不断监测用户的当前位置时每次都会调用这个方法，把用户的最新位置（userLocation参数）传进来.

- (void)mapView:(MKMapView *)mapView didUpdateUserLocation:(MKUserLocation *)userLocation;

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

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

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

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

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

通过MKMapView的下列方法，可以设置地图显示的位置和区域
// 设置地图的中心点位置
@property (nonatomic) CLLocationCoordinate2D centerCoordinate;

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

@property (nonatomic) MKCoordinateRegion region;
- (void)setRegion:(MKCoordinateRegion)region animated:(BOOL)animated;

大头针模型

新建一个大头针模型类
#import <MapKit/MapKit.h>
@interface MyAnnonation : NSObject <MKAnnotation>
/** 坐标位置 */
@property (nonatomic, assign) CLLocationCoordinate2D coordinate;
/** 标题 */
@property (nonatomic, copy) NSString *title; 
/** 子标题 */
@property (nonatomic, copy) NSString *subtitle; 
@end

#pragma mark - 添加大头针
- (void)addAnnotation
{
    // 设置位置
    CLLocationCoordinate2D location1 = CLLocationCoordinate2DMake(40, 116);
    MyAnnotation *annotation = [[MyAnnotation alloc] init];
    
    annotation.coordinate = location1;
    annotation.title = @"BeiJing";
    annotation.subtitle = @"Myhome";
#warning 添加代码
    annotation.image = [UIImage imageNamed:@"88"];
    [_mapView addAnnotation:annotation];
    MyAnnotation *annotation2 = [[MyAnnotation alloc] init];
    CLLocationCoordinate2D location2 = CLLocationCoordinate2DMake(39, 121);
    annotation2.coordinate = location2;
    annotation2.title = @"DaLian";
    annotation2.subtitle = @"Hishome";
    [_mapView addAnnotation:annotation2];
    MyAnnotation *annotation3 = [[MyAnnotation alloc] init];

    CLLocationCoordinate2D location3 = CLLocationCoordinate2DMake(34, 113);
    annotation3.coordinate = location3;
    annotation3.title = @"zhengzhou";
    annotation3.subtitle = @"herhome";
    [_mapView addAnnotation:annotation3];
}

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


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

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

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

自定义大头针

设置MKMapView的代理
实现下面的代理方法，返回大头针控件

- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id <MKAnnotation>)annotation;
根据传进来的(id <MKAnnotation>)annotation参数创建并返回对应的大头针控件
代理方法的使用注意
如果返回nil，显示出来的大头针就采取系统的默认样式

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

因此，需要在代理方法中分清楚(id <MKAnnotation>)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是MKAnnotationView的子类

MKPinAnnotationView比MKAnnotationView多了2个属性

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

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

CLLocationManager 定位的基础信息 
CLLocation  位置的地理信息
CLLocationCoordinate2D  存放经纬度的结构体
CLGeocoder地理位置编码与反编码的类
CLPlacemark 地标.
MKMapView 基础地图 
MKUserLocation  大头针模型
MKCoordinateRegion  显示区域的结构体
MKAnnotationView 自定义大头针控件

#import "ViewController.h"

// 地图使用的框架是MapKit
// 引入框架
#import <MapKit/MapKit.h>
#import <CoreLocation/CoreLocation.h>
#import "MyAnnotation.h"
@interface ViewController ()<MKMapViewDelegate>

// 定位管理器
@property (nonatomic, strong) CLLocationManager *locationManager;

// 显示地图的视图
@property (nonatomic, strong) MKMapView *mapView;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.
    /*
    大头针：
    在iOS开发中经常会标记某个位置，需要使用地图标注，也就是大家俗称的“大头针”。只要一个NSObject类实现MKAnnotation协议就可以作为一个大头针，通常会重写协议中coordinate（标记位置）、title（标题）、subtitle（子标题）三个属性，然后在程序中创建大头针对象并调用addAnnotation:方法添加大头针即可（之所以iOS没有定义一个基类实现这个协议供开发者使用，多数原因应该是MKAnnotation是一个模型对象，对于多数应用模型会稍有不同，例如后面的内容中会给大头针模型对象添加其他属性）。
    */
    // 创建视图
    [self createMapView];

}

#pragma mark - 创建视图
- (void)createMapView
{
    // 创建地图,并添加到当前视图上
    self.mapView = [[MKMapView alloc] initWithFrame:[UIScreen mainScreen].bounds];
    [self.view addSubview:self.mapView];
    // 设置代理
    _mapView.delegate = self;
    
    // 定位的设置
    self.locationManager = [[CLLocationManager alloc] init];
    // 判断是否可用
    if (![CLLocationManager locationServicesEnabled]) {
        NSLog(@"当前设备定位不可用");
    }
    //
    if ([CLLocationManager authorizationStatus] != kCLAuthorizationStatusAuthorizedWhenInUse) {
        [self.locationManager requestWhenInUseAuthorization];
    }
    
    // 设置地图的定位追踪
    _mapView.userTrackingMode = MKUserTrackingModeFollow;
    
    // 设置地图的类型
    _mapView.mapType = MKMapTypeStandard;
    
    // 添加大头针
    [self addAnnotation];
    
}

#pragma mark - 添加大头针
- (void)addAnnotation
{
    // 设置位置
    CLLocationCoordinate2D location1 = CLLocationCoordinate2DMake(40, 116);
    MyAnnotation *annotation = [[MyAnnotation alloc] init];
    
    annotation.coordinate = location1;
    annotation.title = @"BeiJing";
    annotation.subtitle = @"Myhome";
#warning 添加代码
    annotation.image = [UIImage imageNamed:@"88"];
    [_mapView addAnnotation:annotation];
    MyAnnotation *annotation2 = [[MyAnnotation alloc] init];
    CLLocationCoordinate2D location2 = CLLocationCoordinate2DMake(39, 121);
    annotation2.coordinate = location2;
    annotation2.title = @"DaLian";
    annotation2.subtitle = @"Hishome";
    [_mapView addAnnotation:annotation2];
    MyAnnotation *annotation3 = [[MyAnnotation alloc] init];

    CLLocationCoordinate2D location3 = CLLocationCoordinate2DMake(34, 113);
    annotation3.coordinate = location3;
    annotation3.title = @"zhengzhou";
    annotation3.subtitle = @"herhome";
    [_mapView addAnnotation:annotation3];
}

#pragma mark - 代理方法
- (void)mapView:(MKMapView *)mapView didUpdateUserLocation:(MKUserLocation *)userLocation
{
    NSLog(@"=====%@", userLocation);
}

#pragma mark - 实现自定义大头针视图的代理方法
// 显示大头针的时候才会调用
- (MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id<MKAnnotation>)annotation
{
    // 判断是否是当前自定义的大头针类
    if ([annotation isKindOfClass:[MyAnnotation class]]) {
        
        // 先定义一个重用标识
        static NSString *identifier = @"Annotation";
        MKAnnotationView *annotationView =[_mapView dequeueReusableAnnotationViewWithIdentifier:identifier];
        // 重用机制
        if (!annotationView) {
            annotationView = [[MKAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:identifier];
            // 允许用户交互
            annotationView.canShowCallout = YES;
            // 设置详情和大头针的头偏移量
            annotationView.calloutOffset = CGPointMake(0, 1);
            // 设置详情的左视图
            annotationView.leftCalloutAccessoryView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"88"]];
            
        }
        // 修改大头针视图

        annotationView.annotation = annotation;
        // 强转
        annotationView.image = ((MyAnnotation *)annotation).image;
        
        return annotationView;
        
        
    } else {
        return nil;
    }
}