前言
本文是<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;
}
