骑行出行路线规划 最后更新时间: 2026年05月26日

骑行出行路线规划

从搜索功能1.0.0 版本开始支持骑行出行路线规划功能。

骑行路径规划可以根据起终点和骑行路线的数据，使用 RideRouteOverlay 画出骑行路线图层，包括起终点和转弯点。另外也可以自定义起终点和骑行转弯点的图标。

注意：地图SDK V1.0.0版本开始，SDK不再提供 com.amap.api.maps.overlay 包下的 overlay，已在官方demo中开源。

第 1 步，初始化 RouteSearch 对象

this.mRouteSearch = new RouteSearch(this.mContext)

第 2 步，设置数据回调监听器

this.mRouteSearch.setRouteSearchListener(this.onRouteSearchListener)

第 3 步，设置搜索参数

通过 RideRouteQuery(fromAndTo:FromAndTo,mode?:number) 设置搜索条件。参数：fromAndTo，路径的起终点；mode，计算路径的模式。可选，默认为“推荐路线及最快路线综合模式”。

const fromAndTo = new FromAndTo(this.mStartPoint, this.mEndPoint);
const query = new RideRouteQuery(fromAndTo);
query.setExtensions(RouteSearch.EXTENSIONS_ALL);

第 4 步，发送请求

使用类 RouteSearch 的 calculateRideRouteAsyn(query:RideRouteQuery) 方法进行骑行规划路径计算。

this.mRouteSearch.calculateRideRouteAsyn(query)

第 5 步，接收数据

在 RouteSearch.OnRouteSearchListener 接口回调方法 onRideRouteSearched: (result: RideRouteResult, errorCode: number): void  处理骑行规划路径结果。返回的信息中您可以获得预估的骑行距离、骑行的预计时间、骑行路段的道路名称、坐标点等信息。

说明：

1）可以在回调中解析result，获取骑行的路径。

2）result.getPaths()可以获取到 RidePath 列表，骑行路径的详细信息可参考 RidePath 类。

3）返回结果成功或者失败的响应码。1000为成功，其他为失败（详细信息参见网站开发指南-实用工具-错误码对照表）

  private onRouteSearchListener: OnRouteSearchListener = {
    onRideRouteSearched: (result: RideRouteResult, errorCode: number): void => {
      //解析result获取算路结果，可参考官方demo
    }
  }

显示效果如下：

骑行出行路线规划V2

从搜索功能1.0.0 版本开始支持骑行出行路线规划功能。

骑行路径规划可以根据起终点和骑行路线的数据，使用 RideRouteOverlay 画出骑行路线图层，包括起终点和转弯点。另外也可以自定义起终点和骑行转弯点的图标。

注意：地图SDK V1.0.0版本开始，SDK不再提供 com.amap.api.maps.overlay 包下的 overlay，已在官方demo中开源。

第 1 步，初始化 RouteSearch 对象

this.mRouteSearch = new RouteSearchV2(this.mContext)

第 2 步，设置数据回调监听器

this.mRouteSearch.setRouteSearchListener(this.onRouteSearchListener)

第 3 步，设置搜索参数

通过 RideRouteQueryV2(fromAndTo:FromAndTo) 设置搜索条件。参数：fromAndTo，路径的起终点

const fromAndTo = new FromAndTo(this.mStartPoint, this.mEndPoint);
const query = new RideRouteQueryV2(fromAndTo); query.setShowFields(0b0011111)

第 4 步，发送请求

使用类 RouteSearchV2 的 calculateRideRouteAsyn(query:RideRouteQuery) 方法进行骑行规划路径计算。

this.mRouteSearch.calculateRideRouteAsyn(query);

第 5 步，接收数据

在 RouteSearchV2.OnRouteSearchListener 接口回调方法 onRideRouteSearched: (result: RideRouteResult, errorCode: number): void  处理骑行规划路径结果。返回的信息中您可以获得预估的骑行距离、骑行的预计时间、骑行路段的道路名称、坐标点等信息。

说明：

1）可以在回调中解析result，获取骑行的路径。

2）result.getPaths()可以获取到 RidePath 列表，骑行路径的详细信息可参考 RidePath 类。

3）返回结果成功或者失败的响应码。1000为成功，其他为失败（详细信息参见网站开发指南-实用工具-错误码对照表）

private onRouteSearchListener: OnRouteSearchListenerV2 = {
    onRideRouteSearched: (result: RideRouteResultV2, errorCode: number): void => {
      //解析result获取算路结果，可参考官方demo
    }
  }

显示效果如下：