腾讯地图路线规划(Direction API)核心总结
腾讯地图Direction API 提供6种交通方式路线计算,基于HTTP/HTTPS返回JSON,需配合地图API/SDK展示路线。
一、支持交通方式
- 驾车(driving):支持实时路况、多策略、限行、途经点、多路线、未来算路(付费)
- 步行(walking):基础步行路线
- 骑行(bicycling):自行车路线
- 电动车(ebicycling):电动自行车专用路线
- 公交(transit):公交/地铁/火车,支持换乘偏好与多方案
- 新能源汽车(edriving) :带充电站规划,高级付费
二、统一基础信息
- 请求方式:GET
- 域名:
apis.map.qq.com/ws/direction/v1/ - 必传参数:
key、from(lat,lng)、to(lat,lng) - 坐标规则:纬度在前,经度在后
- 路线点串:
polyline压缩格式,需按官方算法解压 - 状态码:
status=0为成功
三、各方式核心要点
1. 驾车(最复杂、功能最全)
- 接口:
/driving/ - 核心能力:
- 策略:时间最短/少收费/不走高速/大路优先等
- 途经点:最多30个,智能排序(付费)
- 限行:传入
plate_number+cartype自动避让 - 未来算路:
departure_time(付费) - 多路线:
get_mp=1最多3条 - 路况:
get_speed=1返回畅通/缓行/拥堵
- 限制:起点20公里内无道路则算路失败
2. 步行
- 接口:
/walking/ - 距离:10米 ~ 300公里
- 包含:过街天桥/地下通道/人行横道标识
3. 骑行 / 电动车
- 接口:
/bicycling/、/ebicycling/ - 骑行距离:10米 ~ 500公里
- 电动车:优先走合规非机动车道
4. 公交
- 接口:
/transit/ - 策略:时间短/少换乘/少步行/推荐
- 可限制:不坐地铁/只地铁/地铁优先
- 返回:步行+公交+地铁+火车分段步骤
5. 新能源汽车
- 接口:
/edriving/ - 用途:按能耗自动规划充电站
- 类型:高级付费,需商务开通
四、通用关键参数
from_poi/to_poi:POI ID,优先于坐标,终点吸附出入口更准output:json/jsonpcallback:JSONP回调polyline:压缩坐标串,需解压使用polyline_idx:路段在全程点串中的下标范围
五、响应通用结构
status:状态result.routes:路线数组distance:总距离(米)duration:预估时间(分钟)polyline:路线坐标steps:分段引导(转弯、路名、方向、动作)
六、重要限制
- 起点会吸附就近道路,20公里内无道路则失败
- 步行/骑行有距离上下限
- 部分高级能力(途经点排序、未来算路、新能源、沿途事件)需付费开通