iOS 高德SDK应用实践（二）—— 自定义大头针AnnotationView

前言：
前段时间，在一个项目中需要自定义地图。于是，我们选择了接入了高德地图。
基于这次自定义地图的实践，总结一些使用上的一些小细节，并计划落地一系列地图相关的文章。
目录如下：
iOS 高德SDK应用实践（一）—— 简介与初始化地图
iOS 高德SDK应用实践（二）—— 自定义大头针AnnotationView
iOS 高德SDK应用实践（三）—— 自定义气泡CalloutView

---

本篇将介绍如何Annotation的默认简单用法，以及自定义大头针AnnotationView。

一、什么是AnnotationView？

AnnotationView是高德地图上的标注控件，可以根据经纬度在高德地图上展示的控件。因为默认是大头针样式，所以AnnotationView也被称作为“大头针”。

默认样式：

二、默认AnnotationView的简单使用

首先，AnnotationView是一个高德地图里的UI控件，每一个AnnotationView都会有一个Annotation与之对应。

因此，我们需要先初始化一个Annotation对象。

    func initAnnotationData() {
        
        let pointAnnotation = MAPointAnnotation()
        pointAnnotation.coordinate = CLLocationCoordinate2D(latitude: 39.98289153831738, longitude: 116.4903445241268)
        pointAnnotation.title = "360大厦"
        pointAnnotation.subtitle = "北京朝阳区酒仙桥路6号院电子城"
        mapView.addAnnotation(pointAnnotation)
    }

官方建议在viewDidAppear方法中调用。

    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        
        initAnnotationData()
    }

实现中的mapView:viewForAnnotation:回调方法。
与UITableView等类似，annotationView也有复用策略。

    /**
     * @brief 根据anntation生成对应的View。
     * @param mapView 地图View
     * @param annotation 指定的标注
     * @return 生成的标注View
     */
    func mapView(_ mapView: MAMapView!, viewFor annotation: MAAnnotation!) -> MAAnnotationView! {
        
        if annotation.isKind(of: MAPointAnnotation.self) {
            let pointReuseIndetifier = "pointReuseIndetifier"
            var annotationView: MAPinAnnotationView? = mapView.dequeueReusableAnnotationView(withIdentifier: pointReuseIndetifier) as! MAPinAnnotationView?
            
            if annotationView == nil {
                annotationView = MAPinAnnotationView(annotation: annotation, reuseIdentifier: pointReuseIndetifier)
            }
            
            annotationView!.canShowCallout = true
            annotationView!.animatesDrop = true
            annotationView!.isDraggable = true
            annotationView!.rightCalloutAccessoryView = UIButton(type: UIButton.ButtonType.detailDisclosure)
            
            return annotationView!
        }
        
        return nil
    }

效果如下图：

---

三、如何自定义AnnotationView？

• 第一步：首先，新建一个类，继承与MAAnnotationView。
  我们给他个名字CustomAnnotationVIew。

像自定义UIView那样，重写它的init方法。

override init!(annotation: MAAnnotation!, reuseIdentifier: String!) {
        super.init(annotation: annotation, reuseIdentifier: reuseIdentifier)
        
        // ...

        self.addSubview(xxxView)
    }

根据我们的需求，自定义这个CustomAnnotationView。

• 第二步：修改中的mapView:viewForAnnotation:回调方法。

在所有AnnotationView中，有一个特殊的AnnotationView。它就是用来展示当前用户定位的AnnotationView。默认是个“小蓝点”。
我们就以这个小蓝点为例，来自定义这个AnnotationView。

那我们如何区分定位小蓝点与其他AnnotationView呢？

每个AnnotationView对应一个Annotation。而区分的标志就是看Annotation的Type。

名称	类型
定位点AnnotationView	MAUserLocation
普通AnnotationView	MAPointAnnotation

同理，如果我们想自定义普通AnnotationView，就修改MAPointAnnotation下的AnnotationView生成方法。

    /**
     * @brief 根据anntation生成对应的View。
     * @param mapView 地图View
     * @param annotation 指定的标注
     * @return 生成的标注View
     */
    func mapView(_ mapView: MAMapView!, viewFor annotation: MAAnnotation!) -> MAAnnotationView! {
        
        // 改变用户定位的Annotation
        if annotation.isKind(of: MAUserLocation.self) {

            userAnnotationView = CustomAnnotationView(annotation: annotation, reuseIdentifier: "UserLocationId") as CustomAnnotationView
            userAnnotationView?.annotation = annotation

            userAnnotationView?.headBoaderColor = .red
            userAnnotationView?.headImage = UIImage.init(named: "QiShare")!
            userAnnotationView?.canShowCallout = false
            userAnnotationView?.tag = userAnnotationViewTag
            userAnnotationView?.zIndex = 360 // 控制annotationView的层级，zIndex值越大越在上层
            
            return userAnnotationView!
        }

        // 改变普通标注的AnnotationView
        if annotation.isKind(of: MAPointAnnotation.self) {
            let pointReuseIndetifier = "pointReuseIndetifier"
            var annotationView: MAPinAnnotationView? = mapView.dequeueReusableAnnotationView(withIdentifier: pointReuseIndetifier) as! MAPinAnnotationView?
            
            if annotationView == nil {
                annotationView = MAPinAnnotationView(annotation: annotation, reuseIdentifier: pointReuseIndetifier)
            }
            
            annotationView!.canShowCallout = true
            annotationView!.animatesDrop = true
            annotationView!.isDraggable = true
            annotationView!.rightCalloutAccessoryView = UIButton(type: UIButton.ButtonType.detailDisclosure)
            
            return annotationView!
        }
        
        return nil
    }

这样我们就自定义了定位AnnotationView。效果如下图：

最后，更多详细信息，请参考：高德地图官方文档