此页面由 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)

根据一组终点和中间航点返回主要路线以及可选的备选路线。

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

例如，在此方法中：

所有可用字段的字段掩码（用于手动检查）：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` 中时长字段内返回的值，该值包含根据历史平均数据预测的交通时间。`TrafficModel` 仅适用于将 `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` 中返回到时长字段的值，该值包含根据历史平均数据预测的交通时间。`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`	相应路线的 Flyover 信息。必须指定 `routes.polyline_details.flyover_info` fieldmask 才能返回此信息。目前，此数据仅会针对印度境内的某些大都市区进行填充。此功能目前处于实验阶段，SKU/费用可能会发生变化。
`NARROW_ROAD_INFO_ON_POLYLINE`	相应路线的狭窄道路信息。必须指定 `routes.polyline_details.narrow_road_info` fieldmask 才能返回此信息。目前，此数据仅会针对印度境内的某些大都市区进行填充。此功能目前处于实验阶段，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

ComputeRoutes 响应消息。

字段

字段
`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`	左转掉头。
`TURN_LEFT`	向左转。
`TURN_SLIGHT_RIGHT`	稍向右转。
`TURN_SHARP_RIGHT`	急剧向右转。
`UTURN_RIGHT`	向右掉头。
`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` 指定目前同一车站各次发车的预计间隔时间。例如，如果 headwaySeconds 值为 600，那么如果您错过了一班公交，预计需要 10 分钟才能等到下一班。
`transit_line`	`TransitLine` 该路段中所用公交线路的相关信息。
`stop_count`	`int32` 从出发站到到达站的经停站数量。此数量包含到达站，但不包含出发站。例如，如果您的路线是从 A 站出发，途经 B 站和 C 站，最终到达 D 站， `stop_count` 返回 3。
`trip_short_text`	`string` 显示在时刻表和指示牌中，用于向乘客标识公交行程的文字。该文本应能唯一标识服务日内的行程。例如，“538”是 Amtrak 列车的 `trip_short_text`，该列车在工作日 15: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` 上有收费站，并且请求的 `ComputeRoutesRequest.extra_computations` 中包含 `TOLLS` 时，系统才会填充此字段。如果设置了此字段，但未填充 estimated_price 子字段，则表示相应道路包含收费站，但我们不知道估计价格。如果 `toll_info` 不存在，则 `RouteLeg` 不收取通行费。
`speed_reading_intervals[]`	`SpeedReadingInterval` 显示车流密度的朗读间隔。仅当请求具有 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL` `ComputeRoutesRequest.routing_preference` 值，且 `TRAFFIC_ON_POLYLINE` 包含在 `ComputeRoutesRequest.extra_computations` 中时，才会为请求填充此字段。这些区间涵盖了 `RouteLeg` 的整个折线，且不重叠。指定区间的起点与前一个区间的终点相同。示例： `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

包含有关特定 RouteLeg 的通行费信息。只有在我们预计 RouteLeg 上有收费站，并且请求的 ComputeRoutesRequest.extra_computations 中包含 TOLLS 时，系统才会填充此字段。如果设置了此字段，但未填充 estimated_price 子字段，则表示相应道路包含收费站，但我们不知道估计价格。如果 toll_info 不存在，则 RouteLeg 不收取通行费。

speed_reading_intervals[]

SpeedReadingInterval

显示车流密度的朗读间隔。仅当请求具有 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference 值，且 TRAFFIC_ON_POLYLINE 包含在 ComputeRoutesRequest.extra_computations 中时，才会为请求填充此字段。这些区间涵盖了 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` 包含路线上的通行费信息。仅当路线预计会经过收费站，且请求的 `ComputeRoutesRequest.extra_computations` 中包含 `TOLLS` 时，系统才会填充此字段。如果设置了此字段，但未填充 `estimatedPrice` 子字段，则表示相应路线包含收费路段，但估计价格未知。如果未设置 `toll_info`，则表示路线不涉及任何收费。
`speed_reading_intervals[]`	`SpeedReadingInterval` 显示车流密度的朗读间隔。仅当请求具有 `TRAFFIC_AWARE` 或 `TRAFFIC_AWARE_OPTIMAL` `ComputeRoutesRequest.routing_preference` 值，且 `TRAFFIC_ON_POLYLINE` 包含在 `ComputeRoutesRequest.extra_computations` 中时，才会为请求填充此字段。这些区间覆盖了路线的整个折线，且不会重叠。指定区间的起点与前一个区间的终点相同。示例： `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`
`fuel_consumption_microliters`	`int64` 预测的燃料消耗量（以微升为单位）。仅当请求的 `ComputeRoutesRequest.extra_computations` 中包含 `FUEL_CONSUMPTION` 时，系统才会填充此字段。
`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`	CA, USA.
`US_CA_FASTRAK_CAV_STICKER`	表示驾驶员除了 DMV 签发的清洁能源汽车 (CAV) 贴纸外，还拥有任何 FasTrak 通行卡。https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO, USA.
`US_CO_GO_PASS`	CO, USA.
`US_DE_EZPASSDE`	DE, USA.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	美国佛罗里达州。
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	美国佛罗里达州。
`US_FL_EPASS`	美国佛罗里达州。
`US_FL_GIBA_TOLL_PASS`	美国佛罗里达州。
`US_FL_LEEWAY`	美国佛罗里达州。
`US_FL_SUNPASS`	美国佛罗里达州。
`US_FL_SUNPASS_PRO`	美国佛罗里达州。
`US_IL_EZPASSIL`	IL, USA.
`US_IL_IPASS`	IL, USA.
`US_IN_EZPASSIN`	IN, USA.
`US_KS_BESTPASS_HORIZON`	KS，美国。
`US_KS_KTAG`	KS，美国。
`US_KS_NATIONALPASS`	KS，美国。
`US_KS_PREPASS_ELITEPASS`	KS，美国。
`US_KY_RIVERLINK`	KY，美国。
`US_LA_GEAUXPASS`	LA, USA.
`US_LA_TOLL_TAG`	LA, USA.
`US_MA_EZPASSMA`	MA, USA.
`US_MD_EZPASSMD`	MD, USA.
`US_ME_EZPASSME`	ME，美国。
`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`	MN, USA.
`US_NC_EZPASSNC`	NC, USA.
`US_NC_PEACH_PASS`	NC, USA.
`US_NC_QUICK_PASS`	NC, USA.
`US_NH_EZPASSNH`	NH, USA.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	NJ, USA.
`US_NJ_EZPASSNJ`	NJ, USA.
`US_NY_EXPRESSPASS`	美国纽约州。
`US_NY_EZPASSNY`	美国纽约州。
`US_OH_EZPASSOH`	OH, USA.
`US_PA_EZPASSPA`	PA, USA.
`US_RI_EZPASSRI`	RI, USA.
`US_SC_PALPASS`	SC，美国。
`US_TX_AVI_TAG`	TX, USA.
`US_TX_BANCPASS`	TX, USA.
`US_TX_DEL_RIO_PASS`	TX, USA.
`US_TX_EFAST_PASS`	TX, USA.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	TX, USA.
`US_TX_EPTOLL`	TX, USA.
`US_TX_EZ_CROSS`	TX, USA.
`US_TX_EZTAG`	TX, USA.
`US_TX_FUEGO_TAG`	TX, USA.
`US_TX_LAREDO_TRADE_TAG`	TX, USA.
`US_TX_PLUSPASS`	TX, USA.
`US_TX_TOLLTAG`	TX, USA.
`US_TX_TXTAG`	TX, USA.
`US_TX_XPRESS_CARD`	TX, USA.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	UT, USA.
`US_VA_EZPASSVA`	VA, USA.
`US_WA_BREEZEBY`	WA, USA.
`US_WA_GOOD_TO_GO`	WA, USA.
`US_WV_EZPASSWV`	WV, USA.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV, USA.
`US_WV_MOV_PASS`	美国西弗吉尼亚州
`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` 与途经点关联的 POI 地点 ID。
`address`	`string` 人类可读的地址或 Plus Code。如需了解详情，请参阅 https://plus.codes。

Package google.maps.routing.v2 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

索引

路由

ComputeRouteMatrixRequest

ExtraComputation

ComputeRoutesRequest

ExtraComputation

ReferenceRoute

ComputeRoutesResponse

FallbackInfo

FallbackReason

FallbackRoutingMode

GeocodedWaypoint

GeocodingResults

LocalizedTime

位置

Maneuver

NavigationInstruction

折线

PolylineDetails

FlyoverInfo

NarrowRoadInfo

PolylinePointIndex

RoadFeatureState

PolylineEncoding

PolylineQuality

路线

RouteLocalizedValues

RouteLabel

RouteLeg

RouteLegLocalizedValues

StepsOverview

MultiModalSegment

RouteLegStep

RouteLegStepLocalizedValues

RouteLegStepTransitDetails

TransitDetailsLocalizedValues

TransitStopDetails

RouteLegStepTravelAdvisory

RouteLegTravelAdvisory

RouteMatrixDestination

RouteMatrixElement

LocalizedValues

RouteMatrixElementCondition

RouteMatrixOrigin

RouteModifiers

RouteTravelAdvisory

RouteTravelMode

RoutingPreference

SpeedReadingInterval

速度

TollInfo

TollPass

TrafficModel

TransitAgency

TransitLine

TransitPreferences

TransitRoutingPreference

TransitTravelMode

TransitStop

TransitVehicle

TransitVehicleType

单位

VehicleEmissionType

VehicleInfo

航点

Package google.maps.routing.v2