您现在的位置: 开发 > Web服务 API > 开发指南 > API文档 > 路径规划 2.0

路线规划2.0 最后更新时间: 2021年06月08日

产品概述


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

功能介绍 


驾车路线规划:

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

步行路线规划:

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

公交路线规划:

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

骑行路线规划:

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

电动车路线规划:

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

流量限制


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

使用说明


第一步,申请Web服务API类型Key

第二步,参考接口参数文档发起HTTP/HTTPS请求,第一步申请的 Key 需作为必填参数一同发送;

第三步,解析请求返回的数据(JSON格式),参考返回参数文档解析数据。

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

服务文档


驾车路线规划

  • 驾车路线规划 API 服务地址

URL

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

请求方式

POST

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

高德Key

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

必填

origin

起点经纬度

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

必填

destination

目的地

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

必填

origin_id

起点POI ID

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

可选

destination_id

目的地POI ID

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

可选

origin_type

起点处道路类型

填入此值可以辅助更精准的起点算路

0:普通道路

1:高架上

2:高架下

3:主路

4:辅路

5:隧道

7:环岛

9:停车场内部

可选

strategy

驾车算路策略

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

33:躲避拥堵

34:高速优先

35:不走高速

36:少收费

37:大路优先

38:速度最快

39:躲避拥堵+高速优先

40:躲避拥堵+不走高速

41:躲避拥堵+少收费

42:少收费+不走高速

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

44:躲避拥堵+大路优先

45:躲避拥堵+速度最快

可选

32

AlternativeRoute

多备选路线

0:不需要,默认返回一条路线

1:需要,最多可返回三条路线

可选

0

waypoints

途经点

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

可选

avoidpolygons

避让区域

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

同时传入避让区域及避让道路,仅支持避让道路;

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

可选

avoidroad

避让道路

道路名称,只支持一条避让道路

同时传入避让区域及避让道路,仅支持避让道路;

可选

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 时有效。

可选

  • 返回结果

名称

类型

说明

status

string

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

info

string

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

infocode

string

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

count

string

路径规划方案总数

route

object

返回的规划方案列表

origin

string

起点经纬度

destination

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

主要收费道路

taxi_fee

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

途径区县名称

polyline

object

设置后可返回分路段坐标点串

polyline

string

分路段坐标点串,两点间用“,”分隔

步行路线规划

  • 步行路线规划 API 服务地址

URL

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

请求方式

GET

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

高德Key

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

必填

isindoor

是否需要室内算路

0:不需要

1:需要

必填

0

origin

起点信息

起点信息和目的地信息均按照以下子字段规则进行填写

必填

destination

目的地信息

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

必填

location

起/终点经纬度

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

必填

id

起/终点poi id

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

可选

name

起/终点poi name

poi名称

可选

type

起/终点poi类型

poi类型

可选

pid

起/终点建筑物id

室内算路需要

可选

floor

起/终点所在楼层

室内算路需要,格式为阿拉伯数字,如:6

可选

f_nona

起/终点所在楼层的实际标注名称

室内算路需要,如:F6

可选

AlternativeRout

返回路线条数

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

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

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

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

可选

show_fields

返回结果控制

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

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

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

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

可选

sig

数字签名

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

可选

output

返回结果格式类型

可选值:JSON

可选

json

callback

回调函数

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

可选

  • 返回结果

名称

类型

说明

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

object

设置后可返回分路段坐标点串

polyline

string

分路段坐标点串,两点间用“,”分隔

骑行路线规划

  • 骑行路线规划 API 服务地址

URL

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

请求方式

GET

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

高德Key

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

必填

origin

起点经纬度

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

必填

destination

目的地

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

必填

show_fields

返回结果控制

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

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

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

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

可选

sig

数字签名

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

可选

output

返回结果格式类型

可选值:JSON

可选

json

callback

回调函数

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

可选

  • 返回结果

名称

类型

说明

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

object

设置后可返回分路段坐标点串

polyline

string

分路段坐标点串,两点间用“,”分隔

电动车路线规划

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

URL

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

请求方式

GET

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

高德Key

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

必填

origin

起点经纬度

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

必填

destination

目的地

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

必填

show_fields

返回结果控制

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

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

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

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

可选

sig

数字签名

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

可选

output

返回结果格式类型

可选值:JSON

可选

json

callback

回调函数

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

可选

  • 返回结果

名称

类型

说明

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

object

设置后可返回分路段坐标点串

polyline

string

分路段坐标点串,两点间用“,”分隔

公交路线规划

  • 骑行路线规划 API 服务地址

URL

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

请求方式

GET

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

高德Key

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

必填

origin

起点经纬度

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

必填

destination

目的地

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

必填

ad1

起点所在行政区域编码

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

可选

ad2

终点所在行政区域编码

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

可选

city1

起点所在城市

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

必填

city2

目的地所在城市

strategy

公共交通换乘策略

可选值:

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

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

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

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

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

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

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

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

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

13:骑行+公交模式

可选

0

AlternativeRoute

返回方案条数

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

可选

5

multiexport

地铁出入口数量

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

1:返回全部地铁出入口

可选

0

max_trans

最大换乘次数

0:直达

1:最多换乘1次

2:最多换乘2次

3:最多换乘3次

4:最多换乘4次

可选

4

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 时有效。

可选

  • 返回结果

名称

类型

说明

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_fee只在route中返回,transit_fee只在segments下返回。分段steps下不返回cost。

duration

string

线路耗时,方案总耗时

taxi_fee

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

object

设置后可返回分路段坐标点串

polyline

string

分路段坐标点串,两点间用“,”分隔

错误码说明:https://developer.amap.com/api/webservice/guide/tools/info

新用户
福利
示例
中心
常见
问题
智能
客服