iOS 百度地圖v2.9.1 API 的詳細使用(一)

一、概述

百度地圖 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,代碼如下:

編譯,運行,效果如下圖所示:

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,283評論 6 530
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 97,947評論 3 413
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,094評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,485評論 1 308
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,268評論 6 405
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,817評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 42,906評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,039評論 0 285
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,551評論 1 331
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,502評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,662評論 1 366
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,188評論 5 356
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 43,907評論 3 345
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,304評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,563評論 1 281
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,255評論 3 389
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,637評論 2 370

推薦閱讀更多精彩內容