此页面由 Cloud Translation API 翻译。

Route Matrix (beta)

RouteMatrix 类

google.maps.routes.RouteMatrix 类

由 RouteMatrix.computeRouteMatrix 为一组出发地/目的地对计算出的路线矩阵

通过调用 const {RouteMatrix} = await google.maps.importLibrary("routes") 进行访问。
请参阅 Maps JavaScript API 中的库。

静态方法
`computeRouteMatrix`	`computeRouteMatrix(request)` 参数： `request`：`ComputeRouteMatrixRequest` 返回值： `Promise<{matrix:RouteMatrix}>` 接受出发地和目的地列表，并返回一个矩阵，其中包含每个出发地和目的地组合的路线信息。注意：此方法要求您通过设置 `ComputeRouteMatrixRequest.fields` 属性在请求中指定响应字段掩码。该值是字段路径的列表。例如：所有可用字段的字段掩码：`fields: ['']` 路线级时长和距离的字段掩码：`fields: ['durationMillis', 'distanceMeters']` 不建议使用通配符响应字段掩码 `fields: ['']`，因为：仅选择您需要的字段有助于我们的服务器节省计算周期，从而使我们能够以更低的延迟时间向您返回结果。仅选择生产作业中需要的字段可确保稳定的延迟时间性能。我们未来可能会添加更多响应字段，而这些新字段可能需要额外的计算时间。如果您选择所有字段，或者选择顶级的所有字段，则可能会遇到性能下降的问题，因为我们添加的任何新字段都会自动包含在响应中。仅选择所需的字段可减小响应大小，从而加快网络加载速度。

computeRouteMatrix

computeRouteMatrix(request)

参数：

返回值： Promise<{matrix:RouteMatrix}>

接受出发地和目的地列表，并返回一个矩阵，其中包含每个出发地和目的地组合的路线信息。

注意：此方法要求您通过设置 ComputeRouteMatrixRequest.fields 属性在请求中指定响应字段掩码。该值是字段路径的列表。

例如：

不建议使用通配符响应字段掩码 fields: ['*']，因为：

仅选择您需要的字段有助于我们的服务器节省计算周期，从而使我们能够以更低的延迟时间向您返回结果。
仅选择生产作业中需要的字段可确保稳定的延迟时间性能。我们未来可能会添加更多响应字段，而这些新字段可能需要额外的计算时间。如果您选择所有字段，或者选择顶级的所有字段，则可能会遇到性能下降的问题，因为我们添加的任何新字段都会自动包含在响应中。
仅选择所需的字段可减小响应大小，从而加快网络加载速度。

属性
`rows`	类型： `Array<RouteMatrixRow>` 矩阵的行。每一行都对应一个出发地，并包含一个 `RouteMatrixItem` 数组，每个 `RouteMatrixItem` 都表示前往某个目的地的路线。

方法
`toJSON`	`toJSON()` 参数：无返回值： `Object` 转换为对象。

google.maps.routes.RouteMatrixRow 类

对应于传递给 RouteMatrix.computeRouteMatrix 的来源。包含 RouteMatrixItem 的列表，其中每个项都表示前往目的地的路线。

通过调用 const {RouteMatrixRow} = await google.maps.importLibrary("routes") 进行访问。
请参阅 Maps JavaScript API 中的库。

属性
`items`	类型： `Array<RouteMatrixItem>` 每个目的地的路线信息。

方法
`toJSON`	`toJSON()` 参数：无返回值： `Object` 转换为对象。

google.maps.routes.RouteMatrixItem 类

包含为传递给 RouteMatrix.computeRouteMatrix 的出发地/目的地对计算的路线信息。

通过调用 const {RouteMatrixItem} = await google.maps.importLibrary("routes") 进行访问。
请参阅 Maps JavaScript API 中的库。

属性
`condition`	类型： `RouteMatrixItemCondition optional` 指示是否找到了路线。
`distanceMeters`	类型： `number optional` 相应路线的行程距离（以米为单位）。
`durationMillis`	类型： `number optional` 导航路线所需的时间（以毫秒为单位）。如果您将 `ComputeRouteMatrixRequest.routingPreference` 设置为 `TRAFFIC_UNAWARE`，则此值与 `RouteMatrixItem.staticDurationMillis` 相同。如果您将 `ComputeRouteMatrixRequest.routingPreference` 设置为 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL`，则系统会根据路况计算此值。注意：如果时长超过 2^53 毫秒，则此值为 `Number.POSITIVE_INFINITY`。
`error`	类型： `RouteMatrixItemError optional` 计算路线时发生的错误。
`fallbackInfo`	类型： `FallbackInfo optional` 在某些情况下，如果服务器无法根据指定偏好设置计算特定起点/终点对的路线，则可能会改用其他计算模式。使用回退时，此字段包含有关回退响应的详细信息。否则，系统将取消设置此字段。
`localizedValues`	类型： `RouteMatrixItemLocalizedValues optional` `RouteMatrixItem` 的属性的文本表示形式。
`staticDurationMillis`	类型： `number optional` 在不考虑路况的情况下，沿路线行驶所需的时间。注意：如果时长超过 2^53 毫秒，则此值为 `Number.POSITIVE_INFINITY`。
`travelAdvisory`	类型： `RouteTravelAdvisory optional` 有关路线的其他信息。

google.maps.routes.ComputeRouteMatrixRequest 接口

对路线矩阵的请求。

属性
`destinations`	类型：