浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
跨城综合公交路线规划简介

跨城综合公交线路规划MassTransitRoute,支持市内和跨城的公交线路规划,可检索火车、飞机、公交、大巴等公共交通线路。

根据起终点的关键字和城市名称,以及根据不同的方案选择多种策略,获取起终点之间的公交路线规划结果,来完成跨城综合公交线路规划。规划结果包含不同出行的多种策略(如火车、飞机、公交、大巴)、路线长度、耗时、途径的每个路段的详细信息等。

注意:此跨城公交线路规划包含旧公交线路规划TransitRoute(支持城市内公交规划)的全部功能,旧公交线路规划将废弃,建议使用新版跨城公交线路规划。

实现步骤
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 = @"郑州";
BMKMassTransitRoutePlanOption *massTransitRoutePlanOption= [[BMKMassTransitRoutePlanOption alloc]init];
massTransitRoutePlanOption.from = start;
massTransitRoutePlanOption.to = end;
//实例化线路检索节点信息类对象
let start = BMKPlanNode()
//起点名称
start.name = "北京西站"
//起点所在城市,注:cityName和cityID同时指定时,优先使用cityID
start.cityName = "北京"
//实例化线路检索节点信息类对象
let end = BMKPlanNode()
//终点名称
end.name = "郑州站"
//终点所在城市,注:cityName和cityID同时指定时,优先使用cityID
end.cityName = "郑州"
//初始化请求参数类BMKMassTransitRoutePlanOption的实例
let massTransitRoutePlanOption = BMKMassTransitRoutePlanOption()
//检索的起点,可通过关键字、坐标两种方式指定。cityName和cityID同时指定时,优先使用cityID
massTransitRoutePlanOption.from = start
//检索的终点,可通过关键字、坐标两种方式指定。cityName和cityID同时指定时,优先使用cityID
massTransitRoutePlanOption.to = end

另外,BMKMassTransitRoutePlanOption中还可以设置市内公交换乘策略策略(incityPolicy)、跨城公交换乘策略(intercityPolicy)和跨城交通方式策略(intercityTransPolicy),具体使用方法可以参考demo中的BMKMassTransitRouteSearchPage。

注意:跨城综合公交路线规划检索起终点城市不支持使用cityId

5发起跨城综合公交路线规划检索请求
Objective-C
Swift
BOOL flag = [routeSearch massTransitSearch: massTransitRoutePlanOption];
if (flag) { 
    NSLog(@"跨城综合公交规划检索发送成功");
} else{
    NSLog(@"跨城综合公交规划检索发送失败");
}
/**
 *发起公共交通路线检索请求(支持市内和跨城)
 *异步函数,返回结果在BMKRouteSearchDelegate的onGetMassTransitRouteResult中
 *注:起终点城市不支持使用cityId
 */
let flag = routeSearch.massTransitSearch(massTransitRoutePlanOption)
if flag {
    print("跨城公交检索成功")
} else {
    print("跨城公交检索失败")
}
6实现代理方法,获取检索结果
Objective-C
Swift
/**
 *返回公共交通路线检索结果(new)
 *@param searcher 搜索对象
 *@param result 搜索结果,类型为BMKMassTransitRouteResult
 *@param error 错误号,@see BMKSearchErrorCode
 */
- (void)onGetMassTransitRouteResult:(BMKRouteSearch*)searcher result:(BMKMassTransitRouteResult*)result errorCode:(BMKSearchErrorCode)error
{
    NSLog(@"onGetMassTransitRouteResult error:%d", (int)error);
    if (error == BMK_SEARCH_NO_ERROR) {
        //成功获取结果
    } else {
        //检索失败
    }
}
/**
 返回公共交通路线检索结果
 
 @param searcher 检索对象
 @param result 检索结果,类型为BMKMassTransitRouteResult
 @param error 错误码,@see BMKSearchErrorCode
 */
func onGetMassTransitRouteResult(_ searcher: BMKRouteSearch!, result: BMKMassTransitRouteResult!, errorCode error: BMKSearchErrorCode) {
    if (error == BMK_SEARCH_NO_ERROR) {
        //成功获取结果
    } else {
        //检索失败
    }
}
7处理检索返回的结果

1)通过代理返回的error判断检索是否成功,如果检索成功,可通过解析result字段获取具体的规划结果。BMKMassTransitRouteResult类结构如下图:
Route_Transit.png
说明:
BMKMassTransitRouteResult     跨城综合公交路线规划结果类

BMKTaxiInfo                            打车信息类

BMKSuggestAddInfo                 路线搜索地址结果类

BMKMassTransitRouteLine        跨城综合公交路线类

BMKMassTransitStep                路线中的一个路段

BMKMassTransitSubStep           BMKMassTransitStep中的有几个方案或几个子路段

BMKMapPoint                          路段所经过的地理坐标

BMKBaseVehicleInfo                 该路段交通工具信息(当BMKMassTransitSubStep中的stepType为公交地铁时,BMKBusVehicleInfo对象;stepType为大巴时,BMKCoachVehicleInfo对象;stepType为飞机时,BMKPlaneVehicleInfo对象;stepType为火车时,BMKTrainVehicleInfo对象;其它为nil)


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

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消