Distance Matrix API 概览

Distance Matrix API 是一项接受 HTTPS 请求的服务 包含指定交通方式的出发地和目的地。对于每个出发地和目的地组合，它都会返回行程距离和用时。

为何使用 Distance Matrix API

您可以使用 Distance Matrix API 来帮助确定最高效的 多个可能的出发地和目的地之间的旅行路线。对于 例如，将哪些员工送到工作现场，或者从哪些仓库发送 软件包

您可以使用 Distance Matrix API 做些什么

利用 Distance Matrix API，您可以提供 一组出发地和目的地。您可以指定多个选项，包括 例如驾车、骑车、公交或步行，以及 公共交通工具，例如公交车、地铁、火车、电车或铁路。

Distance Matrix API 会根据推荐路线提供信息 起点和终点之间的距离。您可以请求以下类型的距离数据：

  • 所选出行方式的行程距离
  • 距离（以公里或英里为单位）
  • 预估交通时间

在地图上和 API 响应中显示出发地和目的地的地图

Distance Matrix API 的工作原理

Distance Matrix API 使用任意数量的起点（起点）和终点，并返回各起点之间的距离和行程时间 出发地和所有请求的目的地，从 然后逐步继续执行下一个请求

例如，如果您的请求将 A 和 B 指定为出发地，将 C 和 D 指定为目的地，它将按以下顺序返回距离和行程时间：

  • A 到 C
  • A 到 D
  • B 到 C
  • B 到 D

以下示例显示了 JSON 格式的请求，其中包含两个出发地（华盛顿特区和波士顿）和单个目的地（纽约州纽约市）：

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

资源

下表汇总了通过 Distance Matrix API 提供的资源以及该 API 返回的数据。

数据资源 返回的数据 返回格式
距离矩阵

以地点 ID、地址、 或纬度/经度坐标。

  • 每个起点和每个目的地之间的距离和行程时间
  • 在交通拥堵中所花的时间（如果您已指定驾驶模式和出发时间）
  • JSON
  • XML

如何使用 Distance Matrix API

1 开始设置。 首先设置 Google Cloud 项目，然后完成后续的设置说明。
2 试用距离矩阵请求 获得 API 密钥后，您就可以直接通过浏览器开始测试 Distance Matrix API。如需查看示例，请参阅使用入门指南中的示例请求。
3 编写更复杂的请求 请尝试提供多个出发地和目的地的请求。了解 限制计算的可选参数，例如指定的 出发时间或路线限制请参阅可选参数 （请参阅距离矩阵请求和响应指南）。
4 了解响应基础知识 探索数据响应，准备好在您的应用中使用距离矩阵数据。请参阅 距离矩阵响应 了解详情。
5 将距离矩阵数据整合到您自己的应用中！ 您可以使用此数据计算行程距离和所需时间。

可用的客户端库

通过以下任一客户端库以您偏好的语言调用此 API：

适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库，并且根据 Apache 2.0 许可开放源代码。您可以从 GitHub 下载这些库，还可以在 GitHub 上找到安装说明和示例代码。

后续步骤