为什么使用 Distance Matrix API
您可以使用 Distance Matrix API 来帮助确定多个可能的出发地和目的地之间最高效的行程路线。例如,要将哪些工作器发送到作业地点,或者要从哪些仓库发送包裹。
Distance Matrix API 的功能
借助 Distance Matrix API,您可以为出发地和目的地矩阵提供行程距离和时间。您可以指定多个选项,包括交通方式(例如驾车、骑车、公交或步行)以及公交模式(例如公交车、地铁、火车、电车或铁路)。
Distance Matrix 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、地址或纬度/经度坐标形式提供出发地和目的地。 |
|
|
如何使用 Distance Matrix API
1 | 开始设置。 | 从设置您的 Google Cloud 项目开始,完成随后的设置说明。 |
2 | 尝试距离矩阵请求 | 有了 API 密钥后,您可以开始直接在浏览器中测试 Distance Matrix API。如需查看相关示例,请参阅使用入门指南中的示例请求。 |
3 | 编写更复杂的请求 | 请尝试提供多个出发地和目的地的请求。了解用于限制计算的可选参数,例如指定的出发时间或路线限制。请参阅距离矩阵请求和响应指南中的可选参数 。 |
4 | 了解响应基础知识 | 探索数据响应,为为您的应用使用距离矩阵数据做好准备。如需了解详情,请参阅距离矩阵响应。 |
5 | 将距离矩阵数据整合到您自己的应用中! | 您可以使用此数据计算行程距离和时间。 |
可用的客户端库
请通过以下任一客户端库以您选择的语言调用此 API:
- 适用于 Google 地图服务的 Java 客户端
- 适用于 Google 地图服务的 Python 客户端
- 适用于 Google 地图服务的 Go 客户端
- 适用于 Google 地图服务的 Node.js 客户端
适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库,并且根据 Apache 2.0 许可开源。请从 GitHub 下载这些示例,您还可以从 GitHub 中找到安装说明和示例代码。