高德地图开发Android 地图SDK开发指南出行路线规划—步行出行路线规划
map开发

高德地图开发Android 地图SDK开发指南出行路线规划—步行出行路线规划

步行出行路线规划 最后更新时间: 2021年01月22日

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

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

第 1 步，初始化 RouteSearch 对象

Java

routeSearch = new RouteSearch(this);

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

Java

routeSearch.setRouteSearchListener(this);

第 3 步，设置搜索参数

通过 WalkRouteQuery(RouteSearch.FromAndTo fromAndTo, int mode) 设置搜索条件。其中：

  • fromAndTo，路径的起终点；
  • mode，计算路径的模式。SDK提供两种模式：RouteSearch.WALK_DEFAULT 和 RouteSearch.WALK_MULTI_PATH。

Java

//初始化query对象，fromAndTo是包含起终点信息，walkMode是步行路径规划的模式
WalkRouteQuery query = new WalkRouteQuery(fromAndTo, walkMode);

第 4 步，发送请求

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

Java

routeSearch.calculateWalkRouteAsyn(query);//开始算路

第 5 步，接收数据

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

说明：

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

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

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

Java

public void onWalkRouteSearched(WalkRouteResult result, int rCode) {
   //解析result获取算路结果，可参考官方demo
}

注意事项

1、使用上述功能需要下载地图SDK，导入搜索功能的jar包。

2、地图SDK V4.1.3版本开始，SDK不再提供 com.amap.api.maps.overlay 包下的 overlay，已在官方demo中开源。