步行路线规划

功能场景

demo支持用户输入终点，发起步行路线规划，并展示在地图上。点击详情按钮，有弹窗可以看出该路线详细信息。

//mapopen-website-wiki.bj.bcebos.com/demos/AndroidVideos/SVID_20200530_210121_1.mp4

扫码体验

使用产品

Android地图SDK

>

步行路线规划

下载源码

核心接口

类

接口

描述

newInstance()

创建路线规划检索实例

setOnGetRoutePlanResultListener(OnGetRoutePlanResultListener listener)

设置路线规划检索监听器

RoutePlanSearch

walkingSearch(WalkingRoutePlanOption option)

发起步行路线规划检索请求

destory()

释放路线规划检索实例

OnGetRoutePlanResultListener

onGetWalkingRouteResult(WalkingRouteResult walkingRouteResult)

步行路线规划的结果回调函数

PlanNode

withCityNameAndPlaceName(String cityName, String placeName)

路线规划起终点参数

from(PlanNode startNode)

设置路线规划起点参数

WalkingRoutePlanOption

to(PlanNode endNode)

设置路线规划终点参数

setData(WalkingRouteLine routeLine)

设置步行路线规划结果数据

WalkingRouteOverlay

addToMap()

添加步行路线添加到地图上

zoomToSpanPaddingBounds(int paddingLeft, int paddingTop, int paddingRight, int paddingRight)

将步行路线调整到地图显示的最佳视野范围内

核心代码

1.步行路线规划结果解析

JAVA

/**
* 设置路线数据。
*
* @param line 路线数据
*/
public void setData(WalkingRouteLine line) {
    mRouteLine = line;
}

@Override
public final List<OverlayOptions> getOverlayOptions() {
    if (mRouteLine == null) {
        return null;
    }

    List<OverlayOptions> overlayList = new ArrayList<OverlayOptions>();
    if (mRouteLine.getAllStep()!= null
            && mRouteLine.getAllStep().size() > 0) {
        for (WalkingRouteLine.WalkingStep step: mRouteLine.getAllStep()) {
            Bundle b = new Bundle();
            b.putInt("index", mRouteLine.getAllStep().indexOf(step));
            if (step.getEntrance()!= null) {
                overlayList.add((new MarkerOptions()).position(step.getEntrance().getLocation())
                        .rotate((360 - step.getDirection())).zIndex(10).anchor(0.5f, 0.5f)
                        .extraInfo(b)
                        .icon(BitmapDescriptorFactory.fromAssetWithDpi("Icon_line_node.png")));
            }
            // 最后路段绘制出口点
            if (mRouteLine.getAllStep().indexOf(step) == (mRouteLine
                                                                    .getAllStep().size() - 1)
                    && step.getExit()!= null) {
                overlayList.add((new MarkerOptions()).position(step.getExit().getLocation())
                        .anchor(0.5f, 0.5f).zIndex(10)
                        .icon(BitmapDescriptorFactory.fromAssetWithDpi("Icon_line_node.png")));
            }
        }
    }
    // starting
    if (mRouteLine.getStarting()!= null) {
        overlayList.add((new MarkerOptions()).position(mRouteLine.getStarting().getLocation())
                .icon(getStartMarker()!= null? getStartMarker()
                       : BitmapDescriptorFactory.fromAssetWithDpi("Icon_start.png"))
                .zIndex(10));
    }
    // terminal
    if (mRouteLine.getTerminal()!= null) {
        overlayList
                .add((new MarkerOptions())
                        .position(mRouteLine.getTerminal().getLocation())
                        .icon(getTerminalMarker()!= null? getTerminalMarker():
                                BitmapDescriptorFactory
                                        .fromAssetWithDpi("Icon_end.png"))
                        .zIndex(10));
    }

    // poly line list
    if (mRouteLine.getAllStep()!= null
            && mRouteLine.getAllStep().size() > 0) {
        LatLng lastStepLastPoint = null;
        for (WalkingRouteLine.WalkingStep step: mRouteLine.getAllStep()) {
            List<LatLng> watPoints = step.getWayPoints();
            if (watPoints!= null) {
                List<LatLng> points = new ArrayList<LatLng>();
                if (lastStepLastPoint!= null) {
                    points.add(lastStepLastPoint);
                }
                points.addAll(watPoints);
                overlayList.add(new PolylineOptions().points(points).width(15).dottedLine(true)
                        .customTexture(getWalkRoadCustomTexture()).zIndex(0));
                lastStepLastPoint = watPoints.get(watPoints.size() - 1);
            }
        }

    }

    return overlayList;
}

public BitmapDescriptor getWalkRoadCustomTexture() {
    return BitmapDescriptorFactory.fromAsset("Icon_road_blue_arrow.png");
}

复制

深色

复制成功

2.将步行路线添加到地图上

JAVA

/**
* 将步行路线添加到地图上
*/
public final void addToMap() {
    if (mBaiduMap == null) {
        return;
    }

    List<OverlayOptions> overlayOptions = getOverlayOptions();
    if (overlayOptions!= null) {
        mOverlayOptionList.addAll(getOverlayOptions());
    }

    for (OverlayOptions option: mOverlayOptionList) {
        mBaiduMap.addOverlay(option)
    }
}

复制

深色

复制成功

3.将步行路线调整到地图显示的最佳视野范围内

JAVA

/**
* 将步行路线调整到地图显示的最佳视野范围内
*/
public void zoomToSpanPaddingBounds(int paddingLeft, int paddingTop, int paddingRight,
    int paddingBottom) {
    if (mBaiduMap == null) {
        return;
    }
    if (mOverlayList.size() > 0) {
        LatLngBounds.Builder builder = new LatLngBounds.Builder();
        for (Overlay overlay: mOverlayList) {
            // polyline 中的点可能太多，只按marker 缩放
            if (overlay instanceof Marker) {
                builder.include(((Marker) overlay).getPosition());
            }
        }

        mBaiduMap.setMapStatus(MapStatusUpdateFactory
                .newLatLngBounds(builder.build(), paddingLeft, paddingTop, paddingRight,
                        paddingBottom));
    }
}

复制

深色

复制成功

更多功能

步行导航

//mapopen-website-wiki.bj.bcebos.com/demos/iosVideos/iOS步行路线规划.mov

扫码体验

使用产品

iOS地图SDK

>

步行路线规划

下载源码

核心接口

类

接口

描述

- (instancetype)init;

创建路线规划检索实例

BMKRouteSearch

id<BMKRouteSearchDelegate> delegate;

设置路线规划检索监听器

- (BOOL)walkingSearch:(BMKWalkingRoutePlanOption *)walkingRoutePlanOption;

发起步行路线规划检索请求

BMKRouteSearchDelegate

- (void)onGetWalkingRouteResult:(BMKRouteSearch *)searcher

                                       result:(BMKWalkingRouteResult *)result errorCode:(BMKSearchErrorCode)error;

步行路线规划的结果回调函数

NSString *cityName;

路线规划起终点城市参数

BMKPlanNode

NSString *name;

路线规划起终点名称参数

BMKPlanNode *from;

设置路线规划起点参数

BMKWalkingRoutePlanOption

BMKPlanNode *to;

设置路线规划终点参数

BMKPolyline

+ (BMKPolyline *)polylineWithPoints:(BMKMapPoint *)points count:(NSUInteger)count;

设置步行路线规划结果数据

BMKMapView

- (void)addOverlay:(id <BMKOverlay>)overlay;

添加步行路线添加到地图上

BMKWalkRoutePlanViewController

- (void)mapViewFitPolyline:(BMKPolyline *)polyline;

将步行路线调整到地图显示的最佳视野范围内

核心代码

1.步行路线规划结果解析

Objective-C

NSMutableArray *tempArray = [NSMutableArray array];
//+polylineWithPoints: count:坐标点的个数
__block NSUInteger pointCount = 0;
//获取所有步行路线中第一条路线
_routeLine = (BMKWalkingRouteLine *)result.routes.firstObject;
//遍历步行路线中的所有路段
[_routeLine.steps enumerateObjectsUsingBlock:^(id  _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
    //获取步行路线中的每条路段
    BMKWalkingStep *step = _routeLine.steps[idx];
    BMKWalkRouteDetailModel *model = [[BMKWalkRouteDetailModel alloc] init];
    model.instruction = step.instruction;
    NSString *instruction = step.instruction;
    NSDictionary *attrs = @{NSFontAttributeName: [UIFont fontWithName:@"PingFangSC-Regular" size:16 * widthScale]};
    CGSize size = CGSizeMake(KScreenWidth  - 86  * widthScale, MAXFLOAT);
    CGSize  actualsize = [instruction boundingRectWithSize:size options:NSStringDrawingUsesLineFragmentOrigin  attributes:attrs context:nil].size;
    model.cellHeight = actualsize.height + 48 * widthScale;
    [tempArray addObject:model];
    //统计路段所经过的地理坐标集合内点的个数
    pointCount += step.pointsCount;
}];
_detailModels = tempArray;
//+polylineWithPoints: count:指定的直角坐标点数组
BMKMapPoint *points = new BMKMapPoint[pointCount];
__block NSUInteger j = 0;
//遍历步行路线中的所有路段
[_routeLine.steps enumerateObjectsUsingBlock:^(id  _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
    //获取步行路线中的每条路段
    BMKWalkingStep *step = _routeLine.steps[idx];
    //遍历路段所经过的地理坐标集合
    for (NSUInteger i = 0; i < step.pointsCount; i ++) {
        //将每条路段所经过的地理坐标点赋值给points
        points[j].x = step.points[i].x;
        points[j].y = step.points[i].y;
        j ++;
    }
}];

复制

深色

复制成功

2.将步行路线和起终点添加到地图上

Objective-C

//设置起点
CLLocationCoordinate2D start = BMKCoordinateForMapPoint(points[0]);
_startAnnotation = [[BMKPointAnnotation alloc] init];
_startAnnotation.coordinate = start;
[self.mapView addAnnotation:_startAnnotation];
//设置终点
CLLocationCoordinate2D end = BMKCoordinateForMapPoint(points[pointCount - 1]);
_endAnnotation = [[BMKPointAnnotation alloc] init];
_endAnnotation.coordinate = end;
[self.mapView addAnnotation:_endAnnotation];
//根据指定直角坐标点生成一段折线
BMKPolyline *polyline = [BMKPolyline polylineWithPoints:points count:pointCount];
/**
    向地图View添加Overlay，需要实现BMKMapViewDelegate的-mapView:viewForOverlay:方法
    来生成标注对应的View
    
    @param overlay 要添加的overlay
    */
[_mapView addOverlay:polyline];

复制

深色

复制成功

3.将步行路线调整到地图显示的最佳视野范围内

Objective-C

//根据polyline设置地图范围
- (void)mapViewFitPolyline:(BMKPolyline *)polyline {
    double leftTop_x, leftTop_y, rightBottom_x, rightBottom_y;
    if (polyline.pointCount < 1) {
        return;
    }
    BMKMapPoint pt = polyline.points[0];
    leftTop_x = pt.x;
    leftTop_y = pt.y;
    //左上方的点lefttop坐标（leftTop_x，leftTop_y）
    rightBottom_x = pt.x;
    rightBottom_y = pt.y;
    //右底部的点rightbottom坐标（rightBottom_x，rightBottom_y）
    for (int i = 1; i < polyline.pointCount; i++) {
        BMKMapPoint point = polyline.points[i];
        if (point.x < leftTop_x) {
            leftTop_x = point.x;
        }
        if (point.x > rightBottom_x) {
            rightBottom_x = point.x;
        }
        if (point.y < leftTop_y) {
            leftTop_y = point.y;
        }
        if (point.y > rightBottom_y) {
            rightBottom_y = point.y;
        }
    }
    BMKMapRect rect;
    rect.origin = BMKMapPointMake(leftTop_x, leftTop_y);
    rect.size = BMKMapSizeMake(rightBottom_x - leftTop_x, rightBottom_y - leftTop_y);
    UIEdgeInsets padding = UIEdgeInsetsMake(KStatuesBarHeight + 170 * widthScale, 20 * widthScale, KStatuesBarHeight + 170 * widthScale, 20 * widthScale);
    [_mapView fitVisibleMapRect:rect edgePadding:padding withAnimated:YES];
}

复制

深色

复制成功

更多功能

步行导航

文档全面上新