此页面由 Cloud Translation API 翻译。

获取路由矩阵

欧洲经济区 (EEA) 开发者

通过调用 computeRouteMatrix 方法 (REST) 或流式 ComputeRouteMatrix 方法 (gRPC)，使用 Routes API 计算多个出发地和目的地的路线距离和时长。

给定出发地和目的地的列表后，该方法会计算从每个出发地出发并到达每个目的地的路线的距离和时长。

获取公交路线矩阵

您还可以计算公交路线矩阵。如需查看示例，请参阅获取公交路线矩阵。

请求限制

对于使用地址或地点 ID 的途径点以及元素，Compute Route Matrix 方法会强制执行以下请求限制。元素是指路线矩阵中每个出发地与目的地之间的路线，因此元素数量等于出发地数量乘以目的地数量。例如，如果您有 10 个出发地和 10 个目的地，则有 100 个元素：

对于非 TRANSIT 路线，元素数量不得超过 625 个。
如果您指定了 TRANSIT 路线，则元素数量不得超过 100。
如果您指定了 TRAFFIC_AWARE_OPTIMAL，则元素数量不得超过 100。如需详细了解 TRAFFIC_AWARE_OPTIMAL，请参阅指定是否以及如何添加流量数据。
如果您使用地址或地点 ID 指定起点或目的地，则最多可以指定 50 个。

响应错误

“计算路线矩阵”方法的一个特点是，可以针对整个响应或单个响应元素返回错误。例如，如果请求格式有误（例如，源为零），则整个响应都会包含错误。

不过，如果错误仅适用于响应中的部分元素（例如，无法计算某个起点和终点组合的路线），则只有受错误影响的元素会返回错误代码。

gRPC 流结果

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 示例同时调用了 Compute Routes 和 Compute Route Matrix。