一、概述

百度地圖 iOS SDK是一套基于iOS 5.0及以上版本設(shè)備的應(yīng)用程序接口熄赡，不僅提供展示地圖的基本接口猾普，還提供POI檢索、路徑規(guī)劃本谜、地圖標(biāo)注初家、離線(xiàn)地圖、定位乌助、周邊雷達(dá)等豐富的LBS能力 溜在。目前最新版本為 v2.9.1。

二他托、引入百度地圖API

1.?申請(qǐng)密鑰?在使用SDK之前需要獲取百度地圖移動(dòng)版開(kāi)發(fā)密鑰（Key）掖肋，該key與你的百度賬戶(hù)相關(guān)聯(lián)。你必須先有百度帳戶(hù)赏参，才能獲得key志笼。并且，該key與引用SDK的程序包名有關(guān), 地圖初始化時(shí)需要用到Key把篓。

2.注意事項(xiàng)

1). 靜態(tài)庫(kù)中采用ObjectC++實(shí)現(xiàn)纫溃，因此需要您保證您工程中至少有一個(gè).mm后綴的源文件(您可以將任意一個(gè).m后綴的文件改名為.mm)，或者在工程屬性中指定編譯方式韧掩，即將 Xcode 的 Project -> Edit Active Target -> Build -> GCC4.2 - Language -> Compile Sources As設(shè)置為"Objective-C++"

2). 如果您只在Xib文件中使用了BMKMapView紊浩，沒(méi)有在代碼中使用BMKMapView，編譯器在鏈接時(shí)不會(huì)鏈接對(duì)應(yīng)符號(hào)，需要在工程屬性中顯式設(shè)定：在Xcode的Project -> Edit Active Target -> Build -> Linking -> Other Linker Flags中添加-ObjC

3). 由于iOS9改用更安全的https坊谁，為了能夠在iOS9中正常使用地圖SDK费彼，請(qǐng)?jiān)?Info.plist"中進(jìn)行如下配置，否則影響SDK的使用口芍。

4). 如果在iOS9中使用了調(diào)起百度地圖客戶(hù)端功能箍铲，必須在"Info.plist"中進(jìn)行如下配置，否則不能調(diào)起百度地圖客戶(hù)端鬓椭。

5). 管理地圖的生命周期：自2.0.0起虹钮，BMKMapView新增viewWillAppear、viewWillDisappear方法來(lái)控制BMKMapView的生命周期膘融，并且在一個(gè)時(shí)刻只能有一個(gè)BMKMapView接受回調(diào)消息芙粱，因此在使用BMKMapView的viewController中需要在viewWillAppear、viewWillDisappear方法中調(diào)用BMKMapView的對(duì)應(yīng)的方法氧映，并處理delegate春畔，代碼如下：

6). 自iOS SDK v2.5.0起，為了對(duì)iOS8的定位能力做兼容岛都，做了相應(yīng)的修改律姨，開(kāi)發(fā)者在使用過(guò)程中注意事項(xiàng)如下：需要在info.plist里添加（以下二選一，兩個(gè)都添加默認(rèn)使用NSLocationWhenInUseUsageDescription）：

NSLocationWhenInUseUsageDescription 臼疫，允許在前臺(tái)使用時(shí)獲取GPS的描述

NSLocationAlwaysUsageDescription 择份，允許永久使用GPS的描述

7). 在使用Xcode 6進(jìn)行SDK開(kāi)發(fā)過(guò)程中，需要在info.plist中添加：Bundle?display?name?烫堤，且其值不能為空（Xcode 6新建的項(xiàng)目沒(méi)有此配置荣赶，若沒(méi)有會(huì)造成manager?start?failed）

8). 百度地圖iOS SDK v2.5.0起，對(duì)arm64進(jìn)行了支持適配鸽斟，開(kāi)發(fā)包體積有所增加拔创。但根據(jù)開(kāi)發(fā)者在研發(fā)過(guò)程中的選擇，最終生成的APP體積并不會(huì)發(fā)生較大的變化富蓄。

9). 確認(rèn)項(xiàng)目中添加mapapi.bundle文件以及添加方法正確剩燥，不能刪除或隨意更改其中files文件夾下的內(nèi)容：

注：mapapi.bundle中存儲(chǔ)了定位、默認(rèn)大頭針標(biāo)注View及路線(xiàn)關(guān)鍵點(diǎn)的資源圖片立倍，還存儲(chǔ)了矢量地圖繪制必需的資源文件灭红。如果您不需要使用內(nèi)置的圖片顯示功能，則可以刪除bundle文件中的image文件夾口注。您也可以根據(jù)具體需求任意替換或刪除該bundle中image文件夾的圖片文件变擒。添加方式：將mapapi.bundle拷貝到您的工程目錄，直接將該bundle文件托拽至Xcode工程左側(cè)的Groups&Files中即可疆导。若您需要替換定位赁项、指南針的圖標(biāo)葛躏，請(qǐng)保留原文件名稱(chēng)澈段，否則不顯示替換的新圖片悠菜，默認(rèn)大頭針標(biāo)注與路線(xiàn)關(guān)鍵點(diǎn)的新圖片名稱(chēng)可自定義名稱(chēng)。

10). 注意BMKManager對(duì)象的生命周期管理败富，在使用地圖SDK期間不能釋放該對(duì)象悔醋，尤其在arc情況下注意避免提前被自動(dòng)釋放，否則兽叮，該對(duì)象一旦被釋放芬骄，網(wǎng)絡(luò)模塊將不可用，地圖無(wú)法加載鹦聪，檢索失敗账阻。

11). app在前后臺(tái)切換時(shí)，需要使用下面的代碼停止地圖的渲染和openGL的繪制：

3. 導(dǎo)入 SDK 開(kāi)發(fā)包

百度地圖iOS SDK自v2.7.0版本起泽本，向廣大開(kāi)發(fā)者提供了 .framework形式的SDK開(kāi)發(fā)包淘太，這種形式的開(kāi)發(fā)包配置簡(jiǎn)單，使用方便规丽，推薦大家使用蒲牧。開(kāi)發(fā)包有以下兩種配置方式:

1). 自動(dòng)配置.framework形式開(kāi)發(fā)包（使用CocoaPods）

注：此種方式只支持導(dǎo)入全量包的SDK，包含百度地圖iOS SDK所有功能

a. 前提：安裝CocoaPods

在終端輸入

sudo gem install cocoapods

如果安裝成功赌莺，會(huì)有一個(gè)提示

Successfully installed cocoaPods

b. 使用CocoaPods導(dǎo)入地圖SDK

在當(dāng)前工程文件（.xcodeproj）所在文件夾下冰抢，打開(kāi)terminal

I.創(chuàng)建Podfile：

$ touch Podfile

II.然后使用vim編輯Podfile文件，使用命令：

$ vim Podfile

III.編輯Podfile內(nèi)容如下:

pod ‘BaiduMapKit‘, ‘~> 2.9.1‘

在編輯完成后按“esc”艘狭，再按“:”,這個(gè)時(shí)候輸入wq,點(diǎn)擊回車(chē)挎扰，保存并退出。

IV.在Podfile所在的文件夾下輸入命令：

$ pod install （這個(gè)可能比較慢巢音，請(qǐng)耐心等待……）

成功以后鼓鲁，會(huì)出現(xiàn)如下記錄：

恭喜你已成功導(dǎo)入百度地圖iOS SDK，現(xiàn)在就可以打開(kāi)xcworkspace文件港谊，在你的項(xiàng)目中使用百度地圖SDK了.

2). 手動(dòng)配置.framework形式開(kāi)發(fā)包

a. 根據(jù)需要導(dǎo)入 .framework包

百度地圖 iOS SDK 采用分包的形式提供 .framework包骇吭，請(qǐng)廣大開(kāi)發(fā)者使用時(shí)確保各分包的版本保持一致。其中BaiduMapAPI_Base.framework為基礎(chǔ)包歧寺，使用SDK任何功能都需導(dǎo)入燥狰，其他分包可按需導(dǎo)入。將所需的BaiduMapAPI_**.framework拷貝到工程所在文件夾下斜筐。

在 TARGETS->Build Phases-> Link Binary With Libaries中點(diǎn)擊“+”按鈕龙致，在彈出的窗口中點(diǎn)擊“Add Other”按鈕，選擇BaiduMapAPI_**.framework添加到工程中顷链。

注: 靜態(tài)庫(kù)中采用Objective-C++實(shí)現(xiàn)目代，因此需要您保證您工程中至少有一個(gè).mm后綴的源文件(您可以將任意一個(gè).m后綴的文件改名為.mm)，或者在工程屬性中指定編譯方式，即將Xcode的Project -> Edit Active Target -> Build -> GCC4.2 - Language -> Compile Sources As設(shè)置為"Objective-C++"

b. 引入所需的系統(tǒng)庫(kù)

百度地圖SDK中提供了定位功能和動(dòng)畫(huà)效果榛了，v2.0.0版本開(kāi)始使用OpenGL渲染在讶，因此您需要在您的Xcode工程中引入?

CoreLocation.framework?

QuartzCore.framework

OpenGLES.framework

SystemConfiguration.framework

CoreGraphics.framework

Security.framework

libsqlite3.0.tbd（xcode7以前為 libsqlite3.0.dylib）

CoreTelephony.framework?

libstdc++.6.0.9.tbd（xcode7以前為 libstdc++.6.0.9.dylib）

（注：紅色標(biāo)識(shí)的系統(tǒng)庫(kù)為v2.9.0新增的系統(tǒng)庫(kù)，使用v2.9.0及以上版本的地圖SDK霜大，務(wù)必增加導(dǎo)入這3個(gè)系統(tǒng)庫(kù)构哺。）

添加方式：在Xcode的Project -> Active Target ->Build Phases ->Link Binary With Libraries，添加這幾個(gè)系統(tǒng)庫(kù)即可战坤。

c. 環(huán)境配置

在TARGETS->Build Settings->Other Linker Flags 中添加-ObjC曙强。

d. 引入mapapi.bundle資源文件

如果使用了基礎(chǔ)地圖功能，需要添加該資源途茫，否則地圖不能正常顯示mapapi.bundle中存儲(chǔ)了定位碟嘴、默認(rèn)大頭針標(biāo)注View及路線(xiàn)關(guān)鍵點(diǎn)的資源圖片，還存儲(chǔ)了矢量地圖繪制必需的資源文件囊卜。如果您不需要使用內(nèi)置的圖片顯示功能娜扇，則可以刪除bundle文件中的image文件夾。您也可以根據(jù)具體需求任意替換或刪除該bundle中image文件夾的圖片文件边败。

方法：選中工程名袱衷，在右鍵菜單中選擇Add Files to “工程名”…，從BaiduMapAPI_Map.framework||Resources文件中選擇mapapi.bundle文件笑窜，并勾選“Copy items if needed”復(fù)選框致燥，單擊“Add”按鈕，將資源文件添加到工程中排截。

e. 引入頭文件

4.初始化地圖

a. 初始化BMKMapManager

在AppDelegate.h文件中添加BMKMapManager的定義.

在AppDelegate.m文件中添加對(duì)BMKMapManager的初始化嫌蚤，并填入申請(qǐng)的授權(quán)Key，示例如下:

b. 創(chuàng)建BMKMapView

在ViewController.m文件中添加BMKMapView的創(chuàng)建代碼断傲，示例如下:

自2.0.0起脱吱，BMKMapView新增viewWillAppear、viewWillDisappear方法來(lái)控制BMKMapView的生命周期认罩，并且在一個(gè)時(shí)刻只能有一個(gè)BMKMapView接受回調(diào)消息箱蝠，因此在使用BMKMapView的viewController中需要在viewWillAppear、viewWillDisappear方法中調(diào)用BMKMapView的對(duì)應(yīng)的方法垦垂，并處理delegate宦搬，代碼如下：

編譯，運(yùn)行劫拗，效果如下圖所示：