路线矩阵请求将出发地和目的地航点数组作为输入。然后,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 处的目的地航点计算得出。
关于响应
表示 API 响应的 JSON 对象包含一个数组,其中每个数组元素用于定义从一个出发地航点到一个目的地航点的路线。
除了 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) } } … ]