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

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

产品介绍

路径规划API是一套以HTTP形式提供的步行、公交、驾车查询及行驶距离计算接口,返回JSON 或 XML格式的查询数据,用于实现路径规划功能的开发。 

由于道路/数据/算法的变更,很可能存在间隔一段时间后请求相同起终点的经纬度返回不同结果。

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

适用场景

  • 无需展现地图的场景下,进行线路查询,如以线路结果页形式展现换乘方案;
  • 根据返回线路数据,自行开发线路导航。

使用限制

 服务调用量的限制请点击这里查阅。 

使用说明

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

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

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

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

简单示例:

https://restapi.amap.com/v3/direction/driving?origin=116.45925,39.910031&destination=116.587922,40.081577&output=xml&key=<用户的key>

步行路径规划

  • 接口简介:

步行路径规划 API 可以规划100KM以内的步行通勤方案,并且返回通勤方案的数据。最大支持 100km 的步行路线规划。

  • 步行路径规划API URL

URL

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

请求方式

GET

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

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

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

必填

origin

出发点

规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801     经纬度小数点不超过6位

必填

destination

目的地

规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801     经纬度小数点不超过6位

必填

sig

数字签名

数字签名获取和使用方法

可选

output

返回数据格式类型

可选值:JSON,XML

可选

JSON

callback

回调函数

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

可选

  • 服务示例
https://restapi.amap.com/v3/direction/walking?origin=116.434307,39.90909&destination=116.434446,39.90816&key=<用户的key>

参数

备注

必选

origin

lon,lat(经度,纬度),如117.500244, 40.417801 经纬度小数点不超过6位

destination

lon,lat(经度,纬度),如117.500244, 40.417801 经纬度小数点不超过6位

  • 返回结果参数说明

步行规划的响应结果的格式由请求参数output指定

名称

含义

规则说明

status

返回状态

值为0或1

1:成功;0:失败

info

返回的状态信息

status为0时,info返回错误原;否则返回“OK”。详情参阅info状态表

count

返回结果总数目


route

路线信息列表



origin

起点坐标


destination

终点坐标


paths

步行方案



distance

起点和终点的步行距离

单位:米

duration

步行时间预计

单位:秒

steps

返回步行结果列表



step

每段步行方案



instruction

路段步行指示


road

道路名称


distance

此路段距离

单位:米

orientation

方向


duration

此路段预计步行时间


polyline

此路段坐标点


action

步行主要动作

详情见步行动作列表

assistant_action

步行辅助动作

详情见步行动作列表

walk_type

这段路是否存在特殊的方式

0,普通道路

1,人行横道

3,地下通道

4,过街天桥

5,地铁通道

6,公园

7,广场

8,扶梯

9,直梯

10,索道

11,空中通道

12,建筑物穿越通道

13,行人通道

14,游船路线

15,观光车路线

16,滑道

18,扩路

19,道路附属连接线

20,阶梯

21,斜坡

22,桥

23,隧道

30,轮渡

  • 步行动作列表

主要动作列表

辅助动作列表

无基本导航动作

无辅助导航动作

左转

左转

右转

右转

向左前方

向左前方

向右前方

向右前方

向左后方

向左后方

向右后方

向右后方

直行

往后走

靠左

往前走

靠右

靠左

通过人行横道

靠右

通过过街天桥

通过人行横道

通过地下通道

通过过街天桥

通过广场

通过地下通道

到道路斜对面

通过广场


到达目的地


进入右侧道路


进入左侧道路

公交路径规划

  • 接口简介:

公交路径规划 API 可以规划综合各类公共(火车、公交、地铁)交通方式的通勤方案,并且返回通勤方案的数据。

  • 公交路径规划API URL:

URL

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

请求方式

GET

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

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

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

必填

origin

出发点

规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801     经纬度小数点不超过6位

必填

destination

目的地

规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801     经纬度小数点不超过6位

必填

city

城市/跨城规划时的起点城市

目前支持市内公交换乘/跨城公交的起点城市。

可选值:城市名称/citycode

必填

cityd

跨城公交规划时的终点城市

跨城公交规划必填参数。

可选值:城市名称/citycode

可选

( 跨城必填 )

extensions

返回结果详略

可选值:base(default)/all

base:返回基本信息;all:返回全部信息

可选

base

strategy

公交换乘策略

可选值:

0:最快捷模式

1:最经济模式

2:最少换乘模式

3:最少步行模式

5:不乘地铁模式

可选

0

nightflag

是否计算夜班车

可选值:0:不计算夜班车

1:计算夜班车

可选

0

date

出发日期

根据出发时间和日期,筛选可乘坐的公交路线,格式示例:date=2014-3-19。在无需设置预计出发时间时,请不要在请求之中携带此参数。

可选

time

出发时间

根据出发时间和日期,筛选可乘坐的公交路线,格式示例:time=22:34。在无需设置预计出发时间时,请不要在请求之中携带此参数。

可选

sig

数字签名

数字签名获取和使用方法

可选

output

返回数据格式类型

可选值:JSON,XML

可选

JSON

callback

回调函数

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

可选

  • 服务示例
https://restapi.amap.com/v3/direction/transit/integrated?origin=116.481499,39.990475&destination=116.465063,39.999538&city=010&output=xml&key=<用户的key>

参数

备注

必选

origin

lon,lat(经度,纬度),如117.500244, 40.417801 经纬度小数点不超过6位

destination

lon,lat(经度,纬度),如117.500244, 40.417801 经纬度小数点不超过6位

city

支持市内公交换乘/跨城公交的起点城市,规则:城市名称/citycode

cityd

跨城公交规划必填参数。规则:城市名称/citycode

strategy

0:最快捷模式;1:最经济模式;2:最少换乘模式;3:最少步行模式;5:不乘地铁模式

nightflag

是否计算夜班车,1:是;0:否

  • 返回结果参数说明

公交规划的响应结果的格式由请求参数output指定。

名称

含义

规则说明

status

返回状态

值为0或1

1:成功;0:失败

info

返回的状态信息

status为0时,info返回错误原;否则返回“OK”。详情参阅info状态表

count

公交换乘方案数目


route

公交换乘信息列表



origin

起点坐标


destination

终点坐标


distance

起点和终点的步行距离

单位:米

taxi_cost

出租车费用

单位:元

transits

公交换乘方案列表



transit

公交换乘方案



cost

此换乘方案价格

单位:元

duration

此换乘方案预期时间

单位:秒

nightflag

是否是夜班车

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

walking_distance

此方案总步行距离

单位:米

segments

换乘路段列表



walking

此路段步行导航信息

详见步行方案信息列表

bus

此路段公交导航信息

详见公交方案信息列表

entrance

地铁入口

只在地铁路段有值,详见出入口信息列表

exit

地铁出口

只在地铁路段有值,详见出入口信息列表

railway

乘坐火车的信息

详情见只在地铁路段有值,详见火车换乘信息列表

  • 步行方案信息列表

名称

含义

规则说明

origin

起点坐标


destination

终点坐标


distance

每段线路步行距离

单位:米

duration

步行预计时间

单位:秒


steps

步行路段列表




instruction

此段路的行走介绍




road

路的名字




distance 

此段路的距离




duration

此段路预计消耗时间

单位:秒



polyline

此段路的坐标




action

步行主要动作




assistant_action

步行辅助动作


  • 公交方案信息列表

名称



含义

规则说明

  buslines  



步行路段列表



 departure_stop 


此段起乘站信息

格式如:中关村



name

站点名字




id

站点id




location

站点经纬度



 arrival_stop 


此段下车站

格式如:中关村



name

 站点名字 




id

 站点id 




location

 站点经纬度 



name 


公交路线名称

格式如:445路(南十里居--地铁望京西站)


id


公交路线id



type 


公交类型

格式如:地铁线路


distance 


公交行驶距离

单位:米


duration 


公交预计行驶时间

单位:秒


polyline 


此路段坐标集

格式为坐标串,如:116.481247,39.990704;116.481270,39.990726


start_time 


首班车时间

格式如:0600,代表06:00


end_time 


末班车时间

格式如:2300,代表23:00


via_num 


此段途经公交站数



via_stops 


此段途经公交站点列表




name 

途径公交站点信息




id

公交站点编号




location

公交站点经纬度


  • 出入口信息列表

name

入口名称

location

入口经纬度

  • 火车换乘信息列表

名称

说明

id

线路id编号

time

该线路车段耗时

name

线路名称

trip

线路车次号

distance

该item换乘段的行车总距离

type

线路车次类型

departure_stop

火车始发站信息


id

上车站点ID

name

上车站点名称


location

上车站点经纬度


adcode

上车站点所在城市的adcode


time

上车点发车时间


start

是否始发站,1表示为始发站,0表示非始发站

arrival_stop

火车到站信息


id

下车站点ID


name

下车站点名称


location

下车站点经纬度


adcode

下车站点所在城市的adcode


time

到站时间,如大于24:00,则表示跨天


end

是否为终点站,1表示为终点站,0表示非终点站

via_stop

途径站点信息,extensions=all时返回


name

途径站点的名称


id

途径站点的ID


location

途径站点的坐标点


time

途径站点的进站时间,如大于24:00,则表示跨天


wait

途径站点的停靠时间,单位:分钟

alters

聚合的备选方案,extensions=all时返回


id

备选方案ID


name

备选线路名称

spaces

仓位及价格信息


code

仓位编码


cost

仓位费用

  • 火车路线类型表

线路类型代码

公共交通工具备注

线路类型代码

公共交通工具备注

2010

普客火车

2015

T字头的特快火车

2011

G字头的高铁火车

2016

K字头的快车火车

2012

D字头的动车火车

2017

L字头,Y字头的临时火车

2013

C字头的城际火车

2018

S字头的郊区线火车

2014

Z字头的直达特快火车



  • 仓位级别表

仓位级别

仓位备注

仓位级别

仓位备注

0

不分仓位级别

20

火车高级软卧下铺

9

特等座

21

火车商务座

10

火车硬座

22

长途汽车座席

11

火车软座

23

长途汽车卧席上铺

12

火车软座1等座

24

长途汽车卧席中铺

13

火车软座2等座

25

长途汽车卧席下铺

14

火车硬卧上铺

30

飞机经济舱

15

火车硬卧中铺

31

飞机商务舱

16

火车硬卧下铺

40

客轮经济舱

17

火车软卧上铺

41

客轮3等舱

18

火车软卧下铺

42

客轮2等舱

19

火车高级软卧上铺

43

客轮豪华舱

驾车路径规划

  • 接口简介:

驾车路径规划 API 可以规划以小客车、轿车通勤出行的方案,并且返回通勤方案的数据。

  • 驾车路径规划API URL:

URL

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

请求方式

GET

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

  • 请求参数

参数名称

含义

规则说明

是否必须

缺省值

key

用户唯一标识

用户在高德地图官网申请

origin

出发点

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。格式为x1,y1|x2,y2|x3,y3。

由于在实际使用过程中,存在定位飘点的情况。为了解决此类问题,允许传入多个起点用于计算车头角度。

最多允许传入3个坐标对,每对坐标之间距离必须超过2m。 虽然对每对坐标之间长度没有上限,但是如果超过4米会有概率性出现不准确的情况。使用三个点来判断距离和角度的有效性,如果两者都有效,使用第一个点和最后一个点计算的角度设置抓路的角度,规划路径时以最后一个坐标对进行规划。

destination

目的地

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

originid

出发点poiid

当起点为POI时,建议填充此值。

destinationid

目的地poiid

当终点为POI时,建议填充此值。

origintype

起点的poi类别

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

destinationtype

终点的poi类别

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

strategy

驾车选择策略

下方10~20的策略,会返回多条路径规划结果。(高德地图APP策略也包含在内,强烈建议从此策略之中选择)

下方策略 0~9的策略,仅会返回一条路径规划结果。



下方策略返回多条路径规划结果

10,返回结果会躲避拥堵,路程较短,尽量缩短时间,与高德地图的默认策略也就是不进行任何勾选一致

11,返回三个结果包含:时间最短;距离最短;躲避拥堵 (由于有更优秀的算法,建议用10代替)

12,返回的结果考虑路况,尽量躲避拥堵而规划路径,与高德地图的“躲避拥堵”策略一致

13,返回的结果不走高速,与高德地图“不走高速”策略一致

14,返回的结果尽可能规划收费较低甚至免费的路径,与高德地图“避免收费”策略一致

15,返回的结果考虑路况,尽量躲避拥堵而规划路径,并且不走高速,与高德地图的“躲避拥堵&不走高速”策略一致

16,返回的结果尽量不走高速,并且尽量规划收费较低甚至免费的路径结果,与高德地图的“避免收费&不走高速”策略一致

17,返回路径规划结果会尽量的躲避拥堵,并且规划收费较低甚至免费的路径结果,与高德地图的“躲避拥堵&避免收费”策略一致

18,返回的结果尽量躲避拥堵,规划收费较低甚至免费的路径结果,并且尽量不走高速路,与高德地图的“避免拥堵&避免收费&不走高速”策略一致

19,返回的结果会优先选择高速路,与高德地图的“高速优先”策略一致

20,返回的结果会优先考虑高速路,并且会考虑路况躲避拥堵,与高德地图的“躲避拥堵&高速优先”策略一致



下方策略仅返回一条路径规划结果

0,速度优先,此路线不一定距离最短

1,费用优先,不走收费路段,且耗时最少的路线

2,距离优先,仅走距离最短的路线,但是可能存在穿越小路/小区的情况

3,速度优先,不走快速路,例如京通快速路(因为策略迭代,建议使用13)

4,躲避拥堵,但是可能会存在绕路的情况,耗时可能较长

5,多策略(同时使用速度优先、费用优先、距离优先三个策略计算路径)。

其中必须说明,就算使用三个策略算路,会根据路况不固定的返回一~三条路径规划信息。

6,速度优先,不走高速,但是不排除走其余收费路段

7,费用优先,不走高速且避免所有收费路段

8,躲避拥堵和收费,可能存在走高速的情况,并且考虑路况不走拥堵路线,但有可能存在绕路和时间较长

9,躲避拥堵和收费,不走高速

0

waypoints

途经点

经度和纬度用","分割,经度在前,纬度在后,小数点后不超过6位,坐标点之间用";"分隔

最大数目:16个坐标点。如果输入多个途径点,则按照用户输入的顺序进行路径规划

avoidpolygons

避让区域

区域避让,支持32个避让区域,每个区域最多可有16个顶点

经度和纬度用","分割,经度在前,纬度在后,小数点后不超过6位,坐标点之间用";"分隔,区域之间用"|"分隔。如果是四边形则有四个坐标点,如果是五边形则有五个坐标点;

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

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

avoidroad

避让道路名

只支持一条避让道路

province

用汉字填入车牌省份缩写,用于判断是否限行

例如:京

number

填入除省份及标点之外,车牌的字母和数字(需大写)。用于判断限行相关。

例如:NH1N11

支持6位传统车牌和7位新能源车牌

cartype

车辆类型

0:普通汽车(默认值)
1:纯电动车
2:插电混动车

0

ferry 

在路径规划中,是否使用轮渡

0:使用渡轮(默认) 
1:不使用渡轮 

0

roadaggregation

是否返回路径聚合信息

false:不返回路径聚合信息

true:返回路径聚合信息,在steps上层增加roads做聚合

false

nosteps

是否返回steps字段内容

当取值为0时,steps字段内容正常返回;

当取值为1时,steps字段内容为空;

0

sig

数字签名

数字签名认证用户必填

output

返回数据格式类型

可选值:JSON,XML

JSON

callback

回调函数

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

extensions

返回结果控制

可选值:base/all

base:返回基本信息;all:返回全部信息

base

  • 服务示例
https://restapi.amap.com/v3/direction/driving?origin=116.481028,39.989643&destination=116.465302,40.004717&extensions=all&output=xml&key=<用户的key>

参数

备注

必选

origin

lon,lat(经度,纬度),如117.500244, 40.417801 经纬度小数点不超过6位

destination

lon,lat(经度,纬度),如117.500244, 40.417801 经纬度小数点不超过6位

originid

当起点为POI时,建议填充此值

destinationid

当终点为POI时,建议填充此值

extensions

base:返回基本信息;all:返回全部信息

strategy

参见上方strategy的说明

waypoints

途经点,最大数目:16个坐标点

avoidpolygons

避让区域,如果是四边形则有四个坐标点,如果是五边形则有五个坐标点

avoidroad

只支持一条避让道路,如:广顺北大街

  • 返回结果参数说明

驾车规划的响应结果的格式由请求参数output指定。

名称 含义 规则说明
status 结果状态值,值为0或1 0:请求失败;1:请求成功
info 返回状态说明 status为0时,info返回错误原因,否则返回“OK”。详情参阅info状态表
count 驾车路径规划方案数目
route 驾车路径规划信息列表
  origin 起点坐标 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
destination 终点坐标 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
taxi_cost 打车费用 单位:元,注意:extensions=all时才会返回
paths 驾车换乘方案
  path 驾车换乘方案
distance 行驶距离 单位:米
duration 预计行驶时间 单位:秒
strategy 导航策略
tolls 此导航方案道路收费 单位:元
restriction 限行结果 0 代表限行已规避或未限行,即该路线没有限行路段
1 代表限行无法规避,即该线路有限行路段
traffic_lights 红绿灯个数
toll_distance 收费路段距离
steps 导航路段
  step 导航路段 详情见导航路段信息step列表
  • 导航路段信息step列表

名称

含义

规则说明

instruction

行驶指示


orientation

方向


road

道路名称


distance

此路段距离

单位:米

tolls

此段收费

单位:元

toll_distance

收费路段距离

单位:米

toll_road

主要收费道路


polyline

此路段坐标点串

格式为坐标串,如:116.481247,39.990704;116.481270,39.990726

action

导航主要动作

详见驾车动作列表

assistant_action

导航辅助动作

详见驾车动作列表

tmcs

驾车导航详细信息

其中包含tmc对象


distance

此段路的长度

单位:米


status

此段路的交通情况

未知、畅通、缓行、拥堵、严重拥堵


polyline

此段路的轨迹

规格:x1,y1;x2,y2

  • 驾车动作列表

注意:extensions=all时以下信息才会返回

主要动作列表

无基本导航动作

左转

右转

向左前方行驶

向右前方行驶

向左后方行驶

向右后方行驶

左转调头

直行

靠左

靠右

进入环岛

离开环岛

减速行驶

辅助动作列表

无辅助导航动作

进入主路

进入辅路

进入高速

进入匝道

进入隧道

进入中间岔道

进入右岔路

进入左岔路

进入右转专用道

进入左转专用道

进入中间道路

进入右侧道路

进入左侧道路

靠右行驶进入辅路

靠左行驶进入辅路

靠右行驶进入主路

靠左行驶进入主路

靠右行驶进入右转专用道

进入轮渡

驶离轮渡

沿当前道路行驶

沿辅路行驶

沿主路行驶

到达出口

到达服务区

到达收费站

到达途经地

到达目的地的

绕环岛左转

绕环岛右转

绕环岛直行

绕环岛调头

小环岛不数出口

到达复杂路口,走右边第一出口

到达复杂路口,走右边第二出口

到达复杂路口,走右边第三出口

到达复杂路口,走右边第四出口

到达复杂路口,走右边第五出口

到达复杂路口,走左边第一出口

到达复杂路口,走左边第二出口

到达复杂路口,走左边第三出口

到达复杂路口,走左边第四出口

到达复杂路口,走左边第五出口

进入调头专用路

骑行路径规划

  • 接口简介: 

骑行路径规划用于规划骑行通勤方案,规划时会考虑天桥、单行线、封路等情况。最大支持 500km 的骑行路线规划。

  • 骑行路径规划API URL:

URL

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

请求方式

GET

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

  • 请求参数

参数名

含义

规则说明

是否必填

缺省值

key

 请求服务权限标识 

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

origin

出发点经纬度

填入规则:X,Y,采用","分隔,例如“ 117.500244, 40.417801 ”

小数点后不得超过6位

destination

目的地经纬度

填入规则:X,Y,采用","分隔,例如“ 117.500244, 40.417801 ”

小数点后不得超过6位

  •  返回结果参数说明 

名称

类型

含义

规则说明

data

对象

里面包含具体内容

业务数据字段


origin

String

起点坐标

格式:X,Y


destination

String 

终点坐标

格式:X,Y 


paths

数组

骑行方案列表信息




distance

数值

起终点的骑行距离

单位:米



duration

数值 

起终点的骑行时间

单位:秒



steps

数组

具体骑行结果





instruction 

String

路段骑行指示

例如:“骑行54米右转” 




road

String

 此段路道路名称

有可能出现空,需要特别指出,日后会用null表示

例如:“建国门北大街”




distance

数值

此段路骑行距离





orientation

String

此段路骑行方向

例如:“南”




duration

数值

此段路骑行耗时

单位:秒




polyline

String

此段路骑行的坐标点

格式:X,Y;X1,Y1;X2,Y2




action

String

此段路骑行主要动作

内容为中文指示。

骑行·主要动作,可能为空,也可能

为左转、右转、向左前方行驶、向右前方行驶等  




assistant_action

String

此段路骑行辅助动作

内容为中文提示。

例如:“到达目的地”

errcode

数值

返回结果码

0,表示成功

errdetail

String 

具体错误原因

此字段会详细说明错误原因

errmsg

String 

返回状态说明

OK代表成功

  •  服务示例
https://restapi.amap.com/v4/direction/bicycling?origin=116.434307,39.90909&destination=116.434307,39.90909&key=<用户的key>

参数

备注

必选

 origin  

起点经纬度

 destination  

终点经纬度


距离测量

  • 距离测量API URL:

URL

https://restapi.amap.com/v3/distance?parameters

请求方式

GET

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

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

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

必填

origins

出发点

支持100个坐标对,坐标对见用“| ”分隔;经度和纬度用","分隔

必填

destination

目的地

规则: lon,lat(经度,纬度), “,”分割

如117.500244, 40.417801     经纬度小数点不超过6位

必填

type

路径计算的方式和方法

0:直线距离

1:驾车导航距离(仅支持国内坐标)。

必须指出,当为1时会考虑路况,故在不同时间请求返回结果可能不同。

此策略和驾车路径规划接口的 strategy=4策略基本一致,策略为“ 躲避拥堵的路线,但是可能会存在绕路的情况,耗时可能较长 ”

若需要实现高德地图客户端效果,可以考虑使用驾车路径规划接口

3:步行规划距离(仅支持5km之间的距离)

可选

1

sig

数字签名

数字签名获取和使用方法

可选

output

返回数据格式类型

可选值:JSON,XML

可选

JSON

callback

回调函数

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

可选

  • 服务示例
https://restapi.amap.com/v3/distance?origins=116.481028,39.989643|114.481028,39.989643|115.481028,39.989643&destination=114.465302,40.004717&output=xml&key=<用户的key>

参数

备注

必选

 origins  

出发点

支持100个坐标对(公交仅支持20个),坐标对见用“| ”分隔;经度和纬度用","分隔

 destination  

目的地

规则: lon,lat(经度,纬度), “,”分割

如117.500244, 40.417801     经纬度小数点不超过6位


type

此参数需要输入路径计算的方式和方法


  • 返回结果参数说明

名称

说明

status

返回结果状态值,值为0或1,0表示请求失败;1表示请求成功

info

返回状态说明,status为0时,info返回错误原因;否则返回“OK”。详情参阅info状态表

results

距离信息列表


result

距离信息


origin_id

起点坐标,起点坐标序列号(从1开始)

dest_id

终点坐标,终点坐标序列号(从1开始) 

distance

路径距离,单位:米 

duration

预计行驶时间,单位:秒 

info

仅在出错的时候显示该字段。大部分显示“未知错误”

由于此接口支持批量请求,建议不论批量与否用此字段判断请求是否成功

code

仅在出错的时候显示此字段。

在驾车模式下:

1,指定地点之间没有可以行车的道路

2,起点/终点 距离所有道路均距离过远(例如在海洋/矿业)

3,起点/终点不在中国境内





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