高级路径规划 最后更新时间: 2025年09月24日
产品介绍
高级路径规划 API 是一套以 HTTP 形式提供的接口,未来路径规划 API 用于查询未来7天的路径规划结果。
高级路径规划接口属于高级服务接口,目前只向企业开发者开放。如需申请,可进行 商务咨询
适用场景
该服务适用于需要实时路况信息和路径规划的场景,帮助优化路线和提高出行效率。
使用说明
为了正常调用 Web 服务 API ,请先注册成为高德开放平台开发者,并申请 Web 服务的 key ,点击具体操作 。
未来路径规划
未来路径规划 API 服务地址
URL
请求方式
https://restapi.amap.com/v4/etd/driving?parameters
GET
请求参数
参数
含义
规则
是否必填
缺省值
origin
出发点
规则: lon,lat(经度,纬度), ","分割,如 117.500244, 40.417801 经纬度小数点不超过6位
是
无
destination
目的地
规则: lon,lat(经度,纬度), ","分割,如 117.500244, 40.417801 经纬度小数点不超过6位
是
无
strategy
规划策略
1.返回的结果考虑路况,尽量躲避拥堵而规划路径,与高德地图的"躲避拥堵"策略一致
2.返回的结果不走高速,与高德地图"不走高速"策略一致
3.返回的结果尽可能规划收费较低甚至免费的路径,与高德地图"避免收费"策略一致
4.返回的结果考虑路况,尽量躲避拥堵而规划路径,并且不走高速,与高德地图的"躲避拥堵&不走高速"策略一致
5.返回的结果尽量不走高速,并且尽量规划收费较低甚至免费的路径结果,与高德地图的"避免收费&不走高速"策略一致
6.返回路径规划结果会尽量的躲避拥堵,并且规划收费较低甚至免费的路径结果,与高德地图的"躲避拥堵&避免收费"策略一致
7.返回的结果尽量躲避拥堵,规划收费较低甚至免费的路径结果,并且尽量不走高速路,与高德地图的"避免拥堵&避免收费&不走高速"策略一致
8.返回的结果会优先选择高速路,与高德地图的"高速优先"策略一致
9.返回的结果会优先考虑高速路,并且会考虑路况躲避拥堵,与高德地图的"躲避拥堵&高速优先"策略一致
10.不考虑路况,返回速度最优、耗时最短的路线,但是此路线不一定距离最短
11.避让拥堵&速度优先&避免收费
否
1
province
用汉字填入车牌省份缩写,用于判断是否限行
例如:京
否
无
number
填入除省份及标点之外,车牌的字母和数字(需大写)。用于判断限行相关。
例如:NH1N11
支持6位传统车牌和7位新能源车牌
否
无
cartype
车辆类型
0:普通汽车(默认值) 1:纯电动车 2:插电混动车
否
0
firsttime
出发时间,第一个时间戳
unix 时间戳,精确到秒
是
无
interval
时间间隔
单位:秒
是
无
count
时间点个数
最多支持48个
是
无
callback
回调函数
callback 值是用户定义的函数名称
否
无
服务示例
https://restapi.amap.com/v4/etd/driving?origin=116.397455,39.909187&destination=116.412422,39.908966&firsttime=1678583200&interval=30&count=10&key=<用户的key>示例代码中的firsttime参数,请在使用时将其替换为未来的日期,以避免接口报错。
|
参数 |
值 |
备注 |
必选 |
|---|---|---|---|
|
origin |
|
出发点,规则: lon,lat(经度,纬度), ","分割,如 117.500244, 40.417801 经纬度小数点不超过 6 位 |
是 |
|
destination |
|
目的地,规则: lon,lat(经度,纬度), ","分割,如 117.500244, 40.417801 经纬度小数点不超过 6 位 |
是 |
|
firsttime |
|
出发时间,unix 时间戳,精确到秒,必须是未来时间,如果小于当前时间会报错 |
是 |
|
interval |
|
时间间隔,单位:秒 |
是 |
|
count |
|
时间点个数,最多支持48个 |
是 |
返回结果参数说明
返回参数
含义说明
errcode
返回状态编码,0 表示成功
errmsg
返回状态说明。
成功时返回 OK ,其他错误返回错误信息。
errdetail
返回错误详细原因
data
返回结果数据
paths
路径规划方案,列表
distance
行驶距离,单位:米
traffic_lights
红绿灯个数
steps
导航路段,列表
adcode
途径区域的区域代码
road
道路名称
distance
路段距离
toll
道路属性字段,是否收费,0:不收费,1:收费。
polyline
路段坐标点串
time_infos
不同时间的规划以及信息列表
starttime
出发时间,Unix 时间戳精确到毫秒
elements
路线列表
pathindex
对应的路线
duration
总时长,单位:分钟
tolls
总收费,单位:元
restriction
0:代表限行已规避或未限行,即该路线没有限行路段 1:代表限行无法规避,即该线路有限行路段
tmcs
路况信息
status
路况状态
polyline
路段坐标点