百度地图开放平台

所有文档

步行路线规划

服务概览

快速开始

使用准备

接口文档

服务功能

步行路线规划

相关资料

更新日志
更新时间: 2026/10/27 15:33

【描述】
步行路线规划API,是一类web API接口服务,以HTTP/HTTPS形式提供步行路线规划服务。
【URL】

URL请求方式

步行路线规划

GET

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

参数名类型说明是否必填备注

ak

string

是

origin

string

起点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

是

起点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

destination

string

终点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

是

终点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

origin_uid

string

否

destination_uid

string

否

waypoints

string

格式为:纬度,经度|纬度,经度|纬度,经度;小数点后不超过6位,40.056878,116.30815|40.056878,116.30815|40.056878,116.30815

否

格式为:纬度,经度|纬度,经度|纬度,经度;小数点后不超过6位,40.056878,116.30815|40.056878,116.30815|40.056878,116.30815

coord_type

string

默认bd09ll

允许的值为:bd09ll(百度经纬度坐标)、bd09mc(百度墨卡托坐标)、gcj02(国测局加密坐标)、wgs84(gps设备获取的坐标)。

否

默认bd09ll

允许的值为:bd09ll(百度经纬度坐标)、bd09mc(百度墨卡托坐标)、gcj02(国测局加密坐标)、wgs84(gps设备获取的坐标)。

ret_coordtype

string

返回值的坐标类型,默认为百度经纬度坐标:bd09ll

可选值:

bd09ll:百度经纬度坐标

gcj02:国测局坐标

否

返回值的坐标类型,默认为百度经纬度坐标:bd09ll

可选值:

bd09ll:百度经纬度坐标

gcj02:国测局坐标

extensions

string

可选值:

guidance:导航引导信息

否

可选值:

guidance:导航引导信息

language

string

该功能为高级子功能,需通过工单联系工作人员开通

否

该功能为高级子功能,需通过工单联系工作人员开通

sn

string

否

timestamp

int64

SN存在时必填

否

SN存在时必填

output

string

可选值:json

否

可选值:json

callback

string

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

否

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

【返回参数】

字段名称字段含义字段类型说明

status

状态码

int

0:成功

1:服务内部错误(用户可以重试一次)

2:参数错误

3001:算路失败

3002:无步行路线

3003:两点间距离过远, 无步行路线

message

状态码对应的信息

string

type

返回数据类型

int

固定值:2,标识返回的是路线数据

result

origin

起点信息

object

uid

起点poi的uid

string

和传入的origin_uid参数一致

originPt

起点经纬度

object

lng

经度

float

lat

纬度

float

destination

终点信息

object

uid

终点poi的uid

string

和传入的destination_uid参数一致

destinationPt

终点经纬度

object

lng

经度

float

lat

纬度

float

routes

返回的路线方案集合

array

distance

路线距离

int

单位:米

duration

路线耗时

int

单位:秒

originLocation

路线起点

object

lng

经度

double

lat

纬度

double

destinationLocation

路线终点

object

lng

经度

double

lat

纬度

double

steps

路线分段

array

leg_index

所在leg索引

int

在途经点处会分leg

direction

进入step方向角

int

distance

step的长度

int

单位:米

duration

step的耗时

int

单位:秒

instructions

路段导航描述

string

name

道路名称

string

path

路线形点序列

string

多个坐标点之间用';'分隔

turn_type_id

转向类型id

int

0 : 无效

1 : 直行

2 : 右前方转弯

3 : 右转

4 : 右后方转弯

5 : 左后方转弯

6 : 左转

7 : 左前方转弯

15 : 到斜对面,右前方转弯

17 : 到斜对面,左前方转弯

21 : 到斜对面,左前方转弯

23 : 到斜对面,右前方转弯

26 : 过马路左转

27 : 过马路右转

28 : 进入左侧道路继续向前

29 : 进入右侧道路继续向前

30 : 进入左侧道路往回走

31 : 进入右侧道路往回走

stepOriginLocation

step的起点

object

lng

经度

double

lat

纬度

double

stepDestinationLocation

step的终点

object

lng

经度

double

lat

纬度

double

guidance

verbal_instructions

导航引导播报

array

参考下文的“verbal_instructions”部分

【verbal_instructions】

字段名称字段含义字段类型说明

distance_to_origin

引导点和路线起点之间的距离

int

单位:米

cloud_guide_version

引导版本号

string

details

array

speak_text

播报文本

string

示例:50米后路口右前方转弯,随后红绿灯路口右转,到成府路辅路

voice_level

语音等级

int

数值越大优先级越高

distance_to_gdpt

播报位置和引导点之间的距离

int

单位:米

上一篇

使用准备

下一篇

更新日志
本篇文章对您是否有帮助?