DistanceMatrixService 类
google.maps.DistanceMatrixService 类
一种服务，用于计算多个起点和终点间的距离。
通过调用 const {DistanceMatrixService} = await google.maps.importLibrary("routes") 进行访问。
请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
DistanceMatrixService |
DistanceMatrixService()参数：无
创建 DistanceMatrixService 的新实例，该实例可将距离矩阵查询发送到 Google 服务器。 |
方法 | |
|---|---|
getDistanceMatrix |
getDistanceMatrix(request[, callback])参数：
用于发出距离矩阵请求。 |
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 为 TRANSIT 的请求的设置。此对象对其他出行方式没有影响。 |
unitSystem optional |
类型：
UnitSystem optional显示距离时要使用的首选单位制。可选；默认使用公制。 |
DistanceMatrixResponse 接口
google.maps.DistanceMatrixResponse
接口
对 DistanceMatrixService 请求的响应，包含格式化的出发地和目的地地址，以及一系列 DistanceMatrixResponseRow，每个出发地地址对应一个 DistanceMatrixResponseRow。
属性 | |
|---|---|
destinationAddresses |
类型：
Array<string>经过格式化的终点地址。 |
originAddresses |
类型：
Array<string>经过格式化的起点地址。 |
rows |
矩阵的各行，对应起点地址。 |
DistanceMatrixResponseRow 接口
google.maps.DistanceMatrixResponseRow
接口
对 DistanceMatrixService 请求的响应中的一行，由一系列 DistanceMatrixResponseElement 组成，每个 DistanceMatrixResponseElement 对应一个目的地地址。
属性 | |
|---|---|
elements |
该行的各元素，对应终点地址。 |
DistanceMatrixResponseElement 接口
google.maps.DistanceMatrixResponseElement
接口
对 DistanceMatrixService 请求的响应中的单个元素，包含从一个出发地到另一个目的地的时长和距离。
属性 | |
|---|---|
distance |
类型：
Distance该起点-终点对的距离。此属性可能未定义，因为距离可能未知。 |
duration |
类型：
Duration该起点-终点对的时长。此属性可能未定义，因为持续时间可能未知。 |
duration_in_traffic |
类型：
Duration此起点-目的地配对的时长，考虑了 trafficModel 属性指示的路况信息。此属性可能为 undefined，因为时长可能未知。仅当在发出请求时定义了 drivingOptions 时，才可供 Premium 方案客户使用。 |
fare |
类型：
TransitFare相应出发地-目的地配对的总票价。仅适用于公交请求。 |
status |
该特定起点-终点对的状态。 |
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 |
在起点和终点之间找不到任何路线。 |