导航|地址|刷新
路径规划-基础 API 文档-开发指南-Web服务 API | 高德地图API

!doctype html>







控制台

去认证企业


登录注册









退出


我的消息

云图市场

应用管理

GeoHUB




产品介绍

产品介绍高德开放平台产品介绍 查看全部文档

搜索定位


鸿蒙星河版定位SDK HOT鸿蒙星河版定位SDK

搜索 HOT位置、周边、行政区、ID等查询接口 API JS Android iOS

定位 HOT基于LBS的定位服务 API Android iOS

地理/逆地理编码 位置名称与经纬度之间转换服务 API JS Android iOS

地理围栏 虚拟空间围栏服务 API Android iOS

天气查询 查询目标区域当前/未来天气

智能硬件定位 通过基站、Wifi获取位置信息




路线导航


鸿蒙星河版导航SDK NEW鸿蒙星河版导航SDK

导航 HOT轻松地在APP中加入导航能力 Android iOS

路线规划 HOT提供步行、驾车等规划能力 API JS Android iOS

猎鹰服务 提供专业轨迹管理服务 API Android iOS

货车路径规划 专业的货车路径规划服务 API Android iOS

智能调度引擎 智能外勤调度，提升效益

物流服务 提供智慧物流API服务接口

公交信息查询 查询公交信息

交通路况查询 查询交通态势情况

高级路径规划 高级路径规划等能力




地图产品


鸿蒙星河版地图SDK HOT鸿蒙星河版-轻量地图SDK

动态地图 HOT动态地图展示、配置 API JS Android iOS HarmonyOS

3D地图 HOT3D动态地图展示、配置

地铁图 简单易用的移动端地铁线路图开发接口 JS Android iOS

静态地图 灵活地将高德地图迁入应用网页

3D地形图 卫星地形图还原真实地形地貌




高级地图工具


世界地图 NEW

自定义地图

地图数据可视化 (LOCA)

地图数据中心 (GeoHUB)

坐标拾取器

高德地图URI Web

高德地图URI APP

三维模型转换

微信小程序插件

地图Flutter插件

地图名片




高德地图小程序


地图小程序

客户管理

员工管理

送货提效

地图小程序API




空间智能开放平台


空间智能开放平台 NEW用真实空间信息解答业务问题






解决方案

解决方案提供各行业LBS解决方案


空间智能 NEW提供LBS领域的Agent解决方案

智能手表 NEW提供智能守护与运动出行解决方案

智能眼镜 NEW智能眼镜实时导航及智慧出行解决方案

世界地图 NEW面向开发者提供全球范围内LBS服务

智能两轮车 NEW合规精确的两轮车场景导航

手机银行 NEW提供手机银行APP地图应用





网格化营销 NEW提供银行网格化营销场景应用

智慧交通 优化交通资源配置，赋能智慧交通系统

出行 提供网约车等出行场景解决方案

O2O 到店、到家等多种O2O业务解决方案

上门服务调度 提供上门业务调度解决方案





三农场景可视化 NEW提供乡村振兴三农场景应用

社交 社交应用位置服务解决方案

运动 运动类应用解决方案

智能硬件 智能硬件LBS解决方案

零售铺货 零售快消行业，渠道铺货解决方案





智慧物流 针对物流行业提供解决方案

电商 电商物流行业解决方案

地址服务 综合地址服务，满足客户全景化需求

企业智图 一张图轻松管理企业数据

智能派单 一站式精准智能派单解决方案






文档与支持

文档与支持高德开放平台开发文档与服务支持 查看全部文档

API


Web基础服务API

Web高级服务API

物流服务API

猎鹰服务 API




JS API


JS API

数据可视化JS API

地图组件

URI API

地铁图 JS API




Android 平台


Android 地图SDK

Android 轻量版地图SDK

Android 定位SDK

Android 导航SDK

Android 猎鹰SDK




iOS 平台


iOS 地图SDK

iOS 轻量版地图SDK

iOS 定位SDK

iOS 导航SDK

iOS 猎鹰SDK




鸿蒙星河版平台


鸿蒙星河版地图SDK HOT

鸿蒙星河版定位SDK HOT

鸿蒙星河版导航SDK NEW




大模型开发工具


SKILL专区 NEW

MCP Server NEW

高德开放平台 CLI NEW




服务与支持


常见问题

创建工单

示例中心

合规中心

技术服务许可查询






定价

定价开放平台产品定价 产品定价

产品定价


产品定价

技术服务许可

GeoHUB自定义地图

GeoHUB数据中心




产品升级


高级能力

企业智图SaaS

云图市场






为什么选择高德




















历史记录

热门推荐
Android定位Android定位问题相关

浏览器定位JS API提供Geolocation定位插件

逆地理编码经纬度转换为详细结构化的地址

自定义地图7大类44种地图元素可定制

认证开发商商业授权相关问题














Web服务 API


概述

创建应用和 Key

入门指南

开发指南
基础 API 文档
地理/逆地理编码

路径规划

路径规划 2.0

行政区域查询

交通事件

IP定位

静态地图

坐标转换

轨迹纠偏


高级 API 文档
搜索POI

搜索POI 2.0

输入提示

天气查询

高级IP定位

智能硬件定位

交通态势查询

公交信息查询

高级路径规划


GeoHUB API文档
三方数据空间检索


实用工具
错误码说明

流量限制说明

天气对照表



常见问题

更新日志

相关下载






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


路径规划最后更新时间: 2026年02月02日


产品介绍

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


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


适用场景


无需展现地图的场景下，进行线路查询，如以线路结果页形式展现换乘方案；



根据返回线路数据，自行开发线路导航。


使用限制

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

使用说明





1

第一步




申请 【Web服务API】密钥（Key）




2

第二步




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




3

第三步


接收 HTTP 请求返回的数据（JSON 或 XML 格式），解析数据



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


成为开发者并创建 Key 
为了正常调用 Web 服务 API ，请先注册成为高德开放平台开发者，并申请 Web 服务的 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位	必填	无
origin_id	起点 POI ID	起点为 POI 时，建议填充此值，可提升路线规划准确性	可选	无
destination_id	目的地 POI ID	目的地为 POI 时，建议填充此值，可提升路线规划准确性	可选	无
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	0：最快捷模式; 1：最经济模式; 2：最少换乘模式; 3：最少步行模式; 5：不乘地铁模式	否
nightflag	0 1	是否计算夜班车,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	此方案总步行距离	单位：米
emergency		取值为all时返回
	linetype	事件类型	1：影响乘坐；2：不影响乘坐
eventTagDesc	事件标签	值为："提示“、”甩站“、”突发“、”停运“
ldescription	事件的线路上的文案
busid	线路id
busname	线路名
segments	换乘路段列表
	walking	此路段步行导航信息	详见 步行方案信息列表
bus	此路段公交导航信息	详见 公交方案信息列表
entrance	地铁入口	只在地铁路段有值，详见 出入口信息列表
exit	地铁出口	只在地铁路段有值，详见 出入口信息列表
railway	乘坐火车的信息	详情见只在地铁路段有值，详见 火车换乘信息列表

步行方案信息列表




…(内容过长已截断)

------
导航页 打开网址