开发 Web服务 API 开发指南 高级 API 文档 高级路径规划

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

产品介绍

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

使用 API 前您需先 申请 Key,若无高德地图 API 账号需要先申请账号。

提示

高级路径规划接口属于高级服务接口,对于已通过企业认证的用户,我们提供每日一定量的配额以供体验(流量限制说明)。如需更多配额,可进行 商务咨询

成为开发者并创建 Key 

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

适用场景

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

使用说明

第一步,申请” Web 服务 API ”密钥(Key);

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

第三步,接收 HTTP 请求返回的数据(JSON 或 XML 格式),解析数据。

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

高级路径规划服务目前只向企业开发者开放。

您通过企业开发者审批之后,可在 控制台-个人中心-帐号权限 页面查看调用量限制,也可在 控制台-数据分析 查询该服务的每日调用情况。

未来路径规划

未来路径规划 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>

示例代码中的时间戳是2023年12月30日,请在使用时将其替换为未来的日期,以避免接口报错。

参数

备注

必选

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

路段坐标点

流量限制说明

服务

个人认证开发者 

企业开发者 

日调用超量封停

(次/日)

QPS

(次/秒)

日调用超量封停

(次/日)

QPS

(次/秒)

未来路径规划

不开放

100

5

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