百度地图定义大头针和聚合点

在文章的末尾有Demo，想看代码的朋友直接翻到最后吧。

1、集成百度地图需要的注意事项

• 1、静态库中采用ObjectC++实现，因此需要您保证您工程中至少有一个.mm后缀的源文件(您可以将任意一个.m后缀的文件改名为.mm)，或者在工程属性中指定编译方式，即在Xcode的Project -> Edit Active Target -> Build Setting 中找到 Compile Sources As，并将其设置为"Objective-C++"

• 2、如果您只在Xib文件中使用了BMKMapView，没有在代码中使用BMKMapView，编译器在链接时不会链接对应符号，需要在工程属性中显式设定：在Xcode的Project -> Edit Active Target -> Build Setting -> Other Linker Flags中添加-ObjC

• 3、iOS9之后改用更安全的https，为了能够在iOS9中正常使用地图SDK，在"Info.plist"中进行如下配置，否则影响SDK的使用

<key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>

• 4、如果在iOS9中使用了调起百度地图客户端功能，必须在"Info.plist"中添加白名单，进行如下配置，否则不能调起百度地图客户端。

<key>LSApplicationQueriesSchemes</key>
    <array>
        <string>baidumap</string>
    </array>

• 5、管理地图的生命周期：自2.0.0起，BMKMapView新增viewWillAppear、viewWillDisappear方法来控制BMKMapView的生命周期，并且在一个时刻只能有一个BMKMapView接受回调消息，因此在使用BMKMapView的viewController中需要在viewWillAppear、viewWillDisappear方法中调用BMKMapView的对应的方法，并处理delegate，代码如下

-(void)viewWillAppear:(BOOL)animated      
{      
    [_mapView viewWillAppear];      
    _mapView.delegate = self; // 此处记得不用的时候需要置nil，否则影响内存的释放      
}      
-(void)viewWillDisappear:(BOOL)animated      
{      
       [_mapView viewWillDisappear];      
      _mapView.delegate = nil; // 不用时，置nil      
}

• 6、iOS SDK v2.5.0起，为了对iOS8的定位能力做兼容，做了相应的修改，开发者在使用过程中注意事项如下： 需要在info.plist里添加（以下二选一，两个都添加默认使用NSLocationWhenInUseUsageDescription）：
  NSLocationWhenInUseUsageDescription ，允许在前台使用时获取GPS的描述
  NSLocationAlwaysUsageDescription ，允许永久使用GPS的描述

• 7、在使用Xcode6进行SDK开发过程中，需要在info.plist中添加：Bundle display name ，且其值不能为空（Xcode6新建的项目没有此配置，若没有会造成manager start failed）

• 8、确认项目中添加mapapi.bundle文件以及添加方法正确，不能删除或随意更改其中files文件夹下的内容：
  注：mapapi.bundle中存储了定位、默认大头针标注View及路线关键点的资源图片，还存储了矢量地图绘制必需的资源文件。如果您不需要使用内置的图片显示功能，则可以删除bundle文件中的image文件夹。您也可以根据具体需求任意替换或删除该bundle中image文件夹的图片文件。添加方式：将mapapi.bundle拷贝到您的工程目录，直接将该bundle文件托拽至Xcode工程左侧的Groups&Files中即可。若您需要替换定位、指南针的图标，请保留原文件名称，否则不显示替换的新图片，默认大头针标注与路线关键点的新图片名称可自定义名称。
其实上面这种替换方法还是利用百度写好的代码，我感觉好的做法是自己继承基础类，然后实现大头针的图片，我给的代码中也是用的这种方法

• 9、app在前后台切换时，需要使用下面的代码停止地图的渲染和openGL的绘制（V2.10.0后不需要再调用）：现在我们使用的是V2.10.2，所以这段代码不用写

- (void)applicationWillResignActive:(UIApplication *)application {
    [BMKMapView willBackGround];//当应用即将后台时调用，停止一切调用opengl相关的操作
}
- (void)applicationDidBecomeActive:(UIApplication *)application {
    [BMKMapView didForeGround];//当应用恢复前台状态时调用，回复地图的渲染和opengl相关的操作
}

2、配置开发环境

• 方式一、pod 'BaiduMapKit' #百度地图SDK

  • 我一般都是用pod安转

• 方式二、手动导入需要的包

  • 1、注意：BaiduMapAPI_Base.framework是基础包，集成中都需要导入，其余的包按需要导入
  • 2、在 TARGETS->Build Phases -> Link Binary With Libaries中点击“+”按钮，在弹出的窗口中点击“Add Other”按钮，选择BaiduMapAPI_**.framework添加到工程中。
  • 3、需要导入的系统类库CoreLocation.framework、QuartzCore.framework、OpenGLES.framework、SystemConfiguration.framework、CoreGraphics.framework、Security.framework、libsqlite3.0.tbd、CoreTelephony.framework 、libstdc++.6.0.9.tbd
  • 4、TARGETS->Build Settings->Other Linker Flags 中添加-ObjC
  • 5、引入mapapi.bundle资源文件：

  如果使用了基础地图功能，需要添加该资源，否则地图不能正常显示mapapi.bundle中存储了定位、默认大头针标注View及路线关键点的资源图片，还存储了矢量地图绘制必需的资源文件。如果您不需要使用内置的图片显示功能，则可以删除bundle文件中的image文件夹。您也可以根据具体需求任意替换或删除该bundle中image文件夹的图片文件。

  方法：选中工程名，在右键菜单中选择Add Files to “工程名”…，从BaiduMapAPI_Map.framework||Resources文件中选择mapapi.bundle文件，并勾选“Copy items if needed”复选框，单击“Add”按钮，将资源文件添加到工程中。

  • 6、引入头文件

  import <BaiduMapAPI_Base/BMKBaseComponent.h>//引入base相关所有的头文件
  
  import <BaiduMapAPI_Map/BMKMapComponent.h>//引入地图功能所有的头文件
  
  import <BaiduMapAPI_Search/BMKSearchComponent.h>//引入检索功能所有的头文件
  
  import <BaiduMapAPI_Cloud/BMKCloudSearchComponent.h>//引入云检索功能所有的头文件
  
  import <BaiduMapAPI_Location/BMKLocationComponent.h>//引入定位功能所有的头文件
  
  import <BaiduMapAPI_Utils/BMKUtilsComponent.h>//引入计算工具所有的头文件
  
  import <BaiduMapAPI_Radar/BMKRadarComponent.h>//引入周边雷达功能所有的头文件
  
  import < BaiduMapAPI_Map/BMKMapView.h>//只引入所需的单个头文件
  

3、百度地图集成过程中一些概念的介绍

• 1、地图覆盖物: 地图上自定义的标注点和覆盖物统称为地图覆盖物。

  • 您可以通过定制BMKAnnotation和BMKOverlay来添加对应的标注点和覆盖物

  • 地图覆盖物的设计遵循数据与View分离的原则，BMKAnnotation和BMKOverlay系列的类主要用来存放覆盖物相关的数据，BMKAnnotaionView和BMKOverlayView系列类为覆盖物对应的View

  • SDK支持画点、折线、圆、多边形（包括凹凸两种）、图片图层和自定义覆盖物。从2.0.0开始矢量地图采用OpenGL绘制，新增支持OpenGL绘制的基本线绘制、面绘制接口。详见AnnotationDemo，SDK内置的BMKPolylineOverlay、BMKPolygonOverlay，BMKCircleOverlay均采用OpenGL绘制。

  • 在实际的开发过程中，我们需要经常的继承这个两个（BMKAnnotation和BMKAnnotationView），注意一点就是继承BMKAnnotation的时候需要遵守BMKAnnotation协议；如果我们项目中只需要添加大头针的话，上面这两个就完全够用；Overlay这个主要就在mapView上画一些线啊、圈一个圆形区域啊等操作，我在工程中用的不多，只是学习的时候，按照官方Demo敲过几次

• 2、百度地图SDK也预置了基本的标注点（BMKPointAnnotation）和一个大头针标注View（BMKPinAnnotationView）其实这两个就是继承自BMKAnnotation和BMKAnnotationView）的，是百度自己简单封装的，一般我不怎么用这两个，我是自己从新继承封装个新的用

4、项目中需要自定义大头针和聚合功能

• 1、先说自定义大头针

• 1、 大头针分两种

  • 1、BMKPinAnnotationView：他是系统自带的大头针，继承于MKAnnotationView，形状跟棒棒糖类似，可以设置糖的颜色，和显示的时候是否有动画效果

  • 2、BMKAnnotationView：可以用指定的图片作为大头针的样式，但显示的时候没有动画效果，如果没有给图片的话会什么都不显示

  • 3 、mapview有个代理方法，当大头针显示在试图上时会调用，可以实现这个方法来自定义大头针的动画效果，我下面写有可以参考一下

  • BMKPinAnnotationView是百度自己写的一个大头针继承类，所以我们的思路应该是学习百度，也自己写一个继承BMKAnnotationView类的自定义大头针继承类。

5、需要经常用的几个代理方法

#pragma mark - MapDelgate
- (void)mapViewDidFinishLoading:(BMKMapView *)mapView
{
// 这个方法是当地图加载完成后会走的一个方法，一般把在mapView上添加其他控件的方法，写在这里

    // 添加系统大头针
//    [self addAnnotation];
    
    // 添加自定义大头针
//    [self addCustomAonnotation];
    
    // 添加聚合点 注意：使用聚合的时候，需要把上面两个给注释掉
    [self updateClusters];
}

/**
 *地图渲染每一帧画面过程中，以及每次需要重绘地图时（例如添加覆盖物）都会调用此接口
 *@param mapview 地图View
 *@param status 此时地图的状态
 */
- (void)mapView:(BMKMapView *)mapView onDrawMapFrame:(BMKMapStatus *)status {
    if (_clusterZoom != 0 && _clusterZoom != (NSInteger)mapView.zoomLevel) {
        // 所以每当地图放大或者缩小的时候，我们都应该调用这个方法，重新计算大头针，这个方法是在写聚合点的时候必须不断调用的一个方法
        [self updateClusters];
    }
}

// 这个代理方法是最常用的一个，一般在mapView上添加点什么东西，最后都要走这个方法
- (BMKAnnotationView *)mapView:(BMKMapView *)mapView viewForAnnotation:(id<BMKAnnotation>)annotation
{
}

#pragma mark - LoactionServiceDelegate
// 这是定位的时候使用的代理方法，一般在导航、线路规划的时候用的较多，我这个工程中就是顺手学过
// 当前用户朝向更新
- (void)didUpdateUserHeading:(BMKUserLocation *)userLocation
{
    NSLog(@"heading is %@",userLocation.heading);
    [_mapView updateLocationData:userLocation];
}
//处理位置坐标更新
- (void)didUpdateBMKUserLocation:(BMKUserLocation *)userLocation
{
}

• 总结下需要注意的地方

• 在做聚合点的时候，百度写了个几个类帮我们计算，在官方demo中，用pod安转的话，应该没有，所以我们需要手动导入，类的文件夹名字是cluster

• 做定位的时候，我们需要在infoPlist文件中加入NSLocationWhenInUseUsageDescription 或者加入NSLocationAlwaysUsageDescription。我们开始定位后，还需要设置定位的状态和显示定位图层，这样我们才能看到我们的位置

• 我个人碰见的坑，在网上搜集的一些经纬度，要注意看好是百度地图使用的才好，否则会有误差，我就碰见过误差很大的

• 百度地图的头文件是用Component结尾的那个，一开始我也没有找到

• 搞明白后还是挺简单的，高德地图的原理和百度是相通的

• 最后工程文件太大了，我就放在百度云中了

• 链接: http://pan.baidu.com/s/1geYx1sf 密码: f8ew