索引
DynamicAttributeService
(界面)Routes
(界面)AnnotatePathsRequest
(消息)AnnotatePathsResponse
(消息)AnnotatedPath
(消息)AnnotatedSegment
(消息)AnnotationOptions
(消息)ComputeRouteMatrixRequest
(消息)ComputeRouteMatrixRequest.ExtraComputation
(枚举)ComputeRoutesRequest
(消息)ComputeRoutesRequest.ExtraComputation
(枚举)ComputeRoutesRequest.ReferenceRoute
(枚举)ComputeRoutesResponse
(消息)FallbackInfo
(消息)FallbackReason
(枚举)FallbackRoutingMode
(枚举)GeocodedWaypoint
(消息)GeocodingResults
(消息)LevelOfService
(枚举)LocalizedTime
(消息)Location
(消息)Maneuver
(枚举)NavigationInstruction
(消息)Path
(消息)Polyline
(消息)PolylineDetails
(消息)PolylineDetails.AltitudeInfo
(消息)PolylineDetails.FerryInfo
(消息)PolylineDetails.HighwayInfo
(消息)PolylineDetails.HovInfo
(消息)PolylineDetails.IncidentInfo
(消息)PolylineDetails.IncidentInfo.IncidentType
(枚举)PolylineDetails.PolylinePointIndex
(消息)PolylineDetails.PredictedSpeedInfo
(消息)PolylineDetails.PredictedSpeedInterval
(消息)PolylineDetails.RestrictionInfo
(消息)PolylineDetails.RoadFeatureState
(枚举)PolylineDetails.SegmentInfo
(消息)PolylineDetails.TollInfo
(消息)PolylineDetails.TunnelInfo
(消息)PolylineDetails.VignetteInfo
(消息)PolylineEncoding
(枚举)PolylineQuality
(枚举)Route
(消息)Route.RouteLocalizedValues
(消息)Route.RouteTokenUpdateFidelity
(枚举)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
(消息)RouteModifiers.HOVPreference
(消息)RouteTokenOptions
(消息)RouteTokenOptions.RouteTokenBehavior
(枚举)RouteTravelAdvisory
(消息)RouteTravelAdvisory.VignetteInfo
(消息)RouteTravelMode
(枚举)RoutingPreference
(枚举)Segment
(消息)SegmentSpan
(消息)SegmentSpanAttribute
(消息)SpeedReadingInterval
(消息)SpeedReadingInterval.Speed
(枚举)TollInfo
(消息)TollPass
(枚举)TrafficModel
(枚举)TransitAgency
(消息)TransitLine
(消息)TransitPreferences
(消息)TransitPreferences.TransitRoutingPreference
(枚举)TransitPreferences.TransitTravelMode
(枚举)TransitStop
(消息)TransitVehicle
(消息)TransitVehicle.TransitVehicleType
(枚举)Units
(枚举)VehicleEmissionType
(枚举)VehicleInfo
(消息)VehicleInfo.TrailerInfo
(消息)Waypoint
(消息)
DynamicAttributeService
包含 AnnotatePaths API 的动态属性服务。
AnnotatePaths |
---|
返回基于输入段的路径,以及路径沿途动态属性的注释。 |
路由
Routes API。
ComputeRouteMatrix |
---|
获取出发地和目的地列表,并返回包含每种出发地和目的地组合的路线信息的数据流。 注意:此方法要求您在输入中指定响应字段掩码。您可以通过以下两种方式提供响应字段掩码:使用网址参数 例如,在此方法中:
请务必在字段掩码中加入
|
ComputeRoutes |
---|
在给定一组终端和中间航点的情况下,返回主路线以及可选的备选路线。 注意:此方法要求您在输入中指定响应字段掩码。您可以通过以下两种方式提供响应字段掩码:使用网址参数 例如,在此方法中:
Google 不建议使用通配符 (
|
AnnotatePathsRequest
对 AnnotatePaths API 的请求。这些路径带有注释,就像车辆在当前时间开始行驶的每条路径一样。
路段上的注释可能会因其所属的路径而异,例如,相同的路段 A 可能存在于路径 1 和路径 2 中。在路径 1 中,路段 A 后跟路段 B,在路径 2 中,路段 A 后跟路段 C。根据后续细分的差异,细分 A 可能会为路径 1 和路径 2 返回不同的动态属性。
字段 | |
---|---|
paths[] |
必需。将使用动态属性数据填充的已请求路线。所有路径都应具有相同的起始路段,即车辆目前所在的路段。系统会假定车辆在第一段的起点处。如果路径并非以同一段开头,则会返回错误。 |
annotation_options |
必需。所请求的动态数据属性,应添加到输入路径中。如果为空,则系统不会对该请求进行注释。 |
AnnotatePathsResponse
AnnotatePathsResponse 包含输入路径,以及为所有请求注释添加的额外数据。
字段 | |
---|---|
annotated_paths[] |
使用请求的属性进行注解的输入中的路径。 |
AnnotatedPath
包含预测属性返回的输入路径的副本。
字段 | |
---|---|
annotated_segments[] |
构成主路径的路段有序列表,带有所请求的属性注解。 |
AnnotatedSegment
用于构建路径的线段,带有动态数据属性注释。
字段 | |
---|---|
segment |
用于将其与其他细分受众群区分开来的细分受众群详细信息。 |
segment_span_attributes[] |
分配给此细分的属性。这些属性可能会因路段所在的路径而异。一个 span 可能会覆盖整个片段。属性 span 将按照从车辆位置到路径末尾的正前顺序排列。 |
AnnotationOptions
已请求的输入路径的注解。
字段 | |
---|---|
include_level_of_service |
可选。如果设置为 true,系统会使用预测的流量值对响应中的细分进行注释。“服务级别”是描述流量分类的常用术语,但此 API 中的服务定义级别仅属于此 API。 |
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[] |
可选。可用于完成请求的额外计算的列表。注意:这些额外的计算可能会在响应中返回额外字段。您还必须在要在响应中返回的字段掩码中指定这些额外字段。 |
route_token |
可选。已弃用:请改用 |
route_token_options |
可选。路由令牌允许请求依赖于之前选择的路由。 |
traffic_model |
可选。指定计算交通时间时要使用的假设条件。此设置会影响 |
transit_preferences |
可选。指定影响为 |
navigation_session_id |
可选。客户端生成的导航会话 ID,用于将此路线请求与客户端导航日志相关联,以进行导航分析。这应该是随机生成的符合 RFC 4122 规范的 UUID,并且是特定导航会话所独有的。 |
ExtraComputation
完成请求时要执行的额外计算。
枚举 | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
未使用。包含此值的请求将失败。 |
TOLLS |
路线的收费信息。 |
FUEL_CONSUMPTION |
路线的估算燃料消耗量。 |
TRAFFIC_ON_POLYLINE |
路线的可感知路况的多段线。 |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions ,以格式化的 HTML 文本字符串表示。此内容应按原样阅读,且仅用于展示。请勿以程序化方式对其进行解析。 |
PREDICTED_SPEED_ON_POLYLINE_20KPH_BUCKETS |
预测的速度为 20 公里/小时。以下 中的结果:[0, 10) kph、[10, 30) kph、... [110, 130) kph、[130, inf) kph。 |
PREDICTED_SPEED_ON_POLYLINE_10KPH_BUCKETS |
预测的速度为 10 公里/小时。以下 中的结果:[0, 10) kph、[10, 20) kph、... [120, 130) kph、[130, inf) kph。 |
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[] |
经过地理编码的中间路标列表,其中每个路标包含一个索引字段,该索引字段对应于航点(按照请求中指定的顺序)从零开始的位置。 |
LevelOfService
与一般流量级别对应的预测流量范围值,用于 ADAS 功能。此 API 返回的值是独立的,不应依赖它来对应其他 API。
枚举 | |
---|---|
LEVEL_OF_SERVICE_UNSPECIFIED |
默认值。该值表示没有预测的流量值可供选择。 |
LEVEL_OF_SERVICE_STOPPED |
已停止流量。 |
LEVEL_OF_SERVICE_STOP_AND_GO |
交通堵塞。 |
LEVEL_OF_SERVICE_SLOW |
预计会行驶缓慢,但不会造成交通堵塞。 |
LEVEL_OF_SERVICE_NORMAL |
车速正常,预计不会减速。 |
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 |
用于表示街道名称更改。 |
路径
请求动态属性的路径。
路径应包含已连接且可行驶的路段。假定路径的路段遵循一条逻辑路线;如果在输入路段上找不到某条路线,则会返回错误。例如,如果路径中的路段没有连接端点或者路径为空,则会产生错误。
路径目前的长度限制为 15 公里。路径是从第一个路段(假定车辆位置)的起点开始测量的。如果路径中某段的起点离第一个路段的起点超过 15 公里,将返回错误。最后一个路段的开始时间可以早于 15 公里,结束时间可以超过 15 公里。不会返回部分响应。
路径可以包含与另一路径相同的路段,但路段注释也可能根据路径其他部分的不同包含不同的响应。
字段 | |
---|---|
segments[] |
必需。形成路径的路段有序列表。 |
Polyline
封装编码多段线。
字段 | |
---|---|
联合字段 polyline_type 。用于封装多段线的类型。默认为 encoded_多段线。polyline_type 只能是下列其中一项: |
|
encoded_polyline |
采用多段线编码算法的多段线的字符串编码 |
geo_json_linestring |
使用 GeoJSON LineString 格式指定多段线。 |
PolylineDetails
对应于多段线的给定索引或连续线段的详细信息。假设多段线包含点 P_0、P_1、...、P_N(从零开始的索引),PolylineDetails
会定义间隔和关联的元数据。
字段 | |
---|---|
altitude_info[] |
沿多段线的海拔高度详情。 |
incident_info[] |
沿多段线的突发事件详情。 |
segment_info[] |
沿着多段线分割详情。 |
ferry_info[] |
沿多段线的轮渡详情。仅当请求指定了 |
highway_info[] |
沿多段线的公路详情。仅当请求指定了 |
toll_info[] |
沿多段线的收费详情。仅当请求指定了 |
tunnel_info[] |
沿多段线的隧道详情。仅当请求指定了 |
vignette_info[] |
沿多段线的晕影详情。仅当请求指定了 |
hov_info[] |
沿多段线的 Hov 详情。仅当请求指定了 |
restriction_info[] |
沿多段线的限制详情。仅当请求指定了 |
predicted_speeds[] |
沿多段线的预测速度分区。 |
AltitudeInfo
沿着多段线封装有关海拔高度的信息。
字段 | |
---|---|
polyline_point_index |
沿多段线的海拔测量地点。 |
altitude_meters |
相对于 WGS-84 椭球体的高度(以米为单位)。 |
FerryInfo
封装多段线沿线的轮渡信息。
字段 | |
---|---|
ferry_presence |
仅限输出。表示在多段线的给定段中是否存在轮渡。 |
polyline_point_index |
沿多段线的轮渡相关信息的位置。 |
HighwayInfo
用于封装沿多段线的公路的相关信息。
字段 | |
---|---|
highway_presence |
仅限输出。表示多段线的给定一段中是否存在公路。 |
polyline_point_index |
沿多段线的公路相关信息的位置。 |
HovInfo
用于封装沿多段线的高承载率车辆路段/车道的相关信息。
字段 | |
---|---|
hov_presence |
仅限输出。用于指明多段线的给定延伸段中是否存在高承载率车辆道/车道。 |
polyline_point_index |
沿多段线的高承载率车辆相关信息的位置。 |
IncidentInfo
用于封装沿多段线的事件相关信息。
字段 | |
---|---|
incident_type |
突发事件的类型。 |
estimated_delay |
相对于正常遍历时间的预计延迟。仅针对 INCIDENT_JAM 返回。 |
polyline_point_index |
沿多段线的突发事件位置。 |
IncidentType
突发事件的类型。
枚举 | |
---|---|
INCIDENT_TYPE_UNSPECIFIED |
默认值。此值未使用。 |
INCIDENT_ROAD_CLOSED |
封路。 |
INCIDENT_CRASH |
车祸。 |
INCIDENT_CONSTRUCTION |
施工。 |
INCIDENT_JAM |
交通堵塞。 |
PolylinePointIndex
封装多段线详情的起始索引和结束索引。对于数据对应于单个点的实例,start_index
和 end_index
相等。
字段 | |
---|---|
start_index |
此详情在多段线上的起始索引。 |
end_index |
此详情在多段线上的结束索引。 |
PredictedSpeedInfo
封装沿多段线的预测速度信息。
字段 | |
---|---|
predicted_speed_interval |
在多段线的这一部分上预测的速度范围。 |
polyline_point_index |
沿多段线的预测速度间隔的位置。 |
PredictedSpeedInterval
灵活的预测速度区间,以 [lower_bound_kph_inclusive
, upper_bound_kph_exclusive
为单位表示速度)。返回的区间取决于请求中指定的
。extra_computations
字段 | |
---|---|
lower_bound_kph_inclusive |
包含性下限。 |
upper_bound_kph_exclusive |
独占上限。未填充时,表示无穷大。 |
RestrictionInfo
用于封装沿多段线各种限制的信息。
字段 | |
---|---|
restriction_presence |
仅限输出。用于指明多段线的给定拉伸是否存在限制。 |
polyline_point_index |
沿多段线的限制相关信息的位置。 |
联合字段 restriction 。用于封装可应用于多段线指定拉伸的限制类型。restriction 只能是下列其中一项: |
|
restricted_height_mm |
高度限制,以毫米为单位。当限制的高度无法通行,或导致指定车辆的净空间较低时,系统就会填充此字段。 |
RoadFeatureState
封装多段线延伸段的道路地图项(例如,高速公路、轮渡等)的状态。
枚举 | |
---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
未计算该道路地图项的状态(默认值)。 |
EXISTS |
该道路地图项已存在。 |
DOES_NOT_EXIST |
此道路地图项不存在。 |
SegmentInfo
用于封装沿多段线的线段的相关信息。
字段 | |
---|---|
place_id |
此路段的地点 ID。 |
polyline_point_index |
沿多段线的线段的位置。 |
TollInfo
用于封装多段线沿线的收费站信息。
字段 | |
---|---|
toll_presence |
仅限输出。用于指明多段线的给定拉伸上是否存在收费站。 |
polyline_point_index |
沿多段线的收费站相关信息的位置。 |
TunnelInfo
封装沿多段线的隧道的相关信息。
字段 | |
---|---|
tunnel_presence |
仅限输出。用于指明多段线的给定拉伸上是否存在隧道。 |
polyline_point_index |
沿多段线的隧道相关信息的位置。 |
VignetteInfo
用于封装沿多段线的晕影效果信息。
字段 | |
---|---|
vignette_presence |
仅限输出。表示多段线的给定拉伸是否存在晕影。 |
polyline_point_index |
沿多段线的晕影相关信息的位置。 |
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。不要比较它的值 - 即使返回了完全相同的路线,此令牌也可能会更改。注意: |
route_token_update_fidelity |
对于包含 |
polyline_details |
包含多段线沿线的详情信息。 |
RouteLocalizedValues
某些属性的文本表示。
字段 | |
---|---|
distance |
以文本形式表示的行程距离。 |
duration |
在考虑路况信息的情况下持续的时间,以文本形式表示。注意:如果您未请求路况信息,则此值将与 |
static_duration |
不考虑路况信息的时长,以文本形式表示。 |
transit_fare |
以文本形式表示的公交票价。 |
RouteTokenUpdateFidelity
对于使用 route_token_behavior
GET_ROUTE_UPDATES
的请求,标识根据关联的 route_token 构造的路由。(与此消息中的 route_token
无关)。
枚举 | |
---|---|
ROUTE_TOKEN_UPDATE_FIDELITY_UNSPECIFIED |
此路线不是根据路线令牌生成的。 |
APPROXIMATE |
此路线是根据路线标记重建的,在逻辑上是等效的,但路线的几何图形不完全相同。 |
IDENTICAL |
此路线的几何图形与路线令牌完全相同。 |
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 会将通行卡视为未知,并尝试返回现金价格。仅适用于 |
avoid_tunnels |
设置为 true 时,在合理情况下避开隧道,优先考虑不包含隧道的路由。仅适用于 |
avoid_vignettes[] |
设置为 true 时,在合理情况下,会避开带有穿插广告的某些国家/地区,优先考虑不包含穿插广告的国家/地区内带有穿插广告的道路。仅适用于 |
hov_preference |
指定是否根据高承载率车辆通行资格的道路更改路线。ComputeRouteMatrix 不支持此字段。 |
HOVPreference
指定是否根据高乘载量车辆 (HOV) 道路或车道更改路线。
字段 | |
---|---|
allow_hov |
指定除共享高承载率车道的路段外,是否允许在只允许高承载率车辆通行的道路上规划路线。默认情况下,系统会优先处理不包含高承载率车辆通行的道路的路线。 |
RouteTokenOptions
与路由令牌相关的选项。
字段 | |
---|---|
route_token |
可选。如果设置,则会尽可能生成与令牌关联的路线“相似”的路线。您仍必须提供原始查询参数(例如出发地、目的地等)。 |
route_token_behavior |
可选。有关如何治疗 |
RouteTokenBehavior
路由令牌支持的模式。
枚举 | |
---|---|
ROUTE_TOKEN_BEHAVIOR_UNSPECIFIED |
作为 GET_ROUTE_UPDATES 处理,以确保兼容性。 |
GET_ROUTE_UPDATES |
如果 |origin| 位于 route_token 表示的路线上,生成的路线之一就是 route_token 表示的路线。其余路由无关。当 |origin| 接近 route_token 的起始位置(即用户没有离开 route_token 的生成位置)时,更新最为高效。 |
GET_SIMILAR_ROUTES |
以 route_token 表示的路线不会包含在响应中,但其他路线会将与 route_token 的相似度用作其排名的加权因子。 |
RouteTravelAdvisory
包含应告知用户的其他信息,例如可能的交通区域限制。
字段 | |
---|---|
toll_info |
包含路线上的收费站相关信息。仅当路线上需要收费时,系统才会填充此字段。如果设置了此字段,但未填充 |
vignette_info |
封装穿插广告的数据字段。该服务仅在以下条件下才会填充此字段:
在这种情况下,该字段包含有关穿插广告的详细信息,例如包含不可避免的穿插广告的国家/地区。 |
speed_reading_intervals[] |
详细说明交通密度的速度读数间隔。适用于 例如:
|
fuel_consumption_microliters |
预测的燃料消耗量(以微升为单位)。 |
route_restrictions_partially_ignored |
返回的路线可能具有不适合请求的出行方式或路线修饰符的限制。 |
transit_fare |
如果存在,则包含该路线的总交通费用或票费。仅针对 |
VignetteInfo
封装路线沿途的穿插信息。
字段 | |
---|---|
country_vignettes_used[] |
使用穿插广告的国家/地区。国家/地区以 Unicode CLDR 区域代码指定。支持的国家/地区包括 CH、AT、CZ、HU、SI、SK。 |
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 |
计算路线时将实时路况考虑在内,而不应用大多数性能优化。使用此值会产生最长的延迟时间。 |
分割部分
属于路径的路段。
字段 | |
---|---|
polyline |
必需。路段的多段线,可用于在无法找到 ID 时标识路段,还可用于区分 ID 相同的两个路段。多段线使用标准的 Google Maps Platform 编码多段线算法格式进行编码。 |
联合字段 id 。用于在 ID 空间中标识此细分受众群。必需。id 只能是下列其中一项: |
|
place_id |
此路段的地点 ID。用于各种 API。 |
SegmentSpan
用于分隔细分的子部分。如果跨度覆盖整个路段,则 start_meters 为 0,而 end_meters 为路段长度。
字段 | |
---|---|
start_meters |
其中,跨度的起点是从线段多段线的起点作为起点。 |
end_meters |
其中,跨度的结束点是从线段多段线的起点开始的。 |
SegmentSpanAttribute
SegmentSpanAttribute 包含从 API 返回的注释。
字段 | |
---|---|
segment_span |
说明注释在片段的适用位置。 |
level_of_service |
路段跨度的预测交通等级,由车辆到达路段起点时预计在此路段预计的车流速度来定义。 |
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 |
描述车辆的排放类型。仅适用于 |
total_axle_count |
轴总数。如果设置,则必须大于等于 2。必须设置为卡车触发,但对于拖车则为可选项。当 |
total_height_mm |
车辆的高度,包括所有相连拖车的高度。必须设置为卡车或拖车触发。当 |
total_length_mm |
车辆的长度,包括所有挂车的长度。必须设置为卡车或拖车触发。当 |
total_width_mm |
车辆的宽度,包括所有相连拖车的宽度。必须设置为卡车或拖车触发。当 |
total_weight_kg |
车辆的重量,包括所有相连拖车的重量。这里的重量是指实际重量,而不是评级。必须设置为卡车或拖车触发。当 |
trailer_info[] |
每个预告片都有一个条目。如果提供了预告片信息,则必须将 |
TrailerInfo
车辆上挂载的单个拖车的相关信息。必须为卡车提供拖车的长度。其他属性是可选的。属性总数必须包含所有预告片的属性。例如,total_height_mm
必须始终大于或等于 trailer_info.height_mm
。
字段 | |
---|---|
height_mm |
拖车的高度。 |
length_mm |
预告片的时长。 |
width_mm |
拖车的宽度。 |
weight_kg |
拖车的重量。这里的重量是指实际重量,而不是评级。 |
航点
封装航点。航点用于标记路线的起点和终点,并包括路线沿途的中间停靠站。
字段 | |
---|---|
via |
将此航点标记为里程碑,而不是停止点。对于请求中的每个非经由航点,响应会在 |
vehicle_stopover |
表示航点供车辆停靠,且意图是上车或下车。设置此值后,计算的路线将不会包含不适合上车和下车的道路上的非 |
side_of_road |
表示此航点的位置优先让车辆停靠在道路的某一侧。设置此值后,路线会经过相应位置,以便车辆可以在偏向于道路中心的道路一侧停靠。此选项仅适用于 |
联合字段 location_type 。表示位置的不同方式。location_type 只能是下列其中一项: |
|
location |
使用地理坐标指定的点,包含可选标题。 |
place_id |
与航点相关联的地图注点地点 ID。 |
address |
人类可读的地址或 Plus 代码。如需了解详情,请参阅 https://plus.codes。 |