RouteGetRouteDirectionsOptionalParams interface

Optionale Parameter.

Extends

RequestOptionsBase

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 mithilfe von fuelEnergyDensityInMJoulesPerLiter gewonnen. Muss mit "decelerationEfficiency" gekoppelt werden.

Der zulässige Wertebereich liegt zwischen 0,0 und 1/verzögerungEfficiency.

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. Mögliche Werte: "anyRoute", "betterRoute"

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.

auxiliaryPowerInkW

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, z. B. "&avoid=autobahnen&avoid=tollRoads&avoid=ferries". In calculateReachableRange-Anforderungen darf der Wert alreadyUsedRoads nicht verwendet werden. Mögliche Werte: "tollRoads", "autobahnen", "ferries", "unpavedRoads", "carpools", "alreadyUsedRoads", "borderCrossings"

computeBestOrder

Ordnen Sie die Routenwegpunkte neu an, um die Routenlänge zu verringern. Erzielt die besten Ergebnisse, wenn sie in Verbindung mit routeType shortest verwendet werden. 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.

computeTravelTimeFor

Gibt an, ob zusätzliche Reisezeiten zurückgegeben werden sollen, indem verschiedene Arten von Verkehrsinformationen (keine, historische, live) sowie die am besten geschätzte Standardreisezeit verwendet werden. Mögliche Werte: "none", "all"

constantSpeedConsumptionInkWhPerHundredkm

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 das Stromverbrauchsmodell erforderlich.

constantSpeedConsumptionInLitersPerHundredkm

Gibt die geschwindigkeitsabhängige Komponente des Verbrauchs an. Wird als ungeordnete Liste von durch Doppelpunkt getrennten Geschwindigkeits-& Verbrauchsratenpaaren 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.

Sinnvolle Werte : 50,6.3:130,11,5

Hinweis : Dieser Parameter ist für das Verbrennungsverbrauchsmodell erforderlich.

currentChargeInkWh

Gibt die aktuelle Stromversorgung in Kilowattstunden (kWh) an. Dieser Parameter ist mit dem parameter maxChargeInkWh koexistiert.

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

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 von fuelEnergyDensityInMJoulesPerLiter gewonnen. Muss mit accelerationEfficiency gekoppelt werden.

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 von fuelEnergyDensityInMJoulesPerLiter gewonnen. Muss mit uphillEfficiency gekoppelt werden.

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

Vernünftige Werte : für Verbrennungsmodell : 0.51, für elektrisches Modell : 0.73

fuelEnergyDensityInMJoulesPerLiter

Gibt die Menge an chemischer Energie an, die in einem Liter Kraftstoff in Megajoules (MJ) gespeichert ist. Es wird in Verbindung mit den *Effizienzparametern für Umrechnungen 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 *Efficiency-Parameter festgelegt ist.

Sinnvolle Werte : 34.2

hilliness

Grad der Hügeligkeit für aufregende Route. Dieser Parameter kann nur in Verbindung mit routeType=thrilling verwendet werden. Mögliche Werte: "niedrig", "normal", "hoch"

instructionsType

Falls angegeben, werden Anleitungen zurückgegeben. Beachten Sie, dass der parameter instructionsType nicht in Verbindung mit routeRepresentation=none verwendet werden kann. Mögliche Werte: "codiert", "text", "getaggt"

language

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

maxAlternatives

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

maxChargeInkWh

Gibt die maximale Elektrische Energieversorgung in Kilowattstunden (kWh) an, die in der Fahrzeugbatterie gespeichert werden kann. Dieser Parameter ist mit dem currentChargeInkWh-Parameter koexistiert.

Der Mindestwert muss größer oder gleich currentChargeInkWh sein.

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.

report

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. Im Fall von Standardparametern wird der Standardwert dort widergespiegelt, wo der Parameter nicht vom Aufrufer angegeben wurde.

routeRepresentation

Gibt die Darstellung der Gruppe von Routen an, die als Antwort bereitgestellt werden. Dieser Parameterwert kann nur in Verbindung mit computeBestOrder=true verwendet werden. Mögliche Werte: "polyline", "summaryOnly", "none"

routeType

Der Typ der angeforderten Route. Mögliche Werte sind: "schnellste", "kürzeste", "öko", "spannend"

sectionType

Gibt an, welcher der Abschnittstypen in der Routenantwort gemeldet wird.

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. Mögliche Werte: "carTrain", "country", "ferry", "motorway", "pedestrian", "tollRoad", "tollVignette", "traffic", "travelMode", "tunnel"

traffic

Mögliche Werte:

  • true: Berücksichtigen Sie alle verfügbaren Datenverkehrsinformationen während des Routings.
  • false: Ignorieren Sie aktuelle Datenverkehrsdaten während des Routings. Beachten Sie, dass die aktuellen Verkehrsdaten während des Routings ignoriert werden, die Auswirkungen des historischen Verkehrs auf die effektiven Straßengeschwindigkeiten jedoch weiterhin berücksichtigt werden.
travelMode

Der Reisemodus für die angeforderte Route. 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, ist das travelMode-Element der Antwort für diesen Abschnitt ein anderes. 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. Mögliche Werte: "Auto", "Lkw", "Taxi", "Bus", "Van", "Motorrad", "Fahrrad", "Fußgänger"

uphillEfficiency

Gibt die Effizienz der Umwandlung der im Kraftstoff gespeicherten chemischen Energie in potenzielle Energie an, wenn das Fahrzeug an Höhe gewinnt (d. h. PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed wird durch Umwandlung von verbrauchtem Brennstoff in chemische Energie mithilfe von fuelEnergyDensityInMJoulesPerLiter gewonnen. Muss mit downhillEfficiency gekoppelt werden.

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

Vernünftige Werte : für Verbrennungsmodell : 0.27, für elektrisches Modell : 0.74

vehicleAxleWeight

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

vehicleCommercial

Das Fahrzeug wird für kommerzielle Zwecke verwendet und darf daher möglicherweise nicht auf einigen Straßen fahren.

vehicleEngineType

Motortyp des Fahrzeugs. Wenn ein detailliertes Verbrauchsmodell angegeben wird, muss es mit dem Wert von vehicleEngineType konsistent sein. Mögliche Werte sind: "Verbrennung", "elektrisch"

vehicleHeading

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

vehicleHeight

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

vehicleLength

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

vehicleLoadType

Arten von Gütern, die als gefahrstoffgefährdete Güter eingestuft werden können und von einigen Straßen aus 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 das US-Routing, während andereHazmat für alle anderen Länder verwendet werden sollten. vehicleLoadType kann mehrmals angegeben werden. Dieser Parameter wird derzeit nur für travelMode=truck berücksichtigt. Mögliche Werte sind: 'USHazmatClass1', 'USHazmatClass2', 'USHazmatClass3', 'USHazmatClass4', 'USHazmatClass5', 'USHazmatClass6', 'USHazmatClass7', 'USHazmatClass8', 'USHazmatClass9', 'otherHazmatExplosive', 'otherHazmatGeneral', 'otherHazmatHarmfulToWater'

vehicleMaxSpeed

Höchstgeschwindigkeit des Fahrzeugs in km/Stunde. 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.

vehicleWeight

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 kein detailliertes Verbrauchsmodell angegeben wird und der Wert von vehicleWeight ungleich Null ist, werden Gewichtsbeschränkungen berücksichtigt.

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

Sensible Werte : für Verbrennungsmodell : 1600, für elektrisches Modell : 1900

vehicleWidth

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=thrilling verwendet werden. Mögliche Werte: "low", "normal", "high"

Geerbte Eigenschaften

abortSignal

Das Signal, das zum Abbrechen von Anforderungen verwendet werden kann.

customHeaders

{object} [customHeaders] Benutzerdefinierte benutzerdefinierte Anforderungsheader, die angewendet werden, bevor die Anforderung gesendet wird.

onDownloadProgress

Rückruf, der beim Downloadfortschritt ausgelöst wird.

onUploadProgress

Rückruf, der beim Hochladen des Fortschritts ausgelöst wird.

timeout

Die Anzahl von Millisekunden, die eine Anforderung dauern kann, bevor sie automatisch beendet wird.

Details zur Eigenschaft

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 mithilfe von fuelEnergyDensityInMJoulesPerLiter gewonnen. Muss mit "decelerationEfficiency" gekoppelt werden.

Der zulässige Wertebereich liegt zwischen 0,0 und 1/verzögerungEfficiency.

Vernünftige Werte : für Verbrennungsmodell : 0.33, für elektrisches Modell : 0.66

accelerationEfficiency?: number

Eigenschaftswert

number

alternativeType

Steuert die Optimalität der berechneten Alternativen im Hinblick auf die angegebenen Planungskriterien im Vergleich zur Referenzroute. Mögliche Werte: "anyRoute", "betterRoute"

alternativeType?: AlternativeRouteType

Eigenschaftswert

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.

arriveAt?: Date

Eigenschaftswert

Date

auxiliaryPowerInkW

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

auxiliaryPowerInkW?: string

Eigenschaftswert

string

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

auxiliaryPowerInLitersPerHour?: number

Eigenschaftswert

number

avoid

Gibt etwas an, das die Routenberechnung beim Bestimmen der Route vermeiden soll. Kann mehrmals in einer Anforderung angegeben werden, z. B. "&avoid=autobahnen&avoid=tollRoads&avoid=ferries". In calculateReachableRange-Anforderungen darf der Wert alreadyUsedRoads nicht verwendet werden. Mögliche Werte: "tollRoads", "autobahnen", "ferries", "unpavedRoads", "carpools", "alreadyUsedRoads", "borderCrossings"

avoid?: Avoid[]

Eigenschaftswert

Avoid[]

computeBestOrder

Ordnen Sie die Routenwegpunkte neu an, um die Routenlänge zu verringern. Erzielt die besten Ergebnisse, wenn sie in Verbindung mit routeType shortest verwendet werden. 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.

computeBestOrder?: boolean

Eigenschaftswert

boolean

computeTravelTimeFor

Gibt an, ob zusätzliche Reisezeiten zurückgegeben werden sollen, indem verschiedene Arten von Verkehrsinformationen (keine, historische, live) sowie die am besten geschätzte Standardreisezeit verwendet werden. Mögliche Werte: "none", "all"

computeTravelTimeFor?: ComputeTravelTimeFor

Eigenschaftswert

constantSpeedConsumptionInkWhPerHundredkm

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 das Stromverbrauchsmodell erforderlich.

constantSpeedConsumptionInkWhPerHundredkm?: string

Eigenschaftswert

string

constantSpeedConsumptionInLitersPerHundredkm

Gibt die geschwindigkeitsabhängige Komponente des Verbrauchs an. Wird als ungeordnete Liste von durch Doppelpunkt getrennten Geschwindigkeits-& Verbrauchsratenpaaren 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.

Sinnvolle Werte : 50,6.3:130,11,5

Hinweis : Dieser Parameter ist für das Verbrennungsverbrauchsmodell erforderlich.

constantSpeedConsumptionInLitersPerHundredkm?: number

Eigenschaftswert

number

currentChargeInkWh

Gibt die aktuelle Stromversorgung in Kilowattstunden (kWh) an. Dieser Parameter ist mit dem parameter maxChargeInkWh koexistiert.

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

Sinnvolle Werte : 43

currentChargeInkWh?: string

Eigenschaftswert

string

currentFuelInLiters

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

currentFuelInLiters?: number

Eigenschaftswert

number

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 von fuelEnergyDensityInMJoulesPerLiter gewonnen. Muss mit accelerationEfficiency gekoppelt werden.

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

Vernünftige Werte : für Verbrennungsmodell : 0.83, für elektrisches Modell : 0.91

decelerationEfficiency?: number

Eigenschaftswert

number

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.

departAt?: Date

Eigenschaftswert

Date

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 von fuelEnergyDensityInMJoulesPerLiter gewonnen. Muss mit uphillEfficiency gekoppelt werden.

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

Vernünftige Werte : für Verbrennungsmodell : 0.51, für elektrisches Modell : 0.73

downhillEfficiency?: number

Eigenschaftswert

number

fuelEnergyDensityInMJoulesPerLiter

Gibt die Menge an chemischer Energie an, die in einem Liter Kraftstoff in Megajoules (MJ) gespeichert ist. Es wird in Verbindung mit den *Effizienzparametern für Umrechnungen 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 *Efficiency-Parameter festgelegt ist.

Sinnvolle Werte : 34.2

fuelEnergyDensityInMJoulesPerLiter?: number

Eigenschaftswert

number

hilliness

Grad der Hügeligkeit für aufregende Route. Dieser Parameter kann nur in Verbindung mit routeType=thrilling verwendet werden. Mögliche Werte: "niedrig", "normal", "hoch"

hilliness?: Hilliness

Eigenschaftswert

instructionsType

Falls angegeben, werden Anleitungen zurückgegeben. Beachten Sie, dass der parameter instructionsType nicht in Verbindung mit routeRepresentation=none verwendet werden kann. Mögliche Werte: "codiert", "text", "getaggt"

instructionsType?: RouteInstructionsType

Eigenschaftswert

language

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

language?: string

Eigenschaftswert

string

maxAlternatives

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

maxAlternatives?: number

Eigenschaftswert

number

maxChargeInkWh

Gibt die maximale Elektrische Energieversorgung in Kilowattstunden (kWh) an, die in der Fahrzeugbatterie gespeichert werden kann. Dieser Parameter ist mit dem currentChargeInkWh-Parameter koexistiert.

Der Mindestwert muss größer oder gleich currentChargeInkWh sein.

Vernünftige Werte : 85

maxChargeInkWh?: string

Eigenschaftswert

string

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.

minDeviationDistance?: number

Eigenschaftswert

number

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.

minDeviationTime?: number

Eigenschaftswert

number

report

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. Im Fall von Standardparametern wird der Standardwert dort widergespiegelt, wo der Parameter nicht vom Aufrufer angegeben wurde.

report?: string

Eigenschaftswert

string

routeRepresentation

Gibt die Darstellung der Gruppe von Routen an, die als Antwort bereitgestellt werden. Dieser Parameterwert kann nur in Verbindung mit computeBestOrder=true verwendet werden. Mögliche Werte: "polyline", "summaryOnly", "none"

routeRepresentation?: RouteRepresentation

Eigenschaftswert

routeType

Der Typ der angeforderten Route. Mögliche Werte sind: "schnellste", "kürzeste", "öko", "spannend"

routeType?: RouteType

Eigenschaftswert

sectionType

Gibt an, welcher der Abschnittstypen in der Routenantwort gemeldet wird.

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. Mögliche Werte: "carTrain", "country", "ferry", "motorway", "pedestrian", "tollRoad", "tollVignette", "traffic", "travelMode", "tunnel"

sectionType?: SectionType

Eigenschaftswert

traffic

Mögliche Werte:

  • true: Berücksichtigen Sie alle verfügbaren Datenverkehrsinformationen während des Routings.
  • false: Ignorieren Sie aktuelle Datenverkehrsdaten während des Routings. Beachten Sie, dass die aktuellen Verkehrsdaten während des Routings ignoriert werden, die Auswirkungen des historischen Verkehrs auf die effektiven Straßengeschwindigkeiten jedoch weiterhin berücksichtigt werden.
traffic?: boolean

Eigenschaftswert

boolean

travelMode

Der Reisemodus für die angeforderte Route. 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, ist das travelMode-Element der Antwort für diesen Abschnitt ein anderes. 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. Mögliche Werte: "Auto", "Lkw", "Taxi", "Bus", "Van", "Motorrad", "Fahrrad", "Fußgänger"

travelMode?: TravelMode

Eigenschaftswert

uphillEfficiency

Gibt die Effizienz der Umwandlung der im Kraftstoff gespeicherten chemischen Energie in potenzielle Energie an, wenn das Fahrzeug an Höhe gewinnt (d. h. PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed wird durch Umwandlung von verbrauchtem Brennstoff in chemische Energie mithilfe von fuelEnergyDensityInMJoulesPerLiter gewonnen. Muss mit downhillEfficiency gekoppelt werden.

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

Vernünftige Werte : für Verbrennungsmodell : 0.27, für elektrisches Modell : 0.74

uphillEfficiency?: number

Eigenschaftswert

number

vehicleAxleWeight

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

vehicleAxleWeight?: number

Eigenschaftswert

number

vehicleCommercial

Das Fahrzeug wird für kommerzielle Zwecke verwendet und darf daher möglicherweise nicht auf einigen Straßen fahren.

vehicleCommercial?: boolean

Eigenschaftswert

boolean

vehicleEngineType

Motortyp des Fahrzeugs. Wenn ein detailliertes Verbrauchsmodell angegeben wird, muss es mit dem Wert von vehicleEngineType konsistent sein. Mögliche Werte sind: "Verbrennung", "elektrisch"

vehicleEngineType?: VehicleEngineType

Eigenschaftswert

vehicleHeading

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

vehicleHeading?: number

Eigenschaftswert

number

vehicleHeight

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

vehicleHeight?: number

Eigenschaftswert

number

vehicleLength

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

vehicleLength?: number

Eigenschaftswert

number

vehicleLoadType

Arten von Gütern, die als gefahrstoffgefährdete Güter eingestuft werden können und von einigen Straßen aus 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 das US-Routing, während andereHazmat für alle anderen Länder verwendet werden sollten. vehicleLoadType kann mehrmals angegeben werden. Dieser Parameter wird derzeit nur für travelMode=truck berücksichtigt. Mögliche Werte sind: 'USHazmatClass1', 'USHazmatClass2', 'USHazmatClass3', 'USHazmatClass4', 'USHazmatClass5', 'USHazmatClass6', 'USHazmatClass7', 'USHazmatClass8', 'USHazmatClass9', 'otherHazmatExplosive', 'otherHazmatGeneral', 'otherHazmatHarmfulToWater'

vehicleLoadType?: VehicleLoadType

Eigenschaftswert

vehicleMaxSpeed

Höchstgeschwindigkeit des Fahrzeugs in km/Stunde. 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.

vehicleMaxSpeed?: number

Eigenschaftswert

number

vehicleWeight

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 kein detailliertes Verbrauchsmodell angegeben wird und der Wert von vehicleWeight ungleich Null ist, werden Gewichtsbeschränkungen berücksichtigt.

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

Sensible Werte : für Verbrennungsmodell : 1600, für elektrisches Modell : 1900

vehicleWeight?: number

Eigenschaftswert

number

vehicleWidth

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

vehicleWidth?: number

Eigenschaftswert

number

windingness

Grad der Kurven für aufregende Route. Dieser Parameter kann nur in Verbindung mit routeType=thrilling verwendet werden. Mögliche Werte: "low", "normal", "high"

windingness?: Windingness

Eigenschaftswert

Geerbte Eigenschaftsdetails

abortSignal

Das Signal, das zum Abbrechen von Anforderungen verwendet werden kann.

abortSignal?: AbortSignalLike

Eigenschaftswert

AbortSignalLike

Geerbt von RequestOptionsBase.abortSignal

customHeaders

{object} [customHeaders] Benutzerdefinierte benutzerdefinierte Anforderungsheader, die angewendet werden, bevor die Anforderung gesendet wird.

customHeaders?: [key: string]: string

Eigenschaftswert

[key: string]: string

Geerbt von RequestOptionsBase.customHeaders

onDownloadProgress

Rückruf, der beim Downloadfortschritt ausgelöst wird.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Eigenschaftswert

(progress: TransferProgressEvent) => void

Geerbt von RequestOptionsBase.onDownloadProgress

onUploadProgress

Rückruf, der beim Hochladen des Fortschritts ausgelöst wird.

onUploadProgress?: (progress: TransferProgressEvent) => void

Eigenschaftswert

(progress: TransferProgressEvent) => void

Geerbt von RequestOptionsBase.onUploadProgress

timeout

Die Anzahl von Millisekunden, die eine Anforderung dauern kann, bevor sie automatisch beendet wird.

timeout?: number

Eigenschaftswert

number

Geerbt von RequestOptionsBase.timeout