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

高德地图开发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中开源。