Freigeben über


RouteDirectionOptions Klasse

Definition

Optionen zum Rendern statischer Bilder.

public class RouteDirectionOptions
type RouteDirectionOptions = class
Public Class RouteDirectionOptions
Vererbung
RouteDirectionOptions

Konstruktoren

RouteDirectionOptions()

Konstruktor von RouteDirectionOptions.

Eigenschaften

AccelerationEfficiency

Gibt die Effizienz der Umwandlung chemischer Energie, die im Kraftstoff gespeichert ist, in kinetische Energie umzuwandeln, wenn das Fahrzeug beschleunigt (d. h. KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed_ wird durch Umwandlung von verbrauchtem Brennstoff in chemische Energie mit fuelEnergyDensityInMJoulesPerLitergewonnen. Muss mit decelerationEfficiencygekoppelt sein. Der zulässige Wertebereich ist 0,0 bis 1/decelerationEfficiency. Vernünftige Werte : für Verbrennungsmodell : 0.33, für elektrisches Modell : 0.66

AlternativeType

Steuert die Optimalität der berechneten Alternativen im Hinblick auf die angegebenen Planungskriterien im Vergleich zur Referenzroute.

ArriveAt

Datum und Uhrzeit der Ankunft am Zielpunkt. Sie muss als dateTime angegeben werden. Wenn kein Zeitzonenoffset angegeben wird, wird davon ausgegangen, dass es sich um den des Zielpunkts handelt. Der wert "arriveAt" muss in der Zukunft sein. Der parameter arriveAt kann nicht in Verbindung mit departAt, minDeviationDistance oder minDeviationTime verwendet werden.

AuxiliaryPowerInKilowatts

Gibt die Energiemenge an, die für die Aufrechterhaltung von Hilfssystemen in Kilowatt (kW) verbraucht wird. Es kann verwendet werden, um den Verbrauch aufgrund von Geräten und Systemen wie Klimaanlagen, Radio, Heizung usw. anzugeben. Sinnvolle Werte : 1.7

AuxiliaryPowerInLitersPerHour

Gibt die Kraftstoffmenge an, die für die Nebensysteme des Fahrzeugs verbraucht wird, in Litern pro Stunde. Es kann verwendet werden, um den Verbrauch aufgrund von Geräten und Systemen wie Klimaanlagen, Radio, Heizung usw. anzugeben. Sinnvolle Werte : 0.2

Avoid

Gibt etwas an, das die Routenberechnung beim Bestimmen der Route vermeiden soll. Kann mehrmals in einer Anforderung angegeben werden. In calculateReachableRange-Anforderungen darf der Wert alreadyUsedRoads nicht verwendet werden.

ComputeBestWaypointOrder

Ordnen Sie die Routenwegpunkte mit einem schnellen heuristischen Algorithmus neu an, um die Routenlänge zu reduzieren. Erzielt die besten Ergebnisse, wenn sie in Verbindung mit routeType shortest verwendet werden. Beachten Sie, dass Ursprung und Ziel von den optimierten Wegpunktindizes ausgeschlossen sind. Um Ursprung und Ziel in die Antwort einzubeziehen, erhöhen Sie alle Indizes um 1, um den Ursprung zu berücksichtigen, und fügen Sie dann das Ziel als endgültigen Index hinzu. Mögliche Werte sind true und false. True berechnet nach Möglichkeit eine bessere Reihenfolge, darf aber nicht in Verbindung mit maxAlternatives-Wert größer als 0 oder in Verbindung mit Kreis-Wegpunkten verwendet werden. False verwendet die Speicherorte in der angegebenen Reihenfolge und darf nicht in Verbindung mit routeRepresentation none verwendet werden.

ConstantSpeedConsumptionInKilowattHoursPerHundredKilometer

Gibt die geschwindigkeitsabhängige Komponente des Verbrauchs an. Wird als ungeordnete Liste von Geschwindigkeits-Verbrauchsraten-Paaren bereitgestellt. Die Liste definiert Punkte für eine Verbrauchskurve. Verbrauchsraten für Geschwindigkeiten, die nicht in der Liste enthalten sind, sind wie folgt zu finden:

  • durch lineare Interpolation, wenn die angegebene Geschwindigkeit zwischen zwei Geschwindigkeiten in der Liste liegt
  • andernfalls durch lineare Extrapolation, sofern eine Konstante (ΔConsumption/ΔSpeed) von den nächsten beiden Punkten in der Liste bestimmt wird
Die Liste muss zwischen 1 und 25 Punkten (einschließlich) enthalten und darf keine doppelten Punkte für dieselbe Geschwindigkeit enthalten. Wenn er nur einen einzelnen Punkt enthält, wird die Verbrauchsrate dieses Punkts ohne weitere Verarbeitung verwendet. Der für die größte Geschwindigkeit angegebene Verbrauch muss größer oder gleich dem der vorletzten größten Geschwindigkeit sein. Dadurch wird sichergestellt, dass die Extrapolation nicht zu negativen Verbrauchsraten führt. Ebenso können Verbrauchswerte, die für die zwei kleinsten Geschwindigkeiten in der Liste angegeben sind, nicht zu einer negativen Verbrauchsrate für eine geringere Geschwindigkeit führen. Der gültige Bereich für die Verbrauchswerte (ausgedrückt in kWh/100km) liegt zwischen 0,01 und 100000,0. Sinnvolle Werte: 50,8.2:130,21.3 Dieser Parameter ist für Electric consumption modelerforderlich.
ConstantSpeedConsumptionInLitersPerHundredKilometer

Gibt die geschwindigkeitsabhängige Komponente des Verbrauchs an. Wird als ungeordnete Liste von durch Doppelpunkt getrennten Geschwindigkeitsverbrauchs-Rate-Paaren & bereitgestellt. Die Liste definiert Punkte für eine Verbrauchskurve. Verbrauchsraten für Geschwindigkeiten, die nicht in der Liste enthalten sind, sind wie folgt zu finden:

  • durch lineare Interpolation, wenn die angegebene Geschwindigkeit zwischen zwei Geschwindigkeiten in der Liste liegt
  • andernfalls durch lineare Extrapolation, sofern eine Konstante (ΔConsumption/ΔSpeed) von den nächsten beiden Punkten in der Liste bestimmt wird
Die Liste muss zwischen 1 und 25 Punkten (einschließlich) enthalten und darf keine doppelten Punkte für dieselbe Geschwindigkeit enthalten. Wenn er nur einen einzelnen Punkt enthält, wird die Verbrauchsrate dieses Punkts ohne weitere Verarbeitung verwendet. Der für die größte Geschwindigkeit angegebene Verbrauch muss größer oder gleich dem der vorletzten größten Geschwindigkeit sein. Dadurch wird sichergestellt, dass die Extrapolation nicht zu negativen Verbrauchsraten führt. Ebenso können Verbrauchswerte, die für die zwei kleinsten Geschwindigkeiten in der Liste angegeben sind, nicht zu einer negativen Verbrauchsrate für eine geringere Geschwindigkeit führen. Der gültige Bereich für die Verbrauchswerte (ausgedrückt in l/100km) liegt zwischen 0,01 und 100000,0. Sensible Werte : 50,6.3:130,11.5 Hinweis : Dieser Parameter ist für das Verbrennungsverbrauchsmodell erforderlich
CurrentChargeInKilowattHours

Gibt die aktuelle Stromversorgung in Kilowattstunden (kWh) an. Dieser Parameter ist mit dem Parameter koexistiert MaxChargeInKilowattHour . Der zulässige Wertebereich ist 0,0 bis MaxChargeInKilowattHour. Sinnvolle Werte : 43

CurrentFuelInLiters

Gibt den aktuellen Kraftstoffbedarf in Litern an. Sinnvolle Werte : 55

DecelerationEfficiency

Gibt die Effizienz der Umwandlung von kinetischer Energie in eingesparten (nicht verbrauchten) Kraftstoff an, wenn das Fahrzeug abbremst (d. h. ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved_ wird durch Umwandlung von gespeichertem (nicht verbrauchtem) Brennstoff in Energie mithilfe fuelEnergyDensityInMJoulesPerLitervon gewonnen. Muss mit accelerationEfficiencygekoppelt sein. Der zulässige Wertebereich ist 0,0 bis 1/accelerationEfficiency. Vernünftige Werte : für Verbrennungsmodell : 0.83, für elektrisches Modell : 0.91

DepartAt

Das Datum und die Uhrzeit des Abflugs vom Ursprungspunkt. Die Abfahrtszeiten müssen ab sofort als dateTime angegeben werden. Wenn kein Zeitzonenoffset angegeben wird, wird davon ausgegangen, dass es sich um den des Ursprungspunkts handelt. Der wert "departAt" muss in der Zukunft im Datum-Uhrzeit-Format (1996-12-19T16:39:57-08:00) vorliegen.

DownhillEfficiency

Gibt die Effizienz der Umwandlung potenzieller Energie in eingesparten (nicht verbrauchten) Kraftstoff an, wenn das Fahrzeug die Höhe verliert (d. h. ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved_ wird durch Umwandlung von gespeichertem (nicht verbrauchtem) Brennstoff in Energie mithilfe fuelEnergyDensityInMJoulesPerLitervon gewonnen. Muss mit uphillEfficiencygekoppelt sein. Der zulässige Wertebereich ist 0,0 bis 1/uphillEfficiency. Vernünftige Werte : für Verbrennungsmodell : 0.51, für elektrisches Modell : 0.73

FuelEnergyDensityInMegajoulesPerLiter

Gibt die Menge an chemischer Energie an, die in einem Liter Kraftstoff in Megajoules (MJ) gespeichert ist. Es wird in Verbindung mit den Parametern für Umrechnungen Efficiency zwischen eingesparter oder verbrauchter Energie und Brennstoff verwendet. Beispielsweise beträgt die Energiedichte 34,2 MJ/l für Benzin und 35,8 MJ/l für Dieselkraftstoff. Dieser Parameter ist erforderlich, wenn ein Parameter Efficiency festgelegt ist. Sinnvolle Werte : 34.2

InclineLevel

Grad der Hügeligkeit für aufregende Route. Dieser Parameter kann nur in Verbindung mit routeType.Thrillingverwendet werden.

InstructionsType

Falls angegeben, werden Anleitungen zurückgegeben. Beachten Sie, dass der parameter instructionsType nicht in Verbindung mit routeRepresentation=none verwendet werden kann.

IsCommercialVehicle

Gibt an, ob das Fahrzeug zu gewerblichen Zwecken genutzt wird. Nutzfahrzeuge dürfen möglicherweise nicht auf einigen Straßen fahren.

Language

Der Sprachparameter bestimmt die Sprache der Leitmeldungen. Richtige Nomen (die Namen von Straßen, Plätzen usw.) werden in der angegebenen Sprache zurückgegeben, oder, wenn dies nicht verfügbar ist, werden sie in einer verfügbaren Sprache zurückgegeben, die sich in ihrer Nähe befindet. Zulässige Werte sind (eine Teilmenge von) die IETF-Sprachtags. Die derzeit unterstützten Sprachen sind im Abschnitt Unterstützte Sprachen aufgeführt. Standardwert: EnglishGreatBritain

MaxAlternatives

Anzahl der gewünschten alternativen Routen, die berechnet werden sollen. Standardwert: 0, Minimum: 0 und Maximum: 5.

MaxChargeInKilowattHours

Gibt die maximale Elektrische Energieversorgung in Kilowattstunden (kWh) an, die in der Fahrzeugbatterie gespeichert werden kann. Dieser Parameter ist mit dem Parameter koexistiert currentChargeInkilowattHour . Der Mindestwert muss größer oder gleich currentChargeInkilowattHoursein. Vernünftige Werte : 85

MinDeviationDistance

Alle zurückgegebenen alternativen Routen folgen der Referenzroute (siehe Abschnitt POST-Anforderungen) vom Ursprungspunkt der calculateRoute-Anforderung für mindestens diese Anzahl von Metern. Kann nur beim Rekonstruieren einer Route verwendet werden. Der minDeviationDistance-Parameter kann nicht in Verbindung mit arriveAt verwendet werden.

MinDeviationTime

Alle zurückgegebenen alternativen Routen folgen mindestens dieser Anzahl von Sekunden der Referenzroute (siehe Abschnitt POST-Anforderungen) vom Ursprungspunkt der calculateRoute-Anforderung. Kann nur beim Rekonstruieren einer Route verwendet werden. Der minDeviationTime-Parameter kann nicht in Verbindung mit arriveAt verwendet werden. Der Standardwert ist 0. Das Festlegen von )minDeviationTime_ auf einen Wert größer als 0 (null) hat folgende Folgen: Der Ursprungspunkt der calculateRoute-Anforderung muss sich auf (oder sehr nahe) der Eingabereferenzroute befinden. Wenn dies nicht der Fall ist, wird ein Fehler zurückgegeben. Der Ursprungspunkt muss sich jedoch nicht am Anfang der Eingabereferenzroute befinden (er kann als die aktuelle Fahrzeugposition auf der Referenzroute betrachtet werden). Die Referenzroute, die als erste Route in der calculateRoute-Antwort zurückgegeben wird, beginnt an dem in der calculateRoute-Anforderung angegebenen Ursprungspunkt. Der anfängliche Teil der Eingabeverweisroute, bis der Ursprungspunkt von der Antwort ausgeschlossen wird. Die Werte von minDeviationDistance und minDeviationTime bestimmen, wie weit alternative Routen ab dem Ursprungspunkt garantiert der Referenzroute folgen. Die Route muss verwenden departAt. Der VehicleHeading wird ignoriert.

RouteDirectionParameters

Wird zum Rekonstruieren einer Route und zum Berechnen von null oder mehr alternativen Routen zu dieser Referenzroute verwendet. Die bereitgestellte Sequenz von Koordinaten wird als Eingabe für die Routenrekonstruktion verwendet. Die alternativen Routen werden zwischen den Ursprungs- und Zielpunkten berechnet, die in den Speicherorten des Basispfadparameters angegeben sind. Wenn sowohl minDeviationDistance als auch minDeviationTime auf Null festgelegt sind, wird erwartet, dass sich diese Ursprungs- und Zielpunkte am Anfang bzw. am Ende der Referenzroute befinden . Zwischenspeicherorte (Wegpunkte) werden bei Verwendung von supportingPoints nicht unterstützt. Das Festlegen mindestens eines von minDeviationDistance oder minDeviationTime auf einen Wert größer 0 hat die folgenden Folgen:

  • Der Ursprungspunkt der calculateRoute-Anforderung muss sich auf (oder sehr nahe) der Eingabereferenzroute befinden. Wenn dies nicht der Fall ist, wird ein Fehler zurückgegeben. Der Ursprungspunkt muss sich jedoch nicht am Anfang der Eingabereferenzroute befinden (er kann als die aktuelle Fahrzeugposition auf der Referenzroute betrachtet werden).
  • Die Referenzroute, die als erste Route in der calculateRoute-Antwort zurückgegeben wird, beginnt an dem in der calculateRoute-Anforderung angegebenen Ursprungspunkt. Der anfängliche Teil der Eingabeverweisroute, bis der Ursprungspunkt von der Antwort ausgeschlossen wird.
  • Die Werte von minDeviationDistance und minDeviationTime bestimmen, wie weit alternative Routen ab dem Ursprungspunkt garantiert der Referenzroute folgen.
  • Die Route muss "departAt" verwenden.
  • Das vehicleHeading wird ignoriert.
RouteRepresentationForBestOrder

Gibt die Darstellung der Als Antwort bereitgestellten Routen an. Dieser Parameterwert kann nur in Verbindung mit computeBestOrder=true verwendet werden.

RouteType

Der Typ der angeforderten Route.

SectionFilter

Gibt an, welcher der Abschnittstypen in der Routenantwort gemeldet wird. <br><br>Wenn beispielsweise sectionType = pedestrian die Abschnitte zurückgegeben werden, die nur für Fußgänger geeignet sind. Es können mehrere Typen verwendet werden. Der StandardabschnittType bezieht sich auf die travelMode-Eingabe. Standardmäßig ist travelMode auf Auto festgelegt.

ShouldReportEffectiveSettings

Gibt an, welche Daten zu Diagnosezwecken gemeldet werden sollen. Bei true werden die effektiven Parameter oder Daten gemeldet, die beim Aufrufen der API verwendet werden. Bei Standardparametern wird die Standardeinstellung angezeigt, wenn der Parameter nicht vom Aufrufer angegeben wurde.

TravelMode

Der Reisemodus für die angeforderte Route. Wenn nicht definiert, ist carder Standardwert . Beachten Sie, dass der angeforderte travelMode möglicherweise nicht für die gesamte Route verfügbar ist. Wenn der angeforderte travelMode für einen bestimmten Abschnitt nicht verfügbar ist, lautet das travelMode-Element der Antwort für diesen Abschnitt "other". Beachten Sie, dass die Reisemodi Bus, Motorrad, Taxi und Van BETA-Funktionalität sind. Vollständige Einschränkungsdaten sind nicht in allen Bereichen verfügbar. In calculateReachableRange Anforderungen dürfen die Werte Fahrrad und Fußgänger nicht verwendet werden.

TravelTimeType

Gibt an, ob zusätzliche Reisezeiten mit verschiedenen Arten von Verkehrsinformationen (keine, historischen, live) sowie der am besten geschätzten Standardreisezeit zurückgegeben werden sollen.

UphillEfficiency

Gibt die Effizienz der Umwandlung chemischer Energie, die im Kraftstoff gespeichert ist, in potenzielle Energie, wenn das Fahrzeug an Höhe gewinnt (d. h. PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed_ wird durch Umwandlung des verbrauchten Brennstoffs in chemische Energie mit fuelEnergyDensityInMJoulesPerLitergewonnen. Muss mit downhillEfficiencygekoppelt werden. Der zulässige Wertebereich liegt zwischen 0,0 und 1/downhillEfficiency. Sensible Werte : für Verbrennungsmodell : 0,27, für elektrisches Modell : 0,74

UseTrafficData

Mögliche Werte:

  • true – Berücksichtigen Sie während des Routings alle verfügbaren Datenverkehrsinformationen.
  • false – Aktuelle Datenverkehrsdaten während des Routings ignorieren. Beachten Sie, dass die aktuellen Datenverkehrsdaten ignoriert werden.
Während des Routings wird die Auswirkung des historischen Verkehrs auf die effektiven Straßengeschwindigkeiten noch berücksichtigt.
VehicleAxleWeightInKilograms

Gewicht pro Achse des Fahrzeugs in Kilogramm. Der Wert 0 bedeutet, dass Gewichtsbeschränkungen pro Achse nicht berücksichtigt werden.

VehicleEngineType

Motortyp des Fahrzeugs. Wenn ein detailliertes Verbrauchsmodell angegeben wird, muss es mit dem Wert von vehicleEngineTypekonsistent sein.

VehicleHeading

Die Richtungsrichtung des Fahrzeugs in Grad, beginnend bei true Nord und weiter im Uhrzeigersinn. Norden ist 0 Grad, Osten 90 Grad, Süden 180 Grad, West ist 270 Grad. Mögliche Werte 0-359.

VehicleHeightInMeters

Höhe des Fahrzeugs in Metern. Der Wert 0 bedeutet, dass Höheneinschränkungen nicht berücksichtigt werden.

VehicleLengthInMeters

Länge des Fahrzeugs in Metern. Der Wert 0 bedeutet, dass Längeneinschränkungen nicht berücksichtigt werden.

VehicleLoadType

Arten von Fracht, die als gefahrgut klassifiziert werden können und von einigen Straßen eingeschränkt werden können. Verfügbare VehicleLoadType-Werte sind US Hazmat Klassen 1 bis 9 sowie generische Klassifizierungen für die Verwendung in anderen Ländern. Werte, die mit USHazmat beginnen, gelten für US-Routing, während otherHazmat für alle anderen Länder verwendet werden sollte. vehicleLoadType kann mehrmals angegeben werden. Dieser Parameter wird derzeit nur für travelMode=truck berücksichtigt.

VehicleMaxSpeedInKilometersPerHour

Höchstgeschwindigkeit des Fahrzeugs in km/Stunde. Die Höchstgeschwindigkeit im Fahrzeugprofil wird verwendet, um zu überprüfen, ob ein Fahrzeug auf Autobahnen zugelassen ist.

  • Der Wert 0 bedeutet, dass bei der Routenplanung ein geeigneter Wert für das Fahrzeug ermittelt und angewendet wird.
  • Ein Wert ungleich 0 kann während der Routenplanung überschrieben werden. Beispielsweise beträgt der aktuelle Verkehrsfluss 60 km/h. Wenn die Höchstgeschwindigkeit des Fahrzeugs auf 50 km/h festgelegt ist, berücksichtigt der Routingmotor 60 km/h, da dies die aktuelle Situation ist. Wenn die Höchstgeschwindigkeit des Fahrzeugs mit 80 km/h angegeben wird, der aktuelle Verkehrsfluss jedoch 60 km/h beträgt, verwendet der Routingmotor wieder 60 km/h.
VehicleWeightInKilograms

Gewicht des Fahrzeugs in Kilogramm.

  • Dies ist obligatorisch, wenn einer der *Efficiency-Parameter festgelegt ist.
  • Es muss streng positiv sein, wenn es im Kontext des Verbrauchsmodells verwendet wird. Gewichtungseinschränkungen werden berücksichtigt.
  • Wenn keine detaillierte Consumption Model Angabe angegeben ist und der Wert von vehicleWeight ungleich 0 (null) ist, werden Gewichtungseinschränkungen berücksichtigt.
  • In allen anderen Fällen wird dieser Parameter ignoriert.
Sensible Werte : für Verbrennungsmodell : 1600, für elektrisches Modell : 1900
VehicleWidthInMeters

Breite des Fahrzeugs in Metern. Der Wert 0 bedeutet, dass Breiteseinschränkungen nicht berücksichtigt werden.

Windingness

Grad der Kurven für aufregende Route. Dieser Parameter kann nur in Verbindung mit routeType.Thrillingverwendet werden.

Gilt für: