Package google.maps.routing.v2

索引

• Routes（接口）
• ComputeRouteMatrixRequest（消息）
• ComputeRouteMatrixRequest.ExtraComputation（枚举）
• ComputeRoutesRequest（消息）
• ComputeRoutesRequest.ExtraComputation（枚举）
• ComputeRoutesRequest.ReferenceRoute（枚举）
• ComputeRoutesResponse（消息）
• FallbackInfo（消息）
• FallbackReason（枚举）
• FallbackRoutingMode（枚举）
• GeocodedWaypoint（消息）
• GeocodingResults（消息）
• Location（消息）
• Maneuver（枚举）
• NavigationInstruction（消息）
• Polyline（消息）
• PolylineEncoding（枚举）
• PolylineQuality（枚举）
• Route（消息）
• RouteLabel（枚举）
• RouteLeg（消息）
• RouteLegStep（消息）
• RouteLegStepTravelAdvisory（消息）
• RouteLegTravelAdvisory（消息）
• RouteMatrixDestination（消息）
• RouteMatrixElement（消息）
• RouteMatrixElementCondition（枚举）
• RouteMatrixOrigin（消息）
• RouteModifiers（消息）
• RouteTravelAdvisory（消息）
• RouteTravelMode（枚举）
• RoutingPreference（枚举）
• SpeedReadingInterval（消息）
• SpeedReadingInterval.Speed（枚举）
• TollInfo（消息）
• TollPass（枚举）
• Units（枚举）
• VehicleEmissionType（枚举）
• VehicleInfo（消息）
• Waypoint（消息）

路线

Routes API。

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 建议不要使用通配符 (*) 响应字段掩码，因为： 仅选择您需要的字段有助于我们的服务器节省计算周期，让我们能够以更低的延迟时间将结果返回给您。 仅选择生产作业中所需的字段可确保延迟时间的稳定性。未来我们可能会添加更多响应字段，这些新字段可能需要额外的计算时间。如果您选择所有字段，或者选择顶级的所有字段，则可能会遇到性能下降，因为我们添加的任何新字段都将自动包含在响应中。 仅选择您需要的字段可减小响应大小，从而实现更高的网络吞吐量。

ComputeRoute

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 必需。一组源站，用于确定响应矩阵的行。对于源站和目的地的基数，有一些大小限制： 在任何情况下，元素（起点 × 终点）的数量均不得超过 625。 如果 route_preference 设为 TRAFFIC_AWARE_OPTIMAL，元素（源站 × 目的地）的数量不得超过 100 个。 指定为 place_id 的路径点（起点 + 终点）数量不得超过 50 个。
destinations[]	RouteMatrixDestination 必需。目标数组，用于确定响应矩阵的列。
travel_mode	RouteTravelMode （可选）指定交通方式。
routing_preference	RoutingPreference （可选）指定如何计算路线。服务器尝试使用所选路由偏好设置来计算路线。如果路由偏好设置导致错误或超长的延迟时间，系统会返回错误。只有当 travel_mode 为 DRIVE 或 TWO_WHEELER 时，您才能指定此选项，否则请求会失败。
departure_time	Timestamp （可选）出发时间。如果未设置此值，则默认为发出请求的时间。如果您将此值设为已经发生的时间，请求将会失败。
language_code	string （可选）BCP-47 语言代码，例如“en-US”或“sr-Latn”。如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。请参阅语言支持，获取支持的语言列表。如果未提供此值，显示语言将根据第一个来源的位置推断出来。
region_code	string （可选）地区代码，指定为 ccTLD（“顶级域名”）双字符值。有关详情，请参阅 https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
extra_computations[]	ExtraComputation （可选）可用于完成请求的额外计算列表。注意：这些额外的计算可能会在响应中返回额外的字段。您还必须在字段掩码中指定这些额外的字段，以在响应中返回。

额外计算

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

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

ComputeRoutes 请求

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 （可选）出发时间。如果未设置此值，则此值默认为您发出请求的时间。如果您将此值设为已经发生的时间，则请求会失败。
compute_alternative_routes	bool （可选）指定是否除了计算路线外，还要计算备选路线。
route_modifiers	RouteModifiers （可选）要满足的一组条件，它们会影响路线的计算方式。
language_code	string （可选）BCP-47 语言代码，例如“en-US”或“sr-Latn”。如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。请参阅语言支持，获取支持的语言列表。如果未提供此值，系统会根据路线请求的位置推断显示语言。
region_code	string （可选）地区代码，指定为 ccTLD（“顶级域名”）双字符值。有关详情，请参阅 https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains
units	Units （可选）指定显示字段的计量单位。这包括 NavigationInstruction 中的 instruction 字段。路线、路程、路段距离和持续时间所用的测量单位不受该值的影响。如果您未提供此值，则系统会根据请求的位置推断显示单元。
requested_reference_routes[]	ReferenceRoute （可选）指定除了默认路线之外，还要作为请求一部分进行计算的参考路线。参考路线是指与默认路线不同的路线计算目标的路线。例如，FUEL_EFFICIENT 参考路线的计算会考虑将达到最节能路线的最佳参数。
extra_computations[]	ExtraComputation （可选）可用于完成请求的额外计算列表。注意：这些额外的计算可能会在响应中返回额外的字段。您还必须在字段掩码中指定这些额外的字段，以在响应中返回。

额外计算

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

枚举
EXTRA_COMPUTATION_UNSPECIFIED	未使用。包含此值的请求将失败。
TOLLS	路线的收费信息。
FUEL_CONSUMPTION	路线的估算燃料消耗量。
TRAFFIC_ON_POLYLINE	路线的可感知多段线。

参考路线

ComputeRoutesRequest 中支持的参考路由。

枚举
REFERENCE_ROUTE_UNSPECIFIED	未使用。包含此值的请求会失败。
FUEL_EFFICIENT	最省油路线。标有该值的路线已确定为优化燃料消耗等参数。

ComputeRoutesResponse

ComputeRoutes 响应消息。

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

后备信息

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

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

后备原因

使用回退响应的原因。

枚举
FALLBACK_REASON_UNSPECIFIED	未指定后备原因。
SERVER_ERROR	按照首选路由模式计算路线时发生服务器错误，但我们可返回由替代模式计算的结果。
LATENCY_EXCEEDED	我们无法按您的首选路由模式按时完成计算，但可以返回由替代模式计算的结果。

回退路由模式

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

枚举
FALLBACK_ROUTING_MODE_UNSPECIFIED	未使用。
FALLBACK_TRAFFIC_UNAWARE	表示使用“TRAFFIC_UNAWARE”路由模式计算响应。
FALLBACK_TRAFFIC_AWARE	表示使用“TRAFFIC_AWARE”路由模式计算响应。

经过地理编码的 Waypoint

有关用作航点的地点的详细信息。仅针对地址航点填充。包含有关地理编码结果的详情，用于确定地理编码地址。

字段
geocoder_status	Status 指明通过地理编码操作生成的状态代码。
type[]	string 结果的类型，采用零个或多个类型标记的形式。支持的类型：https://developers.google.com/maps/documentation/Geocoding/requests-Geocoding#Types
partial_match	bool 表示地理编码器无法返回与原始请求完全匹配的结果，尽管它能够匹配所请求地址的一部分。您不妨检查一下原始请求中是否有拼写错误和/或地址不完整的情况。
place_id	string 此结果的地点 ID。
intermediate_waypoint_request_index	int32 请求中相应中间航点的索引。仅当相应的路标是中间路标时填充。

地理编码结果

包含出发地、目的地和中间航点的 GeocodedWaypoints。仅针对地址航点填充。

字段
origin	GeocodedWaypoint 经过地理编码的航点。
destination	GeocodedWaypoint 目的地经过地理编码的航点。
intermediates[]	GeocodedWaypoint 中间经过地理编码的路标列表，其中每个路标均包含一个索引字段，其对应于从点开始的零位置（按照请求中指定的顺序）。

位置

封装位置（地理位置点和可选航向）。

字段
lat_lng	LatLng 航点的地理坐标。
heading	Int32Value 与流量方向相关的罗盘方向。此值用于指定上车点和下车点的侧面。方向值可在 0 到 360 之间，其中 0 表示正北方向，90 表示正东方向，以此类推。您只能将该字段用于 DRIVE 和 TWO_WHEELER 出行方式。

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	在环岛处右转。

导航说明

封装 RouteLegStep 的导航说明

字段
maneuver	Maneuver 封装当前步骤的导航说明（例如，左转、合并、直行等）。此字段决定了要显示的图标。
instructions	string 关于浏览此步骤的说明。

多段线

封装编码多段线。

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

多段线编码

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

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

多段线质量

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

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

路线

封装路线，其中包含一系列连接了起点、终点和中间航点的相连路段。

字段
route_labels[]	RouteLabel Route 的标签，可用于识别路线要与其他属性进行比较的属性。
legs[]	RouteLeg 组成路线的路程集合（路标之间的路径段）。每段路程都对应于两个非 via 航点之间的行程。例如，没有任何中间航点的路线只有一段路程。一条包含 1 个非 via 中间航点的路线有两条路程。含一个 via 中间航点的路线有一段路程。路程的顺序与从 origin 到 intermediates 到 destination 的 Waypoint 的顺序一致。
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 路线的其他相关信息。
route_token	string 可传递到 NavigationSDK 的 Web 安全 base64 编码路由令牌，这允许 Navigation SDK 在导航期间重建路线，并且在重新路由的情况下遵循在调用 Route ComputeRoutes 时遵循最初的意图。客户应将此令牌视为不透明 blob。注意：Route.route_token 仅适用于将 ComputeRoutesRequest.routing_preference 设置为 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL 的请求。包含 Via 航点的请求也不支持 Route.route_token。

路线标签

Route 的标签，可用于识别路线要与其他属性进行比较的属性。

枚举
ROUTE_LABEL_UNSPECIFIED	默认 - 未使用。
DEFAULT_ROUTE	为路线计算返回的默认“最佳”路线。
DEFAULT_ROUTE_ALTERNATE	默认“最佳”路线的替代方案。指定 ComputeRoutesRequest.compute_alternative_routes 后，将返回此类路由。
FUEL_EFFICIENT	最省油路线。标有该值的路线已确定针对节能参数（如油耗）进行了优化。

路线

封装非 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 封装应通知用户的其他信息，例如路线路段上可能发生的路况区域限制等。

RouteLegStep

封装 RouteLeg 的细分。每个步骤对应一个导航指令。路线路段由各个路段组成。

字段
distance_meters	int32 此路段的行驶距离（以米为单位）。在某些情况下，此字段可能没有值。
static_duration	Duration 不考虑路况信息情况下该路段的行程时长。在某些情况下，此字段可能没有值。
polyline	Polyline 与此步骤关联的多段线。
start_location	Location 此步骤的起始位置。
end_location	Location 此步骤的结束位置。
navigation_instruction	NavigationInstruction 导航说明。
travel_advisory	RouteLegStepTravelAdvisory 封装应告知用户的其他信息，例如针对路程步骤可能的车流量限制。

RouteLegStepTravelAdvisory（咨询）

封装应告知用户的其他信息，例如针对路程步骤可能的车流量限制。

字段
speed_reading_intervals[]	SpeedReadingInterval 注意：此字段目前没有填充。

航线旅行咨询

封装应通知用户的其他信息，例如路线路段上可能发生的路况区域限制等。

字段
toll_info	TollInfo 封装特定 RouteLeg 的收费信息。仅当我们预计 RouteLeg 上有收费站时，才会填充此字段。如果已设置此字段，但未填充推测价格的子字段，则我们预计该道路包含收费路段，但不知道估算价格。如果此字段不存在，则 RouteLeg 不收取任何费用。
speed_reading_intervals[]	SpeedReadingInterval 详细说明流量密度的速度读数间隔。适用于 TRAFFIC_AWARE 和 TRAFFIC_AWARE_OPTIMAL 路由偏好设置。这些间隔覆盖了 RouteLg 的整个多段线而不重叠。指定间隔的起点与上一间隔的终点相同。 例如： polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

ComputeRouteMatrixRequest 的单个目的地

字段
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 在某些情况下，当服务器无法根据此特定起点/目的地对计算指定路线时，可能会回退到使用其他计算模式。使用回退模式时，此字段包含有关回退响应的详细信息。否则，该字段将处于未设置状态。
origin_index	int32 请求中源站的索引（从零开始）。
destination_index	int32 请求中目的地的索引（从零开始）。

RouteMatrixElementCondition

所返回路线的条件。

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

RouteMatrixOrigin

ComputeRouteMatrixRequest 的单个源站

字段
waypoint	Waypoint 必需。出发地航点
route_modifiers	RouteModifiers （可选）以此为起点的每个路由的修饰符

RouteModifier

封装一组在计算路线时满足的可选条件。

字段
avoid_tolls	bool 指定是否在合理范围内避开收费路段。将优先考虑不包含收费道路的路线。仅适用于 DRIVE 和 TWO_WHEELER 出行方式。
avoid_highways	bool 指定是否在合理范围内避开高速公路。将优先考虑不包含高速公路的路线。仅适用于 DRIVE 和 TWO_WHEELER 出行方式。
avoid_ferries	bool 指定是否在合理位置避开轮渡。将优先考虑不包含轮渡行程的路线。仅适用于 DRIVE 和 TWO_WHEELER 出行方式。
avoid_indoor	bool 指定是否在合理的情况下避免在室内导航。将优先考虑不包含室内导航的路线。仅适用于 WALK 出行方式。
vehicle_info	VehicleInfo 指定车辆信息。
toll_passes[]	TollPass 封装有关通行卡的信息。如果提供了通行卡，API 会尝试返回卡券价格。如果未提供通行卡，API 会将通行卡视为未知，并尝试返回现金价格。仅适用于 DRIVE 和 TWO_WHEELER 出行方式。

路线旅行咨询

封装应告知用户的其他信息，例如可能的流量区间限制等。

字段
toll_info	TollInfo 封装路线上的收费信息。仅当我们预计该路线有收费站时，此字段才会显示。如果已设置此字段，但未填充推测价格的子字段，则我们预计该道路包含收费路段，但不知道估算价格。如果未设置此字段，则预计该路线上没有收费站。
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 燃料消耗预测（以微升为单位）。

路线出行模式

用于指定出行方式的一组值。注意：WALK、BICYCLE 和 TWO_WHEELER 路线目前处于 Beta 版阶段，有时可能没人行道、步行道或自行车道。您必须针对应用中显示的所有步行、骑车和双轮机动车路线显示此警告。

枚举
TRAVEL_MODE_UNSPECIFIED	未指定出行方式。默认为 DRIVE。
DRIVE	乘载客旅行。
BICYCLE	骑自行车旅行。
WALK	步行旅行。
TWO_WHEELER	双轮机动车。例如摩托车。请注意，这与涵盖人力模式的 BICYCLE 出行方式不同。

转送偏好设置

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

枚举
ROUTING_PREFERENCE_UNSPECIFIED	未指定路由偏好设置。默认为 TRAFFIC_UNAWARE。
TRAFFIC_UNAWARE	计算路线时不考虑实时路况信息。在路况不重要或不适用时适用。使用此值可实现最低的延迟时间。注意：对于 RouteTravelMode DRIVE 和 TWO_WHEELER，系统会根据道路网和与时间无关的平均路况信息来选择路线和时长。受道路网变化、平均路况信息更新以及该服务的分布式性质的影响，特定请求的结果可能会随时间的推移而发生变化。在任意时间或频率下，结果几乎相同，结果也可能有所差异。
TRAFFIC_AWARE	计算考虑实时路况信息的路线。与 TRAFFIC_AWARE_OPTIMAL 相比，应用某些优化可显著缩短延迟时间。
TRAFFIC_AWARE_OPTIMAL	在计算路线时考虑实时路况信息，而不应用大部分性能优化措施。使用此值可实现最长延迟时间。

快速读取间隔

多段线或路径的连续路段上的交通密度指示器。在给定了点 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	检测到交通拥堵。

收费信息

封装 Route 或 RouteLeg 上的通行费信息。

字段
estimated_price[]	Money 相应 Route 或 RouteLeg 的通行费的货币金额。此列表包含根据通行费站预计需支付的每种货币的金额。通常，对于包含采用某种货币的收费路线，此列表将只包含一项内容。对于国际行程，此列表可能包含多项以不同币种显示的通行费。

通行卡

我们所支持的全球通行卡的列表。

枚举
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	印度尼西亚。由多个银行提供的用于支付通行费的电子卡。所有通过银行签发的电子卡的费用都相同，因此只需要一个枚举值。例如，银行 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	印度，惠普州牌照豁免。
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，美国。
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS	美国阿拉斯加州。
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	德国。
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	美国伊利诺伊州
US_IL_IPASS	美国伊利诺伊州
US_IN_EZPASSIN	印度。
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	美国洛杉矶。
US_LA_TOLL_TAG	美国洛杉矶。
US_MA_EZPASSMA	MA。
US_MD_EZPASSMD	美国医学博士。
US_ME_EZPASSME	ME、USA。
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD	美国密歇根州
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG	美国密歇根州
US_MI_IQ_PROX_CARD	美国密歇根州
US_MI_MACKINAC_BRIDGE_MAC_PASS	美国密歇根州
US_MI_NEXPRESS_TOLL	美国密歇根州
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。
US_RI_EZPASSRI	罗得岛州。
US_SC_PALPASS	南卡罗来纳州美国。
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_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	美国西弗吉尼亚州。
US_WV_MEMORIAL_BRIDGE_TICKETS	美国西弗吉尼亚州。
US_WV_NEWELL_TOLL_BRIDGE_TICKET	美国西弗吉尼亚州。

单位

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

枚举
UNITS_UNSPECIFIED	未指定测量单位。默认为根据请求推断出的计量单位。
METRIC	公制单位。
IMPERIAL	英制（英文）单位。

车辆排放类型

描述车辆排放量的一组值。仅适用于云端硬盘出行模式。

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

车辆信息

封装车辆信息，例如车牌的最后一个字符。

字段
emission_type	VehicleEmissionType 描述车辆的排放类型。仅适用于云端硬盘出行模式。

关键点

封装航点。航点会标记路线的起点和终点，并包括沿途的中间站点。

字段
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”出行方式。
联合字段 location_type。表示营业地点的不同方式。location_type 只能是下列其中一项：
location	Location 使用地理坐标指定的点，包括可选方向。
place_id	string 与航点关联的 POI 地点 ID。
address	string 人类可读的地址或 Plus 代码。如需了解详情，请参阅 https://plus.codes。