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 可用的资源及其返回的数据。

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

以地点 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 下载，您也可以在这里找到安装说明和示例代码。

后续步骤