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 上找到安装说明和示例代码。

后续步骤