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。
  • 如果路由_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 中的时长字段中返回的值,其中包含根据历史平均值预测的交通时间。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 参考路线计算会考虑生成最优燃料效率路线的各种参数。

extra_computations[]

ExtraComputation

可选。可用于完成请求的额外计算的列表。注意:这些额外的计算可能会在响应中返回额外字段。您还必须在要在响应中返回的字段掩码中指定这些额外字段。

traffic_model

TrafficModel

可选。指定计算交通时间时要使用的假设条件。此设置会影响 RouteRouteLeg 中的时长字段中返回的值,该值包含根据历史平均值预测的交通时间。TrafficModel 仅适用于将 RoutingPreference 设置为 TRAFFIC_AWARE_OPTIMALRouteTravelMode 设置为 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 省油路线。标有此值的路线被确定为针对燃料消耗等参数进行优化。

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 指定方向正北方,依此类推。您只能将此字段用于 DRIVETWO_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 用于表示街道名称更改。

封装 RouteLegStep 的导航说明。

字段
maneuver

Maneuver

封装当前步骤的导航说明(例如左转、合并或笔直)。此字段确定要显示的图标。

instructions

string

有关导航步骤的说明。

折线

封装编码多段线。

字段
联合字段 polyline_type。用于封装多段线的类型。默认为 encoded_多段线。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 中间航点的路线有两段路程。包含 1 个 via 中间航点的路线有一段路程。路程顺序与从 originintermediates 再到 destination 的航点顺序一致。

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,则此字段包含中间航点的优化顺序。否则,此字段为空。例如,如果您输入 Origin: LA;中间航点:达拉斯、班戈、菲尼克斯;目的地:纽约;且优化的中间航点顺序为菲尼克斯、达拉斯、班戈,则此字段会包含值 [2, 0, 1]。对于输入中提供的第一个中间航点,索引从 0 开始。

localized_values

RouteLocalizedValues

Route 属性的文本表示形式。

route_token

string

一个可在网络上安全、采用 base64 编码的路线令牌,可传递给 Navigation SDK,使 Navigation SDK 能够在导航期间重建路线,并且在重新规划路线时,通过调用 ComputeRoutes 遵循创建路线时的最初意图。客户应将此令牌视为不透明 blob。不要比较它的值 - 即使返回了完全相同的路线,此令牌也可能会更改。注意:Route.route_token 仅适用于将 ComputeRoutesRequest.routing_preference 设置为 TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL 的请求。包含 Via 航点的请求不支持 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 省油路线。标有此值的路线被确定为针对节能参数(例如燃料消耗)进行优化。

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中的步骤的概览信息。只有 TRANSIT 路线时填充此字段。

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

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

transit_line

TransitLine

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

stop_count

int32

从出发到到达站的经停次数。此计数包含到达站点,但不包括出发站点。例如,如果您的路线从站点 A 出发,途经站点 B 和 C,然后到达站点 D,则 stop_count 将返回 3。

trip_short_text

string

显示在时刻表和标牌中的文本,用于向乘客标识公交行程。该文本应唯一标识服务日内的行程。例如:“538”是工作日 15: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上会有收费站时,才会填充此字段。如果设置了此字段,但未填充 estimate_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 不适用时使用。
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 计算路线时不考虑实时路况信息。在路况不重要或不适用时使用。使用此值可最大限度减少延迟时间。注意:对于RouteTravelModeDRIVE)和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

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 印度尼西亚。多家银行提供的电子卡,用于支付通行费。通过银行发送的所有电子卡都采用相同的计费方式,因此只需要一个枚举值。例如:- 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 印度,惠普州车牌豁免。
JP_ETC Japan ETC。用于收取通行费的电子无线系统。https://www.go-etc.jp/
JP_ETC2 Japan 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 美国亚拉巴马州。
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 美国堪萨斯州。
US_KS_KTAG 美国堪萨斯州。
US_KS_NATIONALPASS 美国堪萨斯州。
US_KS_PREPASS_ELITEPASS 美国堪萨斯州。
US_LA_GEAUXPASS 美国洛杉矶。
US_LA_TOLL_TAG 美国洛杉矶。
US_MA_EZPASSMA 美国马萨诸塞州。
US_MD_EZPASSMD 美国马里兰州。
US_ME_EZPASSME 我,美国。
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD 美国密歇根州。
US_MI_BCPASS 美国密歇根州。
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG 美国密歇根州。
US_MI_IQ_PROX_CARD

美国密歇根州。已弃用,因为此卡券类型已不存在。

US_MI_IQ_TAG 美国密歇根州。
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 美国宾夕法尼亚州。
US_RI_EZPASSRI 美国罗得岛州。
US_SC_PALPASS 美国南卡罗来纳州。
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 美国西弗吉尼亚州。
US_WV_MEMORIAL_BRIDGE_TICKETS 美国西弗吉尼亚州。
US_WV_MOV_PASS 美国西弗吉尼亚州
US_WV_NEWELL_TOLL_BRIDGE_TICKET 美国西弗吉尼亚州。

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 代码。如需了解详情,请参阅 https://plus.codes