iossdk

更新时间：2020-06-23

简介

室内路线规划可以根据同一个室内场所内的两个poi作为起终点，规划出一条步行路线，指引用户到达目的地。

实现步骤

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

BMKIndoorPlanNode* start = [[BMKIndoorPlanNode alloc]init];
start.floor = @"F1";
start.pt = CLLocationCoordinate2DMake(39.916634, 116.379916);
BMKIndoorPlanNode* end = [[BMKIndoorPlanNode alloc]init];
end.floor = @"F5";
end.pt = CLLocationCoordinate2DMake(39.917312, 116.378919);
BMKIndoorRoutePlanOption* indoorRouteSearchOption = [[BMKIndoorRoutePlanOption alloc]init];
indoorRouteSearchOption.from = start;
indoorRouteSearchOption.to = end;

//初始化BMKIndoorPlanNode实例，检索起点
let start = BMKIndoorPlanNode()
//起点所在楼层
start.floor = "F1"
//起点坐标
start.pt = CLLocationCoordinate2DMake(39.916634, 116.379916)
//初始化BMKIndoorPlanNode实例，检索终点
let end = BMKIndoorPlanNode()
//终点所在楼层
end.floor = "F5"
//终点坐标
end.pt = CLLocationCoordinate2DMake(39.917312, 116.378919)
//初始化请求参数类BMKIndoorRoutePlanOption的实例
let indoorRoutePlanOption = BMKIndoorRoutePlanOption()
//检索的起点
indoorRoutePlanOption.from = start
//检索的终点
indoorRoutePlanOption.to = end

5发起室内路线规划检索请求

Objective-C

Swift

BOOL flag = [routeSearch indoorRoutePlanSearch: indoorRouteSearchOption];
if (flag) { 
    NSLog(@"室内路线规划检索发送成功");
} else{
    NSLog(@"室内路线规划检索发送失败");
}

/**
 发起室内路线检索请求，异步函数，返回结果在BMKRouteSearchDelegate的
 onGetIndoorRouteResult中
 */
let flag = routeSearch.indoorRoutePlan(indoorRoutePlanOption)
if flag {
    print("室内路线检索成功")
} else {
    print("室内路线检索失败")
}

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

Objective-C

Swift

/**
 *返回室内路线搜索结果
 *@param searcher 搜索对象
 *@param result 搜索结果，类型为BMKIndoorRouteResult
 *@param error 错误号，@see BMKSearchErrorCode
 */
- (void)onGetIndoorRouteResult:(BMKRouteSearch*)searcher result:(BMKIndoorRouteResult*)result errorCode:(BMKSearchErrorCode)error
{
    NSLog(@"onGetIndoorRouteResult errorcode:%d", (int)error);
    if (error == BMK_SEARCH_NO_ERROR) {
        //检索成功
    } else {
        //检索失败
    }
}

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

7处理检索返回的结果

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

说明：
BMKIndoorRouteResult 室内路线规划结果类 BMKIndoorRouteLine 室内路线类

BMKIndoorRouteStep 室内路线中的一个路段

BMKIndoorStepNode 室内路线结点

BMKMapPoint 路段所经过的地理坐标

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

WebAPI文档全面上新