你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

RouteDirectionOptions 类

定义

用于呈现静态图像的选项。

public class RouteDirectionOptions
type RouteDirectionOptions = class
Public Class RouteDirectionOptions
继承
RouteDirectionOptions

构造函数

RouteDirectionOptions()

RouteDirectionOptions 的构造函数。

属性

AccelerationEfficiency

指定当车辆加速 (即 KineticEnergyGained/ChemicalEnergyConsumed) 时,将燃料中存储的化学能转换为动能的效率。 ChemicalEnergyConsumed_是通过使用将消耗的燃料转化为化学能 fuelEnergyDensityInMJoulesPerLiter获得的。 必须与 配对 decelerationEfficiency。 允许的值范围为 0.0 到 1/decelerationEfficiency。 合理值:对于燃烧模型:0.33,对于电动模型:0.66

AlternativeType

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

ArriveAt

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

AuxiliaryPowerInKilowatts

指定用于维持辅助系统的功耗,以千瓦 (kW) 为单位。 它可用于指定设备和系统(如交流系统、无线电、加热等)的消耗量。合理值:1.7

AuxiliaryPowerInLitersPerHour

指定用于维持车辆辅助系统的燃料消耗量(以升/小时为单位)。 它可用于指定设备和系统(如交流系统、无线电、加热等)的消耗量。合理值:0.2

Avoid

指定在确定路由时路由计算应尝试避免的内容。 可以在一个请求中多次指定。 在 calculateReachableRange 请求中,不得使用已经UsedRoads 的值。

ComputeBestWaypointOrder

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

ConstantSpeedConsumptionInKilowattHoursPerHundredKilometer

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

  • 如果给定速度位于列表中的两个速度之间,则按线性内插
  • 由线性推断,否则,假设常量 (ΟConsumption/ーSpeed) 由列表中最近的两个点决定
该列表必须包含 1 到 25 个点, (包含) ,并且不能包含相同速度的重复点。 如果它只包含单个点,则使用该点的消耗率而无需进一步处理。 为最大速度指定的消耗量必须大于或等于倒数第二个最大速度的消耗量。 这可确保外推不会导致负消耗率。 同样,为列表中的两个最小速度指定的消耗值不能导致任何较小速度的负消耗率。 (以 kWh/100km) 表示的消耗值的有效范围为 0.01 到 100000.0。 合理值:50,8.2:130,21.3 此参数是 的 Electric consumption model必需参数。
ConstantSpeedConsumptionInLitersPerHundredKilometer

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

  • 如果给定速度位于列表中的两个速度之间,则按线性内插
  • 由线性推断,否则,假设常量 (ΟConsumption/ーSpeed) 由列表中最近的两个点决定
该列表必须包含 1 到 25 个点, (包含) ,并且不能包含相同速度的重复点。 如果它只包含单个点,则使用该点的消耗率而无需进一步处理。 为最大速度指定的消耗量必须大于或等于倒数第二个最大速度的消耗量。 这可确保外推不会导致负消耗率。 同样,为列表中的两个最小速度指定的消耗值不能导致任何较小速度的负消耗率。 (以 l/100km) 表示的消耗值的有效范围为 0.01 到 100000.0。 合理值:50,6.3:130,11.5 注意:燃烧消耗模型需要此参数
CurrentChargeInKilowattHours

以千瓦时 (千瓦时) 指定当前电力供应。 此参数与 MaxChargeInKilowattHour 参数共存。 允许的值范围为 0.0 到 MaxChargeInKilowattHour。 合理值:43

CurrentFuelInLiters

指定燃料的当前供应量(以升为单位)。 合理值:55

DecelerationEfficiency

指定当车辆减速 ((即 ChemicalEnergySaved/KineticEnergyLost) )时,将动能转换为节省 (不消耗) 燃料的效率。 ChemicalEnergySaved_是通过使用将节省 (未消耗) 燃料转换为能源 fuelEnergyDensityInMJoulesPerLiter来获得的。 必须与 配对 accelerationEfficiency。 允许的值范围为 0.0 到 1/accelerationEfficiency。 合理值:对于燃烧模型:0.83,对于电动模型:0.91

DepartAt

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

DownhillEfficiency

指定当车辆失去高程 ((即 ChemicalEnergySaved/PotentialEnergyLost) )时,将潜在能量转换为节省 (未消耗) 燃料的效率。 ChemicalEnergySaved_是通过使用将节省 (未消耗) 燃料转换为能源 fuelEnergyDensityInMJoulesPerLiter来获得的。 必须与 配对 uphillEfficiency。 允许的值范围为 0.0 到 1/uphillEfficiency。 合理值:对于燃烧模型:0.51,对于电动模型:0.73

FuelEnergyDensityInMegajoulesPerLiter

指定一升燃料中储存的化学能量(兆焦耳 (MJ) )。 它与参数结合使用, Efficiency 用于在节省或消耗的能量与燃料之间进行转换。 例如,汽油的能量密度为 34.2 MJ/l,柴油燃料的能量密度为 35.8 MJ/l。 如果设置了任何 Efficiency 参数,则此参数是必需的。 合理值:34.2

InclineLevel

惊心动魄路线的丘陵程度。 此参数只能与 routeType.Thrilling结合使用。

InstructionsType

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

IsCommercialVehicle

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

Language

语言参数确定指导消息的语言。 正确名词 (街道、广场等的名称) 以指定语言返回,或者如果不可用,则以接近该语言的可用语言返回。 允许的值 (IETF 语言标记) 子集。 支持的语言部分中列出了当前 支持的语言。 默认值:30EnglishGreatBritain

MaxAlternatives

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

MaxChargeInKilowattHours

指定可能存储在车辆电池中的) 的最大电力供应量(以千瓦时 (千瓦时为单位)。 此参数与 currentChargeInkilowattHour 参数共存。 最小值必须大于或等于 currentChargeInkilowattHour。 合理值:85

MinDeviationDistance

返回的所有备用路由将遵循参考路由 (请参阅 POST 请求) 节,从至少此计量数的 calculateRoute 请求的起始点开始。 只能在重新构造路由时使用。 minDeviationDistance 参数不能与 arriveAt 结合使用。

MinDeviationTime

返回的所有备用路由将遵循引用路由 (请参阅 POST 请求) 部分,从 calculateRoute 请求的源点至少此秒数。 只能在重建路由时使用。 minDeviationTime 参数不能与 arriveAt 一起使用。 默认值为 0。 将) minDeviationTime_设置为大于零的值会产生以下后果:calculateRoute 请求的原点必须位于输入引用路由 (或非常接近) 。 如果不是这种情况,则返回错误。 但是,起点不需要位于输入引用路线的开头, (可以将其视为) 引用路线上的当前车辆位置。 作为 calculateRoute 响应中的第一个路由返回的引用路由将从 calculateRoute 请求中指定的源点开始。 输入引用的初始部分将一直路由到源点,将从响应中排除。 和 minDeviationTime 的值minDeviationDistance确定备用路由将保证从起点开始沿用引用路由的距离。 路由必须使用 departAtVehicleHeading 已忽略。

RouteDirectionParameters

用于重建路由和计算此引用路由的零个或多个备用路由。 提供的坐标序列用作路线重建的输入。 在基路径参数位置中指定的起点和目标点之间计算备用路由。 如果 minDeviationDistance 和 minDeviationTime 都设置为零,则这些源点和目标点应分别位于引用路由的开头和结尾 (或非常接近) 。 使用 supportingPoint 时,不支持 (航点) 的中间位置。 将 minDeviationDistance 或 minDeviationTime 中的至少一个设置为大于零的值会产生以下后果:

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

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

RouteType

请求的路由类型。

SectionFilter

指定在路由响应中报告哪些节类型。 <br><br>例如,如果 sectionType = 行人,则返回仅适用于行人的分区。 可以使用多个类型。 默认 sectionType 引用 travelMode 输入。 默认情况下,travelMode 设置为 car。

ShouldReportEffectiveSettings

指定应报告哪些数据用于诊断目的。 如果为 true,它将报告调用 API 时使用的有效参数或数据。 对于默认参数,默认值将反映在调用方未指定参数的位置。

TravelMode

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

TravelTimeType

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

UphillEfficiency

指定当车辆获得提升 (即 PotentialEnergyGained/ChemicalEnergyConsumed) 时,将存储在燃料中的化学能转换为潜在能量的效率。 ChemicalEnergyConsumed_是使用 fuelEnergyDensityInMJoulesPerLiter将消耗的燃料转化为化学能获得的。 必须与 配对 downhillEfficiency。 允许的值范围是 0.0 到 1/downhillEfficiency。 合理值:对于燃烧模型:0.27,对于电气模型:0.74

UseTrafficData

可能的值:

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

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

VehicleEngineType

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

VehicleHeading

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

VehicleHeightInMeters

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

VehicleLengthInMeters

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

VehicleLoadType

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

VehicleMaxSpeedInKilometersPerHour

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

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

车辆的重量(以公斤为单位)。

  • 如果设置了任何效率参数,则是必需的。
  • 在消耗模型的上下文中使用时,它必须严格为正。 考虑重量限制。
  • 如果未指定详细内容 Consumption Model ,并且 的值为 vehicleWeight 非零,则考虑权重限制。
  • 在所有其他情况下,将忽略此参数。
合理值:对于燃烧模型:1600,对于电气模型:1900
VehicleWidthInMeters

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

Windingness

惊心动魄的路线的转弯水平。 此参数只能与 routeType.Thrilling结合使用。

适用于