骑行路线规划

功能场景

物流快递、出行、O2O等APP中常使用骑行路线规划功能，展示小车到目的地的路线、时间、里程信息等。

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

扫码体验

使用产品

Android地图SDK

>

骑行路线规划

下载源码

核心接口

类

接口

描述

newInstance()

创建路线规划检索实例

setOnGetRoutePlanResultListener(OnGetRoutePlanResultListener listener)

设置路线规划检索监听器

RoutePlanSearch

bikingSearch(BikingRoutePlanOption option)

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

destory()

释放路线规划检索实例

OnGetRoutePlanResultListener

onGetBikingRouteResult(BikingRouteResult bikingRouteResult)

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

PlanNode

withCityNameAndPlaceName(String cityName, String placeName)

路线规划起终点参数

from(PlanNode startNode)

设置路线规划起点参数

BikingRoutePlanOption

to(PlanNode endNode)

设置路线规划终点参数

ridingType(int type)

设置骑行路线规划类型

setData(BikingRouteLine routeLine)

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

BikingRouteOverlay

addToMap()

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

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

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

核心代码

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

JAVA

/**
* 设置路线数据。
*
* @param line 路线数据
*/
public void setData(BikingRouteLine 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 (BikingRouteLine.BikingStep 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 (BikingRouteLine.BikingStep 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(18).dottedLine(true)
                        .customTexture(getBikeRoadCustomTexture()).zIndex(0));
                lastStepLastPoint = watPoints.get(watPoints.size() - 1);
            }
        }

    }

    return overlayList;
}


public BitmapDescriptor getBikeRoadCustomTexture() {
    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)ridingSearch:(BMKRidingRoutePlanOption *)ridingRoutePlanOption;

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

BMKRouteSearchDelegate

- (void)onGetRidingRouteResult:(BMKRouteSearch *)searcher result:(BMKRidingRouteResult *)result errorCode:(BMKSearchErrorCode)error;

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

NSString *cityName;

路线规划起终点城市参数

BMKPlanNode

NSString *name;

路线规划起终点名称参数

BMKPlanNode *from;

设置路线规划起点参数

BMKWalkingRoutePlanOption

BMKPlanNode *to;

设置路线规划终点参数

BMKRidingRoutePlanOption

NSInteger ridingType;

设置骑行类型（0：普通骑行，1：电动车骑行），默认是普通骑行

BMKPolyline

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

设置骑行路线规划点数据

BMKMapView

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

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

BMKBikeRoutePlanViewController

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

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

核心代码

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

Objective-C

NSMutableArray *tempArray = [NSMutableArray array];
//+polylineWithPoints: count:坐标点的个数
__block NSUInteger pointCount = 0;
//获取所有骑行路线中第一条路线
BMKRidingRouteLine *routeline = (BMKRidingRouteLine *)result.routes.firstObject;
_routeLine = routeline;
//遍历骑行路线中的所有路段
[routeline.steps enumerateObjectsUsingBlock:^(id  _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
    //获取骑行路线中的每条路段
    BMKRidingStep *step = routeline.steps[idx];
    BMKBikeRouteDetailModel *model = [[BMKBikeRouteDetailModel 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 copy];
//+polylineWithPoints: count:指定的直角坐标点数组
BMKMapPoint *points = new BMKMapPoint[pointCount];
__block NSUInteger j = 0;
//遍历骑行路线中的所有路段
[routeline.steps enumerateObjectsUsingBlock:^(id  _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
    //获取骑行路线中的每条路段
    BMKRidingStep *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];

复制

深色

复制成功

更多功能

骑行导航

文档全面上新