【描述】
骑行路线规划API,是一类web API接口服务,以HTTP/HTTPS形式提供骑行路线规划服务。
【URL】
| 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:国测局坐标 |
riding_type | int | 0(默认值):自行车 1:电动车 | 否 | 0(默认值):自行车 1:电动车 |
road_prefer | int | 0(默认值):默认路线 3:无逆行且无阶梯的算路方案 | 否 | 0(默认值):默认路线 3:无逆行且无阶梯的算路方案 |
steps_info | int | 0:不返回路线step详情 1(默认值):返回路线step详情 | 否 | 0:不返回路线step详情 1(默认值):返回路线step详情 |
intelligent_plan | int | 0(默认值):普通规划 1:启用智能途经点规划 | 否 | 0(默认值):普通规划 1:启用智能途经点规划 |
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 | |||||
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 | 单位:米 | ||
上一篇
下一篇