特种车辆路线规划与ETD服务 最后更新时间: 2024年11月26日

URL

https://tsapi.amap.com/v1/logistics/transport/route/chemical/direction/etd?paramters 

请求方式

请求方式GET，当avoidpolygons参数特别长时，需要使用POST方式请求

Content-Type

application/json

参数名

含义

规则说明

是否必须

缺省值

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时，建议填充此值。

否

无

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，综合最优：返回的结果会考虑路况，躲避拥堵，速度优先以及费用优先；500Km规划以内会返回多条结果，500Km以外会返回单条结果；考虑路况情况下的综合最优策略，推荐使用；对应导航SDK货导策略10；    12，无路况+不走高速：基于历史的通行速度数据，不考虑当前路况的影响，且不走高速路线，返回速度优先的路。

否

1

waypoints

途经点

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

否

无

size 

车辆大小

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

是

无

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

province

车牌省份

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

否 

无

number

车牌详情

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

否 

无

cartype

车辆类型

0：普通货车（默认值）    1：纯电动货车    2：插电混动货车

否

0

exempts

豁免限行政策

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

否

无

avoidpolygons

避让区域 

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

否

无

mpid

路线还原id

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

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

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

否

无

has_pass

是否使用通行证信息

提前在高德合作城市的小程序、APP中进行过办证操作的，可以选择。选择“是”后，高德算路引擎将查询车牌对应的通行证数据，参考通行证规定的路线进行算路，取值has_pass=true 或者 has_pass=false

否

FALSE

cer_codes

通行证信息

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

否

无

showpolyline

是否返回路线数据

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

否

1

nosteps

是否返回steps字段内容

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

否

0

consider_load

算路是否放宽限重条件

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

0：不放宽限重条件

1：放宽限重条件

否

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

“speed_limit”：限行路段

否

无

experience_points

指定经验轨迹

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

最大10000个点限制

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

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

否

无

lineValue

直线阈值

直线阈值，在当前位置距离路线在当前直线距离范围内，则会尽量规划回原路。超出则不强制回到原路线。取值（0,5000）

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

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

否

5000

usage

用途

0：普通货车

1：危化品车（需要单独鉴权）

2：消防车、救护车（需要单独鉴权）

消防车不返回etd数据

是

无

firstTime

出发时间戳

unix时间戳，单位：秒；可输入时间范围为当前时间至未来6天，若小于当前时间会返回错误码

有值调用etd 服务，否则不返回etd数据

否

无

参数 

含义

规则说明

data

数据体

truckRouteCount

总共返回路线数

route

里面包含距离路线信息

origin 

起点坐标

destination 

终点坐标

incident

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

inner

path_idx

所在道路索引

title

标题

desc

描述

lon

经度

lat

纬度

event_type

事件类型

详见附表

outer

同inner

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 

此方案的行驶距离 

单位：米

mpid

定线存储的mpid

duration 

此方案的耗时

单位：秒

strategy 

导航策略 

tolls 

此导航方案道路收费金额 

单位：元 

toll_distance 

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

单位：米

restriction 

限行结果 

-1，路线上没有限行

0，未知（未输入完整/正确车牌号信息时候显示）    1，已规避限行    2，起点限行    3，途径点在限行区域内（设置途径点才出现此报错）    4，途径限行区域    5，终点限行

traffic_lights 

此方案红绿灯总数 

单位：个 

labels

推荐标签

type

标签类型

content

标签内容

steps

具体方案

instruction 

行驶指示

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

orientation 

方向

road 

道路名

distance 

此路段距离

单位：米

duration 

此路段预计时间

polyline 

此路段的坐标点

action 

导航主要动作

例如：左转 

assistant_action 

导航辅助动作

例如：左转 

tmcs 

驾车导航详细信息

distance 

此段路长度

status 

路况

0：未知

1：畅通

2：缓行

3：拥堵

polyline 

此分段的路线

road_info

distance

此段路长度

road_class

道路等级

0：高速公路

1：国道

2：省道

6：城市快速道

9：普通道路

10：非导航道路

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

light_info

location

红绿灯位置信息

string类型

例子：113.376175,23.127633

speed_limit

需要在showshow_fields开通speed_limit字段才会

index_start

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

index_end

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

limit

限速值

km/h,int类型

etdCount

总共返回路线数

etdPathData

etd规划结果

origin

起点经纬度

destination

终点经纬度

paths

路径规划方案，列表

eta 

通行时间

fare

收费

distance

行驶距离，单位：米

traffic_lights

红绿灯个数

sections

路段列表；划分依据：road、adcode、status在同一路段保持一致

adcode

途径区域的区域代码

road

道路名称

distance

路段距离

toll

道路属性字段，是否收费，

0：不收费，

1：收费。

status 

路况：

0：未知

1：畅通

2：缓行

3：拥堵

polyline

路段坐标点串，","分割

restric_rules

限行信息（当show_fields填写时下发）

ruleid

限行id

path_idx

所在第几条路线索引

type

限行类型

0:外地车辆限行，建议设置车牌

1:外地车辆限行，建议开启限行

2:已避开限行区域

3:起点在限行区域内

4:终点在限行区域内

5:途经点在限行区域内

6:途径限行区域

adcode

限行所在城市

effective_time

限行生效时间描述

start

开始时间

end

结束时间

forbidden

禁行信息（当show_fields填写时下发）

lon

经度

lat

纬度

desc

描述

type

禁行类型

2:禁止左转

3:禁止右转

4:禁止左掉头

5:禁止右掉头

6:禁止直行

errcode 

返回结果编码

10000表示成功

errmsg 

返回状态说明

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

errdetail 

错误具体原因

参考错误码说明

1，事故

2，施工

3，封路

4，管制

5，公告