一切就绪!

着手开发前,请先阅读我们的开发者文档

激活 Google Maps Distance Matrix API

为帮助您起步,我们将引导您在 Google Developers Console 中先完成几项任务:

  1. 创建或选择项目
  2. 激活 Google Maps Distance Matrix API
  3. 创建相应密钥
继续

入门指南

Google Maps Distance Matrix API 是一项根据起点和终点之间的推荐路线为起点和终点矩阵提供行程距离和时间的服务。

该服务还作为客户端 Google Maps JavaScript API 的一部分提供,或者在服务器端与 Java Client、Python Client、Go Client 以及 Node.js Client for Google Maps Services 配合使用。

示例请求和响应

可以使用以网址字符串形式构建的请求、originsdestinations 以及 API 密钥,通过 HTTP 接口访问 Google Maps Distance Matrix API。

下例请求的是华盛顿特区与纽约州纽约市之间 JSON 格式的 Distance Matrix 数据:

https://maps.googleapis.com/maps/api/distancematrix/json?units=imperial&origins=Washington,DC&destinations=New+York+City,NY&key=YOUR_API_KEY

试一试!可以在网络浏览器中输入该网址进行测试(务必将 YOUR_API_KEY 替换成实际使用的 API 密钥)。响应包括指定起点与终点之间的距离和时间。

请查看开发者指南,了解有关生成请求网址和可用参数以及理解响应的详细信息。

下面是一个 JSON 格式的示例响应:

{
   "destination_addresses" : [ "New York, NY, USA" ],
   "origin_addresses" : [ "Washington, DC, USA" ],
   "rows" : [
      {
         "elements" : [
            {
               "distance" : {
                  "text" : "225 mi",
                  "value" : 361715
               },
               "duration" : {
                  "text" : "3 hours 49 mins",
                  "value" : 13725
               },
               "status" : "OK"
            }
         ]
      }
   ],
   "status" : "OK"
}

使用客户端内容库编码入门指南

客户端内容库通过以简单、原生方式实现身份验证、请求限制和自动重试等常见任务来简化 Google Maps Web Service API 开发工作。Java Client、Python Client、Go Client 和 Node.js Client for Google Maps Services 中提供了 Google Maps Distance Matrix API。

身份验证、配额和政策

激活 API 和获取 API 密钥

要使用 Google Maps Distance Matrix API,您必须先在 Google API Console 中激活 API,并获取正确的身份验证凭据。需要在每个请求中提供 API 密钥如果加入的是高级计划,则需提供客户端 ID)。

点击以下按钮完成整个流程,在此过程中您将:

  1. 创建或选择项目
  2. 启用 API
  3. 获取 API 密钥
获取密钥

详细了解身份验证凭据

配额

查看使用限制页面,了解有关为 Google Maps Distance Matrix API 设置的配额的详情。

政策

必须按照 API 政策使用 Google Maps Distance Matrix API。

了解详情

Distance Matrix API 还有其他用途,比如请求不同出行方式的距离数据请求以不同单位(例如公里或英里)表示的距离数据以及估算交通行程时间。请参阅 Distance Matrix API 开发者指南,了解更多示例和其他详情。

发送以下问题的反馈:

此网页
Google Maps Distance Matrix API
Google Maps Distance Matrix API
需要帮助?请访问我们的支持页面