Google Directions API公共交通模式下路段总时长与步骤时长总和不一致问题咨询

你遇到的这个情况是Google Directions API在处理公共交通路线时的正常表现，核心原因是公共交通行程中的等待/换乘时间没有完全被拆分到单个Step的Duration字段中，导致Leg的总时长会包含一些Steps里未体现的“隐性时间”。

具体原因分析： #

• 等待/换乘时间的统计差异
  当路线包含公共交通时，Leg的总时长是从出发到到达的完整时间，涵盖了所有环节：

  1. 步行到车站的耗时（对应WALKING Step的Duration）
  2. 到达车站后等待公交发车的时间
  3. 乘坐公交的行驶耗时（对应TRANSIT Step的Duration）
  4. 换乘时在车站的停留时间
     而单个Step的Duration仅计算该步骤的移动执行时间，那些在车站的等待/停留时间不会被分配到任何一个Step里，只会被统一计入Leg的总时长中。这就是纯步行路线无差异（无等待环节）、含公交路线出现差值、长路线差异更大（多段等待时间累积）的原因。

• API的时间计算逻辑差异
  Leg的duration是基于你传入的departure_time，结合实时/预测的公交运营数据计算出的完整行程耗时；而每个Step的duration只是该步骤本身的执行时间，不包含等待公交的前置时间。比如你例子里差的1秒，就是步行到车站后到公交发车的极短等待时间，被算进了Leg总时长但没分到Step里。

验证与解决建议： #

如果你想更清晰地拆解时间构成，可以查看TRANSIT类型Step的transit_details字段，里面包含了该公交段的精准发车和到达时间：

for step in leg['steps']:
    if step['travel_mode'] == 'TRANSIT':
        dep_time = step['transit_details']['departure_time']['value']
        arr_time = step['transit_details']['arrival_time']['value']
        print(f"公交段实际耗时: {arr_time - dep_time} 秒")

这段代码能帮你看到公交段的实际行驶时长，再结合前后步行Step的时间，加上前一个Step结束到公交发车的等待时间差，就能和Leg总时长完全对应上。

如果只是需要准确的总行程时间，直接使用leg['duration']['value']会更可靠——它是API计算的完整行程耗时，已经包含了所有隐性的等待/换乘时间。

内容的提问来源于stack exchange，提问作者Edvin444