货车路径规划高级版 最后更新时间: 2026年05月14日

参数名

含义

规则说明

是否必填

缺省值

key

请求服务权限标识 

用户在高德地图官网申请Web服务API类型KEY 

是

无

origin

出发点经纬度

填入规则：X,Y，采用","分隔，例如“ 117.500244, 40.417801 ”，小数点后不得超过6位

是

无

originid 

出发POI的唯一编号 

当起点为POI时，建议填充此值。填充此值以后，会影响路径规划的结果。举例来说：当起点的经纬度在高架桥上时，若填充了此值我们会以此POI的经纬度作为更高优的处理。

否

无

originidtype 

出发POI的类型 

当起点为POI时，建议填充此值。

否

无

startangle

起点方向角信息

起点GPS方向，支持上传起点的方向角信息，以正北为0度，取值为[0-359]，与GPS坐标方向相同。起点方向信息可以有助于判定起点所在位置。

否

无

speed

起点速度信息

支持上传起点速度信息，取值为[0-500]，表达起步时的车辆速度。单位：千米/小时。

否

无

destination

目的地经纬度

填入规则：X,Y，采用","分隔，例如“ 117.500244, 40.417801 ”，小数点后不得超过6位

是

无

destinationid 

终点POI的唯一编号 

当终点为POI时，建议填充此值。填充此值以后，会影响路径规划的结果，会以此POI的经纬度作为更高优的处理。

否

无

destinationtype 

终点POI的类型 

当终点为POI时，建议填充此值。

否

无

waypoints

途经点

规则：经度和纬度用“,”分隔，坐标点之间用";"分隔 。最大数目：16个坐标点，如果输入多个途径点，则按照用户输入的顺序进行路径规划"  

否

无

via_to_mainroad

途经点顺路吸附大路

途经点顺路吸附大路：默认0

0.不吸附，保留原始坐标

1.吸附，保留吸附坐标

多途经点则用数组按顺序表达，如0,1,0,1

否

0

diu

设备唯一编号

android的imei，ios的idfa

否

无

strategy

驾车选择策略

1，躲避拥堵：返回的结果考虑路况，尽量躲避拥堵而规划路径；对应导航SDK货导策略12；

2，不走高速：返回的结果考虑路况，不走高速；对应导航SDK货导策略13；

3，避免收费：返回的结果考虑路况，尽可能规划收费较低甚至免费的路径；对应导航SDK货导策略14；

4，躲避拥堵+不走高速：返回的结果考虑路况，尽量躲避拥堵，并且不走高速；对应导航SDK货导策略15；

5，避免收费+不走高速：返回的结果考虑路况，尽量不走高速，并且尽量规划收费较低甚至免费的路径结果；对应导航SDK货导策略16；

6，躲避拥堵+避免收费：返回的结果考虑路况，尽量的躲避拥堵，并且规划收费较低甚至免费的路径结果；对应导航SDK货导策略17；

7，躲避拥堵+避免收费+不走高速：返回的结果考虑路况，尽量躲避拥堵，规划收费较低甚至免费的路径结果，并且尽量不走高速路；对应导航SDK货导策略18；

8，高速优先：返回的结果考虑路况，会优先选择高速路；对应导航SDK货导策略19；

9，躲避拥堵+高速优先：返回的结果考虑路况，会优先考虑高速路，并且会考虑路况躲避拥堵；对应导航SDK货导策略20；

10，无路况+速度优先：基于历史的通行速度数据，不考虑当前路况的影响，返回速度优先的路；如果不需要路况干扰计算结果，推荐使用此策略；（导航SDK货导策略无对应，真实导航时均会考虑路况）--即将废弃，建议使用11

11，综合最优：返回的结果会考虑路况，躲避拥堵，速度优先以及费用优先；500Km规划以内会返回多条结果，500Km以外会返回单条结果；考虑路况情况下的综合最优策略，推荐使用；对应导航SDK货导策略10；

12，无路况+不走高速：基于历史的通行速度数据，不考虑当前路况的影响，且不走高速路线，返回速度优先的路--即将废弃，建议使用2

否

1

emulate_matrix

是否保持算路结果稳定性

是否保持算路结果稳定性

0：否，默认

1：是

否

0

intelligent_sorting

智能排序

传0和1

1：执行智能排序

0：不执行智能排序，默认

否

0

size 

车辆大小

高德此分类依据国标。1：微型车，2：轻型车，3：中型车，4：重型车

高德此分类依据国标。

1：微型车，车长小于等于3.5m，总质量小于等于1800kg。

2：轻型车，车长小于6m，总质量小于4500kg

3：中型车，车长大于等于6m，总质量大于等于4500kg且小于12000kg。

4：重型车，车长大于等于6m，总质量大于等于12000kg。

是

无

length

车辆长度

单位米，货车或者特种车辆时生效，取值[0 – 25.0]米，服务默认6米

否

6

height 

车辆高度

单位米，取值[0 – 25.5]米，默认 1.6 米，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。   

否

1.6

width 

车辆宽度

单位米，取值[0 – 25.5]米，默认 2.5 米，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。   

否 

2.5

load

车辆总重

单位吨，取值[0 – 100]吨，默认 10 吨，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。   总重的含义是核定载重加上车辆自重。

否 

10

weight

货车核定载重

单位吨，取值[0 – 100]吨，默认 0.9 吨，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。   核定载重的含义是可装载货物的最大重量。

否 

0.9

axis

车辆轴数

单位个，取值[0 –255]个，默认 2个轴，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。轴数影响通行费用的计算。   

否 

2

cartype

车辆类型

0：普通货车（默认值）

1：纯电动货车

2：插电混动货车

否

0

plate

车牌号

车牌号，默认为空

取值如:京DFZ239,京ABZ239

plate车牌号 与（province省份、number车牌详情）二者选其一，若同时存在则以前者为准

否

无

province

车牌省份

用汉字填入车牌省份缩写。用于判断是否限行 

否 

无

number

车牌详情

填入除省份及标点之外的字母和数字（需大写），用于判断限行相关。 支持6位传统车牌和7位新能源车牌。

否 

无

restriction

是否开启规避限行

是否开启规避限行：默认1

0：不规避限行

1：规避限行

否

1

exempts

豁免限行政策

支持上传需要豁免的限行政策id，此政策id需要通过限行接口获取。最多支持传入10条限行政策进行豁免，传入后的政策，在算路时将不算为限行。多个限行政策id之间使用";"分隔。

否

无

has_pass

是否使用通行证信息

false：默认值。代表车牌有办理过通行证，算路对通行证类的限行区域豁免。（提前在高德合作城市的小程序、APP中进行过办证操作的，可以选择）

true：代表高德算路引擎，会查询车牌对应的通行证办理信息的进行算路，可结合cer_codes一同使用。

否

FALSE

cer_codes

通行证信息

算路时直接传入通行证证件编码，则可将该证件可通行的区域豁免。最大可以传16个证件编码，分割符；证件编码由高德提供，为16位数字。默认为空。

否

无

consider_load

算路是否放宽限重条件

算路是否放宽限重条件，对2吨以上限重禁行忽略

0：不放宽限重条件

1：放宽限重条件

否

0

avoid_ferry

是否避让轮渡

是否避让轮渡，默认0

0-否

1-是

否

0

avoidpolygons

避让区域 

区域避让，支持100个避让区域，每个区域最多可有16个顶点，每个区域的最大面积是100平方公里。经度和纬度用"",""分隔，坐标点之间用";"分隔，区域之间用"|"分隔。如果是四边形则有四个坐标点，如果是五边形则有五个坐标点。

否

无

showpolyline

是否返回路线数据

当取值为1时，steps与tmcs下的polyline数据会正常返回；当取值为0时，steps与tmcs下的polyline数据为空。

否

1

nosteps

是否返回steps字段内容

当取值为0时，steps字段内容正常返回；当取值为1时，steps字段内容为空。

否

0

show_fields

返回结果控制

（该字段为付费字段功能，如需咨询使用请提交工单）

show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则：

1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型；

2、多个字段间采用“,”进行分割；

3、show_fields未设置时，只返回基础信息类内字段；

4、目前取值支持（需单独开通权限）：

"toll_gate"：收费站信息

"cameras"：电子眼信息

"general"：交通设施信息

"incident"：交通事件信息

“restric_rules”：道路上相关的限行信息

“forbidden”：道路上相关的禁止信息

“road_info”：道路等级

“road_composition”：路型

“road_form”：车道数

“mpid”：支持存储整条路线mpid

"light_info"：道路上的红绿灯信息

"speed_limit"：道路上的限速值信息

“slope_info”：坡度信息

"link_type"：道路类型（轮渡/桥梁/隧道）

“toll_gate_status”：沿途收费站拥堵和事件信息

否

无

experience_points

指定经验轨迹

用户指定经验轨迹,包括起终点的所有坐标点：x,y;x,y

点限制[5,20000]

show_fields中传mpid且有mpid权限时，才生效；

通过mpid还原或通过指定经验轨迹还原，只能二选一使用；

轨迹点上限数量，默认最大20000，超出需额外配置权限；

否

无

lineValue

直线阈值

直线阈值，取值[0,25000]，默认5000

在当前位置距离路线在当前直线距离范围内，则会尽量规划回原路。超出则不强制回到原路线。

show_fields中传mpid且有mpid权限时，才生效；

通过mpid还原或通过指定经验轨迹还原，只能二选一使用

否

5000

mpid_timeliness

mpid生效存储周期

mpid生效存储周期

0: mpid长期存储（默认）

1: mpid短时存储（如7天）--适用量级大的客户

需额外配置权限；

1: mpid短时存储，与experience_points指定经验轨迹不能同时选择

否

0

mpid

路线还原id

mpid的是一个路线的唯一id，是开发者之前使用自定义导航产品中的路线保存接口收藏的id，可以理解为是用户事前收藏的路线的id。传入此参数的目的就是希望在本次路线计算中，尽量的能走到原来收藏的路线上。

通过mpid还原或指定经验轨迹还原，只能二选一使用；

指定经验轨迹还原需要在showfields字段开通mpid权限才可使用

否

无

return_highway_route

是否返回全程高速路线

是否返回全程高速路线，取值：

0-否，默认

1-是（需单独配置权限）

否

0

returnEconomicRoute

是否返回经济路线

是否返回经济路线，取值：

0-否，默认

1-是（需单独配置权限）

否

0

show_more_route

是否需要更多路线

是否需要更多路线，支持返回3-10条路线结果

0-否，默认

1-是

默认返回路线最多3条，更多条数需单独配置权限

否

0

返回字段

含义

规则说明

data

数据体

count

总共返回路线数

route

里面包含距离路线信息

origin 

起点坐标

destination 

终点坐标

via_to_mainroad_points

途经点吸附后的坐标

多个用;分割，成功则返回具体坐标，不成功或不吸附则赋值原始途经点坐标，如116.10639452613512,40.27019658581846;116.10639452613512,40.27019658581846

incident

当请求参数中的show_fields字段中填写了incident参数时，返回此类交通事件信息，包含道路上和道路外的信息

inner

path_idx

所在道路索引

title

标题

desc

描述

lon

经度

lat

纬度

event_type

事件类型

详见附表

outer

同inner

toll_gate_status

沿途收费站动态信息

当请求参数中的show_fields字段中填写了toll_gate_status参数时，返回此路径上的收费站动态信息。

poiId

收费站POIID

例如"BZDCPZ009O"

name

收费站名称

例如"白庙收费站"

adcode

收费站所在城市

例如 110000

freewayName

收费站的高速名称

字段可能为空

例如"G6京藏高速"

type

收费站类型

1-入口（上高速）

2-出口（下高速）

其他取值：无法确定出入口

poiLng

收费站坐标

例如116.765347

poiLat

收费站坐标

例如39.935543

congestions

是否有拥堵

没有拥堵为空数组

startTime

拥堵开始时间 

毫秒，例如1752437280000

duration

拥堵持续时间

秒，例如10851=3小时51秒

distance

拥堵距离

米，例如346=346米

polyline

拥堵路线坐标

"116.769454,39.937035;116.768918,39.936993;116.768918,39.936993;116.768172,39.936928;"

speed

平均速度

当前通过收费站路段的平均时速

freeSpeed

自由流速度

无拥堵情况下通过收费站路段的平均时速

reliability

拥堵可信度

<85低可信，85-90中等可信，>85高可信

events

是否有关联事件

没有事件为空数组

eventId

事件ID

例如"129710398"

headLine

事件标题

例如"G95首都环线高速出口南向北封路"

brief

事件简要描述

例如"前方道路道路关闭"

eventDesc

事件详细描述

例如"G95首都环线高速出口南向北道路关闭"

eventForm

事件坐标形态

1-点事件    2-线事件 

3-面事件    4-多线事件

geoCoord

事件坐标

例如"117.248962,40.621199"

多个点为x,y;x,y

eventType

事件类型

101/102 事故

103 故障车

201 施工

301 管制（非完全封闭）

302/303/304 道路关闭

505 障碍物

536 车道异常占用

501 积水

502 积雪

700-710 灾害

901 公告

reliability

事件置信度

0～10，≥8可信

roadName

道路名称

例如"G95首都环线高速"

startTime

事件开始日，秒

具体开始时间=startDate+timeSlog[0].startTime；

endDate

预计结束日，秒

具体结束时间=endDate+timeSlog[0].endTime

已经结束的事件，实际结束时间见updateTime

updateTime

事件最后在线时间，毫秒

最后在线时间距离目前时间超过3分钟可以认为已经下线

daySel

时间重复类型

0：表示持续

daySel大于0时，表示在startDate到endDate范围内指定的星期数，每天都在timeSlot指定的startTime到endTime时间段内生效

64：周日

32：周一

16：周二

8：周三

4：周四

2：周五

1：周六

127：每一天

timeSlot

事件生效时间段

startTime

开始时间

从一天0点开始算起的秒级时间戳

endTime

结束时间

从一天0点开始算起的秒级时间戳

facilities

cameras

电子眼信息

当请求参数中的show_fields字段中填写了cameras参数时，返回此路径上的电子眼信息。

path_index

所在道路索引

step_index

所在导航段索引

lon

经度

lat

纬度

type

电子眼类型

电子眼类型参见附件

speed

限速值（支持危化品车辆）

只对限速相关电子眼(0:测速，8/9:区间测速)透出，限速无关电子眼无此字段

dist_to_end

区间测速电子眼到区间终点的距离

match_idx

区间测速电子眼匹配id

general

一般设施信息

当请求参数中的show_fields字段中填写了general参数时，返回此路径上的设施信息。

path_index

所在道路索引

step_index

所在导航段索引

lon

经度

lat

纬度

type

设施类型

设施类型参见附件

speed

限速值

toll_gate

收费站信息

当请求参数中的show_fields字段中填写了toll_gate参数时，返回此路径上的收费站信息。

path_idx

所在道路索引

step_idx

所在导航段索引

lon

经度

lat

纬度

name

收费站名称

type

收费口类型

restric_rules

ruleid

限行id

path_idx

所在第几条路线索引

type

限行类型

0：本埠和外埠号牌（默认）

1：本埠车限制规则

2：外埠车限制规则

policy_name

限行政策名

adcode

限行所在城市

ring

是否环装限行

true/false

vehicle

限行车辆类型

0：小客车 1：货车

2：全部

effective_time

限行生效时间描述

例如：工作日9:00-17:00限行

summary

限行摘要信息

例如：五环路（含）以内道路

desc

简要描述

例如：2021年10月4日至2022年1月2日，外地客车尾号限行

星期一限行：5和0；

星期二限行：1和6；

星期三限行：2和7；

星期四限行：3和8；

星期五限行：4和9

尾号为字母时：A～Z视作0

other_desc

详细描述

center_point

中心点位置

line_points

线状限行形状点

area_points

区域形状点

forbidden

path_idx

所在第几条路线索引

step_idx

所在step索引

lon

经度

lat

纬度

type

禁行类型

0：本埠和外埠号牌（默认）

1：本埠车限制规则

2：外埠车限制规则

start_time

禁行起始时间

end_time

禁行结束时间

paths 

驾车的具体方案 

distance 

此方案的行驶距离 

单位：米

repeated_lines

重叠轨迹，若路线重叠导致定线存储失败，则mpid为空，且设置repeated_lines

list<String>，示例："repeated_lines":["118.948503,31.858351;118.950359,31.859289","118.950359,31.859289;118.950053,31.859761","118.950053,31.859761;118.949768,31.860196;118.949752,31.860255","118.947622,31.860003;118.947419,31.859574;118.946995,31.858764","118.949334,31.860899;118.94928,31.860963","118.947773,31.860346;118.947622,31.860003","118.946308,31.857573;118.945858,31.856886;118.945579,31.856494","118.946711,31.858243;118.946308,31.857573","118.946995,31.858764;118.946711,31.858243","118.949436,31.860775;118.949334,31.860899","118.949752,31.860255;118.949704,31.860351;118.949699,31.860367;118.949682,31.860448;118.949618,31.86055;118.949436,31.860775"]

mpid

定线存储的mpid

duration 

此方案的耗时

单位：秒

highway_route

此路线是否为全程高速路线

0否

1是

economic_route

此路线是否为经济路线

0否

1是

strategy 

导航策略 

tolls 

此导航方案道路收费金额 

单位：元 

toll_distance 

此导航方案道路收费距离长度 

单位：米

restriction 

限行结果 

-1，路线上没有限行

0，未知（未输入完整/正确车牌号信息时候显示）

1，已规避限行

2，起点限行

3，途径点在限行区域内（设置途径点才出现此报错）

4，途径限行区域

5，终点限行

traffic_lights 

此方案红绿灯总数 

单位：个 

labels

推荐标签

type

标签类型

content

标签内容

waypoints

途经点，顺序与输入waypoints一致 （输入waypoints时才会有此结点返回）

location

途经点原始坐标

distance

起点到该途经点的距离，单位：米

duration

起点到该途经点的预估耗时，单位：秒

steps 

具体方案

instruction 

行驶指示

例如：沿火器营路向南行驶112米左转 

orientation 

方向

road 

道路名

distance 

此路段距离

单位：米

tolls 

此路段收费金额

单位：元

toll_distance 

收费路段距离

单位：米 

toll_road 

主要收费道路

duration 

此路段预计时间

polyline 

此路段的坐标点

action 

导航主要动作

例如：左转 

assistant_action 

导航辅助动作

例如：进入主路

tmcs 

驾车导航详细信息

distance 

此段路长度

status 

路况

0：未知

1：畅通

2：缓行

3：拥堵

polyline 

此分段的路线

light_info

红绿灯信息

jsonarray

location

红绿灯位置，lng,lat

string类型，如123.45,40.111

slopeInfo

slopeLength

坡长

注意: 连续大于500m才会计算透出

starIndex

polyline坐标索引

endIndex

polyline坐标索引

slopeType

坡度类型

1 上坡

2下坡

speed_limit

限速信息

jsonarray

index_start

路段起点序号，对应polyline坐标点的序号

index_end

路段终点序号，对应polyline坐标点的序号

limit

限速值

double类型，km/h

road_info

distance

此段路长度

road_class

道路等级

0：高速公路

1：国道

2：省道

6：城市快速道

9：普通道路

10：非导航道路

link_info

distance

此段路长度

link_type

道路类型

0：道路（默认）

1：轮渡航线

2：隧道

3：桥

4：地下交通通道

road_composition

distance

此段路长度

form_way

路型

0：非匝道

1：匝道

index_start

路段起点序号，对应polyline坐标点的序号

index_end

路段终点序号，对应polyline坐标点的序号

road_form

distance

此段路长度

lane_num

车道数

index_start

路段起点序号

index_end

路段终点序号

cities 

途径城市列表

adcode 

途径城市adcode

errcode   

返回结果编码

10000表示成功

errmsg  

返回状态说明

成功时返回OK，否则返回错误原因

errdetail 

错误具体原因

参考错误码说明

0，测速摄像

2，闯红灯拍照

3，违章拍照

4，公交专用道拍照

5，应急车道拍照

6、非机动车道拍照

8、区间测速起始

9、区间测速解除

3，急转弯

6，事故多发地

10，限速路牌

25，上陡坡

26，下陡坡

81，货车限高

82，货车限宽

83，货车限重

91，货车检查站

1，事故

2，施工

3，封路

4，管制

5，公告