关于本文
本文是通过利用生成式 AI 的自动化生成流程创建的。
我们将参考 Google 官方一手资料，对用于计算路线、距离和所需时间的 Routes API 进行梳理，同时注意与 Directions API (Legacy) / Distance Matrix API (Legacy) 之间的代际差异。
信息确认基准日：2026-09-19
一言以蔽之
Routes API 是允许应用程序计算从出发地到目的地移动路线的 Google Maps Platform API。
| 观察视角 | 内容 |
|---|---|
| 分类 | Google Maps Platform / Routes |
| 核心目的 | 计算路线、距离和时间 |
| 主要处理 | Compute Routes / Compute Route Matrix |
| 地点指定 | Place ID、坐标、地址、Plus Code 等 |
| 联合使用 | Places、Geocoding、Maps JavaScript API |
flowchart LR O[出発地] --> R[Routes API] D[目的地] --> R W[経由地] --> R R --> Route[経路] R --> Time[所要時間] R --> Distance[距離]
要点
Google 官方建议使用地点 ID（Place ID）来指定地点，以确保效率和准确性。由于地址字符串在内部会被转换为坐标，因此可能会产生模糊性。响应时请使用字段掩码（field mask）仅请求所需项目，从而减少不必要的数据和延迟。
实务示例
普通用户和文职人员是配送、拜访、出行规划界面的用户，IT 管理员负责管理计费、配额、身份验证和位置数据，开发人员则实现路线显示以及地点间的距离和时间计算。
面向 Microsoft 经验者的桥梁
虽然其思路与 Azure Maps Route 系列相近，但 Google 的 Place ID、交通数据以及费用和使用条件则有所不同。可以将其理解为“将 Google Maps 的路线计算引擎作为 API 使用”。
安全测试
仅使用两个公开设施地点进行最小化请求，将返回路线、距离和时间作为成功条件。接下来，只更改一个地方（例如出行模式等）。切勿将家庭住址或真实用户的出行历史记录固定在样本中。
Google 官方信息
文章特定的重新评估
Routes API的核心是Compute Routes和Compute Route Matrix。通过指定出发地、目的地、出行模式等参数，来获取距离、时间和路线信息。缩小响应字段掩码（field mask）的设计也很重要。
Papanda TRY
将东京站→上野站等公开地点作为虚拟输入，制作“两点间→距离/时间”的浏览器卡片并实现每日代码化。在不执行API的公开版本中，采用读取fixture JSON、切换地点时卡片随之切换的架构。
这到底是一个什么样的服务？
这是一个将Google Maps的路线计算能力集成到自己的配送、拜访、出行应用中的API。首先通过两点获取路线，并确认Place ID和字段掩码（field mask）的含义。
