计算路线矩阵概览

欧洲经济区 (EEA) 开发者

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

需要行车路线？如果您对路线方向感兴趣，请参阅 Compute Routes 概览。

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

为何要使用“计算路线矩阵”

借助“计算路线矩阵”，您可以确定用于调度安排的最有效路线，例如：

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

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

您可以使用 Compute Route Matrix 做些什么？

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

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

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

  • 交通状况下的预计行程时间

“计算路线矩阵”的工作原理

ComputeRouteMatrix 方法接受包含请求详细信息的 JSON 请求正文的 HTTP POST 请求。必需的参数包括至少一个出发地、两个或更多目的地、travelMode 以及用于指定要返回哪些字段的字段掩码。

示例

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 的 Compute Route Matrix 方法获得的资源，以及该方法返回的数据。

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

如何使用“计算路线矩阵”

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

可用的客户端库

如需查看适用于 Compute Route Matrix 的可用客户端库的列表，请参阅客户端库。

后续步骤