浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
(以“{{iossdk-sidebar}} <div class="bluetitle"><div class="services-title-text">市内公交路线规划简介</div></div> 市内公交线路规划TransitRoute,支持...”为内容创建页面)
 
 
第6行: 第6行:
 
<div class="bluetitle"><div class="services-title-text">实现步骤</div></div><div class="devguide"><div class="leftborderbg" style="height:990px"></div><div class="devguideorder"><span>1</span>引入头文件</div><div class="devguidecenter">
 
<div class="bluetitle"><div class="services-title-text">实现步骤</div></div><div class="devguide"><div class="leftborderbg" style="height:990px"></div><div class="devguideorder"><span>1</span>引入头文件</div><div class="devguidecenter">
 
市内公交路线规划功能使用的是地图SDK的检索功能,需要在工程中导入检索功能包BaiduMapAPI_Search.framework
 
市内公交路线规划功能使用的是地图SDK的检索功能,需要在工程中导入检索功能包BaiduMapAPI_Search.framework
<pre class="prettyprint codestyle">#import <BaiduMapAPI_Base/BMKBaseComponent.h>
+
<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">#import <BaiduMapAPI_Base/BMKBaseComponent.h>
#import <BaiduMapAPI_Search/BMKSearchComponent.h>
+
#import <BaiduMapAPI_Search/BMKSearchComponent.h></pre>
</pre>
+
<pre class="code_item prettyprint codestyle">// 在桥接头文件BMKSwiftDemo-Bridging-Header中添加
</div><div class="devguideorder"><span>2</span>初始化检索对象</div><div class="devguidecenter"><pre class="prettyprint codestyle">BMKRouteSearch *routeSearch = [[BMKRouteSearch alloc] init];
+
#import <BaiduMapAPI_Base/BMKBaseComponent.h>
</pre>
+
#import <BaiduMapAPI_Search/BMKSearchComponent.h></pre>
</div><div class="devguideorder"><span>3</span>设置路线检索代理</div><div class="devguidecenter"><pre class="prettyprint codestyle">routeSearch.delegate = self;
+
</div></div></div><div class="devguideorder"><span>2</span>初始化检索对象</div><div class="devguidecenter"><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">BMKRouteSearch *routeSearch = [[BMKRouteSearch alloc] init];</pre>
</pre>
+
<pre class="code_item prettyprint codestyle">let routeSearch = BMKRouteSearch()</pre>
</div><div class="devguideorder"><span>4</span>构造市内公交路线规划检索参数</div><div class="devguidecenter"><pre class="prettyprint codestyle">BMKPlanNode* start = [[BMKPlanNode alloc] init];
+
</div></div></div><div class="devguideorder"><span>3</span>设置路线检索代理</div><div class="devguidecenter"><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">routeSearch.delegate = self;</pre>
 +
<pre class="code_item prettyprint codestyle">routeSearch.delegate = self</pre>
 +
</div></div></div><div class="devguideorder"><span>4</span>构造市内公交路线规划检索参数</div><div class="devguidecenter"><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">BMKPlanNode* start = [[BMKPlanNode alloc] init];
 
start.name = @"天安门";
 
start.name = @"天安门";
 
start.cityName = @"北京";
 
start.cityName = @"北京";
第22行: 第24行:
 
transitRoutePlanOption.from = start;
 
transitRoutePlanOption.from = start;
 
transitRoutePlanOption.to = end;
 
transitRoutePlanOption.to = end;
transitRoutePlanOption.city = @"北京"; //必须设置
+
transitRoutePlanOption.city = @"北京"; //必须设置</pre>
</pre>
+
<pre class="code_item prettyprint codestyle">//实例化线路检索节点信息类对象
 
+
let start = BMKPlanNode()
 +
//起点名称
 +
start.name = "天安门"
 +
//起点所在城市,注:cityName和cityID同时指定时,优先使用cityID
 +
start.cityName = "北京"
 +
//实例化线路检索节点信息类对象
 +
let end = BMKPlanNode()
 +
//终点名称
 +
end.name = "清华大学"
 +
//终点所在城市,注:cityName和cityID同时指定时,优先使用cityID
 +
end.cityName = "北京"
 +
//初始化请求参数类BMKTransitRoutePlanOption的实例
 +
let transitRoutePlanOption = BMKTransitRoutePlanOption()
 +
//检索的起点,可通过关键字、坐标两种方式指定。cityName和cityID同时指定时,优先使用cityID
 +
transitRoutePlanOption.from = start
 +
//检索的终点,可通过关键字、坐标两种方式指定。cityName和cityID同时指定时,优先使用cityID
 +
transitRoutePlanOption.to = end
 +
//城市名,用于在哪个城市内进行检索
 +
transitRoutePlanOption.city = "北京" //必须设置</pre>
 +
</div></div>
 
另外,BMKTransitRoutePlanOption中还可以设置途经点(BMKTransitPolicy),具体使用方法可以参考demo中的BMKTransitRouteSearchPage。
 
另外,BMKTransitRoutePlanOption中还可以设置途经点(BMKTransitPolicy),具体使用方法可以参考demo中的BMKTransitRouteSearchPage。
</div><div class="devguideorder"><span>5</span>发起市内公交路线规划检索请求</div><div class="devguidecenter"><pre class="prettyprint codestyle">BOOL flag = [routeSearch transitSearch: transitRoutePlanOption];
+
</div><div class="devguideorder"><span>5</span>发起市内公交路线规划检索请求</div><div class="devguidecenter"><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">BOOL flag = [routeSearch transitSearch: transitRoutePlanOption];
 
if (flag) {  
 
if (flag) {  
 
     NSLog(@"市内公交规划检索发送成功");
 
     NSLog(@"市内公交规划检索发送成功");
 
} else{
 
} else{
 
     NSLog(@"市内公交规划检索发送失败");
 
     NSLog(@"市内公交规划检索发送失败");
}
+
}</pre>
</pre>
+
<pre class="code_item prettyprint codestyle">/**
</div><div class="devguideorder"><span>6</span>实现代理方法,获取检索结果</div><div class="devguidecenter"><pre class="prettyprint codestyle">/**
+
市内公交路线检索,异步函数,返回结果在BMKRouteSearchDelegate的onGetTransitRouteResult中
 +
*/
 +
let flag = routeSearch.transitSearch(transitRoutePlanOption)
 +
if flag {
 +
    print("市内公交路线检索成功")
 +
} else {
 +
    print("市内公交路线检索失败")
 +
}</pre>
 +
</div></div></div><div class="devguideorder"><span>6</span>实现代理方法,获取检索结果</div><div class="devguidecenter"><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">/**
 
  返回公交路线检索结果
 
  返回公交路线检索结果
 
   
 
   
第47行: 第76行:
 
         //检索失败
 
         //检索失败
 
     }
 
     }
}
+
}</pre>
</pre>
+
<pre class="code_item prettyprint codestyle">/**
</div><div class="devguideorder"><span>7</span>处理检索返回的结果</div><div class="devguidecenter">
+
返回公交路线检索结果
 +
 +
@param searcher 检索对象
 +
@param result 检索结果,类型为BMKTransitRouteResult
 +
@param error 错误码,@see BMKSearchErrorCode
 +
*/
 +
func onGetTransitRouteResult(_ searcher: BMKRouteSearch!, result: BMKTransitRouteResult!, errorCode error: BMKSearchErrorCode) {
 +
    if (error == BMK_SEARCH_NO_ERROR) {
 +
        //成功获取结果
 +
    } else {
 +
        //检索失败
 +
    }
 +
}</pre>
 +
</div></div></div><div class="devguideorder"><span>7</span>处理检索返回的结果</div><div class="devguidecenter">
 
1)通过代理返回的error判断检索是否成功,如果检索成功,可通过解析result字段获取具体的规划结果。BMKTransitRouteResult类结构如下图:<br/>http://mapopen-pub-iossdk.cdn.bcebos.com/map/img/Route_Bus.png<br/>说明:<br/>BMKTransitRouteResult &nbsp; &nbsp; 市内公交路线规划结果类 BMKSuggestAddInfo 路线搜索地址结果类
 
1)通过代理返回的error判断检索是否成功,如果检索成功,可通过解析result字段获取具体的规划结果。BMKTransitRouteResult类结构如下图:<br/>http://mapopen-pub-iossdk.cdn.bcebos.com/map/img/Route_Bus.png<br/>说明:<br/>BMKTransitRouteResult &nbsp; &nbsp; 市内公交路线规划结果类 BMKSuggestAddInfo 路线搜索地址结果类
  

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

市内公交路线规划简介

市内公交线路规划TransitRoute,支持城市内公交路线规划,根据起终点的关键字和城市名称,来完成市内公交线路规划。规划结果包含路线长度、耗时、途径的每个路段的详细信息等。

注意:TransitRoute市内公交线路规划为旧公交线路规划,即将废弃;新版跨城公交线路规划MassTransitRoute包含市内公交线路规划的全部功能,建议使用新版跨城公交线路规划。

实现步骤
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 = @"北京";
BMKTransitRoutePlanOption *transitRoutePlanOption= [[BMKTransitRoutePlanOption alloc]init];
transitRoutePlanOption.from = start;
transitRoutePlanOption.to = end;
transitRoutePlanOption.city = @"北京"; //必须设置
//实例化线路检索节点信息类对象
let start = BMKPlanNode()
//起点名称
start.name = "天安门"
//起点所在城市,注:cityName和cityID同时指定时,优先使用cityID
start.cityName = "北京"
//实例化线路检索节点信息类对象
let end = BMKPlanNode()
 //终点名称
end.name = "清华大学"
//终点所在城市,注:cityName和cityID同时指定时,优先使用cityID
end.cityName = "北京"
//初始化请求参数类BMKTransitRoutePlanOption的实例
let transitRoutePlanOption = BMKTransitRoutePlanOption()
//检索的起点,可通过关键字、坐标两种方式指定。cityName和cityID同时指定时,优先使用cityID
transitRoutePlanOption.from = start
//检索的终点,可通过关键字、坐标两种方式指定。cityName和cityID同时指定时,优先使用cityID
transitRoutePlanOption.to = end
//城市名,用于在哪个城市内进行检索
transitRoutePlanOption.city = "北京" //必须设置

另外,BMKTransitRoutePlanOption中还可以设置途经点(BMKTransitPolicy),具体使用方法可以参考demo中的BMKTransitRouteSearchPage。

5发起市内公交路线规划检索请求
Objective-C
Swift
BOOL flag = [routeSearch transitSearch: transitRoutePlanOption];
if (flag) { 
    NSLog(@"市内公交规划检索发送成功");
} else{
    NSLog(@"市内公交规划检索发送失败");
}
/**
 市内公交路线检索,异步函数,返回结果在BMKRouteSearchDelegate的onGetTransitRouteResult中
 */
let flag = routeSearch.transitSearch(transitRoutePlanOption)
if flag {
    print("市内公交路线检索成功")
} else {
    print("市内公交路线检索失败")
}
6实现代理方法,获取检索结果
Objective-C
Swift
/**
 返回公交路线检索结果
 
 @param searcher 检索对象
 @param result 检索结果,类型为BMKTransitRouteResult
 @param error 错误码,@see BMKSearchErrorCode
 */
- (void)onGetTransitRouteResult:(BMKRouteSearch *)searcher result:(BMKTransitRouteResult *)result errorCode:(BMKSearchErrorCode)error {
    NSLog(@"onGetTransitRouteResult error:%d", (int)error);
    if (error == BMK_SEARCH_NO_ERROR) {
        //成功获取结果
    } else {
        //检索失败
    }
}
/**
 返回公交路线检索结果
 
 @param searcher 检索对象
 @param result 检索结果,类型为BMKTransitRouteResult
 @param error 错误码,@see BMKSearchErrorCode
 */
func onGetTransitRouteResult(_ searcher: BMKRouteSearch!, result: BMKTransitRouteResult!, errorCode error: BMKSearchErrorCode) {
    if (error == BMK_SEARCH_NO_ERROR) {
        //成功获取结果
    } else {
        //检索失败
    }
}
7处理检索返回的结果

1)通过代理返回的error判断检索是否成功,如果检索成功,可通过解析result字段获取具体的规划结果。BMKTransitRouteResult类结构如下图:
Route_Bus.png
说明:
BMKTransitRouteResult     市内公交路线规划结果类 BMKSuggestAddInfo 路线搜索地址结果类

BMKTransitRouteLine        市内公交路线类

BMKTransitStep                路线中的一个路段

MKMapPoint                     路段所经过的地理坐标

BMKVehicleInfo                 当路段为公交路段或地铁路段时,可以获取交通工具信息

2)如果需要在地图上展示路线规划结果,可以利用BMKPointAnnotation绘制起终点及线路拐点,利用BMKPolyline来绘制路线,具体使用示例可参照官方demo中的BMKTransitRouteSearchPage。

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消