Package google.maps.routing.v2

索引

路线

Routes API。

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

注意:此方法要求您在输入中指定响应字段掩码。您可以使用网址参数 $fieldsfields,或使用 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)

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

注意:此方法要求您在输入中指定响应字段掩码。您可以使用网址参数 $fieldsfields,或使用 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_idaddress 的起点数量 + 终点数量的总和不得超过 50。
  • 无论如何,起点数量 × 目的地数量的乘积不得超过 625。
  • 如果 routing_preference 设为 TRAFFIC_AWARE_OPTIMAL,则起点数量 × 目的地数量的乘积不得超过 100。
  • 如果 travel_mode 设置为 TRANSIT,则出发地数量 × 目的地数量的乘积不得超过 100。
destinations[]

RouteMatrixDestination

必需。目的地数组,用于确定响应矩阵的列。

travel_mode

RouteTravelMode

可选。指定交通方式。

routing_preference

RoutingPreference

可选。指定如何计算路线。服务器会尝试使用所选的路由偏好设置来计算路由。如果路由偏好设置导致错误或延迟时间过长,则会返回错误。只有当 travel_modeDRIVETWO_WHEELER 时,您才能指定此选项,否则请求会失败。

departure_time

Timestamp

可选。出发时间。如果您未设置此值,则此值默认为您发出请求的时间。注意:只有在将 RouteTravelMode 设置为 TRANSIT 时,您才能指定过去的 departure_time

arrival_time

Timestamp

可选。到达时间。注意:仅当 RouteTravelMode 设置为 TRANSIT 时才能设置此项。您可以指定 departure_timearrival_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 字段中返回的值,该值包含根据历史平均数据预测的交通时间。RoutingPreferenceTRAFFIC_AWARE_OPTIMALRouteTravelModeDRIVE。如果请求了流量但未指定 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_modeDRIVETWO_WHEELER 时,您才能指定此选项,否则请求会失败。

polyline_quality

PolylineQuality

可选。指定多段线的质量偏好设置。

polyline_encoding

PolylineEncoding

可选。指定多段线的首选编码。

departure_time

Timestamp

可选。出发时间。如果您未设置此值,则此值默认为您发出请求的时间。注意:只有在将 RouteTravelMode 设置为 TRANSIT 时,您才能指定过去的 departure_time。公交行程最长可查询过去 7 天或未来 100 天内的信息。

arrival_time

Timestamp

可选。到达时间。注意:仅当 RouteTravelMode 设置为 TRANSIT 时才能设置此项。您可以指定 departure_timearrival_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

可选。指定计算交通时间时所用的假设条件。此设置会影响 RouteRouteLeg 中 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 文本字符串的形式呈现。此内容应按原样读取。此内容仅供展示。请勿以程序化方式解析它。

ReferenceRoute

ComputeRoutesRequest 中受支持的参考路线。

枚举
REFERENCE_ROUTE_UNSPECIFIED 未使用。包含此值的请求会失败。
FUEL_EFFICIENT 省油路线。
SHORTER_DISTANCE

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

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

对于 BICYCLETWO_WHEELER 请求,此功能返回的路线与您未指定 requested_reference_routes 时返回的路线类似。

此功能不适用于任何其他交通方式、通过中间航点或 optimize_waypoint_order 的路线;此类请求将会失败。不过,您可以将其与任何 routing_preference 搭配使用。

ComputeRoutesResponse

计算响应消息的路线。

字段
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 表示正东,以此类推。您只能将此字段用于 DRIVETWO_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 用于指示街道名称变更。

封装 RouteLegStep 的导航说明。

字段
maneuver

Maneuver

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

instructions

string

此步骤的操作说明。

折线

封装编码多段线。

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

string

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

geo_json_linestring

Struct

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

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 中间航点的路线有一个航段。相应路段的顺序与航点的顺序(从 originintermediatesdestination)一致。

distance_meters

int32

相应路线的行程距离(以米为单位)。

duration

Duration

导航路线所需的时间。如果您将 routing_preference 设为 TRAFFIC_UNAWARE,则此值与 static_duration 相同。如果您将 routing_preference 设置为 TRAFFIC_AWARETRAFFIC_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_AWARETRAFFIC_AWARE_OPTIMAL 的请求。Route.route_token 不支持包含经停航点的请求。

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_preferenceTRAFFIC_AWARETRAFFIC_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

将预计时间指定为目前同一车站各次发车之间的时长。例如,当 headway 秒值为 600 时,如果您错过了一班公交,那么预计需要 10 分钟才能等到下一班。

transit_line

TransitLine

此步骤中所用公交线路的相关信息。

stop_count

int32

从出发站到到达站之间的经停点数。此计数包含到达站,但不含出发站。例如,如果您的路线是从 A 站出发,途经 B 站和 C 站,最终到达 D 站,

stop_count

返回 3。

trip_short_text

string

时刻表和标志牌上显示的文本,用于向乘客标识公交行程。该文字应能唯一标识服务日内的行程。例如,“538”是周一至周五下午 3:10 从加利福尼亚州圣何塞出发前往加利福尼亚州萨克拉门托的 Amtrak 火车的 trip_short_text

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_AWARETRAFFIC_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_AWARETRAFFIC_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_metersduration

RouteMatrixOrigin

ComputeRouteMatrixRequest 的单个来源

字段
waypoint

Waypoint

必需。起点航点

route_modifiers

RouteModifiers

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

RouteModifiers

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

字段
avoid_tolls

bool

设置为 true 时,会在合理的情况下避开收费道路,优先选择不含收费道路的路线。仅适用于 DRIVETWO_WHEELER RouteTravelMode

avoid_highways

bool

如果设置为 true,则会在合理的情况下避开高速公路,优先选择不含高速公路的路线。仅适用于 DRIVETWO_WHEELER RouteTravelMode

avoid_ferries

bool

如果设置为 true,则会在合理的情况下避开轮渡,优先选择不含轮渡的路线。仅适用于 DRIVETWO_WHEELER RouteTravelMode

avoid_indoor

bool

设置为 true 时,会在合理情况下避免在室内导航,优先选择不包含室内导航的路线。仅适用于 WALK RouteTravelMode

vehicle_info

VehicleInfo

指定车辆信息。

toll_passes[]

TollPass

封装有关过路卡的信息。如果提供了过路卡,API 会尝试返回过路卡价格。如果未提供过路费卡,API 会将过路费卡视为未知,并尝试返回现金价格。仅适用于 DRIVETWO_WHEELER RouteTravelMode

RouteTravelAdvisory

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

字段
toll_info

TollInfo

包含有关路线上收费信息的信息。只有在路线上预计有收费路段时,系统才会填充此字段。如果已设置此字段,但未填充 estimatedPrice 子字段,则表示相应路线包含过路费,但估算价格未知。如果未设置此字段,则表示相应路线没有预计的过路费。

speed_reading_intervals[]

SpeedReadingInterval

速度读数间隔,详细说明交通密度。适用于 TRAFFIC_AWARETRAFFIC_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

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

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

RoutingPreference

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

枚举
ROUTING_PREFERENCE_UNSPECIFIED 未指定路由偏好设置。默认为 TRAFFIC_UNAWARE
TRAFFIC_UNAWARE 计算路线时不考虑实时路况。当交通状况不重要或不适用时,此值适用。使用此值可产生最短的延迟时间。注意:对于 RouteTravelModeDRIVETWO_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

封装 RouteRouteLeg 上的过路费信息。

字段
estimated_price[]

Money

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

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_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 乘火车出行。这等同于 SUBWAYTRAINLIGHT_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 航点。此选项仅适用于 DRIVETWO_WHEELER 出行方式,并且 location_typeLocation 时有效。

side_of_road

bool

表示此航点的位置旨在让车辆优先停靠在道路的特定侧。设置此值后,路线将穿过相应位置,以便车辆在相应位置偏离道路中心的一侧停车。此选项仅适用于 DRIVETWO_WHEELER RouteTravelMode

联合字段 location_type。表示地理位置的不同方式。location_type 只能是下列其中一项:
location

Location

使用地理坐标指定的点,包括可选的航向。

place_id

string

与航点关联的地图注点地点 ID。

address

string

可读的地址或 Plus Code。如需了解详情,请参阅 https://plus.codes