RouteGetRouteDirectionsWithAdditionalParametersQueryParamProperties interface

Gibt die Effizienz der Umwandlung chemischer Energie im Kraftstoff in kinetische Energie an, wenn das Fahrzeug beschleunigt (d. h.Kine EnergyGained/Chemical EnergyConsumed). ChemicalEnergieConsumed wird durch umwandlung verbrauchten Kraftstoff in chemische Energie mit fuel EnergyDensityInMJoulesPerLiter.

Muss mit DeelerationEfficiencygekoppelt werden.

Der zulässige Wertebereich ist 0,0 bis 1/VerzögerungEffizienz.

Vernünftige Werte : für Verbrennungsmodell : 0,33, für Elektromodell : 0,66

accelerationEfficiency?: number

Eigenschaftswert

Steuert die Optimaleität in Bezug auf die vorgegebenen Planungskriterien der berechneten Alternativen im Vergleich zur Referenzroute.

alternativeType?: "anyRoute" | "betterRoute"

Eigenschaftswert

Das Datum und die Uhrzeit der Ankunft am Zielpunkt, der als dateTime Wert formatiert ist, wie in RFC 3339, Abschnitt 5.6definiert, mit einem optionalen Offset der Zeitzone. Wenn kein Zeitzonenoffset angegeben wird, wird davon ausgegangen, dass es sich um den Zielpunkt handelt.

Beispiele:

• 2023-12-19T16:39:57
• 2023-12-19T16:39:57-08:00

Der parameter arriveAt kann nicht in Verbindung mit departAt, minDeviationDistance oder minDeviationTimeverwendet werden.

arriveAt?: string | Date

Eigenschaftswert

Gibt die Menge der verbrauchten Energie für die Aufrechterhaltung von Hilfssystemen in Watten (kW) an.

Es kann verwendet werden, um den Verbrauch aufgrund von Geräten und Systemen wie Ac-Systemen, Funk, Heizung usw. anzugeben.

Sensible Werte : 1,7

auxiliaryPowerInkW?: number

Eigenschaftswert

Gibt die Menge des verbrauchten Kraftstoffs für die Erhaltung von Hilfssystemen des Fahrzeugs in Litern pro Stunde an.

Es kann verwendet werden, um den Verbrauch aufgrund von Geräten und Systemen wie Ac-Systemen, Funk, Heizung usw. anzugeben.

Sensible Werte : 0,2

auxiliaryPowerInLitersPerHour?: number

Eigenschaftswert

Gibt etwas an, das bei der Routenberechnung beim Bestimmen der Route vermieden werden soll. Kann in einer Anforderung mehrmals angegeben werden, z. B. "&avoid=autobahnen&avoid=tollRoads&avoid=fähren". In Route Range-Anforderungen darf der Wert "AlreadyUsedRoads" nicht verwendet werden.

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

Eigenschaftswert

Ordnen Sie die Routenwegpunkte mithilfe eines schnellen Heuristikalgorithmus neu an, um die Routenlänge zu reduzieren. Erzielt beste Ergebnisse, wenn sie in Verbindung mit routeType kürzestenverwendet werden. Beachten Sie, dass Ursprung und Ziel von den optimierten Wegpunktindizes ausgeschlossen werden. Um Den Ursprung und das Ziel in die Antwort einzuschließen, erhöhen Sie alle Indizes um 1, um den Ursprung zu berücksichtigen, und fügen Sie das Ziel dann als endgültigen Index hinzu. Mögliche Werte sind wahr oder falsch. 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 keineverwendet werden.

computeBestOrder?: boolean

Eigenschaftswert

Gibt an, ob zusätzliche Reisezeiten mit unterschiedlichen Arten von Verkehrsinformationen (keine, historischen, live) sowie die standardmäßige am besten geschätzte Reisezeit zurückgegeben werden sollen.

computeTravelTimeFor?: "none" | "all"

Eigenschaftswert

Gibt die geschwindigkeitsabhängige Komponente des Verbrauchs an.

Wird als ungeordnete Liste der Geschwindigkeits-/Verbrauchsratenpaare 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

• durch lineare Extrapolation andernfalls, vorausgesetzt, eine Konstante (ΔConsumption/ΔSpeed), die durch die nächsten zwei Punkte in der Liste bestimmt wird

Die Liste muss zwischen 1 und 25 Punkt (einschließlich) enthalten und darf keine doppelten Punkte für dieselbe Geschwindigkeit enthalten. Wenn sie nur einen einzigen 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.

Entsprechend können verbrauchsspezifische Werte für die beiden kleinsten Geschwindigkeiten in der Liste nicht zu einer negativen Verbrauchsrate für eine kleinere Geschwindigkeit führen.

Der gültige Bereich für die Verbrauchswerte (ausgedrückt in kWh/100km) liegt zwischen 0,01 und 100000,0.

Sensible Werte : 50,8,2:130,21,3

Dieser Parameter ist für Elektrische Verbrauchsmodellerforderlich.

constantSpeedConsumptionInkWhPerHundredkm?: string

Eigenschaftswert

Gibt die geschwindigkeitsabhängige Komponente des Verbrauchs an.

Bereitgestellt als eine nicht geordnete Liste der durch Doppelpunkt getrennten Geschwindigkeiten & Verbrauchsratenpaare. 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

• durch lineare Extrapolation andernfalls, vorausgesetzt, eine Konstante (ΔConsumption/ΔSpeed), die durch die nächsten zwei Punkte in der Liste bestimmt wird

Die Liste muss zwischen 1 und 25 Punkt (einschließlich) enthalten und darf keine doppelten Punkte für dieselbe Geschwindigkeit enthalten. Wenn sie nur einen einzigen 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.

Entsprechend können verbrauchsspezifische Werte für die beiden kleinsten Geschwindigkeiten in der Liste nicht zu einer negativen Verbrauchsrate für eine kleinere 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 Verbrennungsverbrauchsmodellerforderlich.

constantSpeedConsumptionInLitersPerHundredkm?: string

Eigenschaftswert

Gibt die aktuelle elektrische Energieversorgung in Wattstunden (kWh) an.

Dieser Parameter ist mit maxChargeInkWh Parameter koexistiert.

Der zulässige Wertebereich beträgt 0,0 bis maxChargeInkWh.

Sensible Werte : 43

currentChargeInkWh?: number

Eigenschaftswert

Gibt die aktuelle Kraftstoffversorgung in Litern an.

Sensible Werte : 55

currentFuelInLiters?: number

Eigenschaftswert

Gibt die Effizienz der Umwandlung kinetischer Energie in gespeicherten (nicht verbrauchten) Kraftstoff an, wenn das Fahrzeug verzögert (d. h. Chemical EnergySaved/Kine EnergyLost). ChemicalEnergieSaved wird durch Umwandlung von gespeicherten (nicht verbrauchten) Brennstoffen in Energie mit fuelEnergieDensityInMJoulesPerLitergewonnen.

Muss mit accelerationEfficiencygekoppelt werden.

Der zulässige Wertebereich ist 0,0 bis 1/accelerationEfficiency.

Vernünftige Werte : für Verbrennungsmodell : 0,83, für Elektromodell : 0,91

decelerationEfficiency?: number

Eigenschaftswert

Das Datum und die Uhrzeit des Abflugpunkts, der als dateTime Wert formatiert ist, wie in RFC 3339, Abschnitt 5.6definiert, mit einem optionalen Offset der Zeitzone. Wenn kein Zeitzonenoffset angegeben wird, wird davon ausgegangen, dass es sich um den Ursprungspunkt handelt.

• Standardwert: jetzt
• Anderer Wert: dateTime

Beispiele:

• 2023-12-19T16:39:57
• 2023-12-19T16:39:57-08:00

Der parameter departAt kann nicht in Verbindung mit arriveAtverwendet werden.

departAt?: string | Date

Eigenschaftswert

Gibt die Effizienz der Umwandlung potenzieller Energie in gespeicherten (nicht verbrauchten) Kraftstoff an, wenn das Fahrzeug die Höhe verliert (d. h. Chemical EnergySaved/Potential EnergyLost). ChemicalEnergieSaved wird durch Umwandlung von gespeicherten (nicht verbrauchten) Brennstoffen in Energie mit fuelEnergieDensityInMJoulesPerLitergewonnen.

Muss mit uphillEfficiencygekoppelt werden.

Der zulässige Wertebereich ist 0,0 bis 1/uphillEfficiency.

Sensible Werte : für Verbrennungsmodell : 0,51, für Elektromodell : 0,73

downhillEfficiency?: number

Eigenschaftswert

Gibt die Menge an chemischer Energie an, die in einem Liter Kraftstoff in Megajoules (MJ) gespeichert ist. Es wird in Verbindung mit dem *Efficiency Parametern für Umwandlungen zwischen gespeicherter oder verbrauchter Energie und Kraftstoff verwendet. Die Energiedichte beträgt beispielsweise 34,2 MJ/l für Benzin und 35,8 MJ/l für Dieselkraftstoff.

Dieser Parameter ist erforderlich, wenn *Efficiency Parameter festgelegt ist.

Sensible Werte : 34,2

fuelEnergyDensityInMJoulesPerLiter?: number

Eigenschaftswert

Grad der Hügeligkeit für spannende Route. Dieser Parameter kann nur in Verbindung mit routeType=thrilling verwendet werden.

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

Eigenschaftswert

Wenn angegeben, werden Anleitungsanweisungen zurückgegeben. Beachten Sie, dass der instructionsType-Parameter nicht in Verbindung mit routeRepresentation=none verwendet werden kann.

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

Eigenschaftswert

Der Sprachparameter bestimmt die Sprache der Anleitungsmeldungen. Es wirkt sich nicht auf richtige Substantive aus (die Namen von Straßen, Plätzen usw.) Es hat keine Auswirkung, wenn instructionsType=coded. Zulässige Werte sind (eine Teilmenge) der beschriebenen IETF-Sprachtags.

language?: string

Eigenschaftswert

Die Anzahl der gewünschten alternativen Routen, die berechnet werden sollen. Standard: 0, Minimum: 0 und maximal: 5

maxAlternatives?: number

Eigenschaftswert

Gibt die maximale elektrische Energieversorgung in Wattstunden (kWh) an, die in der Batterie des Fahrzeugs gespeichert werden kann.

Dieser Parameter ist mit currentChargeInkWh Parameter koexistiert.

Der Mindestwert muss größer oder gleich currentChargeInkWhsein.

Sensible Werte : 85

maxChargeInkWh?: number

Eigenschaftswert

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 Parameter "minDeviationDistance" kann nicht in Verbindung mit "arriveAt" verwendet werden.

minDeviationDistance?: number

Eigenschaftswert

Alle zurückgegebenen alternativen Routen folgen der Referenzroute (siehe Abschnitt POST-Anforderungen) vom Ursprungspunkt der calculateRoute-Anforderung für mindestens diese Anzahl von Sekunden. Kann nur beim Rekonstruieren einer Route verwendet werden. Der parameter minDeviationTime kann nicht in Verbindung mit "arriveAt" verwendet werden. Der Standardwert ist 0. Das Festlegen von )minDeviationTime_ auf einen Wert größer als 0 hat die folgenden Folgen:

• Der Ursprungspunkt des calculateRoute Anforderung muss sich auf der Eingabereferenzroute befinden (oder sehr nahe).
  • Wenn dies nicht der Fall ist, wird ein Fehler zurückgegeben.
  • Der Ausgangspunkt muss sich jedoch nicht am Anfang der Eingabebezugsroute befinden (er kann als aktuelle Fahrzeugposition auf der Referenzroute betrachtet werden).
• Die Referenzroute, die als erste Route in der calculateRoute Response zurückgegeben wird, beginnt am Ursprungspunkt, der in der calculateRoute Anforderung angegeben ist. Der erste Teil der Eingabereferenzroute bis zum Ursprungspunkt wird von der Antwort ausgeschlossen.
• Die Werte von minDeviationDistance und minDeviationTime bestimmen, wie weit alternative Routen garantiert werden, ab dem Ausgangspunkt die Referenzroute zu verfolgen.
• Die Route muss departAtverwenden.
• Die vehicleHeading wird ignoriert.

minDeviationTime?: number

Eigenschaftswert

Die Koordinaten, durch die die Route berechnet wird, wird durch einen Doppelpunkt getrennt. Mindestens zwei Koordinaten sind erforderlich. Der erste ist der Ursprung und das letzte ist das Ziel der Route. Optionale Koordinaten zwischeneinander fungieren als WayPoints in der Route. Sie können bis zu 150 WayPoints bestehen.

query: string

Eigenschaftswert

Gibt an, welche Daten für Diagnosezwecke gemeldet werden sollen. Der einzige mögliche Wert ist effectiveSettings. Meldet die effektiven Parameter oder Daten, die beim Aufrufen der API verwendet werden. Bei standardmäßigen Parametern wird die Standardeinstellung angezeigt, bei der der Parameter vom Aufrufer nicht angegeben wurde.

report?: "effectiveSettings"

Eigenschaftswert

Gibt die Darstellung des Satzes von Routen an, die als Antwort bereitgestellt werden.

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

Eigenschaftswert

Der Typ der angeforderten Route.

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

Eigenschaftswert

Gibt an, welche Der Abschnittstypen in der Routenantwort gemeldet werden.

Beispiel: SectionType = Fußgänger die Abschnitte, die nur für Fußgänger geeignet sind, werden zurückgegeben. Kann in einer Anforderung mehrmals angegeben werden, z. B. "§ionType=carTrain§ionType=pedestrian§ionType=autobahn". Der Standard sectionType bezieht sich auf die travelMode-Eingabe. "travelMode" ist standardmäßig auf "Auto" festgelegt.

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

Eigenschaftswert

Mögliche Werte:

• true – Berücksichtigen Sie alle verfügbaren Datenverkehrsinformationen während des Routings.
• false – Aktuelle Datenverkehrsdaten während des Routings ignorieren. Beachten Sie, dass auch wenn die aktuellen Verkehrsdaten während der Weiterleitung ignoriert werden, die Auswirkungen des historischen Verkehrs auf effektive Straßengeschwindigkeiten immer noch integriert werden.

traffic?: boolean

Eigenschaftswert

Der Reisemodus für die angeforderte Route. Wenn nicht definiert, lautet der Standardwert "Auto". 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 Reisemodi Bus, Motorrad, Taxi und Van beta Funktionalität sind. Vollständige Einschränkungsdaten sind in allen Bereichen nicht verfügbar.

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

Eigenschaftswert

Gibt die Effizienz der Umwandlung chemischer Energie im Kraftstoff in potenzielle Energie an, wenn das Fahrzeug eine Erhöhung erhält (d. h. PotentialEnergieGained/ChemicalEnergieConsumed). ChemicalEnergieConsumed wird durch umwandlung verbrauchten Kraftstoff in chemische Energie mit fuel EnergyDensityInMJoulesPerLiter.

Muss mit downhillEfficiencygekoppelt werden.

Der zulässige Wertebereich ist 0,0 bis 1/downhillEfficiency.

Sensible Werte : für Verbrennungsmodell : 0,27, für Elektromodell : 0,74

uphillEfficiency?: number

Eigenschaftswert

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

vehicleAxleWeight?: number

Eigenschaftswert

Ob das Fahrzeug für gewerbliche Zwecke verwendet wird. Nutzfahrzeuge dürfen auf einigen Straßen möglicherweise nicht fahren.

vehicleCommercial?: boolean

Eigenschaftswert

Motortyp des Fahrzeugs. Wenn ein detailliertes Verbrauchsmodell angegeben wird, muss es mit dem Wert von vehicleEngineTypeübereinstimmen.

vehicleEngineType?: "combustion" | "electric"

Eigenschaftswert

Die Richtungsrichtung des Fahrzeugs in Grad, die mit true Nord beginnt und im Uhrzeigersinn fortsetzt. Nord ist 0 Grad, Osten ist 90 Grad, Süd ist 180 Grad, West ist 270 Grad. Mögliche Werte 0-359

vehicleHeading?: number

Eigenschaftswert

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

vehicleHeight?: number

Eigenschaftswert

Länge des Fahrzeugs in Metern. Ein Wert von 0 bedeutet, dass Längenbeschränkungen nicht berücksichtigt werden.

vehicleLength?: number

Eigenschaftswert

Ladungstypen, die als gefährliche Stoffe eingestuft 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/Regionen. Werte, die mit USHazmat beginnen, gelten für us-routing, während andereHazmat für alle anderen Länder/Regionen verwendet werden sollten. vehicleLoadType kann mehrmals angegeben werden. Dieser Parameter gilt derzeit nur für travelMode=truck.

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

Eigenschaftswert

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

• Ein Wert von 0 bedeutet, dass bei der Routenplanung ein entsprechender Wert für das Fahrzeug bestimmt und angewendet wird.

• Ein Wert ungleich Null kann während der Routenplanung außer Kraft gesetzt werden. Beispielsweise beträgt der aktuelle Verkehrsfluss 60 km/Stunde. Wenn die Maximale Geschwindigkeit des Fahrzeugs auf 50 km/Stunde festgelegt ist, berücksichtigt der Routingmotor 60 km/Stunde, da dies die aktuelle Situation ist. Wenn die maximale Geschwindigkeit des Fahrzeugs als 80 km/Stunde angegeben wird, aber der aktuelle Verkehrsfluss 60 km/Stunde beträgt, wird der Routingmotor erneut 60 km/Stunde verwenden.

vehicleMaxSpeed?: number

Eigenschaftswert

Gewicht des Fahrzeugs in Kilogramm.

• Es ist obligatorisch, wenn eine der *Efficiency-Parameter festgelegt ist.

• Es muss streng positiv sein, wenn es im Rahmen des Verbrauchsmodells verwendet wird. Gewichtsbeschränkungen werden berücksichtigt.

• Wenn kein detailliertes Verbrauchsmodell angegeben wird und der Wert fahrzeuggewichtige ungleich Null ist, werden Gewichtseinschränkungen berücksichtigt.

• In allen anderen Fällen wird dieser Parameter ignoriert.

Vernünftige Werte : für Verbrennungsmodell : 1600, für Elektromodell : 1900

vehicleWeight?: number

Eigenschaftswert

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

vehicleWidth?: number

Eigenschaftswert

Grad der Kurven für spannende Route. Dieser Parameter kann nur in Verbindung mit routeType=thrilling verwendet werden.

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

Eigenschaftswert