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

步行出行路线规划

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

第 1 步，初始化 RouteSearch 对象

this.mRouteSearch = new RouteSearch(this.mContext)

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

this.mRouteSearch.setRouteSearchListener(this.onRouteSearchListener)

第 3 步，设置搜索参数

通过 WalkRouteQuery(fromAndTo: FromAndTo) 设置搜索条件。其中：

fromAndTo，路径的起终点；

//fromAndTo，路径的起终点；
const fromAndTo = new FromAndTo(this.mStartPoint, this.mEndPoint)
// 第一个参数表示路径规划的起点和终点
const query = new WalkRouteQuery(fromAndTo); 
//设置扩展字段,可选
query.setExtensions(RouteSearch.EXTENSIONS_ALL);

第 4 步，发送请求

使用类 RouteSearch 的 calculateWalkRouteAsyn(WalkRouteQuery query) 方法进行步行规划路径计算。

this.mRouteSearch.calculateWalkRouteAsyn(query)

第 5 步，接收数据

在 OnRouteSearchListener 接口回调方法中的 onWalkRouteSearched: (walkRouteResult: WalkRouteResult, errorCode: number) => void处理步行规划路径结果。返回的信息中您可以获得路段的距离、步行的预计时间、步行路段的坐标点、步行路段的道路名称、导航主要操作等信息。显示效果如下：

说明：

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

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

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

private onRouteSearchListener: OnRouteSearchListener = {
  onWalkRouteSearched: (result: WalkRouteResult, errorCode: number) => {
    //todo: 处理result步行路径信息
  },
  onDriveRouteSearched: () => {
  },
  onRideRouteSearched: () => {
  },
  onBusRouteSearched: () => {
  }
}

步行出行路线规划V2

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

第 1 步，初始化 RouteSearchV2 对象

this.mRouteSearch = new RouteSearchV2(this.mContext)