应使用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。不能跳过这一步，百度不支持地址直驱路径计算。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 对每个地址单独调一次
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 参数，不加默认走最短时间。
坐标精度、服务开通状态、参数顺序、超时设置——这四点任一出问题，都会让整个链路静默失败，而不是抛出清晰异常。
