索引
Routes
(接口)ComputeRouteMatrixRequest
(消息)ComputeRouteMatrixRequest.ExtraComputation
(枚举)ComputeRoutesRequest
(消息)ComputeRoutesRequest.ExtraComputation
(枚举)ComputeRoutesRequest.ReferenceRoute
(枚举)ComputeRoutesResponse
(消息)FallbackInfo
(消息)FallbackReason
(枚举)FallbackRoutingMode
(枚举)GeocodedWaypoint
(消息)GeocodingResults
(消息)LocalizedTime
(消息)Location
(消息)Maneuver
(枚举)NavigationInstruction
(消息)Polyline
(消息)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 |
---|
获取起点和终点列表,并返回一个流,其中包含起点和终点的每个组合的路线信息。 注意:此方法要求您在输入中指定响应字段掩码。您可以使用网址参数 例如,在此方法中:
请务必在字段掩码中添加
|
ComputeRoutes |
---|
根据一组终点和中间路标返回主路线和可选备选路线。 注意:此方法要求您在输入中指定响应字段掩码。您可以使用网址参数 例如,在此方法中:
Google 不建议使用通配符 (
|
ComputeRouteMatrixRequest
ComputeRouteMatrix 请求消息
字段 | |
---|---|
origins[] |
必需。起点数组,用于确定响应矩阵的行。以下几项大小限制适用于出发地和目的地的基数:
|
destinations[] |
必需。目的地数组,用于确定响应矩阵的列。 |
travel_mode |
可选。指定交通方式。 |
routing_preference |
可选。指定如何计算路由。服务器尝试使用所选的路由偏好设置来计算路由。如果路由偏好设置导致错误或延迟时间过长,则会返回错误。您只能在 |
departure_time |
可选。出发时间。如果未设置此值,则此值默认为您发出请求的时间。注意:当 |
arrival_time |
可选。到达时间。注意:只能在 |
language_code |
可选。BCP-47 语言代码,例如“en-US”或“sr-Latn”。如需了解详情,请参阅 Unicode 语言区域标识符。如需查看受支持语言的列表,请参阅语言支持。如果您未提供此值,系统会根据第一个出发地的位置推断显示语言。 |
region_code |
可选。地区代码,已指定为 ccTLD(“顶级域名”)双字符值。如需了解详情,请参阅国家/地区代码顶级域名。 |
units |
可选。指定显示字段的测量单位。 |
extra_computations[] |
可选。可用于完成请求的额外计算列表。注意:这些额外计算可能会在响应中返回额外字段。还必须在要在响应中返回的字段掩码中指定这些 extra 字段。 |
traffic_model |
可选。指定计算交通时间时要使用的假设条件。此设置会影响 |
transit_preferences |
可选。指定影响为 |
ExtraComputation
完成请求时要执行的额外计算。
枚举 | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
未使用。包含此值的请求将会失败。 |
TOLLS |
矩阵元素的费用信息。 |
ComputeRoutesRequest
ComputeRoutes 请求消息。
字段 | |
---|---|
origin |
必需。出发地航点。 |
destination |
必需。目的地航点。 |
intermediates[] |
可选。路线沿途的一组航点(不包括终点),用于停靠或经过。最多支持 25 个中间航点。 |
travel_mode |
可选。指定交通方式。 |
routing_preference |
可选。指定如何计算路由。服务器尝试使用所选的路由偏好设置来计算路由。如果路由偏好设置导致错误或延迟时间过长,则会返回错误。您只能在 |
polyline_quality |
可选。指定您对多段线质量的偏好。 |
polyline_encoding |
可选。指定多段线的首选编码。 |
departure_time |
可选。出发时间。如果未设置此值,则此值默认为您发出请求的时间。注意:当 |
arrival_time |
可选。到达时间。注意:只能在 |
compute_alternative_routes |
可选。指定除了路线之外,是否计算备选路线。对于包含中间航点的请求,系统不会返回备选路线。 |
route_modifiers |
可选。一组要满足的条件,它们会影响路线的计算方式。 |
language_code |
可选。BCP-47 语言代码,例如“en-US”或“sr-Latn”。如需了解详情,请参阅 Unicode 语言区域标识符。如需查看受支持语言的列表,请参阅语言支持。如果您未提供此值,系统会根据路线请求的位置推断显示语言。 |
region_code |
可选。地区代码,已指定为 ccTLD(“顶级域名”)双字符值。如需了解详情,请参阅国家/地区代码顶级域名。 |
units |
可选。指定显示字段的测量单位。这些字段包括 |
optimize_waypoint_order |
可选。如果设置为 true,该服务会尝试对指定的中间航点重新排序,从而尽量降低路线的总体成本。如果任何中间航点是 |
requested_reference_routes[] |
可选。指定除了默认路由之外,还要将哪些引用路由作为请求的一部分进行计算。参考路线是指路线计算目标与默认路线不同的路线。例如, |
extra_computations[] |
可选。可用于完成请求的额外计算列表。注意:这些额外计算可能会在响应中返回额外字段。还必须在要在响应中返回的字段掩码中指定这些 extra 字段。 |
traffic_model |
可选。指定计算交通时间时要使用的假设条件。此设置会影响 |
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
ComputeRoute 接收响应消息。
字段 | |
---|---|
routes[] |
指定 |
fallback_info |
在某些情况下,当服务器无法使用所有输入偏好设置计算路线结果时,可能会回退到使用其他计算方式。使用回退模式时,此字段包含有关回退响应的详细信息。否则,将取消设置此字段。 |
geocoding_results |
包含指定为地址的航点的地理编码响应信息。 |
FallbackInfo
与使用回退结果的方式和原因相关的信息。如果设置了此字段,则表示服务器使用了与您的首选模式不同的路由模式作为后备。
字段 | |
---|---|
routing_mode |
用于响应的路由模式。如果触发了回退,该模式可能与原始客户端请求中设置的路由偏好设置不同。 |
reason |
使用后备响应而不是原始响应的原因。只有在触发回退模式并返回回退响应时,系统才会填充此字段。 |
FallbackReason
使用回退响应的原因。
枚举 | |
---|---|
FALLBACK_REASON_UNSPECIFIED |
未指定回退原因。 |
SERVER_ERROR |
使用您偏好的路线模式计算路线时发生服务器错误,但我们能返回由替代模式计算出的结果。 |
LATENCY_EXCEEDED |
我们未能使用您的首选路线模式按时完成计算,但我们能返回由替代模式计算出的结果。 |
FallbackRoutingMode
用于返回的后备响应的实际路由模式。
枚举 | |
---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED |
未使用。 |
FALLBACK_TRAFFIC_UNAWARE |
表示使用 TRAFFIC_UNAWARE 计算响应。 |
FALLBACK_TRAFFIC_AWARE |
表示使用 TRAFFIC_AWARE 计算响应。 |
GeocodedWaypoint
有关用作航点的位置的详细信息。仅为地址航点填充。包含有关地理编码结果的详细信息,以便确定将地址进行地理编码。
字段 | |
---|---|
geocoder_status |
表示地理编码操作生成的状态代码。 |
type[] |
搜索结果的类型,是零个或零个以上的类型标记。支持的类型:地址类型和地址组成部分类型。 |
partial_match |
表示地理编码器无法返回与原始请求完全匹配的结果,尽管它能够匹配所请求的地址的一部分。您不妨检查一下原始请求中是否有拼写错误和/或地址不完整的情况。 |
place_id |
此结果的地点 ID。 |
intermediate_waypoint_request_index |
请求中相应中间航点的索引。仅当相应航点是中间航点时填充。 |
GeocodingResults
包含出发地、目的地和中间航点的
。仅为地址航点填充。GeocodedWaypoints
字段 | |
---|---|
origin |
经过地理编码的原点航点。 |
destination |
目的地经过地理编码的航点。 |
intermediates[] |
中间的地理编码路标列表,每个路标都包含一个索引字段,与从零开始的路标位置(按请求中指定的顺序)相对应。 |
LocalizedTime
本地化的时间说明。
字段 | |
---|---|
time |
以字符串形式指定的时间(以给定时区为准)。 |
time_zone |
包含时区。该值是 IANA 时区数据库中定义的时区名称,例如“America/New_York”。 |
位置
封装位置(地理点和可选标题)。
字段 | |
---|---|
lat_lng |
航点的地理坐标。 |
heading |
与车流方向相关联的罗盘航向。此值用于指定上车点和下车点的一侧。朝向值可介于 0 到 360 之间,其中 0 指定正北方位,90 指定正东方位,以此类推。您只能将此字段用于 |
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 |
用于表示街道名称变更。 |
Polyline
封装经过编码的多段线。
字段 | |
---|---|
联合字段 polyline_type 。封装多段线的类型。默认为 encoded_polyline。polyline_type 只能是下列其中一项: |
|
encoded_polyline |
使用多段线编码算法的字符串编码 |
geo_json_linestring |
使用 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[] |
|
legs[] |
构成路线的路程(航点之间的路径段)的集合。每段路程对应于两个非 |
distance_meters |
路线的行程距离(以米为单位)。 |
duration |
浏览路线所需的时间长度。如果您将 |
static_duration |
在不考虑路况信息的情况下沿路线行驶的时长。 |
polyline |
整体路线多段线。此多段线是所有 |
description |
路线的说明。 |
warnings[] |
显示路线时要显示的警告数组。 |
viewport |
多段线的视口边界框。 |
travel_advisory |
有关路线的更多信息。 |
optimized_intermediate_waypoint_index[] |
如果您将 |
localized_values |
|
route_token |
一个可在 Web 上安全使用、采用 base64 编码的路线令牌,可传递给 Navigation SDK,让 Navigation SDK 在导航期间重建路线,并在发生重新路线时遵循您创建路线时的最初意图(通过调用 ComputeRoutes 来实现)。客户应将此令牌视为不透明 blob。不适合读取或更改。注意: |
RouteLocalizedValues
某些属性的文本表示形式。
字段 | |
---|---|
distance |
以文本形式表示的行程距离。 |
duration |
考虑路况的时长,以文本形式表示。注意:如果您未请求路况信息,则此值与 |
static_duration |
不考虑路况信息的时长,以文本形式表示。 |
transit_fare |
以文本形式表示的公交费用。 |
RouteLabel
的标签,有助于识别路由的特定属性,以便与其他属性进行比较。Route
枚举 | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
默认 - 未使用。 |
DEFAULT_ROUTE |
为路线计算返回的默认“最佳”路线。 |
DEFAULT_ROUTE_ALTERNATE |
默认“最佳”路由的备用路由。指定 后,将返回这样的路由。 |
FUEL_EFFICIENT |
省油路线。系统确定带有此值的路线应针对节能参数(例如油耗)进行优化。 |
RouteLeg
包含非 via
航点之间的路段。
字段 | |
---|---|
distance_meters |
路线路程的行程距离(以米为单位)。 |
duration |
浏览腿部所需的时长。如果 |
static_duration |
经由路程的行程时长,计算时不考虑路况信息。 |
polyline |
这段路程的整体多段线,其中包括每个 |
start_location |
这段路程的起始位置。此位置可能与提供的 |
end_location |
这段路程的结束位置。此位置可能与提供的 |
steps[] |
一组路段,用于表示此路程中的路段。每个步骤表示一条导航指令。 |
travel_advisory |
包含用户应了解的其他信息,例如路线路程可能的交通区域限制。 |
localized_values |
|
steps_overview |
关于此 |
RouteLegLocalizedValues
某些属性的文本表示形式。
字段 | |
---|---|
distance |
以文本形式表示的行程距离。 |
duration |
考虑路况信息的时长,以文本形式表示。注意:如果您没有请求获取路况信息,则此值与 static_duration 相同。 |
static_duration |
不考虑路况信息的时长,以文本形式表示。 |
StepsOverview
提供关于 RouteLegStep
列表的概览信息。
字段 | |
---|---|
multi_modal_segments[] |
总结了有关 |
MultiModalSegment
提供有关 RouteLeg.steps
的不同多模态片段的摘要信息。多模态片段是指具有相同 RouteTravelMode
的一个或多个连续 RouteLegStep
。如果 RouteLeg
在步骤中不包含任何多模态片段,则系统不会填充此字段。
字段 | |
---|---|
navigation_instruction |
多模态细分的 NavigationInstruction。 |
travel_mode |
多模态路段的出行方式。 |
step_start_index |
作为多模态细分起点的相应 |
step_end_index |
多模态片段末尾对应的 |
RouteLegStep
包含
的一个片段。一个步骤对应一条导航指令。路线路程由路段组成。RouteLeg
字段 | |
---|---|
distance_meters |
此路段的行程距离(以米为单位)。在某些情况下,此字段可能没有值。 |
static_duration |
不考虑路况条件的情况下通过该路段的行程时长。在某些情况下,此字段可能没有值。 |
polyline |
与此步骤相关联的多段线。 |
start_location |
此步骤的起始位置。 |
end_location |
此步骤的结束位置。 |
navigation_instruction |
导航说明。 |
travel_advisory |
包含用户应了解的其他信息,例如腿部路段可能的交通区域限制。 |
localized_values |
|
transit_details |
有关此步骤的详细信息(如果出行方式为 |
travel_mode |
此路段使用的出行方式。 |
RouteLegStepLocalizedValues
某些属性的文本表示形式。
字段 | |
---|---|
distance |
以文本形式表示的行程距离。 |
static_duration |
不考虑路况信息的时长,以文本形式表示。 |
RouteLegStepTransitDetails
与 TRANSIT
路由相关的 RouteLegStep
的更多信息。
字段 | |
---|---|
stop_details |
相应路段的到达和离开经停点的相关信息。 |
localized_values |
|
headsign |
根据车辆或出发站上标记的指示,指定该线路的行进方向。方向通常为终点站。 |
headway |
将预期时间指定为同一车站当前两次发车之间的间隔时长。例如,当行驶秒数值为 600 时,如果您错过了一班公交,那么预计需要 10 分钟才能等到下一班。 |
transit_line |
此路段中所用公交线路的相关信息。 |
stop_count |
从出发地到到达站的经停次数。此计数包括到达站,但不包括出发站。例如,如果您的路线从站点 A 出发,途经站点 B 和 C,最终到达站点 D,stop_count 将返回 3。 |
trip_short_text |
显示在时间表和标牌中的文本,用于向乘客标识公交行程。文本应唯一地标识服务日内的行程。例如,“538”是指在工作日 15:10 从加利福尼亚州圣何塞出发前往加利福尼亚州萨克拉门托的 Amtrak 火车的 |
TransitDetailsLocalizedValues
RouteTransitDetails
值的本地化说明。
字段 | |
---|---|
arrival_time |
用相应时区表示的时间(采用相应格式的文本表示)。 |
departure_time |
用相应时区表示的时间(采用相应格式的文本表示)。 |
TransitStopDetails
有关RouteLegStep
的公交车站的详细信息。
字段 | |
---|---|
arrival_stop |
相应路段的到达站的相关信息。 |
arrival_time |
相应路段的预计到达时间。 |
departure_stop |
相应路段的出发车站的相关信息。 |
departure_time |
相应路段的预计出发时间。 |
RouteLegStepTravelAdvisory
包含应通知用户的其他信息,例如腿部路段可能的交通区域限制。
字段 | |
---|---|
speed_reading_intervals[] |
注意:此字段当前未填充。 |
RouteLegTravelAdvisory
包含用户需要了解的有关腿部步数的更多信息,例如可能的交通区域限制。
字段 | |
---|---|
toll_info |
包含特定 |
speed_reading_intervals[] |
详细路况密度的速度读取间隔。适用于 例如:
|
RouteMatrixDestination
ComputeRouteMatrixRequest 的单个目标
字段 | |
---|---|
waypoint |
必需。目的地航点 |
RouteMatrixElement
包含针对 ComputeRouteMatrix API 中的出发地/目的地对计算的路线信息。此 proto 可以流式传输到客户端。
字段 | |
---|---|
status |
此元素的错误状态代码。 |
condition |
指示是否找到了路线。与身份无关。 |
distance_meters |
路线的行程距离(以米为单位)。 |
duration |
浏览路线所需的时间长度。如果您将 |
static_duration |
在不考虑路况信息的情况下穿过路线的时长。 |
travel_advisory |
有关路线的更多信息。例如:限制信息和通行信息 |
fallback_info |
在某些情况下,当服务器无法根据此特定出发地/目的地对的指定偏好设置计算路线时,可能会回退到使用其他计算模式。使用回退模式时,此字段包含有关回退响应的详细信息。否则,将取消设置此字段。 |
localized_values |
|
origin_index |
请求中起点的索引(从零开始)。 |
destination_index |
请求中目的地的索引(从零开始)。 |
LocalizedValues
某些属性的文本表示形式。
字段 | |
---|---|
distance |
以文本形式表示的行程距离。 |
duration |
以文本形式表示的时长,同时考虑了路况。注意:如果未请求路况信息,则此值与 static_duration 相同。 |
static_duration |
以文本形式表示的时长(不考虑路况信息)。 |
transit_fare |
以文本形式表示的公交费用。 |
RouteMatrixElementCondition
所返回路线的使用情况。
枚举 | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
仅在元素的 status 不正常时使用。 |
ROUTE_EXISTS |
找到了路线,并为元素填写了相应信息。 |
ROUTE_NOT_FOUND |
找不到路线。系统不会在该元素中填写包含路线信息的字段(例如 distance_meters 或 duration )。 |
RouteMatrixOrigin
ComputeRouteMatrixRequest 的单个来源
字段 | |
---|---|
waypoint |
必需。出发地航点 |
route_modifiers |
可选。为以此作为出发地的每条路线添加修饰符 |
RouteModifiers
封装计算路由时要满足的一组可选条件。
字段 | |
---|---|
avoid_tolls |
设置为 true 时,系统会在合理情况下避开收费道路,并优先选择不包含收费道路的路线。仅适用于 |
avoid_highways |
设置为 true 时,系统会尽可能避开高速公路,并优先选择不包含高速公路的路线。仅适用于 |
avoid_ferries |
设置为 true 时,系统会在合理的范围内避开轮渡,并优先考虑不包含轮渡的路线。仅适用于 |
avoid_indoor |
设置为 true 时,将避免在合理情况下在室内导航,优先考虑不包含室内导航的路线。仅适用于 |
vehicle_info |
用于指定车辆信息。 |
toll_passes[] |
封装有关通行卡的信息。如果提供了通行卡,该 API 会尝试返回卡券价格。如果未提供通行卡,API 会将通行卡视为未知并尝试返回现金价格。仅适用于 |
RouteTravelAdvisory
包含应通知用户的其他信息,例如可能的交通区域限制。
字段 | |
---|---|
toll_info |
包含有关路线收费站的信息。仅当路线上预计有收费站时,系统才会填充此字段。如果设置了此字段,但未填充 |
speed_reading_intervals[] |
详细路况密度的速度读取间隔。适用于 例如:
|
fuel_consumption_microliters |
预计的耗油量(以微升为单位)。 |
route_restrictions_partially_ignored |
返回的路线可能包含不适合请求的出行方式或路线修饰符的限制。 |
transit_fare |
如果存在,则包含该路线的总票价或车票费用。此属性仅针对 |
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 |
计算路线时不考虑实时路况信息。适合在路况无关紧要或不适用时使用。使用该值可以实现最短延迟时间。请注意:对于 DRIVE 和TWO_WHEELER ,所选路线和时长取决于道路网和与时间无关的平均路况信息,而非当前路况信息。因此,路线中可能包括临时封闭的道路。受道路网变化、平均路况信息更新以及服务的分布式性质的影响,给定请求的结果可能会随时间的推移而发生变化。此外,在时间或频率不受限制的情况下,即使两条路线几乎相同,结果还是有可能不同。 |
TRAFFIC_AWARE |
计算路线时将实时路况信息考虑在内。与 TRAFFIC_AWARE_OPTIMAL 相反,应用会进行一些优化来显著缩短延迟时间。 |
TRAFFIC_AWARE_OPTIMAL |
在不应用大多数性能优化的情况下,计算路线时将实时路况信息考虑在内。使用此值会产生最长的延迟时间。 |
SpeedReadingInterval
多段线或路径的连续路段上的交通密度指示器。假设路径包含点 P_0、P_1、...、P_N(从零开始的索引),SpeedReadingInterval
会定义间隔并使用以下类别描述其流量。
字段 | |
---|---|
start_polyline_point_index |
多段线上此区间的起始索引。 |
end_polyline_point_index |
多段线中此间隔的结束索引。 |
联合字段
|
|
speed |
此时间间隔内的交通速度。 |
速度
根据路况数据对多段线速度的分类。
枚举 | |
---|---|
SPEED_UNSPECIFIED |
默认值。此值未使用。 |
NORMAL |
正常速度,未检测到行驶缓慢。 |
SLOW |
检测到行驶缓慢,但未形成交通拥堵。 |
TRAFFIC_JAM |
检测到交通堵塞。 |
TollInfo
字段 | |
---|---|
estimated_price[] |
相应 |
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 |
印度,惠普州牌豁免。 |
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 |
美国 CO。 |
US_CO_GO_PASS |
美国 CO。 |
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_KY_RIVERLINK |
美国肯塔基州。 |
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 |
此公交公司的名称。 |
phone_number |
因语言区域而异的公交公司电话号码。 |
uri |
公交公司的 URI。 |
TransitLine
包含此路段中所用公交线路的相关信息。
字段 | |
---|---|
agencies[] |
运营此公交线路的公交公司。 |
name |
该公交线路的全名,例如“本地 8 大道”。 |
uri |
该公交线路的 URI(由公交公司提供)。 |
color |
此线路站牌中常用的颜色。以十六进制表示。 |
icon_uri |
与此线路相关联的图标的 URI。 |
name_short |
该公交线路的简称。此名称通常是线路号,例如“M7”或“355”。 |
text_color |
该线路站牌上的文字中常用的颜色。以十六进制表示。 |
vehicle |
此公交线路所运行的交通工具类型。 |
TransitPreferences
基于TRANSIT
的路线的偏好设置,这些路线会影响返回的路线。
字段 | |
---|---|
allowed_travel_modes[] |
在获取 |
routing_preference |
路由偏好设置,指定后会影响返回的 |
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 |
公交经停点的名称。 |
location |
经停点的位置(以纬度/经度坐标表示)。 |
TransitVehicle
公交路线中使用的车辆的相关信息。
字段 | |
---|---|
name |
此车辆的名称,采用首字母大写形式。 |
type |
所用车辆的类型。 |
icon_uri |
与此交通工具类型相关联的图标的 URI。 |
local_icon_uri |
与此交通工具类型相关联的图标的 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 |
描述车辆的排放类型。仅适用于 |
关键点
封装航点。航点会标记路线的起点和终点,并包括路线沿途的中间停靠站。
字段 | |
---|---|
via |
将此航点标记为里程碑,而不是停止点。对于请求中的每个非 Waymo 航点,响应会在 |
vehicle_stopover |
表示航点是供车辆停靠的车辆,目的是上车点或下车点。如果您设置了这个值,计算的路线将不会包含不适合上车和下车的道路上的非 |
side_of_road |
表示此航点的位置应首选让车辆停在道路的某一侧。设置此值后,路线将穿过该位置,以便车辆能够在该位置偏向于道路中心的那一侧道路。此选项仅适用于 |
联合字段 location_type 。表示位置的不同方式。location_type 只能是下列其中一项: |
|
location |
使用地理坐标指定的点,包括可选的朝向。 |
place_id |
与航点相关联的地图注点地点 ID。 |
address |
直观易懂的地址或 Plus 代码。如需了解详情,请参阅 https://plus.codes。 |