更新时间:2020-06-23
步行路线规划简介
步行路径规划可以根据起终点的关键字和城市名称,获取起终点之间的步行路线规划结果,包含路线长度、耗时、途径的每个路段的详细信息等。
注意:进行步行路线规划时,起终点间直线距离不应超过100公里。
效果如下:
实现步骤
1引入头文件
步行路线规划功能使用的是地图sdk的检索功能,需要在工程中导入检索功能包baidumapapi_search.framework
objective-c
swift
#import#import
// 在桥接头文件bmkswiftdemo-bridging-header中添加 #import#import
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。