Route - Post Route Directions

RouteDirections

还行

ErrorResponse

发生意外错误。

string

允许返回任何替代路由，而不考虑它与引用路由的比较方式（以最佳性而言）。

string

仅当它比根据给定规划条件的引用路由更好时，才返回备用路由。

string

计算所有类型的交通信息的行程时间，并指定路由响应中摘要中包含的字段 noTrafficTravelTimeInSeconds、historicTrafficTravelTimeInSeconds 和 liveTrafficIncidentsTravelTimeInSeconds 中的所有结果。

string

不计算额外的行程时间。

string

未知。

string

次要。

string

温和。

string

主要。

string

未定义，用于道路关闭和其他无限期延误。

string

左。

string

右。

string

所使用的参数的名称。

string

所使用的参数的值。

object

其他信息。

string

其他信息类型。

ErrorAdditionalInfo[]

错误附加信息。

string

错误代码。

ErrorDetail[]

错误详细信息。

string

错误消息。

string

错误目标。

ErrorDetail

错误对象。

GeoJsonObjectType

指定 GeoJSON 类型。 必须是九种有效的 GeoJSON 对象类型之一 - Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature 和 FeatureCollection。

• GeoJsonGeometryCollection[]
• GeoJsonLineString[]
• GeoJsonMultiLineString[]
• GeoJsonMultiPoint[]
• GeoJsonMultiPolygon[]
• GeoJsonPoint[]
• GeoJsonPolygon[]

包含有效 GeoJSON 几何对象的列表。 注意，GeoJSON 中的坐标以 x、y 顺序（经度、纬度）表示。

GeometryCollection

指定 GeoJSON 类型。 必须是九种有效的 GeoJSON 对象类型之一 - Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature 和 FeatureCollection。

number[]

GeoJson LineString 几何图形的坐标。

LineString

指定 GeoJSON 类型。 必须是九种有效的 GeoJSON 对象类型之一 - Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature 和 FeatureCollection。

number[]

GeoJson MultiLineString 几何图形的坐标。

MultiLineString

指定 GeoJSON 类型。 必须是九种有效的 GeoJSON 对象类型之一 - Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature 和 FeatureCollection。

number[]

GeoJson MultiPoint 几何图形的坐标。

MultiPoint

指定 GeoJSON 类型。 必须是九种有效的 GeoJSON 对象类型之一 - Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature 和 FeatureCollection。

number[]

包含有效 GeoJSON Polygon 对象的列表。 注意，GeoJSON 中的坐标以 x、y 顺序（经度、纬度）表示。

MultiPolygon

指定 GeoJSON 类型。 必须是九种有效的 GeoJSON 对象类型之一 - Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature 和 FeatureCollection。

number[]

Position 是包含两个或多个元素的数字数组。 前两个元素 经度 和 纬度，精确按顺序排列。 海拔/海拔 是可选的第三个元素。 有关详细信息，请参阅 RFC 7946。

Point

指定 GeoJSON 类型。 必须是九种有效的 GeoJSON 对象类型之一 - Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature 和 FeatureCollection。

number[]

GeoJson Polygon 几何图形类型的坐标。

Polygon

指定 GeoJSON 类型。 必须是九种有效的 GeoJSON 对象类型之一 - Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature 和 FeatureCollection。

string

方向信息。

string

到达位置。

string

出发地点。

string

路点位置。

string

道路更改。

string

转。

string

你已经到了

string

你已经到了 目标位于左侧。

string

你已经到了 目标位于右侧。

string

熊离开了

string

熊右。

string

离开。

string

走高速公路。

string

走高速公路。

string

走高速公路。

string

走坡道。

string

跟随。

string

保持左。

string

保持正确。

string

使 U 轮。

string

退出左侧。

string

退出右侧。

string

四处走动。

string

穿过环岛。

string

在环岛，左路走出口。

string

在环形交叉路口，从右侧退出。

string

左转锋利。

string

向右翻转。

string

保持直截了当。

string

切换到主干道。

string

切换到并行道路。

string

退出。

string

乘坐渡轮。

string

尝试进行 U 轮次。

string

向左转。

string

向右转。

string

你已经到达了路点。 它位于左侧。

string

你已经到达了路点。

string

你已经到达了路点。 它就在右边。

string

高

string

低

string

正常

string

分 岔

string

定期

string

环形交叉

number

Latitude 属性

number

经度属性

string

报告调用 API 时使用的有效参数或数据。

string

JavaScript 对象表示法数据交换格式

string

可扩展标记语言

string

需要使用汽车池（HOV/高占用车辆）车道的路线部分。

string

路线的各部分是汽车或火车。

string

指示路线所在的国家/地区的部分。

string

渡轮路线的各部分。

string

高速公路的路段。

string

路线部分仅适用于行人。

string

需要支付通行费的路线部分。

string

需要提供收费 vignette 的路线部分。

string

包含流量信息的路由部分。

string

与请求参数 travelMode相关的节。

string

隧道的路由部分。

string

位于城市地区的路线部分。

string

返回的路线针对自行车进行了优化，包括自行车道的使用。

string

返回的路线针对公共汽车进行了优化，包括仅使用公交车道。 BETA 功能。

string

返回的路线针对汽车进行了优化。

string

返回的路线针对摩托车进行了优化。 BETA 功能。

string

本节中无法提供给定的传输模式

string

返回的路线针对行人进行了优化，包括人行道的使用。

string

返回的路线针对出租车进行了优化。 BETA 功能。

string

返回的路线针对商用车辆进行了优化，例如卡车。

string

返回的路线针对面包车进行了优化。 BETA 功能。

RouteGuidance

包含与指南相关的元素。 仅当请求指导且可用时，才会显示此字段。

RouteLeg[]

腿数组

RouteSection[]

节数组

RouteSummary

Summary 对象

string

避免多次使用相同的道路。 最有用的与 routeType=惊心动魄。

string

避免在路由计算中跨越边界。

string

避免需要使用拼车（HOV/高占用车辆）车道的路线。

string

避免渡轮

string

避免高速公路

string

避免收费公路。

string

避免未修补的道路

string[]

这是允许使用 Vignette 收费公路的国家/地区的 3 个字符、ISO 3166-1、alpha-3 国家/地区代码的列表，例如“AUS，CHE”。 使用某些国家/地区 X 指定 allowVignette 相当于使用所有国家/地区指定 avoidVignette，但 X。指定具有空列表的 allowVignette allowVignette 与避免使用 vignette 的所有收费公路相同。 注意：指定 avoidVignette 和 allowVignette是错误的。

GeoJsonMultiPolygon

表示要避免的区域列表的 GeoJSON MultiPolygon。 仅支持矩形多边形。 矩形的最大大小约为 160x160 km。 最大避免区域数为 10。 它不能跨越第180个子午线。 它必须介于 -80 和 +80 度的纬度之间。

string[]

这是 3 个字符、ISO 3166-1、alpha-3 国家/地区的国家/地区代码的列表，其中所有带 vignette 的收费公路都将被避免，例如“AUS，CHE”。 列表中不带 Vignette 的国家/地区的收费公路不受影响。 注意：指定 avoidVignette 和 allowVignette是错误的。

GeoJsonGeometryCollection

GeoJSON Geometry 集合，表示用作路线重建输入的坐标序列，以及计算此参考路线的零个或多个备用路由。

• 提供的支持点序列用作路线重建的输入。
• 备用路由在基路径参数位置中指定的源点和目标点之间计算。
• 如果 minDeviationDistance 和 minDeviationTime 设置为零，则这些源点和目标点应分别位于引用路由的开头和结尾处（或非常接近）。
• 使用 <supportingPoints>时，不支持中间位置（路点）。
• 引用路由可能包含类型为 ROAD_CLOSURE的交通事件，对于引用路由的行程时间和交通延迟的计算，将忽略这些事件。 有关详细信息，请参阅 支持点。

string

Format Version 属性

RouteOptimizedWaypoint[]

优化了路点序列。 它显示用户提供的针对原始列表和优化列表的路点序列的索引。 例如，响应：

<optimizedWaypoints>
<waypoint providedIndex="0" optimizedIndex="1"/>
<waypoint providedIndex="1" optimizedIndex="2"/>
<waypoint providedIndex="2" optimizedIndex="0"/>
</optimizedWaypoints>

表示原始序列为 [0， 1， 2] 且优化序列为 [1， 2， 0]。 由于索引从 0 开始，原始索引为“first，second， third”，而优化为“second， third， first”。

RouteReport

报告当前调用中使用的有效设置。

Route[]

路由数组

RouteInstructionGroup[]

对相互相关的指令元素序列进行分组。

RouteInstruction[]

描述操作的说明列表。

string

操作的人类可读消息与下一个指令中的消息相结合。 有时，可以将两个连续指令组合成一个指令，以便更轻松地遵循。 在这种情况下，possibleCombineWithNext 标志为 true。 例如：

10. Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam
11. Follow Einsteinweg/A10/E22 towards Ring Amsterdam

指令 10 上的 possibleCombineWithNext 标志为 true。 这向编码指南的客户端表示，它可以与指令 11 结合使用。 对于请求人工可读指南的客户端，这些说明将自动组合在一起。 combinedMessage 字段包含合并的消息：

Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam
then follow Einsteinweg/A10/E22 towards Ring Amsterdam.

string

3 个字符 ISO 3166-1 alpha-3 国家/地区代码。 例如美国

DrivingSide

指示在机动点的左侧与右侧驾驶。

string

当前机动采取的高速公路出口数量。 如果退出具有多个退出编号，则它们将用 “，”分隔，并且可能由“-”聚合，例如“10,13-15”。

GuidanceInstructionType

指令的类型，例如道路窗体的转弯或更改。

JunctionType

进行机动的交汇点的类型。 对于较大的环岛，将生成两个单独的指令，用于进入和离开环岛。

GuidanceManeuver

标识操纵的代码。

string

一条人类可读的信息，用于操纵。

LatLongPair

表示为纬度和经度的位置。

integer

与指令点相对应的折线“磅”列表中的点的索引。

boolean

可以选择将指令与下一个指令组合在一起。 这可用于生成消息，例如“向左转，然后向右转”。

string[]

机动后下一条重要路段（s）或要跟踪的道路段的路号（s）。 示例：[“E34”、“N205”]

integer

这表示在环流处要采取的退出。

integer

从路线起点到指令点的距离。

string

标志标上的文本与操纵最相关，或与应遵循的方向有关。

string

国家/地区的细分（例如，状态）由 ISO 3166-2 代码的第二部分表示。 这仅适用于美国、加拿大和墨西哥等一些国家/地区。

string

机动后下一条重要路段的街道名称，或应遵循的街道的名称。

integer

估计到与 routeOffsetInMeters 对应的点的行程时间。

integer

指示指令的方向。 如果 junctionType 指示轮次指令：

• 180 = U 轮次
• [-179， -1] = 左转
• 0 = 直接打开 （'0 度' 轮次）
• [1， 179] = 右转

如果 junctionType 指示分叉指令：

• <0 - 保留左侧
• >0 - 保持正确

integer

指令中的第一个指令的索引，属于此组。

integer

组的长度。

string

当请求人工可读短信以获取指导时摘要消息（instructionType=text 或标记）。

integer

说明中最后一个指令的索引，属于此组。

string

返回没有人工可读消息的原始指令数据。

string

返回带有标记的可读邮件的原始指令数据，以允许格式设置。 由可重复识别的元素构建可读消息。 这些标记允许客户端应用程序正确设置格式。 当 instructionsType=tagged 时，将标记以下消息组件：street、roadNumber、signpostText、exitNumber、roundaboutExitNumber。

标记的“左转”消息示例：

Turn left onto <roadNumber>A4</roadNumber>/<roadNumber>E19</roadNumber>
towards <signpostText>Den Haag</signpostText>

string

以纯文本形式返回具有人类可读消息的原始指令数据。

LatLongPair[]

点数组

RouteLegSummary

路由节的摘要对象。

string

路线或腿部的估计到达时间。 时间采用 UTC 格式。

number

使用电耗模型估计的电耗以千瓦时（千瓦时为单位）。 如果 vehicleEngineType 设置为电动，并且指定 constantSpeedConsumptionInkWhPerHundredkm，则包含该类型。 batteryConsumptionInkWh 的值包括回收的电力，因此可以是负数（这表示获得能量）。 如果同时指定 maxChargeInkWh 和 currentChargeInkWh，则回收将被封顶，以确保电池电量永远不会超过 maxChargeInkWh。 如果未指定 maxChargeInkWh 和 currentChargeInkWh，则会在消耗计算中假定不受约束的回收。

string

路线或腿部的估计出发时间。 时间采用 UTC 格式。

number

使用燃烧消耗模型估计升的燃油消耗量。 如果 vehicleEngineType 设置为 燃烧 且指定 constantSpeedConsumptionInLitersPerHundredkm，则包含该类型。 该值将为非负值。

integer

使用依赖于时间的历史交通数据计算的估计行程时间。 仅当 computeTravelTimeFor = 所有在查询中使用时才包含。

integer

Length In Meters 属性

integer

使用实时速度数据计算的估计行程时间。 仅当 computeTravelTimeFor = 所有在查询中使用时才包含。

integer

估计的行程时间计算为由于交通状况（例如拥堵）而没有延误路线。 仅当 computeTravelTimeFor = 所有在查询中使用时才包含。

integer

根据交通信息，由实时事件造成的估计延迟（秒）。 对于计划在将来出发时间的航线，延误始终为 0。 若要使用不同类型的交通信息返回其他旅行时间，需要添加参数 computeTravelTimeFor=all。

integer

估计的行程时间（以秒为单位）属性，其中包括由于实时流量导致的延迟。 请注意，即使 traffic=false travelTimeInSeconds 仍包含由于流量导致的延迟。 如果 TravelAt 在将来，则使用依赖于时间的历史交通数据计算行程时间。

integer

从系统优化的方式点索引。

integer

用户提供的路点索引。

EffectiveSetting[]

调用此路由 API 时使用的有效参数或数据。

string

仅包括优化的 waypoint 索引，但不包括响应中的路由几何图形。 此参数值只能与 computeBestOrder=true 结合使用。

string

在响应中包含路由几何图形。

string

按折线汇总，但不包括响应中路由的点几何图形元素。

integer

事件导致的延迟（以秒为单位）。

integer

事件的有效速度（以公里/小时为单位）平均超过其整个长度。

integer

此部分适用的路由中最后一个点（偏移量 0）的索引。

DelayMagnitude

事件造成的延迟幅度。 这些值对应于 获取交通事件详细信息 API的响应字段 ty 的值。

ResponseSectionType

报告的路由响应的节类型

SimpleCategory

事件的类型。 当前可以是 JAM、ROAD_WORK、ROAD_CLOSURE 或其他。 有关详细信息，请参阅“tec”。

integer

此部分适用的路由中第一个点（偏移量 0）的索引。

RouteSectionTec

流量事件的详细信息，使用 TPEG2-TEC 标准中的定义。 可以包含 effectCode 并导致元素。

ResponseTravelMode

计算路线的旅行模式。 如果在本节中无法实现请求的传输模式，该值将设置为 other

RouteSectionTecCause[]

导致数组

integer

对流量流的影响。 包含 tec001：EffectCode 表中的值，如 TPEG2-TEC 标准中定义。 可用于根据严重性对流量事件进行颜色编码。

integer

流量事件的主要原因。 包含 tec002：CauseCode 表中的值，如 TPEG2-TEC 标准中定义。

integer

流量事件的子项。 包含由 mainCauseCode 定义的子原因表中的值，如 TPEG2-TEC 标准中定义。

string

路线或腿部的估计到达时间。 时间采用 UTC 格式。

string

路线或腿部的估计出发时间。 时间采用 UTC 格式。

integer

Length In Meters 属性

integer

根据交通信息，由实时事件造成的估计延迟（秒）。 对于计划在将来出发时间的航线，延误始终为 0。 若要使用不同类型的交通信息返回其他旅行时间，需要添加参数 computeTravelTimeFor=all。

integer

估计的行程时间（以秒为单位）属性，其中包括由于实时流量导致的延迟。 请注意，即使 traffic=false travelTimeInSeconds 仍包含由于流量导致的延迟。 如果 TravelAt 在将来，则使用依赖于时间的历史交通数据计算行程时间。

string

经济和速度平衡的路线。

string

最快路线。

string

最短的路线（按距离）。

string

包括有趣的或具有挑战性的道路，并尽可能少地使用高速公路。 可以选择包括的轮次级别以及丘陵程度。 有关如何设置此参数，请参阅丘陵和曲折参数。 计划路线限制为 900 公里， routeType= 惊心动魄

string

路线的各部分是汽车或火车。

string

需要使用汽车池（HOV/高占用车辆）车道的路线部分。

string

指示路线所在的国家/地区的部分。

string

渡轮路线的各部分。

string

高速公路的路段。

string

路线部分仅适用于行人。

string

需要支付通行费的路线部分。

string

需要提供收费 vignette 的路线部分。

string

包含流量信息的路由部分。

string

与请求参数 travelMode相关的节。

string

隧道的路由部分。

string

位于城市地区的路线部分。

string

塞车。

string

其他。

string

道路封闭。

string

道路工作。

string

返回的路线针对自行车进行了优化，包括自行车道的使用。

string

返回的路线针对公共汽车进行了优化，包括仅使用公交车道。 BETA 功能。

string

返回的路线针对汽车进行了优化。

string

返回的路线针对摩托车进行了优化。 BETA 功能。

string

返回的路线针对行人进行了优化，包括人行道的使用。

string

返回的路线针对出租车进行了优化。 BETA 功能。

string

返回的路线针对商用车辆进行了优化，例如卡车。

string

返回的路线针对面包车进行了优化。 BETA 功能。

string

内燃机。

string

电动发动机。

string

炸药

string

压缩气体

string

易燃液体

string

易燃固体

string

Oxidizers

string

毒药

string

放射性

string

腐蚀

string

杂项

string

炸药

string

杂项

string

有害于水

string

高

string

低

string

正常