iossdk

更新时间：2020-06-23

驾车路线规划简介

驾车路径规划可以根据起终点的关键字和城市名称，获取起终点之间的驾车路线规划结果，支持返回多条不同策略的路线，每段路线包含路线长度、耗时、途径的每个路段的详细信息等。驾车路线规划还支持最多添加20个途经点。

实现步骤

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 = @"天津";
BMKDrivingRoutePlanOption *drivingRouteSearchOption = [[BMKDrivingRoutePlanOption alloc]init];
drivingRouteSearchOption.from = start;
drivingRouteSearchOption.to = end;

/*
 线路检索节点信息类，一个路线检索节点可以通过经纬度坐标或城市名加地名确定
 实例化线路检索节点信息类对象
 */
let start = BMKPlanNode()
//起点名称
start.name = "天安门"
//起点所在城市，注：cityName和cityID同时指定时，优先使用cityID
start.cityName = "北京"
//实例化线路检索节点信息类对象
let end = BMKPlanNode()
//终点名称
end.name = "天津站"
//终点所在城市，注：cityName和cityID同时指定时，优先使用cityID
end.cityName = "天津"
//初始化请求参数类BMKDrivingRoutePlanOption的实例
let drivingRoutePlanOption = BMKDrivingRoutePlanOption()
//检索的起点，可通过关键字、坐标两种方式指定。cityName和cityID同时指定时，优先使用cityID
drivingRoutePlanOption.from = start
//检索的终点，可通过关键字、坐标两种方式指定。cityName和cityID同时指定时，优先使用cityID
drivingRoutePlanOption.to = end

5发起驾车路线规划检索请求

Objective-C

Swift

BOOL flag = [routeSearch drivingSearch: drivingRouteSearchOption];
if (flag) { 
    NSLog(@"驾车规划检索发送成功");
} else{
    NSLog(@"驾车规划检索发送失败");
}

/**
 发起驾乘路线检索请求，异步函数，返回结果在BMKRouteSearchDelegate的onGetDrivingRouteResult中
 */
let flag = routeSearch.drivingSearch(drivingRoutePlanOption)
if flag {
    print("驾车检索成功")
} else {
    print("驾车检索失败")
}

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

Objective-C

Swift

/**
 *返回驾车搜索结果
 *@param searcher 搜索对象
 *@param result 搜索结果，类型为BMKDrivingRouteResult
 *@param error 错误号，@see BMKSearchErrorCode
 */
- (void)onGetDrivingRouteResult:(BMKRouteSearch*)searcher result:(BMKDrivingRouteResult*)result errorCode:(BMKSearchErrorCode)error {
    NSLog(@"onGetDrivingRouteResult error:%d", (int)error);
    if (error == BMK_SEARCH_NO_ERROR) {
        //成功获取结果
    } else {
        //检索失败
    }
}

/**
 返回驾车路线检索结果
 
 @param searcher 检索对象
 @param result 检索结果，类型为BMKDrivingRouteResult
 @param error 错误码 @see BMKSearchErrorCode
 */
func onGetDrivingRouteResult(_ searcher: BMKRouteSearch!, result: BMKDrivingRouteResult!, errorCode error: BMKSearchErrorCode) {
    if error == BMK_SEARCH_NO_ERROR {
        //成功获取结果
    } else {
        //检索失败
    }
}

7处理检索返回的结果

1.）通过代理返回的error判断检索是否成功，如果检索成功，可通过解析result字段获取具体的规划结果。BMKDrivingRouteResult类结构如下图：

说明：
BMKDrivingRouteResult 驾车路线规划结果类

BMKTaxiInfo 打车信息类

BMKSuggestAddInfo 路线搜索地址结果类

BMKDrivingRouteLine 驾车路线类

BMKDrivingStep 路线中的一个路段

BMKMapPoint 路段所经过的地理坐标

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

WebAPI文档全面上新