为何使用 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 客户端、Python 客户端、Go 客户端和 Node.js 客户端 服务是社区支持的客户端库,已按照 Apache 2.0 许可。 您可以从 GitHub 下载它们,您还可以在 GitHub 上找到安装说明和示例代码。
后续步骤
- 开始使用距离矩阵:转到开始使用。
- 开始使用示例请求和响应:前往距离矩阵 请求和响应
- 遵循最佳实践:前往 Web Service Best 做法。