Compute Route Matrix 是 Routes API 服务中的一个方法，用于接受 HTTPS 请求，并返回不同出发地和目的地位置之间路线矩阵的距离和行程时间。支持计算多个目的地之间的行程时间与距离，最多可包含 625 个路线元素。
需要查询行车路线？如果您对路线方向感兴趣，请参阅计算路线概览。
正在迁移？如果您要从 Distance Matrix API（旧版）进行迁移，请参阅从为何迁移到 Routes API 开始的迁移说明。
为何使用计算路线矩阵
借助计算路线矩阵，您可以确定最有效的路线来安排调度，例如：
如何最好地分配一组工人来提取一系列包裹
确定将包裹从哪个仓库配送到最终目的地最合适
您可以使用计算路线矩阵做些什么？
借助“计算路线矩阵”功能，您可以获取多个起点和终点之间可能的路线的矩阵。您可以为每个服务器端请求指定多个起点和目的地，其中起点数量乘以目的地数量不得超过 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 Routes Matrix 方法提供的资源以及它返回的数据。
| 数据资源 | 返回的数据 | 返回格式 |
|---|---|---|
| ComputeRouteMatrix | 返回从一个起点航点到一个目的地航点的路线数组。 | JSON |
如何使用计算路线矩阵
| 1 | 开始设置 | 首先设置 Google Cloud 项目，然后完成后续的设置说明。 |
| 2 | 了解 Routes API 的计费方式 | 如需了解详情，请参阅用量和结算。 |
| 3 | 计算路线矩阵并查看响应 | 如需了解详情，请参阅获取路线矩阵和查看路线矩阵响应。 |
可用的客户端库
如需查看适用于计算路线矩阵的可用客户端库列表，请参阅客户端库。