您可以使用 Routes API 通过调用 computeRouteMatrix 方法 (REST) 或流式传输 ComputeRouteMatrix 方法 (gRPC) 来计算多个出发地和目的地之间的路线距离和时长。
给定一个出发地和目的地列表后，该方法会计算以每个出发地到每个目的地结束的路线的距离和时长。
请求限制
计算路由矩阵方法实施了以下请求限制：
元素数量（出发地数量 × 目的地数量）不能超过 625。
如果您指定
TRAFFIC_AWARE_OPTIMAL，则元素数量不能超过 100。如需详细了解TRAFFIC_AWARE_OPTIMAL，请参阅配置质量与延迟时间。您可以使用地点 ID 指定最多 50 个航点（出发地 + 目的地）。
响应错误
计算路线矩阵方法有一项功能：可以针对整个响应，也可以针对个别响应元素返回错误。例如，如果请求格式不正确，整个响应都会包含错误（例如，请求的来源为零）。
但是，如果错误适用于响应中的一部分元素（例如，无法针对出发地和目的地的组合计算路线），则只有受该错误影响的元素才会返回错误代码。
流式传输结果
ComputeRouteMatrix gRPC 方法会接受出发地和目的地列表，并返回包含出发地和目的地组合的组合的路线。由于结果是作为流返回的，因此您无需等到所有路由组合计算完毕后，才能开始处理结果。
流返回的元素不保证按任何顺序返回。因此，每个响应元素都包含一个 origin_index 和一个 destination_index。对于请求指定的出发地和目的地，对于给定元素，路线出发地等同于 origins[origin_index]，且路线目的地等同于 destinations[destination_index]。这些数组为零索引。请务必存储出发地和目的地列表顺序。
计算路线矩阵示例
在 HTTP 请求中使用 computeRouteMatrix 方法即可计算路由矩阵。
HTTP 示例
以下示例展示了 computeRouteMatrix HTTP 请求。在此示例中：
指定一个包含两个出发地和两个目的地航点的数组。该方法会计算从每个出发地到每个目的地的路线，因此响应中包含四条路线。
在该数组中，第一个元素的索引为 0，第二个元素的索引为 1，依此类推。
添加响应字段掩码，以指定要返回的响应 (REST) 或 ComputeRoutesResponse (gRPC) 的字段。在此示例中，将请求配置为返回每条路线的
originIndex、destinationIndex、duration、distanceMeters、status和condition。如需了解详情，请参阅选择要返回的字段。
curl -X POST -d '{
"origins": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.420761,
"longitude": -122.081356
}
}
},
"routeModifiers": { "avoid_ferries": true}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.403184,
"longitude": -122.097371
}
}
},
"routeModifiers": { "avoid_ferries": true}
}
],
"destinations": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.420999,
"longitude": -122.086894
}
}
}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.383047,
"longitude": -122.044651
}
}
}
}
],
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE"
}' \
-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'
响应中包含关于所有出发地和目的地航点组合的四种可能路线。
使用 originIndex 和 destinationIndex 响应字段来识别响应中的每条路由。例如，响应中 originIndex 为 1 时，相应请求与根据请求中的 origins 数组的索引 1 处的航点计算得出的路线相对应。
[
{
"originIndex": 0,
"destinationIndex": 0,
"status": {},
"distanceMeters": 822,
"duration": "160s",
"condition": "ROUTE_EXISTS"
},
{
"originIndex": 1,
"destinationIndex": 0,
"status": {},
"distanceMeters": 2919,
"duration": "361s",
"condition": "ROUTE_EXISTS"
},
{
"originIndex": 1,
"destinationIndex": 1,
"status": {},
"distanceMeters": 5598,
"duration": "402s",
"condition": "ROUTE_EXISTS"
},
{
"originIndex": 0,
"destinationIndex": 1,
"status": {},
"distanceMeters": 7259,
"duration": "712s",
"condition": "ROUTE_EXISTS"
}
]
gRPC 示例
如需查看 gRPC 请求的示例，请参阅 gRPC 请求示例。该页面上的 Java 示例会同时调用计算路由和计算路由矩阵。