索引
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[] |
可选。可用于完成请求的额外计算的列表。注意:这些额外的计算可能会在响应中返回额外字段。此外,您还必须在要在响应中返回的字段掩码中指定这些额外字段。 |
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[] |
可选。可用于完成请求的额外计算的列表。注意:这些额外的计算可能会在响应中返回额外字段。您还必须在要在响应中返回的字段掩码中指定这些额外字段。 |
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
ComputeRoutes 响应消息。
字段 | |
---|---|
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_type 。用于封装多段线的类型。默认为 encoded_多段线。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 |
一个可在网络上安全、采用 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 |
印度尼西亚。多家银行提供的电子卡,用于支付通行费。通过银行发送的所有电子卡都采用相同的计费方式,因此只需要一个枚举值。例如:- 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_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 Avenue Local”。 |
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 |
将此航点标记为里程碑,而不是停止点。对于请求中的每个非经由航点,响应会在 |
vehicle_stopover |
表示航点供车辆停靠,且目的是上车或下车。设置此值后,计算的路线将不会包含不适合上车点和下车点的道路上的非 |
side_of_road |
表示此航点的位置优先让车辆停靠在道路的某一侧。设置此值后,路线会经过相应位置,这样车辆才能在偏离道路中心的道路一侧停靠。此选项仅适用于 |
联合字段 location_type 。表示位置的不同方式。location_type 只能是下列其中一项: |
|
location |
使用地理坐标指定的点,包含可选标题。 |
place_id |
与航点相关联的地图注点地点 ID。 |
address |
人类可读的地址或 Plus 代码。如需了解详情,请参阅 https://plus.codes。 |