计算路线矩阵概览

欧洲经济区 (EEA) 开发者

计算路线矩阵是 Routes API 服务中的一种方法，它接受 HTTPS 请求，并返回不同出发地和目的地之间路线矩阵的距离和行程时间。支持计算多个目的地之间的行程时间与距离，最多可包含 625 个路线元素。

需要行车路线？如果您对路线指引感兴趣，请参阅 计算路线概览。

要进行迁移？如果您要从 Distance Matrix API（旧版）进行迁移， 请参阅以 “为什么要迁移到 Routes API”开头的迁移说明。

为什么要使用计算路线矩阵

借助计算路线矩阵，您可以确定最有效的调度路线，例如：

  • 如何以最佳方式分配一组工作人员来收取一系列包裹

  • 确定将包裹运送到最终目的地的最佳仓库

计算路线矩阵有哪些用途？

借助计算路线矩阵，您可以获取许多起点和终点之间可能路线的矩阵。您可以在每个服务器端请求中指定多个出发地和目的地，出发地数量乘以目的地数量最多为 625。您可以在整个矩阵计算完成之前流式传输响应元素，从而降低响应延迟。

您可以请求以下类型的路线数据，以确定在多个出发地和目的地之间运送乘客、货物或工作人员的最有效方式：

  • 所选出行方式的距离（以公里或英里为单位）

  • 交通拥堵情况下的预计行程时间

计算路线矩阵的工作原理

ComputeRouteMatrix 方法接受 HTTP POST 请求，该请求包含一个 JSON 请求正文，其中包含请求详细信息。至少需要一个出发地、两个或多个目的地、出行方式和一个字段掩码，以指定要返回的字段。

示例

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

响应包含所有出发地和目的地航点组合的可能路线。

资源

下表总结了可通过 Routes API 计算路线矩阵方法获得的资源，以及该方法返回的数据。

数据资源 返回的数据 返回格式
ComputeRouteMatrix 返回从一个出发地航点到一个目的地 航点的路线数组。 JSON

如何使用计算路线矩阵

1 开始设置 首先按照设置 Google Cloud 项目 中的说明进行操作，然后完成后续设置说明。
2 了解 Routes API 的结算方式 如需了解相关信息，请参阅用量和结算。
3 计算路线矩阵并查看响应 如需了解详情，请参阅获取路线矩阵 和查看路线矩阵响应。

可用的客户端库

如需查看计算路线矩阵可用的客户端库列表，请参阅客户端库。

后续步骤