Route 类
google.maps.routes.Route 类
包含路线，该路线由一系列相连的路段组成，这些路段连接起点、终点和中间航点。
通过调用 const {Route} = await google.maps.importLibrary("routes") 进行访问。
请参阅 Maps JavaScript API 中的库。
静态方法 | |
|---|---|
computeRoutes |
computeRoutes(request)参数：
返回值：
Promise<{根据一组终点和中间航点返回主要路线以及可选的备选路线。 注意：此方法要求您通过设置 ComputeRoutesRequest.fields 属性在请求中指定响应字段掩码。该值是字段路径的列表。例如：
不建议使用通配符响应字段掩码 fields: ['*']，因为：
|
属性 | |
|---|---|
description |
类型：
string optional路线的说明。 |
distanceMeters |
类型：
number optional相应路线的行驶距离（以米为单位）。 |
durationMillis |
类型：
number optional导航路线所需的时间（以毫秒为单位）。如果您将 ComputeRoutesRequest.routingPreference 设置为 TRAFFIC_UNAWARE，则此值与 Route.staticDurationMillis 相同。如果您将 ComputeRoutesRequest.routingPreference 设置为 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL，则系统会根据路况计算此值。注意：如果时长超过 2^53 毫秒，则此值为 Number.POSITIVE_INFINITY。 |
legs |
构成路线的若干路段（航点之间的路径段）。每段行程都对应于两个非 via 航点之间的旅程。例如：
origin 到 intermediates 再到 destination。 |
localizedValues |
类型：
RouteLocalizedValues optionalRoute 的属性的文本表示形式。 |
optimizedIntermediateWaypointIndices |
类型：
Array<number> optional如果您将 ComputeRoutesRequest.optimizeWaypointOrder 设置为 true，此字段将包含优化后的中途经停点顺序。否则，此字段为空。索引从 0 开始，表示输入中提供的第一个中间途经点。例如，如果您输入：
[2, 0, 1]。 |
path |
类型：
Array<LatLngAltitude> optional路线的 LatLngAltitude 列表，可用于绘制路线多段线。可以通过设置 ComputeRoutesRequest.polylineQuality 来控制路径的粒度。 |
polylineDetails |
类型：
PolylineDetails optional包含有关路径沿途的详细信息。 |
routeLabels |
类型：
Array<RouteLabel> optional有助于识别路线特定属性或与其他路线进行比较的标签。 |
routeToken |
类型：
string optional一个不透明的令牌，可传递给 Navigation SDK 以在导航期间重建路线，并在重新规划路线时遵循创建路线时的原始意图。将此令牌视为不透明 blob。请勿跨请求比较其值，因为即使服务返回完全相同的路线，其值也可能会发生变化。 注意： routeToken 仅适用于将 ComputeRoutesRequest.routingPreference 设置为 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL 的请求。不支持包含 via 航点的请求。 |
speedPaths |
路线路径的各个部分及其对应的速度读数。若要填充此字段，必须将 ComputeRoutesRequest.routingPreference 设置为 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL，并且 ComputeRoutesRequest.extraComputations 必须包含 TRAFFIC_ON_POLYLINE。 |
staticDurationMillis |
类型：
number optional在不考虑路况的情况下，沿路线行驶所需的时间。 注意：如果时长超过 2^53 毫秒，则此值为 Number.POSITIVE_INFINITY。 |
travelAdvisory |
类型：
RouteTravelAdvisory optional有关路线的其他信息。 |
viewport |
类型：
LatLngBounds optional路线的视口边界框。 |
warnings |
类型：
Array<string> optional在显示路线时要显示的一系列警告。 |
方法 | |
|---|---|
createPolylines |
createPolylines([options])参数：
根据可用数据为路线创建折线。 多模态多段线：
流量多段线：
总体折线：
|