浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
 
第6行: 第6行:
  
 
骑行导航提供给开发者三类监听,分别是骑行导航算路回调、诱导信息回调、TTS语音播报文本。 使用方法如下:
 
骑行导航提供给开发者三类监听,分别是骑行导航算路回调、诱导信息回调、TTS语音播报文本。 使用方法如下:
<pre class="prettyprint codestyle">- (void)viewWillAppear:(BOOL)animated {
+
<div class="code_template"><div class="code_control"><div class="code_btn opt">Objective-C</div><div class="code_btn">Swift</div></div><div class="code_container"><pre class="code_item active prettyprint codestyle">BMKCycleNavigationManager *manager = [BMKCycleNavigationManager sharedManager];
    [super viewWillAppear:animated];
+
manager.routePlanDelegate = self;  //设置算路回调
    BMKCycleNavigationManager *manager = [BMKCycleNavigationManager sharedManager];
+
manager.routeGuidanceDelegate = self;  //设置导航状态信息回调
    manager.routePlanDelegate = self;  //设置算路回调
+
manager.ttsPlayerDelegate = self;  //设置语音播报回调</pre>
    manager.routeGuidanceDelegate = self;  //设置导航状态信息回调
+
<pre class="code_item prettyprint codestyle">let manager = BMKCycleNavigationManager.shared()
    manager.ttsPlayerDelegate = self;  //设置语音播报回调
+
manager?.routePlanDelegate = self  //设置算路回调
}
+
manager?.routeGuidanceDelegate = self  //设置导航状态信息回调
 
+
manager?.ttsPlayerDelegate = self  //设置语音播报回调
 
</pre>
 
</pre>
<div class="bluetitle"><div class="services-title-text">引擎初始化</div></div>
+
</div></div><div class="bluetitle"><div class="services-title-text">引擎初始化</div></div>
 
开始骑行导航前,需要进行骑行导航引擎初始化。
 
开始骑行导航前,需要进行骑行导航引擎初始化。
  
 
使用方法如下:
 
使用方法如下:
<pre class="prettyprint codestyle">//由开发者提供导航页面
+
<div class="code_template"><div class="code_control"><div class="code_btn opt">Objective-C</div><div class="code_btn">Swift</div></div><div class="code_container"><pre class="code_item active prettyprint codestyle">//由开发者提供导航页面
 
WalkNaviViewController *controller = [[WalkNaviViewController alloc] init];
 
WalkNaviViewController *controller = [[WalkNaviViewController alloc] init];
 
//初始化
 
//初始化
 
BOOL inited = [[BMKCycleNavigationManager sharedManager] initNaviEngine:controller];
 
BOOL inited = [[BMKCycleNavigationManager sharedManager] initNaviEngine:controller];
 
if (inited) {
 
if (inited) {
 +
    //初始化成功,发起算路...
 +
}</pre>
 +
<pre class="code_item prettyprint codestyle">let controller = WalkNaviViewController.init()
 +
let inited = BMKCycleNavigationManager.shared.initNaviEngine(controller)
 +
if inited {
 
     //初始化成功,发起算路...
 
     //初始化成功,发起算路...
 
}
 
}
 
</pre>
 
</pre>
<div class="bluetitle"><div class="services-title-text">发起算路</div></div>
+
</div></div><div class="bluetitle"><div class="services-title-text">发起算路</div></div>
 
引擎初始化成功之后,发起导航算路,其中BMKCycleNaviLaunchParam的参数naviType用于指定是普通骑行导航或是电动车骑行导航。
 
引擎初始化成功之后,发起导航算路,其中BMKCycleNaviLaunchParam的参数naviType用于指定是普通骑行导航或是电动车骑行导航。
  
 
使用方法如下:
 
使用方法如下:
<pre class="prettyprint codestyle">BMKCycleNaviLaunchParam *param = [[BMKCycleNaviLaunchParam alloc] init];
+
<div class="code_template"><div class="code_control"><div class="code_btn opt">Objective-C</div><div class="code_btn">Swift</div></div><div class="code_container"><pre class="code_item active prettyprint codestyle">BMKCycleNaviLaunchParam *param = [[BMKCycleNaviLaunchParam alloc] init];
 
param.startPoint = _startAnnotation.coordinate; //设置起点
 
param.startPoint = _startAnnotation.coordinate; //设置起点
 
param.endPoint = _endAnnotation.coordinate; //设置终点
 
param.endPoint = _endAnnotation.coordinate; //设置终点
 
param.naviType = BMK_WALK_CYCLE_NAVIGATION_TYPE_NORMAL_CYCLE;
 
param.naviType = BMK_WALK_CYCLE_NAVIGATION_TYPE_NORMAL_CYCLE;
[[BMKCycleNavigationManager sharedManager] routePlanWithParams:param];
+
[[BMKCycleNavigationManager sharedManager] routePlanWithParams:param];</pre>
</pre>
+
<pre class="code_item prettyprint codestyle">let param = BMKCycleNaviLaunchParam.init()
<div class="bluetitle"><div class="services-title-text">弹出导航页面</div></div>
+
param.startPoint = startAnnotation.coordinate //设置起点
 +
param.endPoint = endAnnotation.coordinate //设置终点
 +
param.naviType = BMKWalkCycleNavigationType.WALK_CYCLE_NAVIGATION_TYPE_NORMAL_CYCLE
 +
BMKCycleNavigationManager.shared()?.routePlan(withParams: param)</pre>
 +
</div></div><div class="bluetitle"><div class="services-title-text">弹出导航页面</div></div>
 
算路成功后,即可以执行弹出导航页面(即引擎初始化时传入的参数controller)操作。
 
算路成功后,即可以执行弹出导航页面(即引擎初始化时传入的参数controller)操作。
  
 
使用方法如下:
 
使用方法如下:
<pre class="prettyprint codestyle">#pragma mark - BMKWalkCycleRoutePlanDelegate  算路回调
+
<div class="code_template"><div class="code_control"><div class="code_btn opt">Objective-C</div><div class="code_btn">Swift</div></div><div class="code_container"><pre class="code_item active prettyprint codestyle">#pragma mark - BMKWalkCycleRoutePlanDelegate  算路回调
 
   
 
   
 
//开始算路
 
//开始算路
第57行: 第66行:
 
         NSLog(@"算路失败");
 
         NSLog(@"算路失败");
 
     }
 
     }
 +
}</pre>
 +
<pre class="code_item prettyprint codestyle">//MARK:BMKWalkCycleRoutePlanDelegate  算路回调
 +
 +
//开始算路
 +
func onRoutePlanStart(_ naviType: BMKWalkCycleNavigationType) {
 +
    print("开始算路")
 
}
 
}
</pre>
+
<div class="bluetitle"><div class="services-title-text">开始导航</div></div>
+
//算路结果返回
 +
func onRoutePlanResult(_ errorCode: BMKWalkCycleRoutePlanErrorCode, naviType: BMKWalkCycleNavigationType) {
 +
if errorCode == BMKWalkCycleRoutePlanErrorCode.WALK_CYCLE_ROUTEPLAN_RESULT_SUCCESS {
 +
    print("算路成功")
 +
    //算路成功弹出导航页面
 +
    self.navigationController&nbsp;?.pushViewController(_controller, animated: true)
 +
} else {
 +
    print("算路失败")
 +
}
 +
}</pre>
 +
</div></div><div class="bluetitle"><div class="services-title-text">开始导航</div></div>
 
在导航页面的- (void)viewWillAppear:(BOOL)animated方法中发起骑行导航。
 
在导航页面的- (void)viewWillAppear:(BOOL)animated方法中发起骑行导航。
  
第65行: 第90行:
  
 
使用方法如下:
 
使用方法如下:
<pre class="prettyprint codestyle">//初始化导航引擎时开发者提供的导航页面
+
<div class="code_template"><div class="code_control"><div class="code_btn opt">Objective-C</div><div class="code_btn">Swift</div></div><div class="code_container"><pre class="code_item active prettyprint codestyle">//初始化导航引擎时开发者提供的导航页面
 
- (void)viewWillAppear:(BOOL)animated {
 
- (void)viewWillAppear:(BOOL)animated {
 
     [super viewWillAppear:animated];
 
     [super viewWillAppear:animated];
 
     [[BMKCycleNavigationManager sharedManager] startCycleNavi];
 
     [[BMKCycleNavigationManager sharedManager] startCycleNavi];
}
+
}</pre>
</pre>
+
<pre class="code_item prettyprint codestyle">//初始化导航引擎时开发者提供的导航页面
<div class="bluetitle"><div class="services-title-text">监听回调说明</div></div>
+
override func viewWillAppear(_ animated: Bool) {
 +
    super.viewWillAppear(animated)
 +
    BMKCycleNavigationManager.shared()?.startCycleNavi()
 +
}</pre>
 +
</div></div><div class="bluetitle"><div class="services-title-text">监听回调说明</div></div>
 
步行导航和骑行导航均使用相同的代理回调,回调中参数naviType会告知开发者当前回调是骑行导航还是步行导航,请开发者注意区分。
 
步行导航和骑行导航均使用相同的代理回调,回调中参数naviType会告知开发者当前回调是骑行导航还是步行导航,请开发者注意区分。
  

2020年3月26日 (四) 11:28的最后版本

骑行导航简介

iOS 地图SDK自V4.2.0版本起新增骑行导航功能,支持普通自行车骑行导航和电动车骑行导航、偏航纠偏等导航功能。

骑行导航功能实现

注册监听

骑行导航提供给开发者三类监听,分别是骑行导航算路回调、诱导信息回调、TTS语音播报文本。 使用方法如下:

Objective-C
Swift
BMKCycleNavigationManager *manager = [BMKCycleNavigationManager sharedManager];
manager.routePlanDelegate = self;  //设置算路回调
manager.routeGuidanceDelegate = self;  //设置导航状态信息回调
manager.ttsPlayerDelegate = self;  //设置语音播报回调
let manager = BMKCycleNavigationManager.shared()
manager?.routePlanDelegate = self  //设置算路回调
manager?.routeGuidanceDelegate = self  //设置导航状态信息回调
manager?.ttsPlayerDelegate = self  //设置语音播报回调
引擎初始化

开始骑行导航前,需要进行骑行导航引擎初始化。

使用方法如下:

Objective-C
Swift
//由开发者提供导航页面
WalkNaviViewController *controller = [[WalkNaviViewController alloc] init];
//初始化
BOOL inited = [[BMKCycleNavigationManager sharedManager] initNaviEngine:controller];
if (inited) {
    //初始化成功,发起算路...
}
let controller = WalkNaviViewController.init()
let inited = BMKCycleNavigationManager.shared.initNaviEngine(controller)
if inited {
    //初始化成功,发起算路...
}
发起算路

引擎初始化成功之后,发起导航算路,其中BMKCycleNaviLaunchParam的参数naviType用于指定是普通骑行导航或是电动车骑行导航。

使用方法如下:

Objective-C
Swift
BMKCycleNaviLaunchParam *param = [[BMKCycleNaviLaunchParam alloc] init];
param.startPoint = _startAnnotation.coordinate; //设置起点
param.endPoint = _endAnnotation.coordinate; //设置终点
param.naviType = BMK_WALK_CYCLE_NAVIGATION_TYPE_NORMAL_CYCLE;
[[BMKCycleNavigationManager sharedManager] routePlanWithParams:param];
let param = BMKCycleNaviLaunchParam.init()
param.startPoint = startAnnotation.coordinate //设置起点
param.endPoint = endAnnotation.coordinate //设置终点
param.naviType = BMKWalkCycleNavigationType.WALK_CYCLE_NAVIGATION_TYPE_NORMAL_CYCLE
BMKCycleNavigationManager.shared()?.routePlan(withParams: param)
弹出导航页面

算路成功后,即可以执行弹出导航页面(即引擎初始化时传入的参数controller)操作。

使用方法如下:

Objective-C
Swift
#pragma mark - BMKWalkCycleRoutePlanDelegate  算路回调
 
//开始算路
- (void)onRoutePlanStart {
    NSLog(@"开始算路");
}
 
//算路结果返回
- (void)onRoutePlanResult:(BMKWalkRoutePlanErrorCode)errorCode naviType:(BMKWalkCycleNavigationType)naviType {
    if (errorCode == BMKWALK_ROUTEPLAN_RESULT_SUCCESS) {
        NSLog(@"算路成功");
        //算路成功弹出导航页面
        [self.navigationController pushViewController:_controller animated:YES];
    } else {
        NSLog(@"算路失败");
    }
}
//MARK:BMKWalkCycleRoutePlanDelegate  算路回调
 
//开始算路
func onRoutePlanStart(_ naviType: BMKWalkCycleNavigationType) {
    print("开始算路")
}
 
//算路结果返回
func onRoutePlanResult(_ errorCode: BMKWalkCycleRoutePlanErrorCode, naviType: BMKWalkCycleNavigationType) {
if errorCode == BMKWalkCycleRoutePlanErrorCode.WALK_CYCLE_ROUTEPLAN_RESULT_SUCCESS {
    print("算路成功")
    //算路成功弹出导航页面
    self.navigationController ?.pushViewController(_controller, animated: true)
} else {
    print("算路失败")
}
}
开始导航

在导航页面的- (void)viewWillAppear:(BOOL)animated方法中发起骑行导航。

调用- (BOOL)startCycleNavi; 方法开始骑行导航。

使用方法如下:

Objective-C
Swift
//初始化导航引擎时开发者提供的导航页面
- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];
    [[BMKCycleNavigationManager sharedManager] startCycleNavi];
}
//初始化导航引擎时开发者提供的导航页面
override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    BMKCycleNavigationManager.shared()?.startCycleNavi()
}
监听回调说明

步行导航和骑行导航均使用相同的代理回调,回调中参数naviType会告知开发者当前回调是骑行导航还是步行导航,请开发者注意区分。

BMKWalkCycleRoutePlanDelegate

·骑行、步行导航算路代理类,提供两个回调方法,分别是开始算路和算路结果返回。

·其中只有算路结果为成功的情况,开始骑行导航,算路失败发起导航无效。

BMKWalkCycleRouteGuidanceDelegate

·骑行、步行导航诱导信息代理类,提供12个回调方法,主要包括导航开始、结束,导航过程中偏航、偏航结束、诱导信息(包含诱导默认图标、诱导类型、诱导信息、剩余距离、时间、振动回调等)。

·详见 BMKWalkCycleNavigationDelegates.h 头文件。

BMKWalkCycleTTSPlayerDelegate

·骑行、步行导航TTS语音播报代理类,此组件只提供导航过程中的文本输出,不包含语音播报功能,需要自行传入对应的语音回调,形成播报功能。

·建议使用百度语音识别服务SDK。下载地址:http://yuyin.baidu.com/asr/download

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消