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

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

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	省油路线。
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 包含指定为地址的途经点的地理编码响应信息。

FallbackInfo

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

字段
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 中间地理编码航点的列表，每个航点都包含一个索引字段，该字段对应于航点在请求中指定的顺序中的从零开始的位置。

LocalizedTime

时间的本地化说明。

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

位置

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

字段
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 格式指定折线。

PolylineDetails

与多段线的指定索引或连续段对应的详细信息。对于具有点 P_0、P_1、...、P_N（从零开始的索引）的折线，PolylineDetails 定义了一个区间和关联的元数据。

字段
flyover_info[]	FlyoverInfo 沿多段线的飞掠详情。
narrow_road_info[]	NarrowRoadInfo 沿多段线的狭窄道路的详细信息。

FlyoverInfo

封装了沿折线的飞掠信息。

字段
flyover_presence	RoadFeatureState 仅限输出。表示多段线的指定一段是否存在飞掠效果。
polyline_point_index	PolylinePointIndex 沿折线的飞掠相关信息的位置。

NarrowRoadInfo

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

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

PolylinePointIndex

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

字段
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 中的步骤不包含任何多模式路段，则不会填充此字段。

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 采用格式化文本表示形式的时间，以及相应的时区。

TransitStopDetails

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

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

RouteLegStepTravelAdvisory

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

字段
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).

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 在某些情况下，如果服务器无法根据给定的偏好设置计算特定起点/终点对的路线，则可能会改用其他计算模式。使用回退模式时，此字段包含有关回退响应的详细信息。否则，系统将取消设置此字段。
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 可选。将此作为起点的每条路线的修饰符

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	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，美国。
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。