Distance Matrix API 概览

欧洲经济区 (EEA) 开发者

简介

距离矩阵 API（旧版）是一项服务，可接受包含指定运输方式的出发地和目的地的 HTTPS 请求。对于每对出发地和目的地，它都会返回行程距离和时长。

为何要使用 Distance Matrix API

您可以使用 Distance Matrix API 来帮助确定多个可能的出发地与目的地之间最有效的出行路线。例如，将哪些工人派往工作地点，或从哪些仓库发送包裹。

Distance Matrix API 的用途

借助 Distance Matrix API，您可以获取一系列出发地和目的地之间的行程距离和用时。您可以指定多种选项，包括交通方式（例如驾车、骑车、乘坐公交或步行）以及公交方式（例如公交车、地铁、火车、电车或轨道交通）。

Distance Matrix API 会根据起点和终点之间的推荐路线提供信息。您可以请求以下类型的距离数据：

所选出行方式的距离
距离（以公里或英里为单位）
交通状况下的预计行程时间

地图：显示地图上和 API 响应中的出发地和目的地

Distance Matrix API 的运作方式

距离矩阵 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 下载这些客户端库，还可以在其中找到安装说明和示例代码。

后续步骤

开始使用距离矩阵：前往使用入门。
开始使用示例请求和响应：前往距离矩阵请求和响应。
遵循最佳实践：请参阅 Web 服务最佳实践。