Udostępnij za pośrednictwem


RouteGetRouteRangeQueryParamProperties interface

Właściwości

accelerationEfficiency

Określa wydajność konwersji energii chemicznej przechowywanej w paliwie na energię kinetyczną, gdy pojazd przyspiesza (tj. Kinetic EnergyGained/ChemicalEnerGained/ChemicalEnersumed). Chemical EnergyConsumed jest uzyskiwany przez konwersję zużytego paliwa na energię chemiczną przy użyciu paliwaEnergiiInMJoulesPerLiter.

Musi być sparowana z decelerationEfficiency.

Dozwolony zakres wartości to od 0,0 do 1/decelerationEfficiency.

Rozsądne wartości: dla modelu spalania : 0,33 dla modelu elektrycznego: 0,66

auxiliaryPowerInkW

Określa ilość energii zużywanej do utrzymania systemów pomocniczych w kilowatach (kW).

Może służyć do określania zużycia ze względu na urządzenia i systemy, takie jak systemy AC, radio, ogrzewanie itp.

Rozsądne wartości: 1,7

auxiliaryPowerInLitersPerHour

Określa ilość paliwa zużytego do utrzymania systemów pomocniczych pojazdu, w litrach na godzinę.

Może służyć do określania zużycia ze względu na urządzenia i systemy, takie jak systemy AC, radio, ogrzewanie itp.

Rozsądne wartości: 0,2

avoid

Określa element, którego obliczenie trasy powinno próbować uniknąć podczas określania trasy. Można określić wiele razy w jednym żądaniu, na przykład "&avoid=highways&avoid=tollRoads&avoid=promy". W żądaniach zakresu tras wartość jużUsedRoads nie może być używana.

constantSpeedConsumptionInkWhPerHundredkm

Określa składnik zależny od szybkości zużycia.

Podana jako nieurządkowana lista par szybkości/szybkości użycia. Lista definiuje punkty na krzywej zużycia. Wskaźniki zużycia dla szybkości, które nie znajdują się na liście, znajdują się w następujący sposób:

  • według interpolacji liniowej, jeśli dana prędkość leży między dwiema prędkościami na liście

  • przez ekstrapolację liniową w przeciwnym razie przy założeniu stałej (ΔConsumption/ΔSpeed) określonej przez najbliższe dwa punkty na liście

Lista musi zawierać od 1 do 25 punktów (włącznie) i może nie zawierać zduplikowanych punktów dla tej samej prędkości. Jeśli zawiera tylko jeden punkt, wskaźnik zużycia tego punktu jest używany bez dalszego przetwarzania.

Zużycie określone dla największej prędkości musi być większe lub równe z przedostatnią największą prędkością. Gwarantuje to, że ekstrapolacja nie prowadzi do ujemnych wskaźników zużycia.

Podobnie wartości zużycia określone dla dwóch najmniejszych prędkości na liście nie mogą prowadzić do ujemnego zużycia dla każdej mniejszej prędkości.

Prawidłowy zakres wartości zużycia (wyrażony w kWh/100km) wynosi od 0,01 do 10000,0.

Rozsądne wartości: 50,8.2:130,21.3

Ten parametr jest wymagany dla Modelu zużycia energii elektrycznej.

constantSpeedConsumptionInLitersPerHundredkm

Określa składnik zależny od szybkości zużycia.

Podana jako lista nieuprzedażych par szybkości rozdzielonych dwukropkiem & par zużycia. Lista definiuje punkty na krzywej zużycia. Wskaźniki zużycia dla szybkości, które nie znajdują się na liście, znajdują się w następujący sposób:

  • według interpolacji liniowej, jeśli dana prędkość leży między dwiema prędkościami na liście

  • przez ekstrapolację liniową w przeciwnym razie przy założeniu stałej (ΔConsumption/ΔSpeed) określonej przez najbliższe dwa punkty na liście

Lista musi zawierać od 1 do 25 punktów (włącznie) i może nie zawierać zduplikowanych punktów dla tej samej prędkości. Jeśli zawiera tylko jeden punkt, wskaźnik zużycia tego punktu jest używany bez dalszego przetwarzania.

Zużycie określone dla największej prędkości musi być większe lub równe z przedostatnią największą prędkością. Gwarantuje to, że ekstrapolacja nie prowadzi do ujemnych wskaźników zużycia.

Podobnie wartości zużycia określone dla dwóch najmniejszych prędkości na liście nie mogą prowadzić do ujemnego zużycia dla każdej mniejszej prędkości.

Prawidłowy zakres wartości zużycia (wyrażony w l/100km) wynosi od 0,01 do 10000,0.

Rozsądne wartości: 50,6.3:130,11.5

Uwaga: ten parametr jest wymagany dla modelu zużycia spalania.

currentChargeInkWh

Określa bieżące zasilanie energii elektrycznej w kilowatach godzin (kWh).

Ten parametr współistnieje z parametrem maxChargeInkWh.

Dozwolony zakres wartości to 0,0 do maxChargeInkWh.

Rozsądne wartości: 43

currentFuelInLiters

Określa bieżącą dostawę paliwa w litrach.

Rozsądne wartości: 55

decelerationEfficiency

Określa wydajność konwersji energii kinetycznej w celu zaoszczędzenia (nieużytowanego) paliwa, gdy pojazd zwalnia (tj. ChemicalMachiSaved/KineticMachiLost). ChemicalMachiSaved jest uzyskiwany przez konwersję zapisanego (nieużywanego) paliwa na energię przy użyciu paliwaPrzezłodaneInMJoulesPerLiter.

Musi być sparowana z accelerationEfficiency.

Dozwolony zakres wartości to od 0,0 do 1/przyspieszanieSprawność.

Rozsądne wartości: dla modelu spalania : 0,83 dla modelu elektrycznego : 0,91

departAt

Data i godzina odejścia od punktu początkowego sformatowane jako wartość dateTime zdefiniowana w RFC 3339, sekcja 5.6, z opcjonalnym przesunięciem strefy czasowej. Jeśli nie określono przesunięcia strefy czasowej, przyjmuje się, że jest to przesunięcie punktu początkowego.

  • Wartość domyślna: teraz
  • Inna wartość: dateTime

Przykłady:

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

Nie można użyć parametru departAt w połączeniu z arriveAt.

distanceBudgetInMeters

Budżet odległości w metrach, który określa maksymalny zakres, który można pokonać przy użyciu odległości jazdy. Model zużycia będzie mieć wpływ tylko na zakres, gdy typ routeType jest ekologiczny.
Należy użyć dokładnie jednego budżetu (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub distanceBudgetInMeters).

downhillEfficiency

Określa wydajność konwersji potencjalnej energii w celu zaoszczędzenia (nieużytowanego) paliwa, gdy pojazd traci wysokość (tj. ChemicalMachiSaved/PotentialEnerLost). ChemicalMachiSaved jest uzyskiwany przez konwersję zapisanego (nieużywanego) paliwa na energię przy użyciu paliwaPrzezłodaneInMJoulesPerLiter.

Musi być sparowana z pod góręEfficiency.

Zakres dozwolonych wartości to od 0,0 do 1/pod góręEfficiency.

Rozsądne wartości: dla modelu spalania : 0,51 dla modelu elektrycznego: 0,73

energyBudgetInkWh

Budżet energii elektrycznej w godzinach kilowatów (kWh), który określa maksymalny zakres, który można użyć przy użyciu określonego modelu zużycia energii elektrycznej.
W przypadku użycia energiiBudgetInkWh należy określić szczegółowy model zużycia energii elektrycznej.
Należy użyć dokładnie jednego budżetu (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub distanceBudgetInMeters).

fuelBudgetInLiters

Budżet paliwa w litrach, który określa maksymalny zakres, który można przejeżdżać przy użyciu określonego modelu zużycia spalania.
W przypadku użycia paliwaBudgetInLiters należy określić szczegółowy model zużycia spalania.
Należy użyć dokładnie jednego budżetu (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub distanceBudgetInMeters).

fuelEnergyDensityInMJoulesPerLiter

Określa ilość energii chemicznej przechowywanej w jednym litrze paliwa w megajulach (MJ). Jest on używany w połączeniu z *Wydajność parametrów konwersji między zaoszczędzone lub zużywane energii i paliwa. Na przykład gęstość energii wynosi 34,2 MJ/l dla benzyny i 35,8 MJ/l dla paliwa diesla.

Ten parametr jest wymagany, jeśli jest ustawiony dowolny parametr *Wydajność.

Rozsądne wartości: 34.2

hilliness

Stopień hilliness do porywającej trasy. Tego parametru można używać tylko w połączeniu z routeType=thrilling.

maxChargeInkWh

Określa maksymalny zasilacz energii elektrycznej w kilowatach (kWh), które mogą być przechowywane w baterii pojazdu.

Ten parametr współistnieje z parametrem currentChargeInkWh.

Wartość minimalna musi być większa lub równa currentChargeInkWh.

Rozsądne wartości: 85

query

Współrzędna, z której ma zostać uruchomione obliczenie zakresu.

routeType

Żądany typ trasy.

timeBudgetInSec

Budżet czasu w sekundach określający maksymalny zakres, który można podróżować przy użyciu czasu jazdy. Model zużycia będzie mieć wpływ tylko na zakres, gdy typ routeType jest ekologiczny.
Należy użyć dokładnie jednego budżetu (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub distanceBudgetInMeters).

traffic

Możliwe wartości:

  • true — należy wziąć pod uwagę wszystkie dostępne informacje o ruchu podczas routingu
  • false — ignoruj bieżące dane ruchu podczas routingu. Należy pamiętać, że chociaż bieżące dane ruchu są ignorowane podczas routingu, wpływ historycznego ruchu na efektywne prędkości drogowe jest nadal uwzględniany.
travelMode

Tryb podróży dla żądanej trasy. Jeśli nie jest zdefiniowana, wartość domyślna to "samochód". Należy pamiętać, że żądany tryb travelMode może nie być dostępny dla całej trasy. Jeśli żądany element travelMode nie jest dostępny dla określonej sekcji, element travelMode odpowiedzi dla tej sekcji będzie "inny". Należy pamiętać, że tryby podróży autobus, motocykl, taksówka i van są funkcją BETA. Pełne dane ograniczeń nie są dostępne we wszystkich obszarach.

uphillEfficiency

Określa efektywność konwersji energii chemicznej przechowywanej w paliwie na potencjalną energię, gdy pojazd zyskuje wysokość (tj. Potential EnergyGained/Chemical EnergyConsumed). Chemical EnergyConsumed jest uzyskiwany przez konwersję zużytego paliwa na energię chemiczną przy użyciu paliwaEnergiiInMJoulesPerLiter.

Musi być sparowany z downhillEfficiency.

Dozwolony zakres wartości to od 0,0 do 1/downhillEfficiency.

Rozsądne wartości: dla modelu spalania : 0,27, dla modelu elektrycznego : 0,74

vehicleAxleWeight

Waga na oś pojazdu w kg. Wartość 0 oznacza, że ograniczenia wagi na oś nie są brane pod uwagę.

vehicleCommercial

Czy pojazd jest używany do celów komercyjnych. Pojazdy komercyjne mogą nie być dozwolone do jazdy na niektórych drogach.

vehicleEngineType

Typ silnika pojazdu. Po określeniu szczegółowego modelu zużycia musi być zgodny z wartością vehicleEngineType.

vehicleHeight

Wysokość pojazdu w metrach. Wartość 0 oznacza, że ograniczenia wysokości nie są brane pod uwagę.

vehicleLength

Długość pojazdu w metrach. Wartość 0 oznacza, że ograniczenia długości nie są brane pod uwagę.

vehicleLoadType

Typy ładunków, które mogą być klasyfikowane jako materiały niebezpieczne i ograniczone z niektórych dróg. Dostępne wartości vehicleLoadType to klasy US Hazmat od 1 do 9 oraz klasyfikacje ogólne do użycia w innych krajach/regionach. Wartości rozpoczynające się od USHazmat są przeznaczone dla routingu USA, podczas gdy innehazmat powinny być używane dla wszystkich innych krajów/regionów. vehicleLoadType można określić wiele razy. Ten parametr jest obecnie brany pod uwagę tylko dla travelMode=truck.

vehicleMaxSpeed

Maksymalna prędkość pojazdu w km/godzinę. Maksymalna prędkość w profilu pojazdu służy do sprawdzania, czy pojazd jest dozwolony na autostradach.

  • Wartość 0 oznacza, że odpowiednia wartość dla pojazdu zostanie określona i zastosowana podczas planowania tras.

  • Wartość niezerowa może zostać zastąpiona podczas planowania trasy. Na przykład bieżący przepływ ruchu wynosi 60 km/godzinę. Jeśli maksymalna prędkość pojazdu wynosi 50 km/godzinę, silnik rozsyłania rozważy 60 km/godzinę, ponieważ jest to bieżąca sytuacja. Jeśli maksymalna prędkość pojazdu wynosi 80 km/godzinę, ale bieżący przepływ ruchu wynosi 60 km/godzinę, silnik routingu ponownie użyje 60 km/godzinę.

vehicleWeight

Waga pojazdu w kilogramach.

  • To jest obowiązkowe, jeśli którykolwiek z *parametrów wydajności są ustawione.

  • Musi być ściśle dodatnia, jeśli jest używana w kontekście modelu zużycia. Rozważane są ograniczenia wagi.

  • Jeśli nie określono żadnych szczegółowych model zużycia, a wartość vehicleWeight nie jest równa zero, należy rozważyć ograniczenia wagi.

  • We wszystkich innych przypadkach ten parametr jest ignorowany.

Rozsądne wartości: dla modelu spalania : 1600, dla modelu elektrycznego : 1900

vehicleWidth

Szerokość pojazdu w metrach. Wartość 0 oznacza, że ograniczenia szerokości nie są brane pod uwagę.

windingness

Poziom zakrętów dla porywającej trasy. Tego parametru można używać tylko w połączeniu z routeType=thrilling.

Szczegóły właściwości

accelerationEfficiency

Określa wydajność konwersji energii chemicznej przechowywanej w paliwie na energię kinetyczną, gdy pojazd przyspiesza (tj. Kinetic EnergyGained/ChemicalEnerGained/ChemicalEnersumed). Chemical EnergyConsumed jest uzyskiwany przez konwersję zużytego paliwa na energię chemiczną przy użyciu paliwaEnergiiInMJoulesPerLiter.

Musi być sparowana z decelerationEfficiency.

Dozwolony zakres wartości to od 0,0 do 1/decelerationEfficiency.

Rozsądne wartości: dla modelu spalania : 0,33 dla modelu elektrycznego: 0,66

accelerationEfficiency?: number

Wartość właściwości

number

auxiliaryPowerInkW

Określa ilość energii zużywanej do utrzymania systemów pomocniczych w kilowatach (kW).

Może służyć do określania zużycia ze względu na urządzenia i systemy, takie jak systemy AC, radio, ogrzewanie itp.

Rozsądne wartości: 1,7

auxiliaryPowerInkW?: number

Wartość właściwości

number

auxiliaryPowerInLitersPerHour

Określa ilość paliwa zużytego do utrzymania systemów pomocniczych pojazdu, w litrach na godzinę.

Może służyć do określania zużycia ze względu na urządzenia i systemy, takie jak systemy AC, radio, ogrzewanie itp.

Rozsądne wartości: 0,2

auxiliaryPowerInLitersPerHour?: number

Wartość właściwości

number

avoid

Określa element, którego obliczenie trasy powinno próbować uniknąć podczas określania trasy. Można określić wiele razy w jednym żądaniu, na przykład "&avoid=highways&avoid=tollRoads&avoid=promy". W żądaniach zakresu tras wartość jużUsedRoads nie może być używana.

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

Wartość właściwości

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

constantSpeedConsumptionInkWhPerHundredkm

Określa składnik zależny od szybkości zużycia.

Podana jako nieurządkowana lista par szybkości/szybkości użycia. Lista definiuje punkty na krzywej zużycia. Wskaźniki zużycia dla szybkości, które nie znajdują się na liście, znajdują się w następujący sposób:

  • według interpolacji liniowej, jeśli dana prędkość leży między dwiema prędkościami na liście

  • przez ekstrapolację liniową w przeciwnym razie przy założeniu stałej (ΔConsumption/ΔSpeed) określonej przez najbliższe dwa punkty na liście

Lista musi zawierać od 1 do 25 punktów (włącznie) i może nie zawierać zduplikowanych punktów dla tej samej prędkości. Jeśli zawiera tylko jeden punkt, wskaźnik zużycia tego punktu jest używany bez dalszego przetwarzania.

Zużycie określone dla największej prędkości musi być większe lub równe z przedostatnią największą prędkością. Gwarantuje to, że ekstrapolacja nie prowadzi do ujemnych wskaźników zużycia.

Podobnie wartości zużycia określone dla dwóch najmniejszych prędkości na liście nie mogą prowadzić do ujemnego zużycia dla każdej mniejszej prędkości.

Prawidłowy zakres wartości zużycia (wyrażony w kWh/100km) wynosi od 0,01 do 10000,0.

Rozsądne wartości: 50,8.2:130,21.3

Ten parametr jest wymagany dla Modelu zużycia energii elektrycznej.

constantSpeedConsumptionInkWhPerHundredkm?: string

Wartość właściwości

string

constantSpeedConsumptionInLitersPerHundredkm

Określa składnik zależny od szybkości zużycia.

Podana jako lista nieuprzedażych par szybkości rozdzielonych dwukropkiem & par zużycia. Lista definiuje punkty na krzywej zużycia. Wskaźniki zużycia dla szybkości, które nie znajdują się na liście, znajdują się w następujący sposób:

  • według interpolacji liniowej, jeśli dana prędkość leży między dwiema prędkościami na liście

  • przez ekstrapolację liniową w przeciwnym razie przy założeniu stałej (ΔConsumption/ΔSpeed) określonej przez najbliższe dwa punkty na liście

Lista musi zawierać od 1 do 25 punktów (włącznie) i może nie zawierać zduplikowanych punktów dla tej samej prędkości. Jeśli zawiera tylko jeden punkt, wskaźnik zużycia tego punktu jest używany bez dalszego przetwarzania.

Zużycie określone dla największej prędkości musi być większe lub równe z przedostatnią największą prędkością. Gwarantuje to, że ekstrapolacja nie prowadzi do ujemnych wskaźników zużycia.

Podobnie wartości zużycia określone dla dwóch najmniejszych prędkości na liście nie mogą prowadzić do ujemnego zużycia dla każdej mniejszej prędkości.

Prawidłowy zakres wartości zużycia (wyrażony w l/100km) wynosi od 0,01 do 10000,0.

Rozsądne wartości: 50,6.3:130,11.5

Uwaga: ten parametr jest wymagany dla modelu zużycia spalania.

constantSpeedConsumptionInLitersPerHundredkm?: string

Wartość właściwości

string

currentChargeInkWh

Określa bieżące zasilanie energii elektrycznej w kilowatach godzin (kWh).

Ten parametr współistnieje z parametrem maxChargeInkWh.

Dozwolony zakres wartości to 0,0 do maxChargeInkWh.

Rozsądne wartości: 43

currentChargeInkWh?: number

Wartość właściwości

number

currentFuelInLiters

Określa bieżącą dostawę paliwa w litrach.

Rozsądne wartości: 55

currentFuelInLiters?: number

Wartość właściwości

number

decelerationEfficiency

Określa wydajność konwersji energii kinetycznej w celu zaoszczędzenia (nieużytowanego) paliwa, gdy pojazd zwalnia (tj. ChemicalMachiSaved/KineticMachiLost). ChemicalMachiSaved jest uzyskiwany przez konwersję zapisanego (nieużywanego) paliwa na energię przy użyciu paliwaPrzezłodaneInMJoulesPerLiter.

Musi być sparowana z accelerationEfficiency.

Dozwolony zakres wartości to od 0,0 do 1/przyspieszanieSprawność.

Rozsądne wartości: dla modelu spalania : 0,83 dla modelu elektrycznego : 0,91

decelerationEfficiency?: number

Wartość właściwości

number

departAt

Data i godzina odejścia od punktu początkowego sformatowane jako wartość dateTime zdefiniowana w RFC 3339, sekcja 5.6, z opcjonalnym przesunięciem strefy czasowej. Jeśli nie określono przesunięcia strefy czasowej, przyjmuje się, że jest to przesunięcie punktu początkowego.

  • Wartość domyślna: teraz
  • Inna wartość: dateTime

Przykłady:

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

Nie można użyć parametru departAt w połączeniu z arriveAt.

departAt?: string | Date

Wartość właściwości

string | Date

distanceBudgetInMeters

Budżet odległości w metrach, który określa maksymalny zakres, który można pokonać przy użyciu odległości jazdy. Model zużycia będzie mieć wpływ tylko na zakres, gdy typ routeType jest ekologiczny.
Należy użyć dokładnie jednego budżetu (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub distanceBudgetInMeters).

distanceBudgetInMeters?: number

Wartość właściwości

number

downhillEfficiency

Określa wydajność konwersji potencjalnej energii w celu zaoszczędzenia (nieużytowanego) paliwa, gdy pojazd traci wysokość (tj. ChemicalMachiSaved/PotentialEnerLost). ChemicalMachiSaved jest uzyskiwany przez konwersję zapisanego (nieużywanego) paliwa na energię przy użyciu paliwaPrzezłodaneInMJoulesPerLiter.

Musi być sparowana z pod góręEfficiency.

Zakres dozwolonych wartości to od 0,0 do 1/pod góręEfficiency.

Rozsądne wartości: dla modelu spalania : 0,51 dla modelu elektrycznego: 0,73

downhillEfficiency?: number

Wartość właściwości

number

energyBudgetInkWh

Budżet energii elektrycznej w godzinach kilowatów (kWh), który określa maksymalny zakres, który można użyć przy użyciu określonego modelu zużycia energii elektrycznej.
W przypadku użycia energiiBudgetInkWh należy określić szczegółowy model zużycia energii elektrycznej.
Należy użyć dokładnie jednego budżetu (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub distanceBudgetInMeters).

energyBudgetInkWh?: number

Wartość właściwości

number

fuelBudgetInLiters

Budżet paliwa w litrach, który określa maksymalny zakres, który można przejeżdżać przy użyciu określonego modelu zużycia spalania.
W przypadku użycia paliwaBudgetInLiters należy określić szczegółowy model zużycia spalania.
Należy użyć dokładnie jednego budżetu (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub distanceBudgetInMeters).

fuelBudgetInLiters?: number

Wartość właściwości

number

fuelEnergyDensityInMJoulesPerLiter

Określa ilość energii chemicznej przechowywanej w jednym litrze paliwa w megajulach (MJ). Jest on używany w połączeniu z *Wydajność parametrów konwersji między zaoszczędzone lub zużywane energii i paliwa. Na przykład gęstość energii wynosi 34,2 MJ/l dla benzyny i 35,8 MJ/l dla paliwa diesla.

Ten parametr jest wymagany, jeśli jest ustawiony dowolny parametr *Wydajność.

Rozsądne wartości: 34.2

fuelEnergyDensityInMJoulesPerLiter?: number

Wartość właściwości

number

hilliness

Stopień hilliness do porywającej trasy. Tego parametru można używać tylko w połączeniu z routeType=thrilling.

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

Wartość właściwości

"low" | "normal" | "high"

maxChargeInkWh

Określa maksymalny zasilacz energii elektrycznej w kilowatach (kWh), które mogą być przechowywane w baterii pojazdu.

Ten parametr współistnieje z parametrem currentChargeInkWh.

Wartość minimalna musi być większa lub równa currentChargeInkWh.

Rozsądne wartości: 85

maxChargeInkWh?: number

Wartość właściwości

number

query

Współrzędna, z której ma zostać uruchomione obliczenie zakresu.

query: number[]

Wartość właściwości

number[]

routeType

Żądany typ trasy.

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

Wartość właściwości

"fastest" | "shortest" | "eco" | "thrilling"

timeBudgetInSec

Budżet czasu w sekundach określający maksymalny zakres, który można podróżować przy użyciu czasu jazdy. Model zużycia będzie mieć wpływ tylko na zakres, gdy typ routeType jest ekologiczny.
Należy użyć dokładnie jednego budżetu (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub distanceBudgetInMeters).

timeBudgetInSec?: number

Wartość właściwości

number

traffic

Możliwe wartości:

  • true — należy wziąć pod uwagę wszystkie dostępne informacje o ruchu podczas routingu
  • false — ignoruj bieżące dane ruchu podczas routingu. Należy pamiętać, że chociaż bieżące dane ruchu są ignorowane podczas routingu, wpływ historycznego ruchu na efektywne prędkości drogowe jest nadal uwzględniany.
traffic?: boolean

Wartość właściwości

boolean

travelMode

Tryb podróży dla żądanej trasy. Jeśli nie jest zdefiniowana, wartość domyślna to "samochód". Należy pamiętać, że żądany tryb travelMode może nie być dostępny dla całej trasy. Jeśli żądany element travelMode nie jest dostępny dla określonej sekcji, element travelMode odpowiedzi dla tej sekcji będzie "inny". Należy pamiętać, że tryby podróży autobus, motocykl, taksówka i van są funkcją BETA. Pełne dane ograniczeń nie są dostępne we wszystkich obszarach.

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

Wartość właściwości

"pedestrian" | "car" | "truck" | "taxi" | "bus" | "van" | "motorcycle" | "bicycle"

uphillEfficiency

Określa efektywność konwersji energii chemicznej przechowywanej w paliwie na potencjalną energię, gdy pojazd zyskuje wysokość (tj. Potential EnergyGained/Chemical EnergyConsumed). Chemical EnergyConsumed jest uzyskiwany przez konwersję zużytego paliwa na energię chemiczną przy użyciu paliwaEnergiiInMJoulesPerLiter.

Musi być sparowany z downhillEfficiency.

Dozwolony zakres wartości to od 0,0 do 1/downhillEfficiency.

Rozsądne wartości: dla modelu spalania : 0,27, dla modelu elektrycznego : 0,74

uphillEfficiency?: number

Wartość właściwości

number

vehicleAxleWeight

Waga na oś pojazdu w kg. Wartość 0 oznacza, że ograniczenia wagi na oś nie są brane pod uwagę.

vehicleAxleWeight?: number

Wartość właściwości

number

vehicleCommercial

Czy pojazd jest używany do celów komercyjnych. Pojazdy komercyjne mogą nie być dozwolone do jazdy na niektórych drogach.

vehicleCommercial?: boolean

Wartość właściwości

boolean

vehicleEngineType

Typ silnika pojazdu. Po określeniu szczegółowego modelu zużycia musi być zgodny z wartością vehicleEngineType.

vehicleEngineType?: "combustion" | "electric"

Wartość właściwości

"combustion" | "electric"

vehicleHeight

Wysokość pojazdu w metrach. Wartość 0 oznacza, że ograniczenia wysokości nie są brane pod uwagę.

vehicleHeight?: number

Wartość właściwości

number

vehicleLength

Długość pojazdu w metrach. Wartość 0 oznacza, że ograniczenia długości nie są brane pod uwagę.

vehicleLength?: number

Wartość właściwości

number

vehicleLoadType

Typy ładunków, które mogą być klasyfikowane jako materiały niebezpieczne i ograniczone z niektórych dróg. Dostępne wartości vehicleLoadType to klasy US Hazmat od 1 do 9 oraz klasyfikacje ogólne do użycia w innych krajach/regionach. Wartości rozpoczynające się od USHazmat są przeznaczone dla routingu USA, podczas gdy innehazmat powinny być używane dla wszystkich innych krajów/regionów. vehicleLoadType można określić wiele razy. Ten parametr jest obecnie brany pod uwagę tylko dla travelMode=truck.

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

Wartość właściwości

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

vehicleMaxSpeed

Maksymalna prędkość pojazdu w km/godzinę. Maksymalna prędkość w profilu pojazdu służy do sprawdzania, czy pojazd jest dozwolony na autostradach.

  • Wartość 0 oznacza, że odpowiednia wartość dla pojazdu zostanie określona i zastosowana podczas planowania tras.

  • Wartość niezerowa może zostać zastąpiona podczas planowania trasy. Na przykład bieżący przepływ ruchu wynosi 60 km/godzinę. Jeśli maksymalna prędkość pojazdu wynosi 50 km/godzinę, silnik rozsyłania rozważy 60 km/godzinę, ponieważ jest to bieżąca sytuacja. Jeśli maksymalna prędkość pojazdu wynosi 80 km/godzinę, ale bieżący przepływ ruchu wynosi 60 km/godzinę, silnik routingu ponownie użyje 60 km/godzinę.

vehicleMaxSpeed?: number

Wartość właściwości

number

vehicleWeight

Waga pojazdu w kilogramach.

  • To jest obowiązkowe, jeśli którykolwiek z *parametrów wydajności są ustawione.

  • Musi być ściśle dodatnia, jeśli jest używana w kontekście modelu zużycia. Rozważane są ograniczenia wagi.

  • Jeśli nie określono żadnych szczegółowych model zużycia, a wartość vehicleWeight nie jest równa zero, należy rozważyć ograniczenia wagi.

  • We wszystkich innych przypadkach ten parametr jest ignorowany.

Rozsądne wartości: dla modelu spalania : 1600, dla modelu elektrycznego : 1900

vehicleWeight?: number

Wartość właściwości

number

vehicleWidth

Szerokość pojazdu w metrach. Wartość 0 oznacza, że ograniczenia szerokości nie są brane pod uwagę.

vehicleWidth?: number

Wartość właściwości

number

windingness

Poziom zakrętów dla porywającej trasy. Tego parametru można używać tylko w połączeniu z routeType=thrilling.

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

Wartość właściwości

"low" | "normal" | "high"