开发 HarmonyOS NEXT 地图SDK 开发指南 出行路线规划 货车出行路线规划

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

从搜索功能1.0.1 版本开始支持货车出行路线规划功能,货车出行路线规划的具体策略可参见服务文档。

第 1 步,初始化 RouteSearch 对象

this.mRouteSearch = new RouteSearch(this.mContext)

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

this.mRouteSearch.setOnTruckRouteSearchListener(this.onTruckRouteSearchListener)

第 3 步,设置搜索参数

通过 TruckRouteQuery(fromAndTo: FromAndTo, mode: number,passedByPoints:ArrayList<LatLonPoint>|null|undefined,truckSize: number) 设置搜索条件。

参数

说明

fromAndTo

路径的起终点

mode

计算路径的模式(可选),默认为“躲避拥堵”

passedByPoints

途经点

truckSize

货车大小,默认轻型车

const fromAndTo = new FromAndTo(this.mStartPoint, this.mEndPoint);
//设置车牌
fromAndTo.setPlateNumber("A000XXX");
fromAndTo.setPlateProvince("京");
const query = new TruckRouteQuery(fromAndTo,RouteSearch.TRUCK_AVOID_CONGESTION,null,RouteSearch.TRUCK_SIZE_HEAVY); 
//设置车辆信息
query.setTruckAxis(6)
query.setTruckHeight(3.9)
query.setTruckWidth(3)
query.setTruckLoad(45)
query.setTruckWeight(50)

第 4 步,发送请求

使用类 RouteSearch 的calculateTruckRouteAsyn(truckQuery: TruckRouteQuery) 方法进行路线规划路径计算。

this.mRouteSearch.calculateTruckRouteAsyn(query)

第 5 步,接收数据

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

说明:

1)可以在回调中解析result,获取货车的路径。

2)result.getPaths()可以获取到 TruckPath 列表,货车路线的具体方案的详细信息可参考 TruckPath 类。

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

private  onTruckRouteSearchListener:OnTruckRouteSearchListener = {

onTruckRouteSearched:(result: TruckRouteRestult, errorCode: number): void => {
      //解析result获取算路结果,可参考官方demo
      //建议通过TruckPath中getRestriction() 判断路线上是否存在限行

  }

返回顶部 示例中心 常见问题 智能客服 公众号
二维码