路线规划2.0 最后更新时间: 2023年05月05日
产品概述
路线规划接口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 |
请求方式 | GET,当参数过长导致请求失败时,需要使用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 | 驾车算路策略 | 0:速度优先(只返回一条路线),此路线不一定距离最短 1:费用优先(只返回一条路线),不走收费路段,且耗时最少的路线 2:距离优先(只返回一条路线),仅走距离最短的路线,但是可能存在穿越小路/小区的情况 3:速度优先(只返回一条路线),不走快速路,例如京通快速路 32:默认,高德推荐,同高德地图APP默认 33:躲避拥堵 34:高速优先 35:不走高速 36:少收费 37:大路优先 38:速度最快 39:躲避拥堵+高速优先 40:躲避拥堵+不走高速 41:躲避拥堵+少收费 42:少收费+不走高速 43:躲避拥堵+少收费+不走高速 44:躲避拥堵+大路优先 45:躲避拥堵+速度最快 | 可选 | 32 |
waypoints | 途经点 | 途径点坐标串,默认支持1个有序途径点。多个途径点坐标按顺序以英文分号;分隔。最大支持16个途经点。 | 可选 | 无 |
avoidpolygons | 避让区域 | 区域避让,默认支持1个避让区域,每个区域最多可有16个顶点;多个区域坐标按顺序以英文竖线符号分隔,如果是四边形则有四个坐标点,如果是五边形则有五个坐标点;最大支持32个避让区域。 同时传入避让区域及避让道路,仅支持避让道路; 每个避让区域不能超过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 | 终点经纬度 | |||
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 |
- 请求参数
参数名 | 含义 | 规则说明 | 是否必须 | 缺省值 | |
key | 高德Key | 用户在高德地图官网申请Web服务API类型Key | 必填 | 无 | |
origin | 起点信息 | 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 | 必填 | 无 | |
destination | 目的地信息 | 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 | 必填 | 无 | |
alternative_route | 返回路线条数 | 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 | 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未设置时,只返回基础信息类内字段。 | 可选 | 空 |
alternative_route | 返回方案条数 | 1:多备选路线中第一条路线 2:多备选路线中前两条路线 3:多备选路线中三条路线 不传则默认返回一条路线方案 | 可选 | 空 |
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 | 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未设置时,只返回基础信息类内字段。 | 可选 | 空 |
alternative_route | 返回方案条数 | 1:多备选路线中第一条路线 2:多备选路线中前两条路线 3:多备选路线中三条路线 不传则默认返回一条路线方案 | 可选 | 空 |
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 | string | 设置后可返回分路段坐标点串,两点间用“,”分隔 |
公交路线规划
- 公交路线规划 API 服务地址
URL | https://restapi.amap.com/v5/direction/transit/integrated?parameters |
请求方式 | GET |
- 请求参数
参数名 | 含义 | 规则说明 | 是否必须 | 缺省值 |
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 |
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_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 | 设置后可返回分路段坐标点串,两点间用“,”分隔 |
错误码说明:https://developer.amap.com/api/webservice/guide/tools/info