RouteGetRouteDirectionsWithAdditionalParametersQueryParamProperties interface

指定当车辆加速 ( 即 KineticEnergyGained/ChemicalEnergyConsumed) 时，将存储在燃料中的化学能转换为动能的效率。ChemicalEnergyConsumed 是通过使用 fuelEnergyDensityInMJoulesPerLiter 将消耗的燃料转换为化学能获得的。

必须与 减速效率配对。

允许的值范围为 0.0 到 1/减速效率。

合理值：对于 燃烧模型 ：0.33，对于 电动模型 ：0.66

accelerationEfficiency?: number

属性值

控制与参考路线相比计算的替代项的给定规划条件的最佳性。

alternativeType?: "anyRoute" | "betterRoute"

属性值

到达目标点的日期和时间。 必须将其指定为 dateTime。 如果未指定时区偏移量，则将它假定为目标点的时区偏移量。 arriveAt 值必须是将来的。 arriveAt 参数不能与 departAt、minDeviationDistance 或 minDeviationTime 结合使用。

arriveAt?: string | Date

属性值

指定用于维持辅助系统的功耗，以千瓦 (kW) 为单位。

它可用于指定设备和系统（如交流系统、无线电、加热等）的消耗量。

合理值：1.7

auxiliaryPowerInkW?: number

属性值

指定用于维持车辆辅助系统的燃料消耗量（以升/小时为单位）。

它可用于指定设备和系统（如交流系统、无线电、加热等）的消耗量。

合理值：0.2

auxiliaryPowerInLitersPerHour?: number

属性值

指定在确定路由时路由计算应尝试避免的内容。 可以在一个请求中多次指定，例如，“&avoid=高速公路&avoid=tollRoads&avoid=ferries”。 在 calculateReachableRange 请求中，不得使用已经UsedRoads 的值。

avoid?: ("tollRoads" | "motorways" | "ferries" | "unpavedRoads" | "carpools" | "alreadyUsedRoads" | "borderCrossings")[]

属性值

使用快速启发式算法对路线点重新排序，以减少路线长度。 与 routeType 最短结合使用时产生最佳结果。 请注意，源和目标从优化航点索引中排除。 若要在响应中包含源和目标，请将所有索引增加 1 以考虑源，然后将目标添加为最终索引。 可能值为 true 或 false。 如果可能，True 将计算更好的顺序，但不允许与大于 0 的 maxAlternatives 值或与圆路点结合使用。 False 将按给定顺序使用位置，不允许与 routeRepresentation none 结合使用。

computeBestOrder?: boolean

属性值

指定是否使用不同类型的交通信息返回其他行程时间， (无、历史、实时) 以及默认的最佳估计行程时间。

computeTravelTimeFor?: "none" | "all"

属性值

指定消耗的速度相关分量。

以无序的速度/消耗率对列表的形式提供。 该列表定义消耗曲线上的点。 列表中未列出的速度消耗率如下所示：

• 如果给定速度位于列表中的两个速度之间，则按线性内插

• 由线性推断，否则，假设常量 (ΟConsumption/ーSpeed) 由列表中最近的两个点决定

该列表必须包含 1 到 25 个点， (包含) ，并且不能包含相同速度的重复点。 如果它只包含单个点，则使用该点的消耗率而无需进一步处理。

为最大速度指定的消耗量必须大于或等于倒数第二个最大速度的消耗量。 这可确保外推不会导致负消耗率。

同样，为列表中的两个最小速度指定的消耗值不能导致任何较小速度的负消耗率。

(以 kWh/100km) 表示的消耗值的有效范围为 0.01 到 100000.0。

合理值：50,8.2：130,21.3

用 电量模型需要此参数。

constantSpeedConsumptionInkWhPerHundredkm?: string

属性值

指定消耗的速度相关分量。

以冒号分隔的速度 & 消耗率对的无序列表形式提供。 该列表定义消耗曲线上的点。 列表中未列出的速度消耗率如下所示：

• 如果给定速度位于列表中的两个速度之间，则按线性内插

• 由线性推断，否则，假设常量 (ΟConsumption/ーSpeed) 由列表中最近的两个点决定

该列表必须包含 1 到 25 个点， (包含) ，并且不能包含相同速度的重复点。 如果它只包含单个点，则使用该点的消耗率而无需进一步处理。

为最大速度指定的消耗量必须大于或等于倒数第二个最大速度的消耗量。 这可确保推断不会导致负消耗率。

同样，为列表中的两个最小速度指定的消耗值不能导致任何较小速度的负消耗率。

以 l/100km) 表示 (消耗值的有效范围介于 0.01 和 100000.0 之间。

合理值： 50,6.3：130,11.5

注意 ：此参数是 燃烧消耗模型所必需的。

constantSpeedConsumptionInLitersPerHundredkm?: string

属性值

指定当前以千瓦时 (千瓦时) 的电力供应。

此参数与 maxChargeInkWh 参数共存。

允许的值范围为 0.0 到 maxChargeInkWh。

合理值 ： 43

currentChargeInkWh?: number

属性值

指定当前燃料供应量（以升为单位）。

合理值 ： 55

currentFuelInLiters?: number

属性值

指定当车辆减速 (（ 即 ChemicalEnergySaved/KineticEnergyLost) ）时，将动能转换为节省 (不消耗) 燃料的效率。ChemicalEnergySaved 是通过使用 fuelEnergyDensityInMJoulesPerLiter 将节省的 (不消耗) 燃料转换为能源获得的。

必须与 加速效率配对。

允许的值范围是 0.0 到 1/加速效率。

合理值：对于 燃烧模型 ：0.83，对于 电气模型 ：0.91

decelerationEfficiency?: number

属性值

从起点出发的日期和时间。 除现在以外，出发时间必须指定为 dateTime。 如果未指定时区偏移量，则将假定为原点的时区偏移量。 ) ， (1996-12-19T16：39：57-08：00 的 date-time 格式，

departAt?: string | Date

属性值

指定当车辆失去高程 (（ 例如 ChemicalEnergySaved/PotentialEnergyLost) ）时，将潜在能量转换为节省 (不消耗) 燃料的效率。ChemicalEnergySaved 是通过使用 fuelEnergyDensityInMJoulesPerLiter 将节省的 (不消耗) 燃料转换为能源获得的。

必须与 uphillEfficiency 配对。

允许的值范围是 0.0 到 1/上坡效率。

合理值：对于 燃烧模型 ：0.51，对于 电气模型 ：0.73

downhillEfficiency?: number

属性值

指定存储在一升燃料中的化学能量（以兆焦耳 (MJ) 为单位）。 它与 *效率 参数结合使用，用于在节省或消耗的能量与燃料之间进行转换。 例如，汽油的能量密度为 34.2 MJ/l，柴油燃料的能量密度为 35.8 MJ/l。

如果设置了任何 *效率 参数，则此参数是必需的。

合理值 ： 34.2

fuelEnergyDensityInMJoulesPerLiter?: number

属性值

惊心动魄的路线的丘陵程度。 此参数只能与 =thrilling 一起使用 routeType。

hilliness?: "low" | "normal" | "high"

属性值

如果指定，将返回指导说明。 请注意，instructionsType 参数不能与 routeRepresentation=none 一起使用

instructionsType?: "coded" | "text" | "tagged"

属性值

语言参数确定指导消息的语言。 它不会影响适当的名词 (街道、广场等的名称 ) 当 instructionsType=coded 时，它不起作用。 允许的值 (描述的 IETF 语言标记) 子集

language?: string

属性值

要计算的所需备用路由数。 默认值：0，最小值：0，最大值：5

maxAlternatives?: number

属性值

指定可能存储在车辆电池中 (千瓦时) 的最大电力供应量（千瓦时）。

此参数与 currentChargeInkWh 参数共存。

最小值必须大于或等于 currentChargeInkWh。

合理值 ： 85

maxChargeInkWh?: number

属性值

返回的所有备用路由将遵循引用路由 (请参阅 POST 请求) 部分，从 calculateRoute 请求的起始点至少为此数米。 只能在重建路由时使用。 minDeviationDistance 参数不能与 arriveAt 一起使用

minDeviationDistance?: number

属性值

返回的所有备用路由将遵循引用路由 (请参阅 POST 请求) 部分从 calculateRoute 请求的起始点至少此秒数。 只能在重建路由时使用。 minDeviationTime 参数不能与 arriveAt 一起使用。 默认值为 0。 将 ) minDeviationTime_ 设置为大于零的值会产生以下后果：

• calculateRoute 请求的源点必须位于 (或非常接近输入引用路由) 。
  • 如果不是这种情况，则返回错误。
  • 但是，起点不需要位于输入引用路线的开头， (可以将其视为) 引用路线上的当前车辆位置。
• 作为 calculateRoute 响应中的第一个路由返回的引用路由将从 calculateRoute 请求中指定的源点开始。 输入引用的初始部分将一直路由到源点，将从响应中排除。
• minDeviationDistance 和 minDeviationTime 的值确定从源点起，备用路由将保证遵循引用路由的距离。
• 路由必须使用 departAt。
• 将忽略 vehicleHeading。

minDeviationTime?: number

属性值

计算路线所依据的坐标，由冒号分隔。 至少需要两个坐标。 第一个是起点，最后一个是路由的目标。 中间的可选坐标充当路由中的 WayPoint。 最多可以传递 150 个 WayPoint。

query: string

属性值

指定应报告哪些数据用于诊断目的。 唯一可能的值是 effectiveSettings。 报告调用 API 时使用的有效参数或数据。 对于默认参数，默认值将反映在调用方未指定参数的位置。

report?: "effectiveSettings"

属性值

指定作为响应提供的路由集的表示形式。 此参数值只能与 computeBestOrder=true 一起使用。

routeRepresentation?: "polyline" | "summaryOnly" | "none"

属性值

请求的路由类型。

routeType?: "fastest" | "shortest" | "eco" | "thrilling"

属性值

指定在路由响应中报告哪些节类型。

例如，如果 sectionType = 行人，则返回仅适用于行人的节。 可以使用多个类型。 默认 sectionType 引用 travelMode 输入。 默认情况下，travelMode 设置为 car

sectionType?: "carTrain" | "country" | "ferry" | "motorway" | "pedestrian" | "tollRoad" | "tollVignette" | "traffic" | "travelMode" | "tunnel" | "carpool" | "urban"

属性值

可能的值：

• true - 在路由期间考虑所有可用的流量信息
• false - 在路由期间忽略当前流量数据。 请注意，尽管在路由过程中忽略了当前交通数据，但仍会纳入历史交通对有效道路速度的影响。

traffic?: boolean

属性值

所请求路线的行驶模式。 如果未定义，则默认值为“car”。 请注意，请求的 travelMode 可能不适用于整个路线。 如果请求的 travelMode 不适用于特定节，则该节响应的 travelMode 元素将是“其他”。 请注意，旅行模式公共汽车、摩托车、出租车和面包车是 BETA 功能。 并非所有区域都提供完全限制数据。 在 calculateReachableRange 请求中，不得使用自行车和行人的值。

travelMode?: "pedestrian" | "car" | "truck" | "taxi" | "bus" | "van" | "motorcycle" | "bicycle"

属性值

指定当车辆获得提升 (即 PotentialEnergyGained/ChemicalEnergyConsumed) 时，将存储在燃料中的化学能转换为潜在能量的效率。ChemicalEnergyConsumed 是通过使用 fuelEnergyDensityInMJoulesPerLiter 将消耗的燃料转换为化学能量获得的。

必须与 下坡效率配对。

允许的值范围为 0.0 到 1/下坡效率。

合理值：对于 燃烧模型 ：0.27，对于 电气模型 ：0.74

uphillEfficiency?: number

属性值

车辆每轴的重量（以公斤为单位）。 值为 0 表示不考虑每个轴的重量限制。

vehicleAxleWeight?: number

属性值

车辆是否用于商业目的。 商用车辆可能不允许在某些道路上行驶。

vehicleCommercial?: boolean

属性值

车辆的发动机类型。 指定详细消耗模型时，它必须与 vehicleEngineType 的值一致。

vehicleEngineType?: "combustion" | "electric"

属性值

车辆的方向方向从真正北端开始，沿顺时针方向继续。 北为0度，东为90度，南为180度，西为270度。 可能的值 0-359

vehicleHeading?: number

属性值

车辆的高度（以米为单位）。 值为 0 表示不考虑高度限制。

vehicleHeight?: number

属性值

车辆长度（以米为单位）。 值为 0 表示不考虑长度限制。

vehicleLength?: number

属性值

可归类为危险品并限制在某些道路的货物类型。 可用的 vehicleLoadType 值为美国 Hazmat 类 1 到 9，外加用于其他国家/地区的泛型分类。 以 USHazmat 开头的值用于美国路由，而 otherHazmat 应用于所有其他国家/地区。 可以多次指定 vehicleLoadType。 此参数目前仅考虑用于 travelMode=truck。

vehicleLoadType?: "USHazmatClass1" | "USHazmatClass2" | "USHazmatClass3" | "USHazmatClass4" | "USHazmatClass5" | "USHazmatClass6" | "USHazmatClass7" | "USHazmatClass8" | "USHazmatClass9" | "otherHazmatExplosive" | "otherHazmatGeneral" | "otherHazmatHarmfulToWater"

属性值

车辆的最高速度（以公里/小时为单位）。 车辆配置文件中的最大速度用于检查是否允许车辆在高速公路上行驶。

• 值为 0 表示将在路线规划期间确定并应用车辆的适当值。

• 在路线规划期间，可能会重写非零值。 例如，当前交通流量为 60 公里/小时。 如果车辆最高时速设置为 50 公里/小时，则路由引擎将考虑 60 km/小时，这是目前的情况。 如果车辆的最高时速为 80 公里/小时，但当前交通流量为 60 公里/小时，则路由引擎将再次使用 60 公里/小时。

vehicleMaxSpeed?: number

属性值

车辆的重量（以公斤为单位）。

• 如果设置了任何效率参数，则是必需的。

• 在消耗模型的上下文中使用时，它必须严格为正。 考虑重量限制。

• 如果未指定详细的 消耗模型 ，并且 vehicleWeight 的值非零，则考虑重量限制。

• 在所有其他情况下，将忽略此参数。

合理值：对于 燃烧模型 ：1600，对于 电气模型 ：1900

vehicleWeight?: number

属性值

车辆宽度（以米为单位）。 值为 0 表示不考虑宽度限制。

vehicleWidth?: number

属性值

惊心动魄的路线的转弯水平。 此参数只能与 =thrilling 一起使用 routeType。

windingness?: "low" | "normal" | "high"

属性值