开发 Web服务 API 开发指南 基础 API 文档 路径规划 2.0

路径规划2.0 最后更新时间: 2024年10月24日

产品介绍

路线规划接口2.0是一类 Web API 接口服务,以 HTTP/HTTPS 形式提供了多种路线规划服务。支持驾车、公交、步行、骑行、电动车路线规划。

功能介绍 

驾车路线规划:开发者可根据起终点坐标检索符合条件的驾车路线规划方案,支持一次请求返回多条路线结果、支持传入多个途经点、支持传入车牌规避限行、支持根据不同业务场景设置不同的算路策略等。

步行路线规划:开发者可根据起终点坐标检索符合条件的步行路线规划方案。

公交路线规划:开发者可根据起终点坐标检索符合条件的公共交通路线规划方案,支持结合业务场景设置不同的公交换乘策略。

骑行路线规划:开发者可根据起终点坐标检索符合条件的骑行路线规划方案。

电动车路线规划:开发者可根据起终点坐标检索符合条件的电动车路线规划方案,与骑行略有不同的是会考虑限行等条件。

流量限制

目前该服务是试用阶段,如果您有正式上线需求,请随时通过工单跟我们沟通配额流量问题。

使用说明

1
第一步
申请 【Web服务API】密钥(Key)
2
第二步
拼接 HTTP 请求 URL,第一步申请的 Key 需作为必填参数一同发送
3
第三步
接收 HTTP 请求返回的数据(JSON 或 XML 格式),解析数据
如无特殊声明,接口的输入参数和输出数据编码全部统一为 UTF-8
成为开发者并创建 Key 

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

驾车路线规划

驾车路线规划 API 服务地址

URL

请求方式

https://restapi.amap.com/v5/direction/driving?parameters

GET,当参数过长导致请求失败时,需要使用 POST 方式请求

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

请求参数

参数名

含义

规则说明

是否必须

缺省值

key

高德Key

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

必填

origin

起点经纬度

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

destination

目的地

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

destination_type

终点的 poi 类别

当用户知道终点 POI 的类别时候,建议填充此值

destination_id

目的地 POI ID

目的地为 POI 时,建议填充此值,可提升路径规划准确性

可选

strategy

驾车算路策略

0:速度优先(只返回一条路线),此路线不一定距离最短

1:费用优先(只返回一条路线),不走收费路段,且耗时最少的路线

2:距离优先(只返回一条路线),仅走距离最短的路线,但是可能存在穿越小路/小区的情况

32:默认,高德推荐,同高德地图APP默认

33:躲避拥堵

34:高速优先

35:不走高速

36:少收费

37:大路优先

38:速度最快

39:躲避拥堵+高速优先

40:躲避拥堵+不走高速

41:躲避拥堵+少收费

42:少收费+不走高速

43:躲避拥堵+少收费+不走高速

44:躲避拥堵+大路优先

45:躲避拥堵+速度最快

可选

32

waypoints

途经点

途径点坐标串,默认支持1个有序途径点。多个途径点坐标按顺序以英文分号;分隔。最大支持16个途经点。

可选

avoidpolygons

避让区域

区域避让,默认支持1个避让区域,每个区域最多可有16个顶点;多个区域坐标按顺序以英文竖线符号“|”分隔,如果是四边形则有四个坐标点,如果是五边形则有五个坐标点;最大支持32个避让区域。

每个避让区域不能超过81平方公里,否则避让区域会失效。

可选

plate

车牌号码

车牌号,如 京AHA322,支持6位传统车牌和7位新能源车牌,用于判断限行相关。

可选

cartype

车辆类型

0:普通燃油汽车

1:纯电动汽车

2:插电式混动汽车

可选

0

ferry

是否使用轮渡

0:使用渡轮

1:不使用渡轮 

可选

0

show_fields

返回结果控制

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

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

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

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

可选

sig

数字签名

请参考 数字签名获取和使用方法

可选

output

返回结果格式类型

可选值:JSON

可选

json

callback

回调函数

callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。

可选

服务示例

https://restapi.amap.com/v5/direction/driving?origin=116.434307,39.90909&destination=116.434446,39.90816&key=<用户的key>

参数

备注

必选

origin

起点经纬度,经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

destination

目的地,经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

destination_id

目的地 POI ID,目的地为 POI 时,建议填充此值,可提升路径规划准确性

返回结果

名称

类型

说明

status

string

本次 API 访问状态,如果成功返回1,如果失败返回0。

info

string

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

infocode

string

返回状态说明,10000代表正确,详情参阅 info 状态表

count

string

路径规划方案总数

route

object

返回的规划方案列表

origin

string

起点经纬度

destination

string

终点经纬度

taxi_cost

string

预计出租车费用,单位:元

paths

object

算路方案详情

distance

string

方案距离,单位:米

restriction

string

0 代表限行已规避或未限行,即该路线没有限行路段

1 代表限行无法规避,即该线路有限行路段

steps

object

路线分段

instruction

string

行驶指示

orientation

string

进入道路方向

road_name

string

分段道路名称

step_distance

string

分段距离信息

注意以下字段如果需要返回,需要通过“show_fields”进行参数类设置。

show_fields

string

可选差异化结果返回

cost

object

设置后可返回方案所需时间及费用成本

duration

string

线路耗时,分段 step 中的耗时

tolls

string

此路线道路收费,单位:元,包括分段信息

toll_distance

string

收费路段里程,单位:米,包括分段信息

toll_road

string

主要收费道路

traffic_lights

string

方案中红绿灯个数,单位:个

tmcs

object

设置后可返回分段路况详情

tmc_status

string

路况信息,包括:未知、畅通、缓行、拥堵、严重拥堵

tmc_distance

string

从当前坐标点开始 step 中路况相同的距离

tmc_polyline

string

此段路况涉及的道路坐标点串,点间用","分隔

navi

object

设置后可返回详细导航动作指令

action

string

导航主要动作指令

assistant_action

string

导航辅助动作指令

cities

object

设置后可返回分段途径城市信息

adcode

string

途径区域编码

citycode

string

途径城市编码

city

string

途径城市名称

district

object

途径区县信息

name

string

途径区县名称

adcode

string

途径区县 adcode

polyline

string

设置后可返回分路段坐标点串,两点间用“;”分隔

步行路线规划

步行路线规划 API 服务地址

URL

请求方式

https://restapi.amap.com/v5/direction/walking?parameters

GET

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

请求参数

参数名

含义

规则说明

是否必须

缺省值

key

高德Key

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

必填

origin

起点信息

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

destination

目的地信息

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

origin_id

起点 POI ID

起点为 POI 时,建议填充此值,可提升路线规划准确性

可选

destination_id

目的地 POI ID

目的地为 POI 时,建议填充此值,可提升路线规划准确性

可选

alternative_route

返回路线条数

1:多备选路线中第一条路线

2:多备选路线中前两条路线

3:多备选路线中三条路线

不传则默认返回一条路线方案

可选

show_fields

返回结果控制

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

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

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

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

可选

sig

数字签名

请参考 数字签名获取和使用方法

可选

isindoor

是否需要室内算路

0:不需要

1:需要

可选

0

output

返回结果格式类型

可选值:JSON

可选

json

callback

回调函数

callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。

可选

服务示例

https://restapi.amap.com/v5/direction/walking?isindoor=0&origin=116.466485,39.995197&destination=116.46424,40.020642&key=<用户的key>

参数

备注

必选

isindoor

是否需要室内算路:
0:不需要
1:需要

origin

起点信息,经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

destination

目的地信息,经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

返回结果

名称

类型

说明

status

string

本次 API 访问状态,如果成功返回1,如果失败返回0。

info

string

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

infocode

string

返回状态说明,10000代表正确,详情参阅 info 状态表

count

string

路径规划方案总数

route

object

返回的规划方案列表

origin

string

起点经纬度

destination

string

终点经纬度

paths

object

算路方案详情

distance

string

方案距离,单位:米

steps

object

路线分段

instruction

string

步行指示

orientation

string

进入道路方向

road_name

string

分段道路名称

step_distance

string

分段距离信息

注意以下字段如果需要返回,需要通过“show_fields”进行参数类设置。

cost

object

设置后可返回方案所需时间及费用成本。注意:steps 中不返回 taxi 字段。

duration

string

线路耗时,包括方案总耗时及分段 step 中的耗时

taxi

string

预估打车费用

navi

object

设置后可返回详细导航动作指令

action

string

导航主要动作指令

assistant_action

string

导航辅助动作指令

walk_type

string

算路结果中存在的道路类型:

0,普通道路 1,人行横道 3,地下通道 4,过街天桥

5,地铁通道 6,公园 7,广场 8,扶梯 9,直梯

10,索道 11,空中通道 12,建筑物穿越通道

13,行人通道 14,游船路线 15,观光车路线 16,滑道

18,扩路 19,道路附属连接线 20,阶梯 21,斜坡

22,桥 23,隧道 30,轮渡

polyline

string

设置后可返回分路段坐标点串,两点间用“,”分隔

骑行路线规划

骑行路线规划 API 服务地址

URL

请求方式

https://restapi.amap.com/v5/direction/bicycling?parameters

GET

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

请求参数

参数名

含义

规则说明

是否必须

缺省值

key

高德Key

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

必填

origin

起点经纬度

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

destination

目的地

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

show_fields

返回结果控制

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

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

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

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

可选

alternative_route

返回方案条数

1:多备选路线中第一条路线

2:多备选路线中前两条路线

3:多备选路线中三条路线

不传则默认返回一条路线方案

可选

sig

数字签名

请参考 数字签名获取和使用方法

可选

output

返回结果格式类型

可选值:JSON

可选

json

callback

回调函数

callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。

可选

服务示例

https://restapi.amap.com/v5/direction/bicycling?origin=116.466485,39.995197&destination=116.46424,40.020642&key=<用户的key>

参数

备注

必选

origin

起点经纬度,经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

destination

目的地,经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

返回结果

名称

类型

说明

status

string

本次 API 访问状态,如果成功返回1,如果失败返回0。

info

string

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

infocode

string

返回状态说明,10000代表正确,详情参阅 info 状态表

count

string

路径规划方案总数

route

object

返回的规划方案列表

origin

string

起点经纬度

destination

string

终点经纬度

paths

object

算路方案详情

distance

string

方案距离,单位:米

steps

object

路线分段

instruction

string

骑行指示

orientation

string

进入道路方向

road_name

string

分段道路名称

step_distance

string

分段距离信息

注意以下字段如果需要返回,需要通过“show_fields”进行参数类设置。

cost

object

设置后可返回方案所需时间及费用成本

duration

string

线路耗时,包括方案总耗时及分段step中的耗时

navi

object

设置后可返回详细导航动作指令

action

string

导航主要动作指令

assistant_action

string

导航辅助动作指令

walk_type

string

算路结果中存在的道路类型:

0,普通道路 1,人行横道 3,地下通道 4,过街天桥

5,地铁通道 6,公园 7,广场 8,扶梯 9,直梯

10,索道 11,空中通道 12,建筑物穿越通道

13,行人通道 14,游船路线 15,观光车路线 16,滑道

18,扩路 19,道路附属连接线 20,阶梯 21,斜坡

22,桥 23,隧道 30,轮渡

polyline

string

设置后可返回分路段坐标点串,两点间用“,”分隔

电动车路线规划

电动车(骑行)路线规划 API 服务地址

URL

请求方式

https://restapi.amap.com/v5/direction/electrobike?parameters

GET

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

请求参数

参数名

含义

规则说明

是否必须

缺省值

key

高德Key

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

必填

origin

起点经纬度

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

destination

目的地

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

show_fields

返回结果控制

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

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

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

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

可选

alternative_route

返回方案条数

1:多备选路线中第一条路线

2:多备选路线中前两条路线

3:多备选路线中三条路线

不传则默认返回一条路线方案

可选

sig

数字签名

请参考 数字签名获取和使用方法

可选

output

返回结果格式类型

可选值:JSON

可选

json

callback

回调函数

callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。

可选

服务示例

https://restapi.amap.com/v5/direction/electrobike?origin=116.466485,39.995197&destination=116.46424,40.020642&key=<用户的key>

参数

备注

必选

origin

起点经纬度,经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

destination

目的地,经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

返回结果

名称

类型

说明

status

string

本次 API 访问状态,如果成功返回1,如果失败返回0。

info

string

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

infocode

string

返回状态说明,10000代表正确,详情参阅 info 状态表

count

string

路径规划方案总数

route

object

返回的规划方案列表

origin

string

起点经纬度

destination

string

终点经纬度

paths

object

算路方案详情

distance

string

方案距离,单位:米

steps

object

路线分段

instruction

string

骑行指示

orientation

string

进入道路方向

road_name

string

分段道路名称

step_distance

string

分段距离信息

注意以下字段如果需要返回,需要通过“show_fields”进行参数类设置。

cost

object

设置后可返回方案所需时间及费用成本

duration

string

线路耗时,包括方案总耗时及分段step中的耗时

navi

object

设置后可返回详细导航动作指令

action

string

导航主要动作指令

assistant_action

string

导航辅助动作指令

walk_type

string

算路结果中存在的道路类型:

0,普通道路 1,人行横道 3,地下通道 4,过街天桥

5,地铁通道 6,公园 7,广场 8,扶梯 9,直梯

10,索道 11,空中通道 12,建筑物穿越通道

13,行人通道 14,游船路线 15,观光车路线 16,滑道

18,扩路 19,道路附属连接线 20,阶梯 21,斜坡

22,桥 23,隧道 30,轮渡

polyline

string

设置后可返回分路段坐标点串,两点间用“,”分隔

公交路线规划

公交路线规划 API 服务地址

URL

请求方式

https://restapi.amap.com/v5/direction/transit/integrated?parameters

GET

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

请求参数

参数名

含义

规则说明

是否必须

缺省值

key

高德Key

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

必填

origin

起点经纬度

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

destination

目的地经纬度

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。

必填

originpoi

起点 POI ID

1、起点 POI ID 与起点经纬度均填写时,服务使用起点 POI ID;

2、该字段必须和目的地 POI ID 成组使用。

可选

destinationpoi

目的地 POI ID

1、目的地 POI ID 与目的地经纬度均填写时,服务使用目的地  POI ID;

2、该字段必须和起点 POI ID 成组使用。

可选

ad1

起点所在行政区域编码

仅支持 adcode,参考行政区域编码表

可选

ad2

终点所在行政区域编码

仅支持 adcode,参考行政区域编码表

可选

city1

起点所在城市

仅支持 citycode,相同时代表同城,不同时代表跨城

必填

city2

目的地所在城市

strategy

公共交通换乘策略

可选值:

0:推荐模式,综合权重,同高德APP默认

1:最经济模式,票价最低

2:最少换乘模式,换乘次数少

3:最少步行模式,尽可能减少步行距离

4:最舒适模式,尽可能乘坐空调车

5:不乘地铁模式,不乘坐地铁路线

6:地铁图模式,起终点都是地铁站

(地铁图模式下 originpoi 及 destinationpoi 为必填项)

7:地铁优先模式,步行距离不超过4KM

8:时间短模式,方案花费总时间最少

可选

0

AlternativeRoute

返回方案条数

可传入1-10的阿拉伯数字,代表返回的不同条数。

可选

5

multiexport

地铁出入口数量

0:只返回一个地铁出入口

1:返回全部地铁出入口

可选

0

nightflag

考虑夜班车

可选值:

0:不考虑夜班车

1:考虑夜班车

可选

0

date

请求日期

例如:2013-10-28

可选

time

请求时间

例如:9-54

可选

show_fields

返回结果控制

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

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

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

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

可选

sig

数字签名

请参考 数字签名获取和使用方法

可选

output

返回结果格式类型

可选值:JSON

可选

json

callback

回调函数

callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。

可选

服务示例

https://restapi.amap.com/v5/direction/transit/integrated?origin=116.466485,39.995197&destination=116.46424,40.020642&key=<用户的key>&city1=010&city2=010

参数

备注

必选

origin

起点经纬度,经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

destination

目的地,经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

city1

起点所在城市,仅支持 citycode,相同时代表同城,不同时代表跨城

city2

目的地所在城市,仅支持 citycode,相同时代表同城,不同时代表跨城

返回结果

名称

类型

说明

status

string

本次 API 访问状态,如果成功返回1,如果失败返回0。

info

string

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见 错误码说明

infocode

string

返回状态说明,10000代表正确,详情参阅 info 状态表

count

string

路径规划方案总数

route

object

返回的规划方案列表

origin

string

起点经纬度

destination

string

终点经纬度

transits

object

公交方案列表

distance

string

本条路线的总距离,单位:米

nightflag

nightflag

0:非夜班车;1:夜班车

segments

object

路线分段

walking

string

此分段中需要步行导航的信息

steps

参考 v3老接口

bus

string

此分段中需要公交导航的信息

steps

参考 v3老接口

railway

string

此分段中需要火车的信息

steps

参考 v3老接口

taxi

price

string

打车预计花费金额

drivetime

string

打车预计花费时间

distance

string

打车距离

polyline

string

线路点集合,通过 show_fields 控制返回与否

startpoint

string

打车起点经纬度

startname

string

打车起点名称

endpoint

string

打车终点经纬度

endname

string

打车终点名称

注意以下字段如果需要返回,需要通过“show_fields”进行参数类设置。

cost

object

设置后可返回方案所需时间及费用成本注意:taxi_cost 只在 route 中返回,transit_fee 只在 segments 下返回。分段 steps 下不返回 cost。

duration

string

线路耗时,方案总耗时,包含等车时间

taxi_cost

string

预估出租车费用

transit_fee

string

各换乘方案总花费

navi

object

设置后可返回详细导航动作指令

action

string

导航主要动作指令

assistant_action

string

导航辅助动作指令

walk_type

string

算路结果中存在的道路类型:

0,普通道路 1,人行横道 3,地下通道 4,过街天桥

5,地铁通道 6,公园 7,广场 8,扶梯 9,直梯

10,索道 11,空中通道 12,建筑物穿越通道

13,行人通道 14,游船路线 15,观光车路线 16,滑道

18,扩路 19,道路附属连接线 20,阶梯 21,斜坡

22,桥 23,隧道 30,轮渡

polyline

string

设置后可返回分路段坐标点串,两点间用“,”分隔

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