高级路径规划最后更新时间: 2024年08月06日

产品介绍

高级路径规划 API 是一套以 HTTP 形式提供的接口，未来路径规划 API 用于查询未来7天的路径规划结果。

提示

高级路径规划接口属于高级服务接口，目前只向企业开发者开放。如需申请，可进行商务咨询

适用场景

该服务适用于需要实时路况信息和路径规划的场景，帮助优化路线和提高出行效率。

使用说明

第一步

申请【Web服务API】密钥（Key）

第二步

拼接 HTTP 请求 URL，第一步申请的 Key 需作为必填参数一同发送

第三步

接收 HTTP 请求返回的数据（JSON 或 XML 格式），解析数据

如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8。

成为开发者并创建 Key

为了正常调用 Web 服务 API ，请先注册成为高德开放平台开发者，并申请 Web 服务的 key ，点击具体操作。

未来路径规划

未来路径规划 API 服务地址

URL	请求方式
https://restapi.amap.com/v4/etd/driving?parameters	GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

请求参数

参数	含义	规则	是否必填	缺省值
key	请求服务权限标识	用户在高德地图官网申请 Web 服务 API 类型 KEY	是	无
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	路段坐标点