百度地图 SDK提供了一套功能很强大的地图框架使用接口,它不仅提供构建地图的基本接口,还提供POI搜索、地理编码、路线规划、定位、本地覆盖物绘制等服务。而由于百度地图SDK官方网站 上给出的使用说明是使用 Objective-C 语言以及 Xcode 4来进行开发的,很多朋友在使用 Swift 语言来进行开发的过程中遇到了不少的问题,在此我将我的使用经验与遇到的问题写下来给大家进行分享,帮助大家快速使用百度地图。
百度地图 iOS SDK是一套基于iOS 5.0及以上版本设备的应用程序接口,不仅提供展示地图的基本接口,还提供POI检索、路径规划、地图标注、离线地图、室内地图、定位、周边雷达等丰富的LBS能力 。
您可以使用百度地图iOS SDK开发适用于移动设备的地图应用,通过接口,您可以轻松访问百度服务和数据,构建功能丰富、交互性强的地图应用程序。
自v3.0起,iOS地图SDK全面支持IPv6网络。该套SDK提供的服务是免费的,任何非营利性程序均可使用,您需要先申请密钥(key) ,才可使用该套SDK接口。任何非营利性产品请直接使用,商业目的产品使用前请参考 使用须知 。
在您使用百度地图iOS SDK之前,请先阅读 百度地图API使用条款 。
第一步、导入地图SDK,参考 配置开发环境 ;百度地图iOS SDK自v2.7.0版本起,向广大开发者提供了 .framework形式的SDK开发包,这种形式的开发包配置简单,使用方便,推荐大家使用。
注:由于iOS9改用更安全的https,为了能够在iOS9中正常使用地图SDK,请在"Info.plist"中进行如下配置,否则影响SDK的使用。
注:此种方式只支持导入全量包的SDK,包含百度地图iOS SDK所有功能
一、前提:安装CocoaPods
在终端输入
如果安装成功,会有一个提示
二、使用CocoaPods导入地图SDK
在当前工程文件(.xcodeproj)所在文件夹下,打开terminal
1.创建Podfile:
2.编辑Podfile内容如下:
3.在Podfile所在的文件夹下输入命令:
成功以后,会出现如下记录:
恭喜你已成功导入百度地图iOS SDK,现在就可以打开xcworkspace文件,在你的项目中使用百度地图SDK了
第一步、根据需要导入 .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 Setting 中找到 Compile Sources As,并将其设置为"Objective-C++"
第二步、引入所需的系统库
百度地图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,添加这几个系统库即可。
在TARGETS->Build Settings->Other Linker Flags 中添加-ObjC。
第四步、引入mapapi.bundle资源文件
如果使用了基础地图功能,需要添加该资源,否则地图不能正常显示mapapi.bundle中存储了定位、默认大头针标注View及路线关键点的资源图片,还存储了矢量地图绘制必需的资源文件。如果您不需要使用内置的图片显示功能,则可以删除bundle文件中的image文件夹。您也可以根据具体需求任意替换或删除该bundle中image文件夹的图片文件。
方法:选中工程名,在右键菜单中选择Add Files to “工程名”…,从BaiduMapAPI_Map.framework||Resources文件中选择mapapi.bundle文件,并勾选“Copy items if needed”复选框,单击“Add”按钮,将资源文件添加到工程中。
第五步、引入头文件
在使用SDK的类 按需 引入下边的头文件:
var _mapManager: BMKMapManager?
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool
{
_mapManager = BMKMapManager()
// 如果要关注网络及授权验证事件,请设定generalDelegate参数
let ret = _mapManager?.start("申请的百度地图key", generalDelegate: self)
if ret == false {
NSLog("manager start failed!")
}
return true
}
二、创建BMKMapView 在您的ViewController.swift文件中添加BMKMapView的创建代码,示例如下
class ViewController: UIViewController,BMKGeoCodeSearchDelegate,BMKLocationServiceDelegate
{
@IBOutlet weak var addressLabel: UILabel!
var locationService : BMKLocationService!
var geoCodeSearch : BMKGeoCodeSearch!
var lat = Double()
var lon = Double()
override func viewDidLoad() {
super.viewDidLoad()
geoCodeSearch = BMKGeoCodeSearch()
locationService = BMKLocationService()
locationService.startUserLocationService()
}
自2.0.0起,BMKMapView新增viewWillAppear、viewWillDisappear方法来控制BMKMapView的生命周期,并且在一个时刻只能有一个BMKMapView接受回调消息,因此在使用BMKMapView的viewController中需要在viewWillAppear、viewWillDisappear方法中调用BMKMapView的对应的方法,并处理delegate,代码如下:
override func viewWillAppear(animated: Bool)
{
super.viewWillAppear(animated)
geoCodeSearch.delegate = self
locationService.delegate = self
}
override func viewWillDisappear(animated: Bool)
{
super.viewWillDisappear(animated)
geoCodeSearch.delegate = nil
locationService.delegate = nil
}
/**
*用户位置更新后,会调用此函数
*@param userLocation 新的用户位置
*/
func didUpdateBMKUserLocation(userLocation: BMKUserLocation!)
{
self.lat = userLocation.location.coordinate.latitude
self.lon = userLocation.location.coordinate.longitude
let reverseGeocodeSearchOption = BMKReverseGeoCodeOption()
reverseGeocodeSearchOption.reverseGeoPoint = CLLocationCoordinate2DMake(self.lat, self.lon)
print("目标位置:\(self.lat)\(self.lon)")
//发送反编码请求.并返回是否成功
let flag = geoCodeSearch.reverseGeoCode(reverseGeocodeSearchOption)
if (flag)
{
print("反geo检索发送成功")
} else {
print("反geo检索发送失败")
}
}
/**
*返回反地理编码搜索结果
*@param searcher 搜索对象
*@param result 搜索结果
*@param error 错误号,@see BMKSearchErrorCode
- (void)onGetReverseGeoCodeResult:(BMKGeoCodeSearch *)searcher result:(BMKReverseGeoCodeResult *)result errorCode:(BMKSearchErrorCode)error;
*/
func onGetReverseGeoCodeResult(searcher: BMKGeoCodeSearch!, result: BMKReverseGeoCodeResult!, errorCode error: BMKSearchErrorCode)
{
print("返回错误信息%@",error)
if (error == BMK_SEARCH_NO_ERROR) {
print("返回正常")
self.addressLabel.text = result.address
} else{
print("返回错误....")
}
}
1 .百度地图的安全码是否与该项目的Bundle Identifier 名称是否一致 如过不一致将两者名称保持一致,再进行测试运行,
2 .百度地图为了给用户提供更安全的服务,iOS SDK自v2.0.2版本开始采用了全新的Key验证体系。因此,当您选择使用v2.0.2及之后版本的SDK时,需要到新的Key申请页面进行全新Key的申请,申请及配置流程请参考开发指南对应章节。(选择使用v2.0.1及之前版本SDK的开发者,申请密钥(Key)的方式不变)。 可以根据自己的百度地图版本查看自己key值是否相对应,检查完毕后 ok 后,再运行进行测试.
通过上面两个方法,我的反地理编码已成功解决,希望看完文章后能够对您有所帮助!
Demo下载地址: 点击打开链接