路径规划可根据起点、终点的经纬度以及POI ID,给用户提供出行路线。路径规划成功后得到1条路线信息,根据路线信息可以在地图上进行位置标注、绘制路线等操作。 发起路径规划方法如下,
//发起步行导航路线规划
mWalkNaviManager.searchRoute(start, dest,
new TencentRouteSearchCallback() {
@Override
public void onRouteSearchFailure(int code, String msg) {
// 算路失败需查看具体的error code类型
}
@Override
public void onRouteSearchSuccess(ArrayList<RouteData> arrayList) {
// 若算路成功,可通过result获得路线数据,通过地图SDK绘制路线
}
});
路径规划参数如下面表格所示:
| 参数 | 类型 | 是否必填 | 说明 | |
|---|---|---|---|---|
| dest | NaviPoi | 是 | 路径规划终点,一般使用检索接口获取 | |
| mLatitude | double | 是 | 纬度坐标 | |
| mLongitude | double | 是 | 经度坐标 | |
| mPoiId | Striing | 否 | 终点POI ID(可通过腾讯位置服务地点搜索服务得到),当目的地为较大园区、小区时,会以引导点作为终点(如出入口等),体验更优。该参数优先级高于坐标,但是当目的地无引导点数据或POI ID失效时,仍会使用坐标作为终点 | |
| mPoiName | Striing | 否 | 终点的名称 | |
| start | NaviPoi | 是 | 路径规划起点,一般使用当前定位点赋值 | |
| mLatitude | double | 是 | 纬度坐标 | |
| mLongitude | double | 是 | 经度坐标 | |
| uid | Striing | 否 | 该地点的唯一标识,即poi id。解释同下方终点的uid |
| 参数 | 类型 | 说明 |
|---|---|---|
| errorCode | String | 算路失败错误码,具体见下 |
| errorMsg | String | 算路失败错误描述 |
| routes | ArrayList< RouteData > | 算路的路线数据,包含1条路线 |
每条路线RouteData 包含数据如下:
| 参数 | 类型 | 说明 |
|---|---|---|
| mRecommendMsg | String | 推荐该路线的理由 |
| routeId | String | 路线id |
| mDistance | int | 路线总距离,单位:米 |
| mTime | int | 总预计时间. 单位,分钟 |
| mRoutePoints | List< LatLng > | 路线点串数据, 可以用地图SDK绘制路线 |
错误信息类列表如下,
errCode = 1001, //< 网络错误
errCode = 3001, //< 返回数据无效
errCode = 3002, //< 起终点参数错误
errCode = 3003, //< 途经点参数错误
errCode = 3004, //< 吸附失败
errCode = 3005, //< 算路失败
errCode = 3006, //< 鉴权失败
errCode = 3007, //< 点串导航时参数不合法
errCode = 3008, //< 路线过长,无法算路
errCode = 3009, //< 起终点坐标过近
errCode = 3999, //< 服务器内部错误
有帮助
没帮助