查看路由矩阵响应

路线矩阵请求将出发地和目的地数组作为输入 航点。然后，Routes API 会计算从每个出发地出发的路线 到每个目的地航点的航点例如，如果您指定两个来源 航点和两个目的地航点，API 随后会计算四个单独的 路由。

API 响应包含一个数组，其中的每个数组元素都对应 从一个起点航点到一个目的地航点的路线。因此，如果您 指定两个起点航点和两个目的地航点、响应数组 包含四个元素，每条计算的路线各一个。

使用响应，您可以为客户提供不同的路线选项 然后让用户根据自己的需求选择合适的路由。

关于字段掩码

调用计算路线的方法时，必须指定字段 用于定义要在响应中返回哪些字段的掩码。没有任何 默认返回字段列表。如果您省略此列表，这些方法会返回 错误。

本文档中的示例展示了整个响应对象， 字段掩码。在生产环境中，您的响应 仅包含您在字段掩码中明确指定的字段。

如需了解详情，请参阅选择要返回的信息。

关于显示版权

在向用户显示结果时，您必须添加以下版权声明：

Powered by Google, ©YEAR Google

例如：

Powered by Google, ©2023 Google

识别响应中的路由

使用 originIndex 和 destinationIndex 响应属性来标识 每个路由这些属性包含从零开始的索引 输入 origin 和 destination 航点，用于计算 。这意味着第一个起点航点和第一个目的地航点 都位于数组索引 0。

例如，响应中的路由包含：

"originIndex": 1,
"destinationIndex": 0

这些属性表示路线是从起点计算的 输入数组中索引 1 处的航点，以 索引 0。

对于下一条路线：

"originIndex": 4,
"destinationIndex": 1

该路线是根据输入中索引 4 处的起点航点计算的 数组，从输入数组中索引 1 处的目的地航点开始。

关于响应

通过 JSON 对象 表示 API 响应包含一个数组，其中每个数组元素 定义从一个起点航点到一个终点航点的路线。

除了 originIndex 和 destinationIndex 属性外，每条路线还包括 包含特定于该路线的信息，例如 distanceMeters、 duration 和 travelAdvisory。

响应的格式如下：

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]