应使用driving/v1/route接口,需先通过geocoding/v3将地址转为结构化坐标(lng,lat),再调用路线规划,且须开通「路线规划服务」、注意参数顺序与超时设置。

百度地图API的行车路径接口选哪个
直接用 driving/v1/route,不是 direction/v2/driving(已废弃),也不是 distancematrix/v2(只返回距离/时间矩阵,不带路径详情)。新版 v1 接口需在控制台开通「路线规划服务」并绑定 SDK key,否则返回 INVALID_REQUEST 或 AK_INVALID。
注意:该接口要求起点和终点都必须是「结构化地理坐标」(lng,lat,经度在前),不能传地址字符串——这点最容易踩坑,传中文地址会返回 INVALID_PARAMS。
怎么把地址转成坐标再调用驾车路线
必须分两步:先用 geocoding/v3/ 将地址转为 lng,lat,再把两个坐标喂给 driving/v1/route。不能跳过这一步,百度不支持地址直驱路径计算。
实操建议:
- 对每个地址单独调一次
geocoding/v3/,解析响应中的result.location.lng和result.location.lat - 检查
result.status是否为0,非零值说明地址没解析出来(比如“北京市朝阳区建国路”可能失败,换成“北京市朝阳区建国路87号”更稳) - 坐标精度建议保留小数点后6位,传太多位反而可能被截断或触发校验失败
- 两次请求共用同一个
ak,但要注意配额:地理编码和路线规划是分开计费的
请求参数里哪些字段影响结果准确性
driving/v1/route 的 origin 和 destination 必须是 lng,lat 字符串(如 "116.480965,39.989631"),顺序错一个就反向导航;traffic_condition 设为 1 才返回实时路况耗时(duration 字段),设为 0 则只算无拥堵基准时间;avoid_polygons 可传绕行区域(如施工路段),但格式必须是 GeoJSON 多边形坐标数组,填错直接报 INVALID_PARAMS。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
常见错误现象:
- 返回
{"status":302,"message":"NO_PERMISSION"}→ 控制台没开通「路线规划」服务,或 ak 绑定的 IP 白名单不包含你服务器的出口 IP - 返回
{"status":200,"message":"成功","result":{"routes":[]}}→ 起终点坐标落在水域、禁行区或百度地图未覆盖区域(如部分山区) -
distance是米,duration是秒,别直接当公里和分钟用
Python里怎么安全拼接请求并处理异常
别手拼 URL,用 urllib.parse.urlencode() 处理参数编码,尤其地址含中文时;别用 requests.get(..., timeout=1) 这种极短超时,百度接口平均响应 300–800ms,设 timeout=(3, 10)(连通3秒,读取10秒)更稳妥。
关键代码片段(不含重试逻辑):
import requests
from urllib.parse import urlencode
ak = "your_ak_here"
url_geocode = f"https://api.map.baidu.com/geocoding/v3/?{urlencode({'address': '北京市海淀区中关村南一街2号', 'output': 'json', 'ak': ak})}"
resp_geo = requests.get(url_geocode, timeout=(3, 10))
data = resp_geo.json()
if data.get("status") != 0:
raise ValueError(f"Geocoding failed: {data.get('message')}")
lng, lat = data["result"]["location"]["lng"], data["result"]["location"]["lat"]
url_route = f"https://api.map.baidu.com/driding/v1/route?{urlencode({
'origin': f'{lng},{lat}',
'destination': '116.462184,39.992571',
'traffic_condition': '1',
'ak': ak
})}"
resp_route = requests.get(url_route, timeout=(3, 10))
route_data = resp_route.json()
if route_data.get("status") != 0:
raise RuntimeError(f"Route failed: {route_data.get('message')}")
print(f"距离: {route_data['result']['routes'][0]['distance']}m, 耗时: {route_data['result']['routes'][0]['duration']}s")
真实场景中,driving/v1/route 返回的 routes 是数组,哪怕只有一条路径也得取 [0];如果需要多策略(如少收费、躲避高速),得显式加 policy 参数,不加默认走最短时间。
坐标精度、服务开通状态、参数顺序、超时设置——这四点任一出问题,都会让整个链路静默失败,而不是抛出清晰异常。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










