为何Google Map Route API与Google Map结果不一致？地铁路线缺失

我调用Google Route API查询日本福冈国际机场到博多车站的公共交通路线，请求参数如下：

使用地址的请求：

{
  "origin":{
    "address": "日本福岡國際機場"
  },
  "destination":{
    "address": "博多車站"
  },
  "travelMode": "TRANSIT",
  "transitPreferences": {
    "allowedTravelModes": ["TRANSIT_TRAVEL_MODE_UNSPECIFIED"],
    "routingPreference": "LESS_WALKING"
  },
  "computeAlternativeRoutes": true,
  "languageCode": "zh-HK",
  "units": "METRIC"
}

使用Place ID的请求：

{
  "origin":{
    "placeId": "ChIJrQFpQhaQQTURtx9OWEZ_5hY"
  },
  "destination":{
    "placeId": "ChIJdbP55seRQTURkIu5RT0r4i4"
  },
  "travelMode": "TRANSIT",
  "transitPreferences": {
    "allowedTravelModes": ["TRANSIT_TRAVEL_MODE_UNSPECIFIED"],
    "routingPreference": "LESS_WALKING"
  },
  "computeAlternativeRoutes": true,
  "languageCode": "zh-HK",
  "units": "METRIC"
}

但API仅返回步行路线，而直接在Google Map中搜索相同起点终点会显示地铁路线，请问为何存在此差异？

核心问题：Transit偏好参数配置错误 #

transitPreferences里的allowedTravelModes设置为TRANSIT_TRAVEL_MODE_UNSPECIFIED是关键诱因。这个枚举值代表未指定任何公共交通模式，API会将其视为过滤掉所有公共交通选项，最终只能返回步行路线。而Google Map网页端会自动忽略这种模糊配置，直接加载所有可用的公共交通方式。

其他可能影响因素 #

• API与网页端逻辑差异：Google Map网页端会自动整合实时交通数据、本地通勤习惯等因素优先推荐常用路线；而Route API需要明确的参数触发相同逻辑，默认不会自动补充未指定的偏好。
• Place ID匹配偏差：使用的Place ID可能指向整个机场/车站区域，而非靠近公共交通接驳口的具体点位，导致API判断无法接驳公共交通。

修复方案 #

1. 修正Transit偏好参数：
   • 移除allowedTravelModes参数，让API自动匹配所有可用公共交通方式：

     "transitPreferences": {
       "routingPreference": "LESS_WALKING"
     }
     

   • 或指定具体的公共交通模式（如地铁RAIL、公交BUS）：

     "transitPreferences": {
       "allowedTravelModes": ["RAIL", "BUS"],
       "routingPreference": "LESS_WALKING"
     }
     

2. 验证Place ID准确性：确认使用的Place ID对应到机场/车站内靠近公共交通接驳口的具体位置，而非整个区域的ID。

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