开发 iOS 导航SDK 开发指南 路线规划 步行路线规划

步行路线规划 最后更新时间: 2021年01月22日

基本介绍

要实现步行路径规划功能,以下三个类您需要了解:

  • AMapNaviWalkManager 是步行导航管理类,提供路线规划、行前选路、导航中重算等方法。注意:从导航SDK7.4.0开始,AMapNaviWalkManager 的init方法已被禁止使用,请使用单例 [AMapNaviWalkManager sharedInstance] 替代,且在调用类的 dealloc 函数里或其他适当时机(如导航ViewController被pop时),调用 [AMapNaviWalkManager destroyInstance] 来销毁单例(需要注意如未销毁成功,请检查单例是否被强引用)
  • <AMapNaviWalkManagerDelegate> 是步行导航管理协议类,提供算路导航过程中的事件(如:路径规划成功/失败、TTS字符串、GPS信号弱、到达目的地等)回调接口。
  • <AMapNaviWalkDataRepresentable> 是步行导航数据协议类,提供算路导航过程中的实时数据(如:诱导信息NaviInfo、定位信息等)回调接口。

说明:

  • 注意:路径规划功能需要联网使用。
  • 起终点信息可通过多种方式获取,如:使用坐标拾取器查询您需要的点的坐标;还可以通过搜索 SDK 中的 POI  搜索查询兴趣点,作为起终点。
  • 提供三种步行路线规划的方法,如下表所示:

 方法名 

 参数说明 

 返回值说明 

 方法效果 

calculateWalkRouteWithEndPoints: 

endPoints:终点坐标; 

BOOL,表示规划路径所需条件和参数校验是否成功,不代表算路是否成功。 

终点为经纬度的无起点步行路径规划。(内部取当前定位点作为起点) 

calculateWalkRouteWithStartPoints:endPoints: 

startPoints:起点坐标;

endPoints:终点坐标;

BOOL,表示规划路径所需条件和参数校验是否成功,不代表算路是否成功。 

起终点为经纬度的步行路径规划。 

calculateWalkRouteWithStartPOIInfo:endPOIInfo:strategy: 

startPOIInfo:起点POIInfo;

endPOIInfo:终点POIInfo;

strategy:路径的计算策略;

BOOL,表示规划路径所需条件和参数校验是否成功,不代表算路是否成功。 

起终点为POIInfo的步行路径规划。(起点可为空,内部取当前定位点作为起点) 

  • 推荐使用 -calculateWalkRouteWithStartPOIInfo:endPOIInfo:strategy: 方法进行路径规划,SDK内部会根据 POIId 或者 startPOIInfo.startAngle,自动补全其他信息,从而规划出更合理的路线,有效减少绕路的出现。

使用说明

第 1 步,设置起终点信息

//使用POI初始化起终点
self.startPOIInfo = [[AMapNaviPOIInfo alloc]init];
self.startPOIInfo.mid = @"B0FFFAB6J2";

self.endPOIInfo = [[AMapNaviPOIInfo alloc]init];
self.endPOIInfo.mid = @"B0FFIA9OE8";
//使用POI初始化起终点
let startPOIInfo = AMapNaviPOIInfo.init()
startPOIInfo.mid = "B0FFFAB6J2"

let endPOIInfo = AMapNaviPOIInfo.init()
endPOIInfo.mid = "B0FFIA9OE8"

第 2 步,规划路线

//使用POI规划步行路线
[[AMapNaviWalkManager sharedInstance] calculateWalkRouteWithStartPOIInfo:self.startPOIInfo endPOIInfo:self.endPOIInfo strategy:AMapNaviTravelStrategyMultipleDefault];
//使用POI规划步行路线
AMapNaviWalkManager.sharedInstance().calculateWalkRoute(withStart: startPOIInfo, end: endPOIInfo, strategy: AMapNaviTravelStrategy.multipleDefault)

第 3 步,处理结果

当步行路线规划成功时,会触发 -walkManagerOnCalculateRouteSuccess: 回调,在该回调函数中,可以进行规划路线显示,也可以直接开启导航。 

- (void)walkManagerOnCalculateRouteSuccess:(AMapNaviWalkManager *)walkManager
{
    NSLog(@"onCalculateRouteSuccess");
    //显示路径或开启导航
}
func walkManager(onCalculateRouteSuccess walkManager: AMapNaviWalkManager) 
{
   NSLog("CalculateRouteSuccess")
   //显示路径或开启导航
}
返回顶部 示例中心 常见问题 智能客服 公众号
二维码