索引
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_ |
可选。指定交通方式。 |
routing_ |
可选。指定如何计算路线。服务器会尝试使用所选的路由偏好设置来计算路由。如果路由偏好设置导致错误或延迟时间过长,则会返回错误。只有当 |
departure_ |
可选。出发时间。如果您未设置此值,则此值默认为您发出请求的时间。注意:只有在将 |
arrival_ |
可选。到达时间。注意:仅当 |
language_ |
可选。BCP-47 语言代码,例如“en-US”或“sr-Latn”。如需了解详情,请参阅 Unicode 语言区域标识符。如需查看支持的语言列表,请参阅语言支持。如果您未提供此值,系统会根据第一个来源的位置推断显示语言。 |
region_ |
可选。地区代码,指定为一个 ccTLD(“顶级域名”)双字符值。如需了解详情,请参阅国家/地区代码顶级域名。 |
units |
可选。指定显示字段的衡量单位。 |
extra_ |
可选。可能用于完成请求的额外计算列表。注意:这些额外的计算可能会在响应中返回额外的字段。这些额外的字段还必须在要返回的字段掩码中指定。 |
traffic_ |
可选。指定计算交通时间时所用的假设条件。此设置会影响 |
transit_ |
可选。指定影响为 |
ExtraComputation
在完成请求时要执行的额外计算。
枚举 | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
未使用。包含此值的请求将失败。 |
TOLLS |
矩阵元素的过路费信息。 |
ComputeRoutesRequest
ComputeRoutes 请求消息。
字段 | |
---|---|
origin |
必需。起点航点。 |
destination |
必需。目的地航点。 |
intermediates[] |
可选。路线上(不包括终点)的一组航点,用于停靠或经过。最多支持 25 个中间航点。 |
travel_ |
可选。指定交通方式。 |
routing_ |
可选。指定如何计算路线。服务器会尝试使用所选的路由偏好设置来计算路由。如果路由偏好设置导致错误或延迟时间过长,则会返回错误。只有当 |
polyline_ |
可选。指定多段线的质量偏好设置。 |
polyline_ |
可选。指定多段线的首选编码。 |
departure_ |
可选。出发时间。如果您未设置此值,则此值默认为您发出请求的时间。注意:只有在将 |
arrival_ |
可选。到达时间。注意:仅当 |
compute_ |
可选。指定是否应计算路线以外的备选路线。对于包含中间航点的请求,系统不会返回备选路线。 |
route_ |
可选。一组需要满足的条件,这些条件会影响路线的计算方式。 |
language_ |
可选。BCP-47 语言代码,例如“en-US”或“sr-Latn”。如需了解详情,请参阅 Unicode 语言区域标识符。如需查看支持的语言列表,请参阅语言支持。如果您未提供此值,系统会根据路线请求的位置推断显示语言。 |
region_ |
可选。地区代码,指定为一个 ccTLD(“顶级域名”)双字符值。如需了解详情,请参阅国家/地区代码顶级域名。 |
units |
可选。指定显示字段的衡量单位。这些字段包括 |
optimize_ |
可选。如果设置为 true,该服务会尝试通过重新排列指定的中间航点来最大限度地降低路线的总费用。如果任何中间航点是 |
requested_ |
可选。除了默认路线之外,指定请求中要计算的参考路线。参考路线是指与默认路线具有不同路线计算目标的路线。例如, |
extra_ |
可选。可能用于完成请求的额外计算列表。注意:这些额外的计算可能会在响应中返回额外的字段。这些额外的字段还必须在要返回的字段掩码中指定。 |
traffic_ |
可选。指定计算交通时间时所用的假设条件。此设置会影响 |
transit_ |
可选。指定影响为 |
ExtraComputation
在完成请求时要执行的额外计算。
枚举 | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
未使用。包含此值的请求将失败。 |
TOLLS |
相应路线的过路费信息。 |
FUEL_CONSUMPTION |
相应路线的预估油耗。 |
TRAFFIC_ON_POLYLINE |
路线的可感知路况多段线。 |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions 以格式化 HTML 文本字符串的形式呈现。此内容应按原样读取。此内容仅供展示。请勿以程序化方式解析它。 |
ReferenceRoute
ComputeRoutesRequest 中受支持的参考路线。
枚举 | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
未使用。包含此值的请求会失败。 |
FUEL_EFFICIENT |
省油路线。 |
SHORTER_DISTANCE |
行程距离较短的路线。这是一项实验性功能。 对于 对于 此功能不适用于任何其他交通方式、通过中间航点或 |
ComputeRoutesResponse
计算响应消息的路线。
字段 | |
---|---|
routes[] |
如果您指定了 |
fallback_ |
在某些情况下,如果服务器无法使用所有输入偏好设置计算路线结果,则可能会回退到使用其他计算方式。使用回退模式时,此字段包含有关回退响应的详细信息。否则,此字段将未设置。 |
geocoding_ |
包含指定为地址的路径点的地理编码响应信息。 |
FallbackInfo
与使用回退结果的方式和原因相关的信息。如果此字段已设置,则表示服务器使用了与首选模式不同的路由模式作为回退。
字段 | |
---|---|
routing_ |
用于响应的路由模式。如果触发了回退,模式可能与原始客户端请求中设置的路由偏好设置不同。 |
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_ |
表示地理编码操作生成的状态代码。 |
type[] |
结果的类型,形式为零个或多个类型标记。支持的类型:地址类型和地址组成部分类型。 |
partial_ |
表示地理编码器无法返回与原始请求完全匹配的结果,尽管它能够匹配所请求地址的一部分内容。您不妨检查一下原始请求中是否有拼写错误和/或地址不完整的情况。 |
place_ |
此结果的地点 ID。 |
intermediate_ |
请求中相应中间航点的索引。仅当相应的航点是中间航点时才填充。 |
GeocodingResults
包含适用于起点、终点和中间航点的
。仅针对地址路点进行填充。GeocodedWaypoints
字段 | |
---|---|
origin |
经过地理编码的起点航点。 |
destination |
经过地理编码的目的地航点。 |
intermediates[] |
一系列经过地理编码的中间路径点,每个路径点都包含一个索引字段,该字段与路径点在请求中指定的顺序中的以零为起点的位置相对应。 |
LocalizedTime
时间的本地化说明。
字段 | |
---|---|
time |
以字符串形式指定的给定时区中的时间。 |
time_ |
包含时区。该属性的值是时区的名称(如 IANA 时区数据库中所定义),例如“America/New_York”。 |
位置
封装位置(地理点和可选的标题)。
字段 | |
---|---|
lat_ |
航点的地理坐标。 |
heading |
与交通流方向相关联的罗盘方向。此值用于指定上车点和下车点所在的道路边。航向值介于 0 到 360 之间,其中 0 表示正北,90 表示正东,以此类推。您只能将此字段用于 |
Maneuver
一组值,用于指定要对当前步骤执行的导航操作(例如左转、合并或直行)。
枚举 | |
---|---|
MANEUVER_UNSPECIFIED |
未使用。 |
TURN_SLIGHT_LEFT |
稍微向左转。 |
TURN_SHARP_LEFT |
向左急转。 |
UTURN_LEFT |
左转 U 形调头。 |
TURN_LEFT |
向左转。 |
TURN_SLIGHT_RIGHT |
稍微向右转。 |
TURN_SHARP_RIGHT |
向右急转。 |
UTURN_RIGHT |
右转 U 形调头。 |
TURN_RIGHT |
向右转。 |
STRAIGHT |
一直往前走。 |
RAMP_LEFT |
进入左侧匝道。 |
RAMP_RIGHT |
进入右侧匝道。 |
MERGE |
合并到车流中。 |
FORK_LEFT |
向左转。 |
FORK_RIGHT |
向右转弯。 |
FERRY |
乘坐渡轮。 |
FERRY_TRAIN |
乘坐前往渡轮的火车。 |
ROUNDABOUT_LEFT |
在圆形交叉路口左转。 |
ROUNDABOUT_RIGHT |
在圆形交叉路口右转。 |
DEPART |
初始机动。 |
NAME_CHANGE |
用于指示街道名称变更。 |
折线
封装编码多段线。
字段 | |
---|---|
联合字段 polyline_type 。封装折线的类型。默认为 encoded_polyline。polyline_type 只能是下列其中一项: |
|
encoded_ |
使用多段线编码算法对多段线进行的字符串编码 |
geo_ |
使用 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_ |
|
legs[] |
构成路线的一系列路段(航点之间的路径段)。每个航段都对应于两个非 |
distance_ |
相应路线的行程距离(以米为单位)。 |
duration |
导航路线所需的时间。如果您将 |
static_ |
不考虑交通状况的情况下,沿着相应路线行驶所需的时间。 |
polyline |
整个路线多段线。此多段线是所有 |
description |
路线说明。 |
warnings[] |
显示路线时显示的一组警告。 |
viewport |
折线的视口边界框。 |
travel_ |
有关相应路线的其他信息。 |
optimized_ |
如果您将 |
localized_ |
|
route_ |
一个不透明令牌,可传递给 Navigation SDK 以在导航期间重构路线,并在重新路线时遵循创建路线时的原始意图。将此令牌视为不透明 blob。请勿比较不同请求的此值,因为即使服务返回完全相同的路线,此值也可能会发生变化。 注意: |
RouteLocalizedValues
特定属性的文字表示法。
字段 | |
---|---|
distance |
以文本形式表示的旅行距离。 |
duration |
时长,以文本形式表示,并本地化为查询所在区域的语言。考虑路况信息。注意:如果您未请求交通信息,则此值与 |
static_ |
不考虑交通状况的行程时长,以文本形式表示。 |
transit_ |
以文本形式表示的公共交通费用。 |
RouteLabel
的标签,可用于标识路线的特定属性,以便与其他路线进行比较。Route
枚举 | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
默认 - 不使用。 |
DEFAULT_ROUTE |
路线计算返回的默认“最佳”路线。 |
DEFAULT_ROUTE_ALTERNATE |
默认“最佳”路线的替代方案。指定 后,系统将返回这样的路线。 |
FUEL_EFFICIENT |
省油路线。系统会确定标有此值的路线是针对燃油消耗等生态参数进行了优化。 |
SHORTER_DISTANCE |
行程距离较短的路线。这是一项实验性功能。 |
RouteLeg
包含非 via
航点之间的路段。
字段 | |
---|---|
distance_ |
路线航段的行程距离(以米为单位)。 |
duration |
导航相应航段所需的时间。如果 |
static_ |
相应路段的旅行时长,计算时不考虑路况。 |
polyline |
此路段的整体多段线,其中包含每个 |
start_ |
此行程的起始位置。此位置可能与提供的 |
end_ |
此行程的终点。此位置可能与提供的 |
steps[] |
表示此路段中各个路段的步骤数组。每个步骤代表一条导航指令。 |
travel_ |
包含应告知用户的其他信息,例如路线行程中可能存在的交通区域限制。 |
localized_ |
|
steps_ |
此 |
RouteLegLocalizedValues
特定属性的文字表示法。
字段 | |
---|---|
distance |
以文本形式表示的旅行距离。 |
duration |
时长,以文本形式表示,并本地化为查询所在区域的语言。考虑路况信息。注意:如果您未请求交通信息,此值与 static_duration 相同。 |
static_ |
不考虑交通状况的行程时长,以文本形式表示。 |
StepsOverview
提供有关 RouteLegStep
列表的概览信息。
字段 | |
---|---|
multi_ |
关于 |
MultiModalSegment
提供有关 RouteLeg.steps
的不同多模态细分的汇总信息。多模态片段定义为具有相同 RouteTravelMode
的一个或多个连续 RouteLegStep
。如果 RouteLeg
中的步骤不包含任何多模态细分,则不会填充此字段。
字段 | |
---|---|
navigation_ |
多模式路段的 NavigationInstruction。 |
travel_ |
多模式路段的出行方式。 |
step_ |
多模态片段的起始对应的 |
step_ |
多模态片段的结束对应的 |
RouteLegStep
包含
的一部分。步骤对应于单个导航指令。路线分段由步骤组成。RouteLeg
字段 | |
---|---|
distance_ |
此步骤的移动距离(以米为单位)。在某些情况下,此字段可能没有值。 |
static_ |
不考虑交通状况的情况下,完成此步骤所需的时间。在某些情况下,此字段可能没有值。 |
polyline |
与此步骤关联的多段线。 |
start_ |
此步骤的起始位置。 |
end_ |
此步骤的终点位置。 |
navigation_ |
导航说明。 |
travel_ |
包含用户应了解的其他信息,例如相应行程步骤可能存在的交通区域限制。 |
localized_ |
|
transit_ |
如果行程模式为 |
travel_ |
此步骤所用的交通方式。 |
RouteLegStepLocalizedValues
特定属性的文字表示法。
字段 | |
---|---|
distance |
以文本形式表示的旅行距离。 |
static_ |
不考虑交通状况的行程时长,以文本形式表示。 |
RouteLegStepTransitDetails
与 TRANSIT
路线相关的 RouteLegStep
的其他信息。
字段 | |
---|---|
stop_ |
相应步骤的到达站和出发站的相关信息。 |
localized_ |
|
headsign |
指定该线路的行进方向,如车辆或出发站所标示的方向。方向通常是终点站。 |
headway |
将预计时间指定为目前同一车站各次发车之间的时长。例如,当 headway 秒值为 600 时,如果您错过了一班公交,那么预计需要 10 分钟才能等到下一班。 |
transit_ |
此步骤中所用公交线路的相关信息。 |
stop_ |
从出发站到到达站之间的经停点数。此计数包含到达站,但不含出发站。例如,如果您的路线是从 A 站出发,途经 B 站和 C 站,最终到达 D 站,
返回 3。 |
trip_ |
时刻表和标志牌上显示的文本,用于向乘客标识公交行程。该文字应能唯一标识服务日内的行程。例如,“538”是周一至周五下午 3:10 从加利福尼亚州圣何塞出发前往加利福尼亚州萨克拉门托的 Amtrak 火车的 |
TransitDetailsLocalizedValues
RouteTransitDetails
值的本地化说明。
字段 | |
---|---|
arrival_ |
时间的格式化文本表示法,并带有相应的时区。 |
departure_ |
时间的格式化文本表示法,并带有相应的时区。 |
TransitStopDetails
有关 RouteLegStep
公交车站的详细信息。
字段 | |
---|---|
arrival_ |
有关相应步骤到达经停点的信息。 |
arrival_ |
相应步骤的预计到达时间。 |
departure_ |
有关相应步骤的出发车站的信息。 |
departure_ |
相应步骤的预计出发时间。 |
RouteLegStepTravelAdvisory
包含应告知用户的其他信息,例如相应行程步骤可能存在的交通区域限制。
字段 | |
---|---|
speed_ |
注意:此字段目前未填充任何内容。 |
RouteLegTravelAdvisory
包含应告知用户的路段步骤的其他信息,例如可能存在的交通区域限制。
字段 | |
---|---|
toll_ |
包含特定 |
speed_ |
速度读数间隔,详细说明交通密度。适用于 示例:
|
RouteMatrixDestination
ComputeRouteMatrixRequest 的单个目的地
字段 | |
---|---|
waypoint |
必需。目的地航点 |
RouteMatrixElement
包含 ComputeRouteMatrix API 中为起点/终点对计算的路线信息。此 proto 可以流式传输到客户端。
字段 | |
---|---|
status |
此元素的错误状态代码。 |
condition |
指示是否找到了路线。与状态无关。 |
distance_ |
相应路线的行程距离(以米为单位)。 |
duration |
导航路线所需的时间。如果您将 |
static_ |
不考虑交通状况的情况下,沿着相应路线行驶所需的时间。 |
travel_ |
有关相应路线的其他信息。例如:限制信息和过路费信息 |
fallback_ |
在某些情况下,如果服务器无法根据给定偏好设置为此特定始发地/目的地对计算路线,则可能会改用其他计算模式。使用回退模式时,此字段包含有关回退响应的详细信息。否则,此字段将未设置。 |
localized_ |
|
origin_ |
请求中来源的索引(从零开始)。 |
destination_ |
请求中目的地的索引(从零开始)。 |
LocalizedValues
特定属性的文字表示法。
字段 | |
---|---|
distance |
以文本形式表示的旅行距离。 |
duration |
考虑交通状况以文本形式表示的持续时间。注意:如果未请求交通信息,此值与 static_duration 相同。 |
static_ |
时长以文本形式表示,不考虑交通状况。 |
transit_ |
以文本形式表示的公共交通费用。 |
RouteMatrixElementCondition
返回的路线的状态。
枚举 | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
仅在元素的 status 不 OK 时使用。 |
ROUTE_EXISTS |
找到了路线,并为相应元素填写了相应信息。 |
ROUTE_NOT_FOUND |
找不到路线。元素中不会填充包含路线信息的字段,例如 distance_meters 或 duration 。 |
RouteMatrixOrigin
ComputeRouteMatrixRequest 的单个来源
字段 | |
---|---|
waypoint |
必需。起点航点 |
route_ |
可选。将此地点作为起点的每条路线的修饰符 |
RouteModifiers
封装一组可选条件,以便在计算路线时满足这些条件。
字段 | |
---|---|
avoid_ |
设置为 true 时,会在合理的情况下避开收费道路,优先选择不含收费道路的路线。仅适用于 |
avoid_ |
如果设置为 true,则会在合理的情况下避开高速公路,优先选择不含高速公路的路线。仅适用于 |
avoid_ |
如果设置为 true,则会在合理的情况下避开轮渡,优先选择不含轮渡的路线。仅适用于 |
avoid_ |
设置为 true 时,会在合理情况下避免在室内导航,优先选择不包含室内导航的路线。仅适用于 |
vehicle_ |
指定车辆信息。 |
toll_ |
封装有关过路卡的信息。如果提供了过路卡,API 会尝试返回过路卡价格。如果未提供过路费卡,API 会将过路费卡视为未知,并尝试返回现金价格。仅适用于 |
RouteTravelAdvisory
包含应告知用户的其他信息,例如可能存在的交通区域限制。
字段 | |
---|---|
toll_ |
包含有关路线上收费信息的信息。只有在路线上预计有收费路段时,系统才会填充此字段。如果已设置此字段,但未填充 |
speed_ |
速度读数间隔,详细说明交通密度。适用于 示例:
|
fuel_ |
预测的燃料消耗量(以微升为单位)。 |
route_ |
返回的路线可能存在不适合请求的出行方式或路线修饰符的限制。 |
transit_ |
若存在,则包含此路线的总票价或总票费。此属性仅针对 |
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_ |
此时间段在多段线中的起始索引。 |
end_ |
多段线中此时间段的结束索引。 |
联合字段
|
|
speed |
此时间段内的交通速度。 |
速度
根据交通数据对多段线速度进行的分类。
枚举 | |
---|---|
SPEED_UNSPECIFIED |
默认值。此值未使用。 |
NORMAL |
正常速度,未检测到任何减速。 |
SLOW |
检测到车速缓慢,但未形成交通堵塞。 |
TRAFFIC_JAM |
检测到交通堵塞。 |
TollInfo
字段 | |
---|---|
estimated_ |
相应 |
TollPass
我们支持的全球过路卡列表。
枚举 | |
---|---|
TOLL_PASS_UNSPECIFIED |
未使用。如果使用此值,则请求会失败。 |
AU_ETOLL_TAG |
悉尼通行卡。如需了解更多详情,请访问 https://www.myetoll.com.au。 |
AU_EWAY_TAG |
悉尼通行卡。如需了解更多详情,请访问 https://www.tollpay.com.au。 |
AU_LINKT |
澳大利亚境内通行卡。如需了解详情,请访问 https://www.linkt.com.au/。 |
AR_TELEPASE |
阿根廷通行卡。如需了解更多详情,请访问 https://telepase.com.ar |
BR_AUTO_EXPRESO |
巴西通行卡。如需了解更多详情,请访问 https://www.autoexpreso.com |
BR_CONECTCAR |
巴西通行卡。如需了解更多详情,请访问 https://conectcar.com。 |
BR_MOVE_MAIS |
巴西通行卡。如需了解更多详情,请访问 https://movemais.com。 |
BR_PASSA_RAPIDO |
巴西通行卡。如需了解更多详情,请访问 https://pasorapido.gob.do/ |
BR_SEM_PARAR |
巴西通行卡。如需了解更多详情,请访问 https://www.semparar.com.br。 |
BR_TAGGY |
巴西通行卡。如需了解更多详情,请访问 https://taggy.com.br。 |
BR_VELOE |
巴西通行卡。如需了解更多详情,请访问 https://veloe.com.br/site/onde-usar。 |
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD |
加拿大至美国边境过境。 |
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD |
加拿大至美国边境过境。 |
CA_US_BLUE_WATER_EDGE_PASS |
加拿大安大略省至美国密歇根州的边境过境点。 |
CA_US_CONNEXION |
加拿大安大略省至美国密歇根州的边境过境点。 |
CA_US_NEXUS_CARD |
加拿大至美国边境过境。 |
ID_E_TOLL |
印度尼西亚。多家银行提供的电子卡,用于支付过路费。通过银行发行的所有电子卡的费用相同,因此只需一个枚举值。例如:- Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash |
IN_FASTAG |
India. |
IN_LOCAL_HP_PLATE_EXEMPT |
印度,豁免了 HP 州车牌。 |
JP_ETC |
日本 ETC。收取过路费的电子无线系统。https://www.go-etc.jp/ |
JP_ETC2 |
日本 ETC2.0。新版 ETC 可享受更多折扣,并支持车载设备与道路上的天线之间进行双向通信。https://www.go-etc.jp/etc2/index.html |
MX_IAVE |
墨西哥过路卡。https://iave.capufe.gob.mx/#/ |
MX_PASE |
墨西哥 https://www.pase.com.mx |
MX_QUICKPASS |
墨西哥 https://operadoravial.com/quick-pass/ |
MX_SISTEMA_TELEPEAJE_CHIHUAHUA |
http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf |
MX_TAG_IAVE |
墨西哥 |
MX_TAG_TELEVIA |
墨西哥通行卡公司。这是墨西哥城众多公交车站之一。如需了解详情,请访问 https://www.televia.com.mx。 |
MX_TELEVIA |
墨西哥通行卡公司。这是墨西哥城众多电视台之一。https://www.televia.com.mx |
MX_VIAPASS |
墨西哥通行卡。如需了解更多详情,请访问 https://www.viapass.com.mx/viapass/web_home.aspx。 |
US_AL_FREEDOM_PASS |
AL, USA. |
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS |
AK, USA. |
US_CA_FASTRAK |
加拿大、美国。 |
US_CA_FASTRAK_CAV_STICKER |
表示驾驶员除了拥有 DMV 签发的清洁空气车辆 (CAV) 贴纸外,还拥有任何 FasTrak 卡券。https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml |
US_CO_EXPRESSTOLL |
美国科罗拉多州。 |
US_CO_GO_PASS |
美国科罗拉多州。 |
US_DE_EZPASSDE |
DE, USA. |
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS |
FL, USA. |
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD |
FL, USA. |
US_FL_EPASS |
FL, USA. |
US_FL_GIBA_TOLL_PASS |
FL, USA. |
US_FL_LEEWAY |
FL, USA. |
US_FL_SUNPASS |
FL, USA. |
US_FL_SUNPASS_PRO |
FL, USA. |
US_IL_EZPASSIL |
IL, USA. |
US_IL_IPASS |
IL, USA. |
US_IN_EZPASSIN |
美国印第安纳州。 |
US_KS_BESTPASS_HORIZON |
KS, USA. |
US_KS_KTAG |
KS, USA. |
US_KS_NATIONALPASS |
KS, USA. |
US_KS_PREPASS_ELITEPASS |
KS, USA. |
US_KY_RIVERLINK |
KY, USA. |
US_LA_GEAUXPASS |
美国洛杉矶。 |
US_LA_TOLL_TAG |
美国洛杉矶。 |
US_MA_EZPASSMA |
MA, USA。 |
US_MD_EZPASSMD |
美国马里兰州。 |
US_ME_EZPASSME |
美国缅因州。 |
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD |
MI, USA. |
US_MI_BCPASS |
MI, USA. |
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG |
MI, USA. |
US_MI_IQ_PROX_CARD |
MI, USA. 已废弃,因为此卡券类型已不存在。 |
US_MI_IQ_TAG |
MI, USA. |
US_MI_MACKINAC_BRIDGE_MAC_PASS |
MI, USA. |
US_MI_NEXPRESS_TOLL |
MI, USA. |
US_MN_EZPASSMN |
美国明尼苏达州。 |
US_NC_EZPASSNC |
美国北卡罗来纳州。 |
US_NC_PEACH_PASS |
美国北卡罗来纳州。 |
US_NC_QUICK_PASS |
美国北卡罗来纳州。 |
US_NH_EZPASSNH |
美国新罕布什尔州。 |
US_NJ_DOWNBEACH_EXPRESS_PASS |
美国新泽西州。 |
US_NJ_EZPASSNJ |
美国新泽西州。 |
US_NY_EXPRESSPASS |
美国纽约州。 |
US_NY_EZPASSNY |
美国纽约州。 |
US_OH_EZPASSOH |
美国俄亥俄州。 |
US_PA_EZPASSPA |
PA, USA。 |
US_RI_EZPASSRI |
RI, USA. |
US_SC_PALPASS |
SC, USA. |
US_TX_AVI_TAG |
美国德克萨斯州。 |
US_TX_BANCPASS |
美国德克萨斯州。 |
US_TX_DEL_RIO_PASS |
美国德克萨斯州。 |
US_TX_EFAST_PASS |
美国德克萨斯州。 |
US_TX_EAGLE_PASS_EXPRESS_CARD |
美国德克萨斯州。 |
US_TX_EPTOLL |
美国德克萨斯州。 |
US_TX_EZ_CROSS |
美国德克萨斯州。 |
US_TX_EZTAG |
美国德克萨斯州。 |
US_TX_FUEGO_TAG |
美国德克萨斯州。 |
US_TX_LAREDO_TRADE_TAG |
美国德克萨斯州。 |
US_TX_PLUSPASS |
美国德克萨斯州。 |
US_TX_TOLLTAG |
美国德克萨斯州。 |
US_TX_TXTAG |
美国德克萨斯州。 |
US_TX_XPRESS_CARD |
美国德克萨斯州。 |
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD |
美国德克萨斯州。 |
US_VA_EZPASSVA |
美国弗吉尼亚州。 |
US_WA_BREEZEBY |
美国华盛顿州。 |
US_WA_GOOD_TO_GO |
美国华盛顿州。 |
US_WV_EZPASSWV |
WV, USA. |
US_WV_MEMORIAL_BRIDGE_TICKETS |
WV, USA. |
US_WV_MOV_PASS |
WV, USA |
US_WV_NEWELL_TOLL_BRIDGE_TICKET |
WV, USA. |
TrafficModel
指定计算交通时间时所用的假设条件。此设置会影响响应中返回到 duration
字段的值,该值包含根据历史平均数据预测的交通时间。
枚举 | |
---|---|
TRAFFIC_MODEL_UNSPECIFIED |
未使用。如果指定,则默认为 BEST_GUESS 。 |
BEST_GUESS |
表示返回的 duration 应该是最准确的行程时间估算值(根据已知的历史路况信息和实时路况信息得出)。departure_time 越接近当前时间,实时路况信息就越重要。 |
PESSIMISTIC |
表示返回的行程时间在大多数日子里应该长于实际行程时间,但在交通状况特别糟糕的少数日子里,实际行程时间可能超过此值。 |
OPTIMISTIC |
表示返回的行程时长在大多数日子里应该短于实际行程时间,但偶尔路况特别理想的时候,实际行程时间可能会小于该值。 |
TransitAgency
运营公交线路的公交公司。
字段 | |
---|---|
name |
此公交公司的名称。 |
phone_ |
公交公司采用特定语言区域格式的电话号码。 |
uri |
公交公司的 URI。 |
TransitLine
包含此路段中所用公交线路的相关信息。
字段 | |
---|---|
agencies[] |
运营此公交线路的公交公司(或公交公司)。 |
name |
此公交线路的全名,例如“8 Avenue Local”。 |
uri |
该公交线路的 URI(由公交公司提供)。 |
color |
该线路标牌中常用的颜色。以十六进制表示。 |
icon_ |
与该线路相关联的图标的 URI。 |
name_ |
该公交线路的简称。此名称通常是线路编号,例如“M7”或“355”。 |
text_ |
该线路站牌上常用的文字颜色。以十六进制表示。 |
vehicle |
此公交线路上运营的车辆类型。 |
TransitPreferences
基于 TRANSIT
的路线的偏好设置,会影响返回的路线。
字段 | |
---|---|
allowed_ |
获取 |
routing_ |
路由偏好设置,指定后会影响返回的 |
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。 |
local_ |
与该交通工具类型关联的图标的 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_ |
描述车辆的排放类型。仅适用于 |
关键点
封装航点。航点用于标记路线的起点和终点,并包含路线上的中途停靠点。
字段 | |
---|---|
via |
将此航点标记为里程碑,而不是停止点。对于请求中的每个非经停点路径点,响应都会将一个条目附加到 |
vehicle_ |
表示该航点是供车辆停靠的,目的是上车或下车。如果您设置此值,则计算出的路线不会包含不适合上车或下车的道路上的非 |
side_ |
表示此航点的位置旨在让车辆优先停靠在道路的特定侧。设置此值后,路线将穿过相应位置,以便车辆在相应位置偏离道路中心的一侧停车。此选项仅适用于 |
联合字段 location_type 。表示地理位置的不同方式。location_type 只能是下列其中一项: |
|
location |
使用地理坐标指定的点,包括可选的航向。 |
place_ |
与航点关联的地图注点地点 ID。 |
address |
可读的地址或 Plus Code。如需了解详情,请参阅 https://plus.codes。 |