Google Maps Directions/Routes API日本Transit无结果问题咨询

关键排查项 #

• API启用与权限
  先去Google Cloud控制台确认：Directions API和Routes API都已启用，API密钥没有IP、地域或服务限制，且公共交通相关的请求配额未耗尽。很多时候“无路线”其实是API未启用或权限不足的隐性表现，而非真的没有路线数据。
• 参数配置细节
  • 公共交通模式必须明确指定mode=transit（Directions API）或travelMode=TRANSIT（Routes API），同时必须设置departure_time或arrival_time——东京的公共交通路线依赖时间维度，不指定的话API可能无法返回有效计划路线。
  • 优先用经纬度作为起点/终点，比地址字符串更可靠。即使从Google Maps复制路线，也要把地址转换成精确的坐标再测试，避免地址解析偏差。
  • 如果设置了transit_mode过滤（比如只选地铁），要确认包含东京实际运营的交通类型（如rail、bus、subway），别误过滤掉可用路线。
• 日本地区支持情况
  明确说明：Google Maps这两个API完全支持东京的公共交通路线查询，不存在地区限制问题。核心区域的公共交通数据覆盖完整，除非是极偏远区域，否则不会无结果。
• Routes API特殊注意
  使用Routes API时，公共交通请求要确保origin和destination使用结构化的位置信息（经纬度或完整地址），避免模糊的地点名称。另外，部分测试工具可能默认未开启公共交通支持，手动检查请求参数是否正确。

快速验证步骤 #

1. 用Google Cloud控制台的API测试工具，输入东京核心区域的起点（比如千代田区丸之内1-1）和终点（新宿区新宿1-1），指定mode=transit和当前时间作为departure_time，看是否返回结果。
2. 查看API配额页面，确认公共交通请求的剩余配额充足，没有被限流。
3. 去掉所有额外过滤参数（比如transit_mode），用最基础的请求测试，排除参数过滤导致的无结果。

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