iossdk

更新时间：2020-06-23

获取公交线路uid

在POI检索中关键字传入公交线路名称，如：1路；大多数情况下，在返回的检索结果中的前两条数据即为该路线的往返公交线路，其中的uid 就是公交线路的uid。

公交信息检索

通过公交路线检索接口传入获取的公交线路uid，可以得到指定公交路线的详细信息（如：该公交线有多少个站点，每个站点的名称，位置、参考票价和上下线行信息）。

实现步骤

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

BMKBusLineSearch *search = [[BMKBusLineSearch alloc] init];

let busLineSearch = BMKBusLineSearch()

3设置公交信息检索代理

Objective-C

Swift

search.delegate = self;

busLineSearch.delegate = self

4构造公交信息检索参数

Objective-C

Swift

BMKBusLineSearchOption *option = [[BMKBusLineSearchOption alloc] init];  
option.city= @"北京";  
option.busLineUid = @"6a9a06cc20927666a90dd87c";

//初始化请求参数类BMKBusLineSearchOption的实例
let buslineOption = BMKBusLineSearchOption()
//城市名
buslineOption.city = "北京"
//公交线路的UID
buslineOption.busLineUid = "6a9a06cc20927666a90dd87c"

5发起公交信息检索请求

Objective-C

Swift

BOOL flag = [search busLineSearch:option];  
if (flag) {  
    NSLog(@"busline检索发送成功");  
}  else  {  
    NSLog(@"busline检索发送失败");  
}

/**
 公交详情检索，异步方法，返回结果在BMKBusLineSearchDelegate的
 onGetBusDetailResult里
 
 busLineOption 公交线路检索信息类
 成功返回YES，否则返回NO
 */
let flag = busLineSearch.busLineSearch(buslineOption)
if flag {
    print("公交路线检索成功")
} else {
    print("公交路线检索失败")
}

6实现代理方法，获取检索结果

Objective-C

Swift

#pragma mark - BMKBusLineSearchDelegate
/**
 *返回busdetail搜索结果
 *@param searcher 搜索对象
 *@param busLineResult 搜索结果
 *@param error 错误号，@see BMKSearchErrorCode
 */ 
- (void)onGetBusDetailResult:(BMKBusLineSearch*)searcher result:(BMKBusLineResult*)busLineResult errorCode:(BMKSearchErrorCode)error {
    if (error == BMK_SEARCH_NO_ERROR) {
        //在此处理正常结果
    }
    else {
        NSLog(@"检索失败");
    }
}

/**
 公交路线检索结果回调
 
 @param searcher 检索对象
 @param busLineResult 公交路线检索结果
 @param error 错误码，@see BMKCloudErrorCode
 */
func onGetBusDetailResult(_ searcher: BMKBusLineSearch!, result busLineResult: BMKBusLineResult!, errorCode error: BMKSearchErrorCode) {
    if (error == BMK_SEARCH_NO_ERROR) {
        //在此处理正常结果
    }
    else {
        print(@"检索失败")
    }
}

7处理检索返回的结果

通过代理返回的error判断检索是否成功，如果检索成功，可通过解析result字段获取具体的结果。具体使用示例可参照官方demo中的BMKBusLineSearchPage。BMKBusLineResult类结构如下图：

说明：
BMKBusLineResult 公交详情检索结果类

BMKBusStation 公交站点信息

BMKBusStep 公交路线分段信息类

WebAPI文档全面上新