Google Maps Platform 即将推出全新地图样式。此次地图样式更新包括全新默认调色板，以及地图体验和易用性方面的改进。所有地图样式将于 2025 年 3 月自动更新。如需详细了解适用范围以及如何提前选择启用，请参阅全新 Google Maps Platform 地图样式。

此页面由 Cloud Translation API 翻译。

Distance Matrix

DistanceMatrixService 类

google.maps.DistanceMatrixService 类

一种服务，用于计算多个起点和终点间的距离。

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

构造函数
`DistanceMatrixService`	`DistanceMatrixService()` 参数：无创建 `DistanceMatrixService` 的新实例，可向 Google 服务器发送距离矩阵查询。

方法
`getDistanceMatrix`	`getDistanceMatrix(request[, callback])` 参数： `request`：`DistanceMatrixRequest` `callback`：`function(DistanceMatrixResponse optional, DistanceMatrixStatus): void optional` 返回值：`Promise<DistanceMatrixResponse>` 用于发出距离矩阵请求。

DistanceMatrixRequest 接口

google.maps.DistanceMatrixRequest 接口

DistanceMatrixService 发送的距离矩阵查询，其中包含出发地和目的地位置的数组以及用于计算指标的各种选项。

属性
`destinations`	类型：`Array<string\|LatLng\|LatLngLiteral\|Place>` 一个数组，其中包含用于计算距离和时间的目标地址字符串、`LatLng` 或 `Place` 对象。必填。
`origins`	类型：`Array<string\|LatLng\|LatLngLiteral\|Place>` 一个数组，其中包含用于计算距离和时间的起点地址字符串、`LatLng` 或 `Place` 对象。必填。
`travelMode`	类型：`TravelMode` 请求的路线类型。必填。
`avoidFerries optional`	类型：`boolean optional` 如果为 `true`，则指示距离矩阵服务尽可能避开轮渡。可选。
`avoidHighways optional`	类型：`boolean optional` 如果为 `true`，则指示距离矩阵服务尽可能避开高速公路。可选。
`avoidTolls optional`	类型：`boolean optional` 如果为 `true`，则指示距离矩阵服务尽可能避开收费路段。可选。
`drivingOptions optional`	类型：`DrivingOptions optional` 这些设置仅适用于 `travelMode` 为“`DRIVING`”的请求。此对象对其他出行方式没有任何影响。
`language optional`	类型：`string optional` 返回结果时所用的语言的语言标识符（如可用）。请参阅支持的语言列表。
`region optional`	类型：`string optional` 用作地址解析请求偏向的区域代码。地区代码接受 ccTLD（“顶级域名”）双字符值。多数 ccTLD 代码都与 ISO 3166-1 代码相同，但也有一些需要注意的例外情况。例如，英国的 ccTLD 为“uk”(`.co.uk`)，而其 ISO 3166-1 代码为“gb”（专指“大不列颠及北爱尔兰联合王国”）。
`transitOptions optional`	类型：`TransitOptions optional` 这些设置仅适用于 `travelMode` 为广告附加信息的请求。此对象对其他出行方式没有任何影响。
`unitSystem optional`	类型：`UnitSystem optional` 显示距离时要使用的首选单位制。可选；默认使用公制。

DistanceMatrixResponse 接口

google.maps.DistanceMatrixResponse 接口

对 DistanceMatrixService 请求的响应，包含经过格式化的出发地和目的地地址以及一系列 DistanceMatrixResponseRow（每个出发地地址对应一个）。

属性
`destinationAddresses`	类型：`Array<string>` 经过格式化的终点地址。
`originAddresses`	类型：`Array<string>` 经过格式化的起点地址。
`rows`	类型：`Array<DistanceMatrixResponseRow>` 矩阵的各行，对应起点地址。

DistanceMatrixResponseRow 接口

google.maps.DistanceMatrixResponseRow 接口

对 DistanceMatrixService 请求的响应中的一行，由 DistanceMatrixResponseElement 序列组成，每个目的地地址对应一个。

属性
`elements`	类型：`Array<DistanceMatrixResponseElement>` 该行的各元素，对应终点地址。

DistanceMatrixResponseElement 接口

google.maps.DistanceMatrixResponseElement 接口

对 DistanceMatrixService 请求的响应中的单个元素，其中包含从一个出发地到一个目的地的时长和距离。

属性
`distance`	类型：`Distance` 该起点-终点对的距离。此属性可能未定义，因为距离可能未知。
`duration`	类型：`Duration` 该起点-终点对的时长。此属性可能未定义，因为持续时间可能未知。
`duration_in_traffic`	类型：`Duration` 该出发地-目的地配对的时长，考虑了 `trafficModel` 属性指示的路况信息。此属性可能为 `undefined`，因为时长可能未知。仅适用于在发出请求时定义了 `drivingOptions` 的专业版方案客户。
`fare`	类型：`TransitFare` 该起点-终点对的总票价。仅适用于公交请求。
`status`	类型：`DistanceMatrixElementStatus` 该特定起点-终点对的状态。

DistanceMatrixStatus 常量

google.maps.DistanceMatrixStatus 常量

完成距离矩阵请求后，DistanceMatrixService 通常会返回的该请求的顶级状态。通过值或使用常量名称来指定这些变量。例如 'OK' 或 google.maps.DistanceMatrixStatus.OK。

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

常量
`INVALID_REQUEST`	提供的请求无效。
`MAX_DIMENSIONS_EXCEEDED`	该请求包含的起点或终点的数量超过了 25 个。
`MAX_ELEMENTS_EXCEEDED`	这些起点和终点所产生的结果数量超出了每条查询的限制。
`OK`	响应中包含有效结果。
`OVER_QUERY_LIMIT`	在允许的时间段内请求的元素数量过多。如果您稍后重试，请求应该会成功。
`REQUEST_DENIED`	该服务拒绝您的网页使用距离矩阵服务。
`UNKNOWN_ERROR`	由于服务器错误，系统无法处理距离矩阵请求。如果您重试一次，请求可能会成功

DistanceMatrixElementStatus 常量

google.maps.DistanceMatrixElementStatus 常量

完成距离矩阵请求后，由 DistanceMatrixService 返回的关于特定出发地-目的地对的元素级状态。这些值以字符串形式指定，例如 'OK'。

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

常量
`NOT_FOUND`	无法对该配对的起点和/或终点进行地址解析。
`OK`	响应中包含有效结果。
`ZERO_RESULTS`	在原点和目标之间找不到任何路线。