更新时间:2020-06-23
步行路线规划简介
步行路径规划可以根据起终点的关键字和城市名称,获取起终点之间的步行路线规划结果,包含路线长度、耗时、途径的每个路段的详细信息等。
注意:进行步行路线规划时,起终点间直线距离不应超过100公里。
效果如下:
实现步骤
1引入头文件
步行路线规划功能使用的是地图SDK的检索功能,需要在工程中导入检索功能包BaiduMapAPI_Search.framework
Objective-C
Swift
#import <BaiduMapAPI_Base/BMKBaseComponent.h> #import <BaiduMapAPI_Search/BMKSearchComponent.h>
// 在桥接头文件BMKSwiftDemo-Bridging-Header中添加 #import <BaiduMapAPI_Base/BMKBaseComponent.h> #import <BaiduMapAPI_Search/BMKSearchComponent.h>
2初始化检索对象
Objective-C
Swift
BMKRouteSearch *routeSearch = [[BMKRouteSearch alloc] init];
let routeSearch = BMKRouteSearch()
3设置路线检索代理
Objective-C
Swift
routeSearch.delegate = self;
routeSearch.delegate = self
4构造步行路线规划检索参数
Objective-C
Swift
BMKPlanNode* start = [[BMKPlanNode alloc] init]; start.name = @"天安门"; start.cityName = @"北京"; BMKPlanNode* end = [[BMKPlanNode alloc] init]; end.name = @"百度科技园"; end.cityName = @"北京"; BMKWalkingRoutePlanOption *walkingRouteSearchOption = [[BMKWalkingRoutePlanOption alloc] init]; walkingRouteSearchOption.from = start; walkingRouteSearchOption.to = end;
/* 线路检索节点信息类,一个路线检索节点可以通过经纬度坐标或城市名加地名确定 实例化线路检索节点信息类对象 */ let start = BMKPlanNode() //起点名称 start.name = "天安门" //起点所在城市,注:cityName和cityID同时指定时,优先使用cityID start.cityName = "北京" //实例化线路检索节点信息类对象 let end = BMKPlanNode() //终点名称 end.name = "百度科技园" //终点所在城市,注:cityName和cityID同时指定时,优先使用cityID end.cityName = "北京" //初始化请求参数类BMKWalkingRoutePlanOption的实例 let walkingRoutePlanOption = BMKWalkingRoutePlanOption() //检索的起点,可通过关键字、坐标两种方式指定。cityName和cityID同时指定时,优先使用cityID walkingRoutePlanOption.from = start //检索的终点,可通过关键字、坐标两种方式指定。cityName和cityID同时指定时,优先使用cityID walkingRoutePlanOption.to = end
5发起步行路线规划检索请求
Objective-C
Swift
BOOL flag = [routeSearch walkingSearch:walkingRouteSearchOption]; if (flag) { NSLog(@"步行路线规划检索发送成功"); } else{ NSLog(@"步行路线规划检索发送失败"); }
/** 发起步行路线检索请求,异步函数,返回结果在BMKRouteSearchDelegate的 onGetWalkingRouteResult中 */ let flag = routeSearch.walkingSearch(walkingRoutePlanOption) if flag { NSLog("步行检索成功") } else { NSLog("步行检索失败") }
6实现代理方法,获取检索结果
Objective-C
Swift
/** *返回步行搜索结果 *@param searcher 搜索对象 *@param result 搜索结果,类型为BMKWalkingRouteResult *@param error 错误号,@see BMKSearchErrorCode */ -(void)onGetWalkingRouteResult:(BMKRouteSearch*)searcher result:(BMKWalkingRouteResult*)result errorCode:(BMKSearchErrorCode)error { NSLog(@"onGetWalkingRouteResult error:%d", (int)error); if (error == BMK_SEARCH_NO_ERROR) { //成功获取结果 } else { //检索失败 } }
/** 返回步行路线检索结果 @param searcher 检索对象 @param result 检索结果,类型为BMKWalkingRouteResult @param error 错误码,@see BMKSearchErrorCode */ func onGetWalkingRouteResult(_ searcher: BMKRouteSearch!, result: BMKWalkingRouteResult!, errorCode error: BMKSearchErrorCode) { if error == BMK_SEARCH_NO_ERROR { //成功获取结果 } else { //检索失败 } }
7处理检索返回的结果
1)通过代理返回的error判断检索是否成功,如果检索成功,可通过解析result字段获取具体的规划结果。BMKWalkingRouteResult类结构如下图:

说明:
BMKWalkingRouteResult 步行路线规划结果类 BMKTaxiInfo 打车信息类

说明:
BMKWalkingRouteResult 步行路线规划结果类 BMKTaxiInfo 打车信息类
BMKSuggestAddInfo 路线搜索地址结果类
BMKWalkingRouteLine 步行路线类
BMKWalkingStep 路线中的一个路段
BMKMapPoint 路段所经过的地理坐标
2)如果需要在地图上展示路线规划结果,可以利用BMKPointAnnotation绘制起终点及线路拐点,利用BMKPolyline来绘制路线,具体使用示例可参照官方demo中的BMKWalkingRouteSearchPage。