前言

本文是<iOS項目集成百度地圖2016.5>文章的后續，個人對百度地圖官方文檔的總結與補充。

1.準備工作

1.1導入頭文件

#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>//只引入所需的單個頭文件

1.2無論你使用哪種功能，都需要先啟動百度地圖管理工具

#import "AppDelegate.h"
#import <BaiduMapAPI_Map/BMKMapComponent.h>
@interface AppDelegate ()

@end
BMKMapManager* _mapManager;
@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    // 要使用百度地圖，請先啟動BaiduMapManager
    _mapManager = [[BMKMapManager alloc]init];
    BOOL ret = [_mapManager start:@"你在百度地圖開發平臺注冊應用的AppKey" generalDelegate:self];
    if (!ret) {
        NSLog(@"manager start failed!");
    }
    
    [self.window addSubview:navigationController.view];
    [self.window makeKeyAndVisible];
    return YES;
}
/**
 *  網絡檢查
 *
 *  @param iError 錯誤碼
 */
- (void)onGetNetworkState:(int)iError
{
    if (iError) {
        NSLog(@"%d", iError);
    } else {
        NSLog(@"網絡連接成功");
    }
}

- (void)onGetPermissionState:(int)iError
{
    if (0 == iError) {
        NSLog(@"授權成功");
    }
    else {
        NSLog(@"onGetPermissionState %d",iError);
    }   
}
@end

2.定位功能

2.1可以和地圖功能分離使用，單獨的定位功能使用方式如下：

-(void)viewDidLoad { //初始化BMKLocationService 
self.locService = [[BMKLocationService alloc]init]; 
self.locService.delegate = self; 
//啟動LocationService 
 [self.locService startUserLocationService];
 } 

//實現相關delegate 處理位置信息更新

 //處理東西南北的方向變更信息
 - (void)didUpdateUserHeading:(BMKUserLocation *)userLocation { 
//NSLog(@"heading is %@",userLocation.heading); 
} 
//處理位置坐標更新 

- (void)didUpdateBMKUserLocation:(BMKUserLocation *)userLocation { 
   // [self.locService stopUserLocationService];停止定位
    NSLog(@"當前的坐標是: 經度%.2f,緯度%.2f",userLocation.location.coordinate.longitude,userLocation.location.coordinate.latitude);
 }

2.2搭配地圖一起使用

-(void)viewDidLoad {

BMKMapView* mapView = [[BMKMapView alloc]initWithFrame:[UIScreen mainScreen].bounds];
    mapView.delegate=self;
    [self.view addSubview:mapView];
    self.mapView = mapView;

 //初始化BMKLocationService 
self.locService = [[BMKLocationService alloc]init]; 
self.locService.delegate = self; 
//啟動LocationService 
 [self.locService startUserLocationService];
 } 

//實現相關delegate 處理位置信息更新

 //處理東西南北的方向變更信息
 - (void)didUpdateUserHeading:(BMKUserLocation *)userLocation { 
//NSLog(@"heading is %@",userLocation.heading); 
} 
//處理位置坐標更新 

- (void)didUpdateBMKUserLocation:(BMKUserLocation *)userLocation { 
   // [self.locService stopUserLocationService];停止定位
    NSLog(@"當前的坐標是: 經度%.2f,緯度%.2f",userLocation.location.coordinate.longitude,userLocation.location.coordinate.latitude);
 }

3.檢索功能

百度地圖SDK提供的檢索服務包括以下功能模塊：POI檢索，公交方案檢索，駕車路線檢索，步行路線檢索，行政區邊界數據檢索，地理編碼，反地理編碼，公交詳情檢索，在線建議查詢，短串分享（包括POI搜索結果分享、駕車/公交/騎行/步行路線規劃分享、反向地理編碼結果分享）。

每個檢索功能模塊都包括一個主檢索對象，一個用于構造檢索參數的Option結構體，和一個用于接收檢索結果回調的Delegate，所有檢索服務都使用異步回調模式。使用檢索服務時，需要先初始化主檢索對象，然后通過主檢索對象以包含檢索參數的Option做為參數發起檢索，最后實現相應的檢索功能模塊的Delegate處理返回結果 。

3.1POI檢索

POI（Point of Interest），中文可以翻譯為“興趣點”。在地理信息系統中，一個POI可以是一棟房子、一個商鋪、一個郵筒、一個公交站等。

百度地圖SDK提供三種類型的POI檢索：周邊檢索、區域檢索和城市內檢索。
周邊檢索示例：
定義一個屬性，創建一個檢索對象，并且懶加載。

@property (nonatomic, strong) BMKPoiSearch *searcher;//poi檢索對象
-(BMKPoiSearch *)searcher{
    if (_searcher==nil) {
        _searcher =[[BMKPoiSearch alloc]init];
        _searcher.delegate = self;
    }
    return _searcher;
}

- (void)nearSearch:(BMKUserLocation *)userLocation{
    BMKNearbySearchOption *option = [[BMKNearbySearchOption alloc]init];
    
    // 分頁顯示默認第一頁
    option.pageIndex = 0;
    option.pageCapacity = 10;
    
    // 搜索的位置
    //手動指定位置
    //option.location = CLLocationCoordinate2D{23.35, 113.404};
   
    //自動獲取當前定位位置
    CLLocation *location = userLocation.location;
    option.location =location.coordinate;
    option.keyword = @"酒店";
    
    // 設置顯示區域
    BMKCoordinateSpan span = BMKCoordinateSpanMake(0.03, 0.03);
    BMKCoordinateRegion region = BMKCoordinateRegionMake(option.location, span);
    [_mapView setRegion:region animated:YES];
    
    // 開始搜索
    BOOL flag = [self.searcher poiSearchNearBy:option];
    
    if(flag)
    {
        NSLog(@"周邊檢索發送成功");
    }
    else
    {
        NSLog(@"周邊檢索發送失敗");
    }   
}

//實現PoiSearchDeleage處理回調結果

 - (void)onGetPoiResult:(BMKPoiSearch*)searcher result:(BMKPoiResult*)poiResultList errorCode:(BMKSearchErrorCode)error { 
if (error == BMK_SEARCH_NO_ERROR) { 
//在此處理正常結果  }
 else if (error == BMK_SEARCH_AMBIGUOUS_KEYWORD){
 //當在設置城市未找到結果，但在其他城市找到結果時，回調建議檢索城市列表 
 // result.cityList;  
NSLog(@"起始點有歧義"); 
} else {
 NSLog(@"抱歉，未找到結果"); 
} 
} 

//不使用時將delegate設置為 nil 
-(void)viewWillDisappear:(BOOL)animated {
 _searcher.delegate = nil; 
}