此页面由 Cloud Translation API 翻译。

Package google.maps.routing.v2

索引

Routes（接口）
ComputeRouteMatrixRequest（消息）
ComputeRouteMatrixRequest.ExtraComputation（枚举）
ComputeRoutesRequest（消息）
ComputeRoutesRequest.ExtraComputation（枚举）
ComputeRoutesRequest.ReferenceRoute（枚举）
ComputeRoutesResponse（消息）
FallbackInfo（消息）
FallbackReason（枚举）
FallbackRoutingMode（枚举）
GeocodedWaypoint（消息）
GeocodingResults（消息）
LocalizedTime（消息）
Location（消息）
Maneuver（枚举）
NavigationInstruction（消息）
Polyline（消息）
PolylineDetails（消息）
PolylineDetails.FlyoverInfo（消息）
PolylineDetails.NarrowRoadInfo（消息）
PolylineDetails.PolylinePointIndex（消息）
PolylineDetails.RoadFeatureState（枚举）
PolylineEncoding（枚举）
PolylineQuality（枚举）
Route（消息）
Route.RouteLocalizedValues（消息）
RouteLabel（枚举）
RouteLeg（消息）
RouteLeg.RouteLegLocalizedValues（消息）
RouteLeg.StepsOverview（消息）
RouteLeg.StepsOverview.MultiModalSegment（消息）
RouteLegStep（消息）
RouteLegStep.RouteLegStepLocalizedValues（消息）
RouteLegStepTransitDetails（消息）
RouteLegStepTransitDetails.TransitDetailsLocalizedValues（消息）
RouteLegStepTransitDetails.TransitStopDetails（消息）
RouteLegStepTravelAdvisory（消息）
RouteLegTravelAdvisory（消息）
RouteMatrixDestination（消息）
RouteMatrixElement（消息）
RouteMatrixElement.LocalizedValues（消息）
RouteMatrixElementCondition（枚举）
RouteMatrixOrigin（消息）
RouteModifiers（消息）
RouteTravelAdvisory（消息）
RouteTravelMode（枚举）
RoutingPreference（枚举）
SpeedReadingInterval（消息）
SpeedReadingInterval.Speed（枚举）
TollInfo（消息）
TollPass（枚举）
TrafficModel（枚举）
TransitAgency（消息）
TransitLine（消息）
TransitPreferences（消息）
TransitPreferences.TransitRoutingPreference（枚举）
TransitPreferences.TransitTravelMode（枚举）
TransitStop（消息）
TransitVehicle（消息）
TransitVehicle.TransitVehicleType（枚举）
Units（枚举）
VehicleEmissionType（枚举）
VehicleInfo（消息）
Waypoint（消息）

路线

Routes API。

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)` 接受起点和目的地列表，并返回一个数据流，其中包含每个起点和目的地组合的路线信息。注意：此方法要求您在输入中指定响应字段掩码。您可以使用网址参数 `$fields` 或 `fields`，或使用 HTTP/gRPC 标头 `X-Goog-FieldMask` 提供响应字段掩码（请参阅可用的网址参数和标头）。该值是以英文逗号分隔的字段路径列表。请参阅有关如何构建字段路径的详细文档。例如，在此方法中：所有可用字段的字段掩码（适用于人工检查）：`X-Goog-FieldMask: ` 路线时长、距离、元素状态、条件和元素索引的字段掩码（一个生产设置示例）：`X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` 请务必在字段掩码中添加 `status`，否则所有消息都将显示为正常。Google 不建议使用通配符 (``) 响应字段掩码，因为：仅选择您需要的字段有助于我们的服务器节省计算周期，从而让我们能够以更短的延迟时间向您返回结果。仅在生产作业中选择所需的字段可确保稳定的延迟时间性能。我们未来可能会添加更多响应字段，这些新字段可能需要额外的计算时间。如果您选择所有字段，或者选择顶级的所有字段，则可能会出现性能下降，因为我们添加的任何新字段都会自动包含在响应中。仅选择所需字段会缩减响应大小，从而提高网络吞吐量。

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

接受起点和目的地列表，并返回一个数据流，其中包含每个起点和目的地组合的路线信息。

注意：此方法要求您在输入中指定响应字段掩码。您可以使用网址参数 $fields 或 fields，或使用 HTTP/gRPC 标头 X-Goog-FieldMask 提供响应字段掩码（请参阅可用的网址参数和标头）。该值是以英文逗号分隔的字段路径列表。请参阅有关如何构建字段路径的详细文档。

例如，在此方法中：

所有可用字段的字段掩码（适用于人工检查）：X-Goog-FieldMask: *
路线时长、距离、元素状态、条件和元素索引的字段掩码（一个生产设置示例）：X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

请务必在字段掩码中添加 status，否则所有消息都将显示为正常。Google 不建议使用通配符 (*) 响应字段掩码，因为：

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

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` 给定一组终点和中间航点，返回主要路线以及可选的备用路线。注意：此方法要求您在输入中指定响应字段掩码。您可以使用网址参数 `$fields` 或 `fields`，或使用 HTTP/gRPC 标头 `X-Goog-FieldMask` 提供响应字段掩码（请参阅可用的网址参数和标头）。该值是以英文逗号分隔的字段路径列表。请参阅有关如何构建字段路径的详细文档。例如，在此方法中：所有可用字段的字段掩码（适用于人工检查）：`X-Goog-FieldMask: ` 路线级时长、距离和多段线的字段掩码（生产环境设置示例）：`X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` Google 不建议使用通配符 (``) 响应字段掩码，也不建议在顶级 (`routes`) 指定字段掩码，因为：仅选择您需要的字段有助于我们的服务器节省计算周期，从而让我们能够以更短的延迟时间向您返回结果。仅在生产作业中选择所需的字段可确保稳定的延迟时间性能。我们未来可能会添加更多响应字段，这些新字段可能需要额外的计算时间。如果您选择所有字段，或者选择顶级的所有字段，则可能会出现性能下降，因为我们添加的任何新字段都会自动包含在响应中。仅选择所需字段会使响应大小变小，从而提高网络吞吐量。

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

给定一组终点和中间航点，返回主要路线以及可选的备用路线。

例如，在此方法中：

所有可用字段的字段掩码（适用于人工检查）：X-Goog-FieldMask: *
路线级时长、距离和多段线的字段掩码（生产环境设置示例）：X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google 不建议使用通配符 (*) 响应字段掩码，也不建议在顶级 (routes) 指定字段掩码，因为：

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

ComputeRouteMatrixRequest

ComputeRouteMatrix 请求消息

字段
`origins[]`	`RouteMatrixOrigin` 必需。来源数组，用于确定响应矩阵的行。起点和目的地的基数受到以下几项大小限制：指定为 `place_id` 或 `address` 的起点数量 + 终点数量的总和不得超过 50。无论如何，起点数量 × 目的地数量的乘积不得超过 625。如果 routing_preference 设为 `TRAFFIC_AWARE_OPTIMAL`，则起点数量 × 目的地数量的乘积不得超过 100。如果 travel_mode 设置为 `TRANSIT`，则出发地数量 × 目的地数量的乘积不得超过 100。
`destinations[]`	`RouteMatrixDestination` 必需。目的地数组，用于确定响应矩阵的列。
`travel_mode`	`RouteTravelMode` 可选。指定交通方式。
`routing_preference`	`RoutingPreference` 可选。指定如何计算路线。服务器会尝试使用所选的路由偏好设置来计算路由。如果路由偏好设置导致错误或延迟时间过长，则会返回错误。只有当 `travel_mode` 为 `DRIVE` 或 `TWO_WHEELER` 时，您才能指定此选项，否则请求会失败。
`departure_time`	`Timestamp` 可选。出发时间。如果您未设置此值，则此值默认为您发出请求的时间。注意：只有在将 `RouteTravelMode` 设置为 `TRANSIT` 时，您才能指定过去的 `departure_time`。
`arrival_time`	`Timestamp` 可选。到达时间。注意：仅当 `RouteTravelMode` 设置为 `TRANSIT` 时才能设置此项。您可以指定 `departure_time` 或 `arrival_time`，但不能同时指定这两者。
`language_code`	`string` 可选。BCP-47 语言代码，例如“en-US”或“sr-Latn”。如需了解详情，请参阅 Unicode 语言区域标识符。如需查看支持的语言列表，请参阅语言支持。如果您未提供此值，系统会根据第一个来源的位置推断显示语言。
`region_code`	`string` 可选。地区代码，指定为一个 ccTLD（“顶级域名”）双字符值。如需了解详情，请参阅国家/地区代码顶级域名。
`units`	`Units` 可选。指定显示字段的衡量单位。
`extra_computations[]`	`ExtraComputation` 可选。可能用于完成请求的额外计算列表。注意：这些额外的计算可能会在响应中返回额外的字段。这些额外的字段还必须在要返回的字段掩码中指定。
`traffic_model`	`TrafficModel` 可选。指定计算交通时间时所用的假设条件。此设置会影响 `RouteMatrixElement` 中 duration 字段中返回的值，该值包含根据历史平均数据预测的交通时间。`RoutingPreference` 至 `TRAFFIC_AWARE_OPTIMAL` 和 `RouteTravelMode` 至 `DRIVE`。如果请求了流量但未指定 `TrafficModel`，则默认为 `BEST_GUESS`。
`transit_preferences`	`TransitPreferences` 可选。指定影响为 `TRANSIT` 路线返回的路线的偏好设置。注意：只有在将 `RouteTravelMode` 设置为 `TRANSIT` 时才能指定 `transit_preferences`。

ExtraComputation

在完成请求时要执行的额外计算。

枚举
`EXTRA_COMPUTATION_UNSPECIFIED`	未使用。包含此值的请求将失败。
`TOLLS`	矩阵元素的过路费信息。

ComputeRoutesRequest

ComputeRoutes 请求消息。

字段
`origin`	`Waypoint` 必需。起点航点。
`destination`	`Waypoint` 必需。目的地航点。
`intermediates[]`	`Waypoint` 可选。路线上（不包括终点）的一组航点，用于停靠或经过。最多支持 25 个中间航点。
`travel_mode`	`RouteTravelMode` 可选。指定交通方式。
`routing_preference`	`RoutingPreference` 可选。指定如何计算路线。服务器会尝试使用所选的路由偏好设置来计算路由。如果路由偏好设置导致错误或延迟时间过长，则会返回错误。只有当 `travel_mode` 为 `DRIVE` 或 `TWO_WHEELER` 时，您才能指定此选项，否则请求会失败。
`polyline_quality`	`PolylineQuality` 可选。指定多段线的质量偏好设置。
`polyline_encoding`	`PolylineEncoding` 可选。指定多段线的首选编码。
`departure_time`	`Timestamp` 可选。出发时间。如果您未设置此值，则此值默认为您发出请求的时间。注意：只有在将 `RouteTravelMode` 设置为 `TRANSIT` 时，您才能指定过去的 `departure_time`。公交行程最长可查询过去 7 天或未来 100 天内的数据。
`arrival_time`	`Timestamp` 可选。到达时间。注意：仅当 `RouteTravelMode` 设置为 `TRANSIT` 时才能设置此项。您可以指定 `departure_time` 或 `arrival_time`，但不能同时指定这两者。公交行程最长可查询过去 7 天或未来 100 天内的数据。
`compute_alternative_routes`	`bool` 可选。指定是否应计算路线之外的备选路线。对于包含中间航点的请求，系统不会返回备选路线。
`route_modifiers`	`RouteModifiers` 可选。一组需要满足的条件，这些条件会影响路线的计算方式。
`language_code`	`string` 可选。BCP-47 语言代码，例如“en-US”或“sr-Latn”。如需了解详情，请参阅 Unicode 语言区域标识符。如需查看支持的语言列表，请参阅语言支持。如果您未提供此值，系统会根据路线请求的位置推断显示语言。
`region_code`	`string` 可选。地区代码，指定为一个 ccTLD（“顶级域名”）双字符值。如需了解详情，请参阅国家/地区代码顶级域名。
`units`	`Units` 可选。指定显示字段的衡量单位。这些字段包括 `NavigationInstruction` 中的 `instruction` 字段。路线、路段、步数距离和时长所用的衡量单位不受此值的影响。如果您未提供此值，系统会根据第一个起源的位置推断显示单位。
`optimize_waypoint_order`	`bool` 可选。如果设置为 true，该服务会尝试通过重新排列指定的中间航点来最大限度地降低路线的总费用。如果任何中间航点是 `via` 航点，请求将失败。使用 `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` 查找新的排序。如果未在 `X-Goog-FieldMask` 标头中请求 `ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index`，则请求会失败。如果将 `optimize_waypoint_order` 设为 false，`ComputeRoutesResponse.optimized_intermediate_waypoint_index` 将为空。
`requested_reference_routes[]`	`ReferenceRoute` 可选。除了默认路线之外，指定请求中要计算的参考路线。参考路线是指与默认路线具有不同路线计算目标的路线。例如，`FUEL_EFFICIENT` 参考路线计算会考虑各种参数，以生成最省油的路线。使用此功能时，请在生成的路线中查找 `route_labels`。
`extra_computations[]`	`ExtraComputation` 可选。可能用于完成请求的额外计算列表。注意：这些额外的计算可能会在响应中返回额外的字段。这些额外的字段还必须在要返回的字段掩码中指定。
`traffic_model`	`TrafficModel` 可选。指定计算交通时间时所用的假设条件。此设置会影响 `Route` 和 `RouteLeg` 中 duration 字段中返回的值，该值包含根据历史平均数据预测的交通时间。`TrafficModel` 仅适用于将 `RoutingPreference` 设置为 `TRAFFIC_AWARE_OPTIMAL` 且将 `RouteTravelMode` 设置为 `DRIVE` 的请求。如果请求了流量但未指定 `TrafficModel`，则默认为 `BEST_GUESS`。
`transit_preferences`	`TransitPreferences` 可选。指定影响为 `TRANSIT` 路线返回的路线的偏好设置。注意：只有在将 `RouteTravelMode` 设置为 `TRANSIT` 时才能指定 `transit_preferences`。

ExtraComputation

在完成请求时要执行的额外计算。

枚举
`EXTRA_COMPUTATION_UNSPECIFIED`	未使用。包含此值的请求将失败。
`TOLLS`	相应路线的过路费信息。
`FUEL_CONSUMPTION`	相应路线的预估油耗。
`TRAFFIC_ON_POLYLINE`	路线的可感知路况多段线。
`HTML_FORMATTED_NAVIGATION_INSTRUCTIONS`	`NavigationInstructions` 以格式化 HTML 文本字符串的形式呈现。此内容应按原样读取。此内容仅供展示。请勿以程序化方式解析它。
`FLYOVER_INFO_ON_POLYLINE`	相应路线的航拍信息。必须指定 `routes.polyline_details.flyover_info` 字段掩码才能返回此信息。目前，系统只会为印度的部分大都市填充此类数据。此功能目前处于实验阶段，SKU/费用可能会发生变化。
`NARROW_ROAD_INFO_ON_POLYLINE`	相应路线的狭窄道路信息。必须指定 `routes.polyline_details.narrow_road_info` 字段掩码才能返回此信息。目前，系统只会为印度的部分大都市填充此类数据。此功能目前处于实验阶段，SKU/费用可能会发生变化。

ReferenceRoute

ComputeRoutesRequest 中受支持的参考路线。

枚举

REFERENCE_ROUTE_UNSPECIFIED 未使用。包含此值的请求会失败。

FUEL_EFFICIENT 省油路线。

枚举
`REFERENCE_ROUTE_UNSPECIFIED`	未使用。包含此值的请求会失败。
`FUEL_EFFICIENT`	省油路线。
`SHORTER_DISTANCE`	行程距离较短的路线。这是一项实验性功能。对于 `DRIVE` 请求，此功能会优先考虑距离，而不是驾驶舒适度。例如，它可能会优先选择本地道路而非高速公路、走土路、穿过停车场等。此功能不会返回 Google 地图知道是违法行为的任何机动作业。对于 `BICYCLE` 和 `TWO_WHEELER` 请求，此功能返回的路线与您未指定 `requested_reference_routes` 时返回的路线类似。此功能不适用于任何其他通过中间航点或 `optimize_waypoint_order` 的出行方式；此类请求将会失败。不过，您可以将其与任何 `routing_preference` 搭配使用。

SHORTER_DISTANCE

行程距离较短的路线。这是一项实验性功能。

对于 DRIVE 请求，此功能会优先考虑距离，而不是驾驶舒适度。例如，它可能会优先选择本地道路而非高速公路、走土路、穿过停车场等。此功能不会返回 Google 地图知道是违法行为的任何机动作业。

对于 BICYCLE 和 TWO_WHEELER 请求，此功能返回的路线与您未指定 requested_reference_routes 时返回的路线类似。

此功能不适用于任何其他通过中间航点或 optimize_waypoint_order 的出行方式；此类请求将会失败。不过，您可以将其与任何 routing_preference 搭配使用。

ComputeRoutesResponse

计算响应消息的路线。

字段

字段
`routes[]`	`Route` 如果您指定了 `compute_alternatives_routes`，则包含一个计算路线数组（最多三个），如果未指定，则仅包含一条路线。如果此数组包含多个条目，则第一个条目是最推荐的路线。如果数组为空，则表示找不到路线。
`fallback_info`	`FallbackInfo` 在某些情况下，如果服务器无法使用所有输入偏好设置计算路线结果，则可能会回退到使用其他计算方式。使用回退模式时，此字段包含有关回退响应的详细信息。否则，此字段将未设置。
`geocoding_results`	`GeocodingResults` 包含指定为地址的路径点的地理编码响应信息。

routes[]

Route

如果您指定了 compute_alternatives_routes，则包含一个计算路线数组（最多三个），如果未指定，则仅包含一条路线。如果此数组包含多个条目，则第一个条目是最推荐的路线。如果数组为空，则表示找不到路线。

fallback_info

FallbackInfo

在某些情况下，如果服务器无法使用所有输入偏好设置计算路线结果，则可能会回退到使用其他计算方式。使用回退模式时，此字段包含有关回退响应的详细信息。否则，此字段将未设置。

geocoding_results

GeocodingResults

包含指定为地址的路径点的地理编码响应信息。

FallbackInfo

与使用回退结果的方式和原因相关的信息。如果此字段已设置，则表示服务器使用了与首选模式不同的路由模式作为回退。

字段

字段
`routing_mode`	`FallbackRoutingMode` 用于响应的路由模式。如果触发了回退，模式可能与原始客户端请求中设置的路由偏好设置不同。
`reason`	`FallbackReason` 使用回退响应而非原始响应的原因。仅当触发回退模式并返回回退响应时，才会填充此字段。

routing_mode

FallbackRoutingMode

用于响应的路由模式。如果触发了回退，模式可能与原始客户端请求中设置的路由偏好设置不同。

reason

FallbackReason

使用回退响应而非原始响应的原因。仅当触发回退模式并返回回退响应时，才会填充此字段。

FallbackReason

使用回退响应的原因。

枚举
`FALLBACK_REASON_UNSPECIFIED`	未指定回退原因。
`SERVER_ERROR`	使用您的首选路线模式计算路线时发生了服务器错误，但我们能够返回通过备用模式计算的结果。
`LATENCY_EXCEEDED`	我们无法按时使用您的首选路线模式完成计算，但可以返回使用备选模式计算的结果。

FallbackRoutingMode

用于返回的后备响应的实际路由模式。

枚举
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	未使用。
`FALLBACK_TRAFFIC_UNAWARE`	表示使用了 `TRAFFIC_UNAWARE` `RoutingPreference` 来计算响应。
`FALLBACK_TRAFFIC_AWARE`	表示使用了 `TRAFFIC_AWARE` `RoutingPreference` 来计算响应。

GeocodedWaypoint

有关用作航点的位置的详细信息。仅针对地址航点进行填充。包含地理编码结果的详细信息，以便确定地址的地理编码结果。

字段
`geocoder_status`	`Status` 表示地理编码操作生成的状态代码。
`type[]`	`string` 结果的类型，形式为零个或多个类型标记。支持的类型：地址类型和地址组成部分类型。
`partial_match`	`bool` 表示地理编码器无法返回与原始请求完全匹配的结果，尽管它能够匹配所请求地址的一部分内容。您不妨检查一下原始请求中是否有拼写错误和/或地址不完整的情况。
`place_id`	`string` 此结果的地点 ID。
`intermediate_waypoint_request_index`	`int32` 请求中相应中间航点的索引。仅当相应的航点是中间航点时才填充。

GeocodingResults

包含适用于起点、终点和中间航点的 GeocodedWaypoints。仅针对地址路点进行填充。

字段

字段
`origin`	`GeocodedWaypoint` 经过地理编码的起点航点。
`destination`	`GeocodedWaypoint` 经过地理编码的目的地航点。
`intermediates[]`	`GeocodedWaypoint` 一系列经过地理编码的中间路径点，每个路径点都包含一个索引字段，该字段与路径点在请求中指定的顺序中的以零为起点的位置相对应。

origin

GeocodedWaypoint

经过地理编码的起点航点。

destination

GeocodedWaypoint

经过地理编码的目的地航点。

intermediates[]

GeocodedWaypoint

一系列经过地理编码的中间路径点，每个路径点都包含一个索引字段，该字段与路径点在请求中指定的顺序中的以零为起点的位置相对应。

LocalizedTime

时间的本地化说明。

字段

字段
`time`	`LocalizedText` 以字符串形式指定的给定时区中的时间。
`time_zone`	`string` 包含时区。该属性的值是时区的名称（如 IANA 时区数据库中所定义），例如“America/New_York”。

time

LocalizedText

以字符串形式指定的给定时区中的时间。

time_zone

string

包含时区。该属性的值是时区的名称（如 IANA 时区数据库中所定义），例如“America/New_York”。

位置

封装位置（地理点和可选的标题）。

字段

字段
`lat_lng`	`LatLng` 航点的地理坐标。
`heading`	`Int32Value` 与交通流方向相关联的罗盘方向。此值用于指定上车点和下车点所在的道路边。航向值介于 0 到 360 之间，其中 0 表示正北，90 表示正东，以此类推。您只能将此字段用于 `DRIVE` 和 `TWO_WHEELER` `RouteTravelMode`。

lat_lng

LatLng

航点的地理坐标。

heading

Int32Value

与交通流方向相关联的罗盘方向。此值用于指定上车点和下车点所在的道路边。航向值介于 0 到 360 之间，其中 0 表示正北，90 表示正东，以此类推。您只能将此字段用于 DRIVE 和 TWO_WHEELER RouteTravelMode。

Maneuver

一组值，用于指定要对当前步骤执行的导航操作（例如，向左转弯、合并或直行）。

枚举
`MANEUVER_UNSPECIFIED`	未使用。
`TURN_SLIGHT_LEFT`	稍微向左转。
`TURN_SHARP_LEFT`	向左急转。
`UTURN_LEFT`	左转 U 形调头。
`TURN_LEFT`	向左转。
`TURN_SLIGHT_RIGHT`	稍微向右转。
`TURN_SHARP_RIGHT`	向右急转。
`UTURN_RIGHT`	右转 U 形调头。
`TURN_RIGHT`	向右转。
`STRAIGHT`	一直往前走。
`RAMP_LEFT`	进入左侧匝道。
`RAMP_RIGHT`	进入右侧匝道。
`MERGE`	合并到车流中。
`FORK_LEFT`	向左转。
`FORK_RIGHT`	向右转弯。
`FERRY`	乘坐渡轮。
`FERRY_TRAIN`	乘坐火车前往轮渡码头。
`ROUNDABOUT_LEFT`	在圆形交叉路口左转。
`ROUNDABOUT_RIGHT`	在圆形交叉路口右转。
`DEPART`	初始机动。
`NAME_CHANGE`	用于指示街道名称变更。

NavigationInstruction

封装 RouteLegStep 的导航说明。

字段

maneuver

Maneuver

封装当前步骤的导航说明（例如，向左转弯、合并或直行）。此字段决定了要显示哪个图标。

instructions

string

此步骤的操作说明。

折线

封装编码多段线。

字段

字段
联合字段 `polyline_type`。封装折线的类型。默认为 encoded_polyline。`polyline_type` 只能是下列其中一项：
`encoded_polyline`	`string` 使用多段线编码算法对多段线进行的字符串编码
`geo_json_linestring`	`Struct` 使用 GeoJSON LineString 格式指定多段线。

联合字段 polyline_type。封装折线的类型。默认为 encoded_polyline。polyline_type 只能是下列其中一项：

encoded_polyline

string

使用多段线编码算法对多段线进行的字符串编码

geo_json_linestring

Struct

使用 GeoJSON LineString 格式指定多段线。

PolylineDetails

与多段线的给定索引或相邻线段对应的详细信息。给定包含点 P_0、P_1、...、P_N（以零为起点的编号）的多段线，PolylineDetails 会定义一个间隔和关联的元数据。

字段

字段
`flyover_info[]`	`FlyoverInfo` 沿多段线的路线详情。
`narrow_road_info[]`	`NarrowRoadInfo` 多段线沿途的狭窄道路详情。

flyover_info[]

FlyoverInfo

沿多段线的路线详情。

narrow_road_info[]

NarrowRoadInfo

多段线沿途的狭窄道路详情。

FlyoverInfo

封装与沿多段线飞越相关的信息。

字段

字段
`flyover_presence`	`RoadFeatureState` 仅限输出。表示多段线的给定路段是否存在平视图。
`polyline_point_index`	`PolylinePointIndex` 沿多段线显示的俯视图相关信息的位置。

flyover_presence

RoadFeatureState

仅限输出。表示多段线的给定路段是否存在平视图。

polyline_point_index

PolylinePointIndex

沿多段线显示的俯视图相关信息的位置。

NarrowRoadInfo

封装多段线沿线的狭窄道路的相关信息。

字段

字段
`narrow_road_presence`	`RoadFeatureState` 仅限输出。表示多段线的给定路段是否存在狭窄道路。
`polyline_point_index`	`PolylinePointIndex` 多段线上与狭窄道路相关的信息的位置。

narrow_road_presence

RoadFeatureState

仅限输出。表示多段线的给定路段是否存在狭窄道路。

polyline_point_index

PolylinePointIndex

多段线上与狭窄道路相关的信息的位置。

PolylinePointIndex

封装多段线详细信息的起始索引和结束索引。如果数据对应于单个点，则 start_index 和 end_index 将相等。

字段

字段
`start_index`	`int32` 此详细信息在多段线中的起始索引。
`end_index`	`int32` 此细节在多段线中的结束索引。

start_index

int32

此详细信息在多段线中的起始索引。

end_index

int32

此细节在多段线中的结束索引。

RoadFeatureState

封装一段多段线沿途道路地图项的状态。

枚举
`ROAD_FEATURE_STATE_UNSPECIFIED`	未计算道路地图项的状态（默认值）。
`EXISTS`	相应道路地图项存在。
`DOES_NOT_EXIST`	相应道路地图项不存在。

PolylineEncoding

指定要返回的多段线的首选类型。

枚举
`POLYLINE_ENCODING_UNSPECIFIED`	未指定多段线类型偏好设置。默认为 `ENCODED_POLYLINE`。
`ENCODED_POLYLINE`	指定使用多段线编码算法编码的多段线。
`GEO_JSON_LINESTRING`	使用 GeoJSON LineString 格式指定多段线

PolylineQuality

一组值，用于指定多段线的质量。

枚举
`POLYLINE_QUALITY_UNSPECIFIED`	未指定多段线质量偏好设置。默认为 `OVERVIEW`。
`HIGH_QUALITY`	指定高质量多段线，其组成所用的点数比 `OVERVIEW` 多，但响应大小会增加。如需更高的精度，请使用此值。
`OVERVIEW`	指定概览多段线，该多段线由少量点组成。在显示路线概览时，请使用此值。与使用 `HIGH_QUALITY` 选项相比，使用此选项的请求延迟时间更短。

路线

包含一条路线，该路线由一系列相连的道路路段组成，这些路段连接起始航点、终点和中间航点。

字段
`route_labels[]`	`RouteLabel` `Route` 的标签，可用于标识路线的特定属性，以便与其他路线进行比较。
`legs[]`	`RouteLeg` 构成路线的一系列路段（航点之间的路径段）。每个航段都对应于两个非 `via` `Waypoints` 之间的行程。例如，没有中间航点的路线只有一个航段。包含一个非 `via` 中间航点的路线有两段。包含一个 `via` 中间航点的路线有一个航段。相应路段的顺序与航点的顺序（从 `origin` 到 `intermediates` 到 `destination`）一致。
`distance_meters`	`int32` 路线的行程距离（以米为单位）。
`duration`	`Duration` 导航路线所需的时间。如果您将 `routing_preference` 设为 `TRAFFIC_UNAWARE`，则此值与 `static_duration` 相同。如果您将 `routing_preference` 设置为 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL`，则系统会在计算此值时考虑交通状况。
`static_duration`	`Duration` 不考虑交通状况的情况下，沿着相应路线行驶所需的时间。
`polyline`	`Polyline` 整个路线多段线。此多段线是所有 `legs` 的组合多段线。
`description`	`string` 路线说明。
`warnings[]`	`string` 显示路线时显示的一组警告。
`viewport`	`Viewport` 折线的视口边界框。
`travel_advisory`	`RouteTravelAdvisory` 有关相应路线的其他信息。
`optimized_intermediate_waypoint_index[]`	`int32` 如果您将 `optimize_waypoint_order` 设置为 true，此字段将包含经过优化的中间路径点排序。否则，此字段为空。例如，如果您输入的起点为洛杉矶；中继航点为达拉斯、班戈、菲尼克斯；目的地为纽约；经过优化的中继航点顺序为菲尼克斯、达拉斯、班戈，则此字段包含值 [2, 0, 1]。对于输入中提供的第一个中间航点，索引从 0 开始。
`localized_values`	`RouteLocalizedValues` `Route` 属性的文本表示法。
`route_token`	`string` 一个不透明令牌，可传递给 Navigation SDK 以在导航期间重构路线，并在重新路线时遵循创建路线时的原始意图。将此令牌视为不透明 blob。请勿比较不同请求的此值，因为即使服务返回完全相同的路线，此值也可能会发生变化。注意：`Route.route_token` 仅适用于将 `ComputeRoutesRequest.routing_preference` 设置为 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL` 的请求。`Route.route_token` 不支持包含经停航点的请求。
`polyline_details`	`PolylineDetails` 包含有关多段线沿线详细信息的信息。

RouteLocalizedValues

特定属性的文字表示法。

字段
`distance`	`LocalizedText` 以文本形式表示的旅行距离。
`duration`	`LocalizedText` 时长，以文本形式表示，并本地化为查询所在区域的语言。考虑路况信息。注意：如果您未请求交通信息，则此值与 `static_duration` 相同。
`static_duration`	`LocalizedText` 不考虑交通状况的行程时长，以文本形式表示。
`transit_fare`	`LocalizedText` 以文本形式表示的公共交通费用。

RouteLabel

Route 的标签，可用于标识路线的特定属性，以便与其他路线进行比较。

枚举
`ROUTE_LABEL_UNSPECIFIED`	默认 - 不使用。
`DEFAULT_ROUTE`	路线计算返回的默认“最佳”路线。
`DEFAULT_ROUTE_ALTERNATE`	默认“最佳”路线的替代方案。指定 `compute_alternative_routes` 后，系统将返回这样的路线。
`FUEL_EFFICIENT`	省油路线。系统会确定标有此值的路线是针对燃油消耗等生态参数进行优化的。
`SHORTER_DISTANCE`	行程距离较短的路线。这是一项实验性功能。

RouteLeg

包含非 via 航点之间的路段。

字段
`distance_meters`	`int32` 路线航段的行程距离（以米为单位）。
`duration`	`Duration` 导航相应航段所需的时间。如果 `route_preference` 设置为 `TRAFFIC_UNAWARE`，则此值与 `static_duration` 相同。如果 `route_preference` 为 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL`，则系统会在计算此值时考虑交通状况。
`static_duration`	`Duration` 相应路段的旅行时长，计算时不考虑路况。
`polyline`	`Polyline` 此路段的整体多段线，其中包含每个 `step` 的多段线。
`start_location`	`Location` 此行程的起始位置。此位置可能与提供的 `origin` 不同。例如，如果提供的 `origin` 不在道路附近，则此值为道路上的某个点。
`end_location`	`Location` 此行程的终点。此位置可能与提供的 `destination` 不同。例如，如果提供的 `destination` 不在道路附近，则此值为道路上的某个点。
`steps[]`	`RouteLegStep` 表示此路段中各个路段的步骤数组。每一步都代表一条导航指令。
`travel_advisory`	`RouteLegTravelAdvisory` 包含应告知用户的其他信息，例如路线行程中可能存在的交通区域限制。
`localized_values`	`RouteLegLocalizedValues` `RouteLeg` 属性的文本表示法。
`steps_overview`	`StepsOverview` 此 `RouteLeg` 中步骤的概览信息。此字段仅针对公交路线进行填充。

RouteLegLocalizedValues

特定属性的文字表示法。

字段

distance

LocalizedText

以文本形式表示的旅行距离。

duration

LocalizedText

时长，以文本形式表示，并本地化为查询所在区域的语言。考虑路况信息。注意：如果您未请求交通信息，此值与 static_duration 相同。

static_duration

LocalizedText

不考虑交通状况的行程时长，以文本形式表示。

StepsOverview

提供有关 RouteLegStep 列表的概览信息。

字段

字段
`multi_modal_segments[]`	`MultiModalSegment` 关于 `RouteLeg.steps` 不同多模态片段的汇总信息。如果 `RouteLeg` 中的步骤不包含任何多模态细分，则不会填充此字段。

multi_modal_segments[]

MultiModalSegment

关于 RouteLeg.steps 不同多模态片段的汇总信息。如果 RouteLeg 中的步骤不包含任何多模态细分，则不会填充此字段。

MultiModalSegment

提供有关 RouteLeg.steps 的不同多模态细分的汇总信息。多模态片段定义为具有相同 RouteTravelMode 的一个或多个连续 RouteLegStep。如果 RouteLeg 中的步骤不包含任何多模态细分，则不会填充此字段。

字段
`navigation_instruction`	`NavigationInstruction` 多模式路段的 NavigationInstruction。
`travel_mode`	`RouteTravelMode` 多模式路段的出行方式。
`step_start_index`	`int32` 多模态片段的起始对应的 `RouteLegStep` 索引。
`step_end_index`	`int32` 多模态片段的结束对应的 `RouteLegStep` 索引。

RouteLegStep

包含 RouteLeg 的一部分。步骤对应于单个导航指令。路线分段由步骤组成。

字段
`distance_meters`	`int32` 此步骤的移动距离（以米为单位）。在某些情况下，此字段可能没有值。
`static_duration`	`Duration` 不考虑交通状况的情况下，完成此步骤所需的时间。在某些情况下，此字段可能没有值。
`polyline`	`Polyline` 与此步骤关联的多段线。
`start_location`	`Location` 此步骤的起始位置。
`end_location`	`Location` 此步骤的终点位置。
`navigation_instruction`	`NavigationInstruction` 导航说明。
`travel_advisory`	`RouteLegStepTravelAdvisory` 包含用户应了解的其他信息，例如相应行程步骤可能存在的交通区域限制。
`localized_values`	`RouteLegStepLocalizedValues` `RouteLegStep` 属性的文本表示法。
`transit_details`	`RouteLegStepTransitDetails` 如果行程模式为 `TRANSIT`，则与此步骤相关的详细信息。
`travel_mode`	`RouteTravelMode` 此步骤所用的交通方式。

RouteLegStepLocalizedValues

特定媒体资源的文字表示法。

字段

distance

LocalizedText

以文本形式表示的旅行距离。

static_duration

LocalizedText

不考虑交通状况的行程时长，以文本形式表示。

RouteLegStepTransitDetails

与 TRANSIT 路线相关的 RouteLegStep 的其他信息。

字段
`stop_details`	`TransitStopDetails` 相应步骤的到达站和出发站的相关信息。
`localized_values`	`TransitDetailsLocalizedValues` `RouteLegStepTransitDetails` 属性的文本表示法。
`headsign`	`string` 指定该线路的行进方向，如车辆或出发站所标示的方向。方向通常是终点站。
`headway`	`Duration` 将预计时间指定为目前同一车站各次发车之间的时长。例如，当 headway 秒值为 600 时，如果您错过了一班公交，那么预计需要 10 分钟才能等到下一班。
`transit_line`	`TransitLine` 此步骤中所用公交线路的相关信息。
`stop_count`	`int32` 从出发站到到达站之间的经停点数量。此计数包含到达站，但不含出发站。例如，如果您的路线是从 A 站出发，途经 B 站和 C 站，最终到达 D 站， `stop_count` 返回 3。
`trip_short_text`	`string` 时刻表和标志牌上显示的文字，用于向乘客指明公交行程。该文字应能唯一标识服务日内的行程。例如，“538”是 Amtrak 火车的 `trip_short_text`，该火车在工作日下午 3:10 从加利福尼亚州圣何塞出发，前往加利福尼亚州萨克拉门托。

TransitDetailsLocalizedValues

RouteTransitDetails 值的本地化说明。

字段

字段
`arrival_time`	`LocalizedTime` 时间的格式化文本表示法，并带有相应的时区。
`departure_time`	`LocalizedTime` 时间的格式化文本表示法，并带有相应的时区。

arrival_time

LocalizedTime

时间的格式化文本表示法，并带有相应的时区。

departure_time

LocalizedTime

时间的格式化文本表示法，并带有相应的时区。

TransitStopDetails

有关 RouteLegStep 公交车站的详细信息。

字段
`arrival_stop`	`TransitStop` 有关相应步骤到达经停点的信息。
`arrival_time`	`Timestamp` 相应步骤的预计到达时间。
`departure_stop`	`TransitStop` 有关相应步骤的出发车站的信息。
`departure_time`	`Timestamp` 相应步骤的预计出发时间。

RouteLegStepTravelAdvisory

包含应告知用户的其他信息，例如相应行程步骤可能存在的交通区域限制。

字段

字段
`speed_reading_intervals[]`	`SpeedReadingInterval` 注意：此字段目前未填充任何内容。

speed_reading_intervals[]

SpeedReadingInterval

注意：此字段目前未填充任何内容。

RouteLegTravelAdvisory

包含应告知用户的路段步骤的其他信息，例如可能存在的交通区域限制。

字段

字段
`toll_info`	`TollInfo` 包含特定 `RouteLeg` 的过路费信息。只有在我们预计 `RouteLeg` 上有收费时，才会填充此字段。如果已设置此字段，但未填充 estimated_price 子字段，则表示相应道路包含过路费，但我们不知道预计价格。如果此字段不存在，则 `RouteLeg` 没有过路费。
`speed_reading_intervals[]`	`SpeedReadingInterval` 速度读数间隔，详细说明交通密度。适用于 `TRAFFIC_AWARE` 和 `TRAFFIC_AWARE_OPTIMAL` 路由偏好设置。这些时间间隔涵盖 `RouteLeg` 的整个多段线，且不重叠。指定间隔的起点与前一间隔的终点相同。示例： `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

包含特定 RouteLeg 的过路费信息。只有在我们预计 RouteLeg 上有收费时，才会填充此字段。如果已设置此字段，但未填充 estimated_price 子字段，则表示相应道路包含过路费，但我们不知道预计价格。如果此字段不存在，则 RouteLeg 没有过路费。

speed_reading_intervals[]

SpeedReadingInterval

速度读数间隔，详细说明交通密度。适用于 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 路由偏好设置。这些时间间隔涵盖 RouteLeg 的整个多段线，且不重叠。指定间隔的起点与前一间隔的终点相同。

示例：

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

ComputeRouteMatrixRequest 的单个目的地

字段

字段
`waypoint`	`Waypoint` 必需。目的地航点

waypoint

Waypoint

必需。目的地航点

RouteMatrixElement

包含 ComputeRouteMatrix API 中为起点/终点对计算的路线信息。此 proto 可以流式传输到客户端。

字段
`status`	`Status` 此元素的错误状态代码。
`condition`	`RouteMatrixElementCondition` 指示是否找到了路线。与状态无关。
`distance_meters`	`int32` 路线的行程距离（以米为单位）。
`duration`	`Duration` 导航路线所需的时间。如果您将 `routing_preference` 设为 `TRAFFIC_UNAWARE`，则此值与 `static_duration` 相同。如果您将 `routing_preference` 设置为 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL`，则系统会在计算此值时考虑交通状况。
`static_duration`	`Duration` 不考虑交通状况的情况下，沿着相应路线行驶所需的时间。
`travel_advisory`	`RouteTravelAdvisory` 有关相应路线的其他信息。例如：限制信息和过路费信息
`fallback_info`	`FallbackInfo` 在某些情况下，如果服务器无法根据给定偏好设置为此特定始发地/目的地对计算路线，则可能会改用其他计算模式。使用回退模式时，此字段包含有关回退响应的详细信息。否则，此字段将未设置。
`localized_values`	`LocalizedValues` `RouteMatrixElement` 属性的文本表示法。
`origin_index`	`int32` 请求中来源的索引（从零开始）。
`destination_index`	`int32` 请求中目的地的索引（从零开始）。

LocalizedValues

特定属性的文字表示法。

字段
`distance`	`LocalizedText` 以文本形式表示的旅行距离。
`duration`	`LocalizedText` 考虑交通状况以文本形式表示的持续时间。注意：如果未请求交通信息，此值与 static_duration 相同。
`static_duration`	`LocalizedText` 时长以文本形式表示，不考虑交通状况。
`transit_fare`	`LocalizedText` 以文本形式表示的公共交通费用。

RouteMatrixElementCondition

返回的路线的状态。

枚举
`ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED`	仅在元素的 `status` 不 OK 时使用。
`ROUTE_EXISTS`	找到了路线，并为相应元素填写了相应信息。
`ROUTE_NOT_FOUND`	找不到路线。元素中不会填充包含路线信息的字段，例如 `distance_meters` 或 `duration`。

RouteMatrixOrigin

ComputeRouteMatrixRequest 的单个来源

字段

字段
`waypoint`	`Waypoint` 必需。起点航点
`route_modifiers`	`RouteModifiers` 可选。将此地点作为起点的每条路线的修饰符

waypoint

Waypoint

必需。起点航点

route_modifiers

RouteModifiers

可选。将此地点作为起点的每条路线的修饰符

RouteModifiers

封装一组可选条件，以便在计算路线时满足这些条件。

字段
`avoid_tolls`	`bool` 设置为 true 时，会在合理的情况下避开收费道路，优先选择不含收费道路的路线。仅适用于 `DRIVE` 和 `TWO_WHEELER` `RouteTravelMode`。
`avoid_highways`	`bool` 如果设置为 true，则会在合理的情况下避开高速公路，优先选择不含高速公路的路线。仅适用于 `DRIVE` 和 `TWO_WHEELER` `RouteTravelMode`。
`avoid_ferries`	`bool` 如果设置为 true，则会在合理情况下避开轮渡，优先选择不含轮渡的路线。仅适用于 `DRIVE` 和 `TWO_WHEELER` `RouteTravelMode`。
`avoid_indoor`	`bool` 设置为 true 时，会在合理情况下避免在室内导航，优先选择不包含室内导航的路线。仅适用于 `WALK` `RouteTravelMode`。
`vehicle_info`	`VehicleInfo` 指定车辆信息。
`toll_passes[]`	`TollPass` 封装有关过路卡的信息。如果提供了过路卡，API 会尝试返回过路卡价格。如果未提供过路费卡，API 会将过路费卡视为未知，并尝试返回现金价格。仅适用于 `DRIVE` 和 `TWO_WHEELER` `RouteTravelMode`。

RouteTravelAdvisory

包含应告知用户的其他信息，例如可能存在的交通区域限制。

字段
`toll_info`	`TollInfo` 包含有关路线上收费信息的信息。只有在路线上预计有收费路段时，系统才会填充此字段。如果已设置此字段，但未填充 `estimatedPrice` 子字段，则表示相应路线包含过路费，但预估价格未知。如果未设置此字段，则表示相应路线没有预计的过路费。
`speed_reading_intervals[]`	`SpeedReadingInterval` 速度读数间隔，详细说明交通密度。适用于 `TRAFFIC_AWARE` 和 `TRAFFIC_AWARE_OPTIMAL` 路由偏好设置。这些时间间隔应涵盖路线的整个多段线，且不重叠。指定间隔的起点与前一间隔的终点相同。示例： `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`
`fuel_consumption_microliters`	`int64` 预测的燃料消耗量（以微升为单位）。
`route_restrictions_partially_ignored`	`bool` 返回的路线可能存在不适合请求的出行方式或路线修饰符的限制。
`transit_fare`	`Money` 若存在，则包含此路线的总票价或总票费。此属性仅针对 `TRANSIT` 请求返回，且仅适用于所有公交步骤均有票价信息的路线。

RouteTravelMode

一组用于指定出行方式的值。注意：WALK、BICYCLE 和 TWO_WHEELER 路线处于 Beta 版阶段，有时可能缺少明确的步道、人行道或自行车道。对于您在应用中显示的所有步行、骑行和两轮车路线，都必须向用户显示此警告。

枚举
`TRAVEL_MODE_UNSPECIFIED`	未指定出行方式。默认为 `DRIVE`。
`DRIVE`	乘坐客车。
`BICYCLE`	骑自行车。
`WALK`	步行。
`TWO_WHEELER`	双轮机动车。例如摩托车。请注意，这与涵盖人力车辆模式的 `BICYCLE` 出行方式不同。
`TRANSIT`	乘坐公共交通工具（如有）。

RoutingPreference

一组值，用于指定计算路线时要考虑的因素。

枚举
`ROUTING_PREFERENCE_UNSPECIFIED`	未指定路由偏好设置。默认为 `TRAFFIC_UNAWARE`。
`TRAFFIC_UNAWARE`	计算路线时不考虑实时路况。当交通状况不重要或不适用时，此值适用。使用此值可产生最短的延迟时间。注意：对于 `RouteTravelMode`、`DRIVE` 和 `TWO_WHEELER`，系统会根据道路网和与时间无关的平均路况信息而非当前路况信息来选择路线和时长。因此，路线可能包括暂时关闭的道路。受道路网变化、平均路况信息更新以及服务的分布式性质的影响，给定请求的结果可能会随时间的推移而发生变化。此外，在时间或频率不受限制的情况下，即使两条路线几乎相同，结果还是有可能不同。
`TRAFFIC_AWARE`	计算路线时会考虑实时路况。与 `TRAFFIC_AWARE_OPTIMAL` 相比，系统会应用一些优化来显著缩短延迟时间。
`TRAFFIC_AWARE_OPTIMAL`	计算路线时会考虑实时交通状况，但不会应用大多数性能优化。使用此值会产生最长的延迟时间。

SpeedReadingInterval

多段线或路径的连续路段上的交通密度指示器。给定包含点 P_0、P_1、...、P_N（从零开始编号）的路径，SpeedReadingInterval 会定义一个时间间隔，并使用以下类别描述其流量。

字段
`start_polyline_point_index`	`int32` 此时间段在多段线中的起始索引。
`end_polyline_point_index`	`int32` 多段线中此时间段的结束索引。
联合字段 `speed_type`。 `speed_type` 只能是下列其中一项：
`speed`	`Speed` 此时间段内的交通速度。

速度

根据交通数据对多段线速度进行的分类。

枚举
`SPEED_UNSPECIFIED`	默认值。此值未使用。
`NORMAL`	正常速度，未检测到任何减速。
`SLOW`	检测到车速缓慢，但未形成交通堵塞。
`TRAFFIC_JAM`	检测到交通堵塞。

TollInfo

封装 Route 或 RouteLeg 上的过路费信息。

字段

estimated_price[]

Money

相应 Route 或 RouteLeg 的过路费金额。此列表包含各个收费站预计收取的每种币种的金额。通常，对于使用一种货币收取过路费的路线，此列表中只会包含一个项。对于国际行程，此列表可能包含多个项，以反映不同币种的过路费。

TollPass

我们支持的全球过路卡列表。

枚举
`TOLL_PASS_UNSPECIFIED`	未使用。如果使用此值，则请求会失败。
`AU_ETOLL_TAG`	悉尼通行卡。如需了解更多详情，请访问 https://www.myetoll.com.au。
`AU_EWAY_TAG`	悉尼通行卡。如需了解更多详情，请访问 https://www.tollpay.com.au。
`AU_LINKT`	澳大利亚境内通行卡。如需了解详情，请访问 https://www.linkt.com.au/。
`AR_TELEPASE`	阿根廷通行卡。如需了解更多详情，请访问 https://telepase.com.ar
`BR_AUTO_EXPRESO`	巴西通行卡。如需了解更多详情，请访问 https://www.autoexpreso.com
`BR_CONECTCAR`	巴西通行卡。如需了解更多详情，请访问 https://conectcar.com。
`BR_MOVE_MAIS`	巴西通行卡。如需了解更多详情，请访问 https://movemais.com。
`BR_PASSA_RAPIDO`	巴西通行卡。如需了解更多详情，请访问 https://pasorapido.gob.do/
`BR_SEM_PARAR`	巴西通行卡。如需了解更多详情，请访问 https://www.semparar.com.br。
`BR_TAGGY`	巴西通行卡。如需了解更多详情，请访问 https://taggy.com.br。
`BR_VELOE`	巴西通行卡。如需了解更多详情，请访问 https://veloe.com.br/site/onde-usar。
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	加拿大至美国边境过境。
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	加拿大至美国边境过境。
`CA_US_BLUE_WATER_EDGE_PASS`	加拿大安大略省至美国密歇根州的边界过境点。
`CA_US_CONNEXION`	加拿大安大略省至美国密歇根州的边界过境点。
`CA_US_NEXUS_CARD`	加拿大至美国边境过境。
`ID_E_TOLL`	印度尼西亚。多家银行提供的电子卡，用于支付过路费。通过银行发行的所有电子卡的费用相同，因此只需一个枚举值。例如：- Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
`IN_FASTAG`	India.
`IN_LOCAL_HP_PLATE_EXEMPT`	印度，豁免了 HP 州车牌。
`JP_ETC`	日本 ETC。收取过路费的电子无线系统。https://www.go-etc.jp/
`JP_ETC2`	日本 ETC2.0。新版 ETC 可享受更多折扣，并支持车载设备与道路上的天线之间进行双向通信。https://www.go-etc.jp/etc2/index.html
`MX_IAVE`	墨西哥过路卡。https://iave.capufe.gob.mx/#/
`MX_PASE`	墨西哥 https://www.pase.com.mx
`MX_QUICKPASS`	墨西哥 https://operadoravial.com/quick-pass/
`MX_SISTEMA_TELEPEAJE_CHIHUAHUA`	http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
`MX_TAG_IAVE`	墨西哥
`MX_TAG_TELEVIA`	墨西哥通行卡公司。这是墨西哥城众多公交车站之一。如需了解详情，请访问 https://www.televia.com.mx。
`MX_TELEVIA`	墨西哥通行卡公司。这是墨西哥城众多电视台之一。https://www.televia.com.mx
`MX_VIAPASS`	墨西哥通行卡。如需了解更多详情，请访问 https://www.viapass.com.mx/viapass/web_home.aspx。
`US_AL_FREEDOM_PASS`	AL, USA.
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	AK, USA.
`US_CA_FASTRAK`	加拿大、美国。
`US_CA_FASTRAK_CAV_STICKER`	表示驾驶员除了拥有 DMV 签发的清洁空气车辆 (CAV) 贴纸外，还拥有任何 FasTrak 卡券。https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	美国科罗拉多州。
`US_CO_GO_PASS`	美国科罗拉多州。
`US_DE_EZPASSDE`	DE, USA.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	FL, USA.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	FL, USA.
`US_FL_EPASS`	FL, USA.
`US_FL_GIBA_TOLL_PASS`	FL, USA.
`US_FL_LEEWAY`	FL, USA.
`US_FL_SUNPASS`	FL, USA.
`US_FL_SUNPASS_PRO`	FL, USA.
`US_IL_EZPASSIL`	IL, USA.
`US_IL_IPASS`	IL, USA.
`US_IN_EZPASSIN`	美国印第安纳州。
`US_KS_BESTPASS_HORIZON`	KS, USA.
`US_KS_KTAG`	KS, USA.
`US_KS_NATIONALPASS`	KS, USA.
`US_KS_PREPASS_ELITEPASS`	KS, USA.
`US_KY_RIVERLINK`	KY, USA.
`US_LA_GEAUXPASS`	美国洛杉矶。
`US_LA_TOLL_TAG`	美国洛杉矶。
`US_MA_EZPASSMA`	MA, USA。
`US_MD_EZPASSMD`	美国马里兰州。
`US_ME_EZPASSME`	美国缅因州。
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	MI, USA.
`US_MI_BCPASS`	MI, USA.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	MI, USA.
`US_MI_IQ_PROX_CARD`	MI, USA. 已废弃，因为此卡券类型已不存在。此项已弃用！
`US_MI_IQ_TAG`	MI, USA.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	MI, USA.
`US_MI_NEXPRESS_TOLL`	MI, USA.
`US_MN_EZPASSMN`	美国明尼苏达州。
`US_NC_EZPASSNC`	美国北卡罗来纳州。
`US_NC_PEACH_PASS`	美国北卡罗来纳州。
`US_NC_QUICK_PASS`	美国北卡罗来纳州。
`US_NH_EZPASSNH`	美国新罕布什尔州。
`US_NJ_DOWNBEACH_EXPRESS_PASS`	美国新泽西州。
`US_NJ_EZPASSNJ`	美国新泽西州。
`US_NY_EXPRESSPASS`	美国纽约州。
`US_NY_EZPASSNY`	美国纽约州。
`US_OH_EZPASSOH`	美国俄亥俄州。
`US_PA_EZPASSPA`	PA, USA.
`US_RI_EZPASSRI`	RI, USA.
`US_SC_PALPASS`	SC, USA.
`US_TX_AVI_TAG`	美国德克萨斯州。
`US_TX_BANCPASS`	美国德克萨斯州。
`US_TX_DEL_RIO_PASS`	美国德克萨斯州。
`US_TX_EFAST_PASS`	美国德克萨斯州。
`US_TX_EAGLE_PASS_EXPRESS_CARD`	美国德克萨斯州。
`US_TX_EPTOLL`	美国德克萨斯州。
`US_TX_EZ_CROSS`	美国德克萨斯州。
`US_TX_EZTAG`	美国德克萨斯州。
`US_TX_FUEGO_TAG`	美国德克萨斯州。
`US_TX_LAREDO_TRADE_TAG`	美国德克萨斯州。
`US_TX_PLUSPASS`	美国德克萨斯州。
`US_TX_TOLLTAG`	美国德克萨斯州。
`US_TX_TXTAG`	美国德克萨斯州。
`US_TX_XPRESS_CARD`	美国德克萨斯州。
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	美国德克萨斯州。
`US_VA_EZPASSVA`	美国弗吉尼亚州。
`US_WA_BREEZEBY`	美国华盛顿州。
`US_WA_GOOD_TO_GO`	美国华盛顿州。
`US_WV_EZPASSWV`	WV, USA.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV, USA.
`US_WV_MOV_PASS`	WV, USA
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV, USA.

TrafficModel

指定计算交通时间时所用的假设条件。此设置会影响响应中返回到 duration 字段的值，该值包含根据历史平均数据预测的交通时间。

枚举
`TRAFFIC_MODEL_UNSPECIFIED`	未使用。如果指定，则默认为 `BEST_GUESS`。
`BEST_GUESS`	表示返回的 `duration` 应该是最准确的行程时间估算值（根据已知的历史路况信息和实时路况信息得出）。`departure_time` 越接近当前时间，实时路况信息就越重要。
`PESSIMISTIC`	表示返回的行程时长在大多数日子里应该长于实际行程时间，但在交通状况特别糟糕的少数日子里，实际行程时间可能超过此值。
`OPTIMISTIC`	表示返回的行程时长在大多数日子里应该短于实际行程时间，但偶尔路况特别理想的时候，实际行程时间可能会小于该值。

TransitAgency

运营公交线路的公交公司。

字段

name

string

此公交公司的名称。

phone_number

string

公交公司采用特定语言区域格式的电话号码。

uri

string

公交公司的 URI。

TransitLine

包含此路段中所用公交线路的相关信息。

字段
`agencies[]`	`TransitAgency` 运营此公交线路的公交公司（或公交公司）。
`name`	`string` 此公交线路的全名，例如“8 Avenue Local”。
`uri`	`string` 该公交线路的 URI（由公交公司提供）。
`color`	`string` 该线路标牌中常用的颜色。以十六进制表示。
`icon_uri`	`string` 与该线路关联的图标的 URI。
`name_short`	`string` 该公交线路的简称。此名称通常是线路编号，例如“M7”或“355”。
`text_color`	`string` 该线路站牌上常用的文字颜色。以十六进制表示。
`vehicle`	`TransitVehicle` 此公交线路上运营的车辆类型。

TransitPreferences

基于 TRANSIT 的路线的偏好设置，会影响返回的路线。

字段

allowed_travel_modes[]

TransitTravelMode

获取 TRANSIT 路线时要使用的一组出行方式。默认为所有受支持的出行方式。

routing_preference

TransitRoutingPreference

路由偏好设置，指定后会影响返回的 TRANSIT 路线。

TransitRoutingPreference

指定公共交通路线的路线优先级。

枚举
`TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED`	未指定偏好设置。
`LESS_WALKING`	表示计算的路线应首选步行距离有限的路线。
`FEWER_TRANSFERS`	表示计算的路线应首选换乘次数有限的路线。

TransitTravelMode

一组用于指定公交方式的值。

枚举
`TRANSIT_TRAVEL_MODE_UNSPECIFIED`	未指定公共交通出行方式。
`BUS`	乘坐公交车。
`SUBWAY`	乘坐地铁。
`TRAIN`	乘火车出行。
`LIGHT_RAIL`	乘坐轻轨或有轨电车。
`RAIL`	乘火车出行。这等同于 `SUBWAY`、`TRAIN` 和 `LIGHT_RAIL` 的组合。

TransitStop

有关公交车站的信息。

字段

name

string

相应公交经停点的名称。

location

Location

经停点的位置（以经度/纬度坐标表示）。

TransitVehicle

公交线路中使用的车辆的相关信息。

字段
`name`	`LocalizedText` 此车辆的名称（应采用大写形式）。
`type`	`TransitVehicleType` 使用的车辆类型。
`icon_uri`	`string` 与此车辆类型关联的图标的 URI。
`local_icon_uri`	`string` 与该交通工具类型关联的图标的 URI，取决于当地交通标志。

TransitVehicleType

公交线路的车辆类型。

枚举
`TRANSIT_VEHICLE_TYPE_UNSPECIFIED`	未使用。
`BUS`	公交车。
`CABLE_CAR`	一种靠电缆运行的交通工具，通常在地面上行驶。空中缆车可以算作 `GONDOLA_LIFT` 类型。
`COMMUTER_TRAIN`	通勤铁路。
`FERRY`	轮渡。
`FUNICULAR`	一种由缆线拉上陡坡的交通工具。索道缆车通常由两个车体组成，彼此作为对方的平衡重物。
`GONDOLA_LIFT`	空中缆车
`HEAVY_RAIL`	重轨。
`HIGH_SPEED_TRAIN`	高速列车。
`INTERCITY_BUS`	长途客车。
`LONG_DISTANCE_TRAIN`	长途列车。
`METRO_RAIL`	轻轨交通。
`MONORAIL`	单轨。
`OTHER`	所有其他车辆。
`RAIL`	铁路。
`SHARE_TAXI`	合乘出租车是一种可在其运行路线上随处上下乘客的公共汽车。
`SUBWAY`	地下轻轨。
`TRAM`	地上轻轨。
`TROLLEYBUS`	无轨电车。

单位

一组值，用于指定显示屏中使用的测量单位。

枚举
`UNITS_UNSPECIFIED`	未指定度量单位。默认为从请求中推断出的衡量单位。
`METRIC`	公制单位。
`IMPERIAL`	英制（英语）计量单位。

VehicleEmissionType

一组值，用于描述车辆的排放类型。仅适用于 DRIVE RouteTravelMode。

枚举
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	未指定排放类型。默认为 `GASOLINE`。
`GASOLINE`	汽油车。
`ELECTRIC`	电动车辆。
`HYBRID`	混合燃料（例如汽油 + 电）车辆。
`DIESEL`	柴油车。

VehicleInfo

包含车辆信息，例如车辆排放类型。

字段

emission_type

VehicleEmissionType

描述车辆的排放类型。仅适用于 DRIVE RouteTravelMode。

关键点

封装航点。航点用于标记路线的起点和终点，并包含路线上的中途停靠点。

字段
`via`	`bool` 将此航点标记为里程碑，而不是停止点。对于请求中的每个非经停点路径点，响应都会将一条目附加到 `legs` 数组，以提供该行程相应路段的停靠点详细信息。如果您希望路线通过此航点而不停留，请将此值设置为 true。经由路径点不会导致向 `legs` 数组添加条目，但会将旅程路线改为途经该路径点。您只能对中间航点设置此值。如果您在终点航点上设置此字段，则请求将失败。如果 `ComputeRoutesRequest.optimize_waypoint_order` 设为 true，则此字段不能设为 true；否则，请求将失败。
`vehicle_stopover`	`bool` 表示该航点是供车辆停靠的，目的是上车或下车。如果您设置此值，则计算出的路线不会包含不适合上车或下车的道路上的非 `via` 航点。此选项仅适用于 `DRIVE` 和 `TWO_WHEELER` 出行方式，并且 `location_type` 为 `Location` 时有效。
`side_of_road`	`bool` 指示此航点的位置是指示车辆在道路的特定侧停车的偏好设置。设置此值后，路线将穿过相应位置，以便车辆能够停靠在相应位置偏离道路中心的一侧。此选项仅适用于 `DRIVE` 和 `TWO_WHEELER` `RouteTravelMode`。
联合字段 `location_type`。表示地理位置的不同方式。`location_type` 只能是下列其中一项：
`location`	`Location` 使用地理坐标指定的点，包括可选的航向。
`place_id`	`string` 与航点关联的地图注点地点 ID。
`address`	`string` 可读的地址或 Plus Code。如需了解详情，请参阅 https://plus.codes。