一、概述
百度地圖 iOS SDK是一套基于iOS 5.0及以上版本設備的應用程序接口,不僅提供展示地圖的基本接口,還提供POI檢索、路徑規劃、地圖標注、離線地圖、定位、周邊雷達等豐富的LBS能力 。目前最新版本為 v2.9.1。
二、引入百度地圖API
1.?申請密鑰?在使用SDK之前需要獲取百度地圖移動版開發密鑰(Key),該key與你的百度賬戶相關聯。你必須先有百度帳戶,才能獲得key。并且,該key與引用SDK的程序包名有關, 地圖初始化時需要用到Key。
2.注意事項
1). 靜態庫中采用ObjectC++實現,因此需要您保證您工程中至少有一個.mm后綴的源文件(您可以將任意一個.m后綴的文件改名為.mm),或者在工程屬性中指定編譯方式,即將 Xcode 的 Project -> Edit Active Target -> Build -> GCC4.2 - Language -> Compile Sources As設置為"Objective-C++"
2). 如果您只在Xib文件中使用了BMKMapView,沒有在代碼中使用BMKMapView,編譯器在鏈接時不會鏈接對應符號,需要在工程屬性中顯式設定:在Xcode的Project -> Edit Active Target -> Build -> Linking -> Other Linker Flags中添加-ObjC
3). 由于iOS9改用更安全的https,為了能夠在iOS9中正常使用地圖SDK,請在"Info.plist"中進行如下配置,否則影響SDK的使用。
4). 如果在iOS9中使用了調起百度地圖客戶端功能,必須在"Info.plist"中進行如下配置,否則不能調起百度地圖客戶端。
5). 管理地圖的生命周期:自2.0.0起,BMKMapView新增viewWillAppear、viewWillDisappear方法來控制BMKMapView的生命周期,并且在一個時刻只能有一個BMKMapView接受回調消息,因此在使用BMKMapView的viewController中需要在viewWillAppear、viewWillDisappear方法中調用BMKMapView的對應的方法,并處理delegate,代碼如下:
6). 自iOS SDK v2.5.0起,為了對iOS8的定位能力做兼容,做了相應的修改,開發者在使用過程中注意事項如下:需要在info.plist里添加(以下二選一,兩個都添加默認使用NSLocationWhenInUseUsageDescription):
NSLocationWhenInUseUsageDescription ,允許在前臺使用時獲取GPS的描述
NSLocationAlwaysUsageDescription ,允許永久使用GPS的描述
7). 在使用Xcode 6進行SDK開發過程中,需要在info.plist中添加:Bundle?display?name?,且其值不能為空(Xcode 6新建的項目沒有此配置,若沒有會造成manager?start?failed)
8). 百度地圖iOS SDK v2.5.0起,對arm64進行了支持適配,開發包體積有所增加。但根據開發者在研發過程中的選擇,最終生成的APP體積并不會發生較大的變化。
9). 確認項目中添加mapapi.bundle文件以及添加方法正確,不能刪除或隨意更改其中files文件夾下的內容:
注:mapapi.bundle中存儲了定位、默認大頭針標注View及路線關鍵點的資源圖片,還存儲了矢量地圖繪制必需的資源文件。如果您不需要使用內置的圖片顯示功能,則可以刪除bundle文件中的image文件夾。您也可以根據具體需求任意替換或刪除該bundle中image文件夾的圖片文件。添加方式:將mapapi.bundle拷貝到您的工程目錄,直接將該bundle文件托拽至Xcode工程左側的Groups&Files中即可。若您需要替換定位、指南針的圖標,請保留原文件名稱,否則不顯示替換的新圖片,默認大頭針標注與路線關鍵點的新圖片名稱可自定義名稱。
10). 注意BMKManager對象的生命周期管理,在使用地圖SDK期間不能釋放該對象,尤其在arc情況下注意避免提前被自動釋放,否則,該對象一旦被釋放,網絡模塊將不可用,地圖無法加載,檢索失敗。
11). app在前后臺切換時,需要使用下面的代碼停止地圖的渲染和openGL的繪制:
3. 導入 SDK 開發包
百度地圖iOS SDK自v2.7.0版本起,向廣大開發者提供了 .framework形式的SDK開發包,這種形式的開發包配置簡單,使用方便,推薦大家使用。開發包有以下兩種配置方式:
1). 自動配置.framework形式開發包(使用CocoaPods)
注:此種方式只支持導入全量包的SDK,包含百度地圖iOS SDK所有功能
a. 前提:安裝CocoaPods
在終端輸入
sudo gem install cocoapods
如果安裝成功,會有一個提示
Successfully installed cocoaPods
b. 使用CocoaPods導入地圖SDK
在當前工程文件(.xcodeproj)所在文件夾下,打開terminal
I.創建Podfile:
$ touch Podfile
II.然后使用vim編輯Podfile文件,使用命令:
$ vim Podfile
III.編輯Podfile內容如下:
pod ‘BaiduMapKit‘, ‘~> 2.9.1‘
在編輯完成后按“esc”,再按“:”,這個時候輸入wq,點擊回車,保存并退出。
IV.在Podfile所在的文件夾下輸入命令:
$ pod install (這個可能比較慢,請耐心等待……)
成功以后,會出現如下記錄:
恭喜你已成功導入百度地圖iOS SDK,現在就可以打開xcworkspace文件,在你的項目中使用百度地圖SDK了.
2). 手動配置.framework形式開發包
a. 根據需要導入 .framework包
百度地圖 iOS SDK 采用分包的形式提供 .framework包,請廣大開發者使用時確保各分包的版本保持一致。其中BaiduMapAPI_Base.framework為基礎包,使用SDK任何功能都需導入,其他分包可按需導入。將所需的BaiduMapAPI_**.framework拷貝到工程所在文件夾下。
在 TARGETS->Build Phases-> Link Binary With Libaries中點擊“+”按鈕,在彈出的窗口中點擊“Add Other”按鈕,選擇BaiduMapAPI_**.framework添加到工程中。
注: 靜態庫中采用Objective-C++實現,因此需要您保證您工程中至少有一個.mm后綴的源文件(您可以將任意一個.m后綴的文件改名為.mm),或者在工程屬性中指定編譯方式,即將Xcode的Project -> Edit Active Target -> Build -> GCC4.2 - Language -> Compile Sources As設置為"Objective-C++"
b. 引入所需的系統庫
百度地圖SDK中提供了定位功能和動畫效果,v2.0.0版本開始使用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)
(注:紅色標識的系統庫為v2.9.0新增的系統庫,使用v2.9.0及以上版本的地圖SDK,務必增加導入這3個系統庫。)
添加方式:在Xcode的Project -> Active Target ->Build Phases ->Link Binary With Libraries,添加這幾個系統庫即可。
c. 環境配置
在TARGETS->Build Settings->Other Linker Flags 中添加-ObjC。
d. 引入mapapi.bundle資源文件
如果使用了基礎地圖功能,需要添加該資源,否則地圖不能正常顯示mapapi.bundle中存儲了定位、默認大頭針標注View及路線關鍵點的資源圖片,還存儲了矢量地圖繪制必需的資源文件。如果您不需要使用內置的圖片顯示功能,則可以刪除bundle文件中的image文件夾。您也可以根據具體需求任意替換或刪除該bundle中image文件夾的圖片文件。
方法:選中工程名,在右鍵菜單中選擇Add Files to “工程名”…,從BaiduMapAPI_Map.framework||Resources文件中選擇mapapi.bundle文件,并勾選“Copy items if needed”復選框,單擊“Add”按鈕,將資源文件添加到工程中。
e. 引入頭文件
4.初始化地圖
a. 初始化BMKMapManager
在AppDelegate.h文件中添加BMKMapManager的定義.
在AppDelegate.m文件中添加對BMKMapManager的初始化,并填入申請的授權Key,示例如下:
b. 創建BMKMapView
在ViewController.m文件中添加BMKMapView的創建代碼,示例如下:
自2.0.0起,BMKMapView新增viewWillAppear、viewWillDisappear方法來控制BMKMapView的生命周期,并且在一個時刻只能有一個BMKMapView接受回調消息,因此在使用BMKMapView的viewController中需要在viewWillAppear、viewWillDisappear方法中調用BMKMapView的對應的方法,并處理delegate,代碼如下:
編譯,運行,效果如下圖所示: