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 下载它们，您还可以在 GitHub 上找到安装说明和示例代码。

后续步骤