Udostępnij za pośrednictwem


Model użycia

Usługa Routing udostępnia zestaw parametrów dla szczegółowego opisu modelu zużycia specyficznego dla pojazdu. W zależności od wartości vehicleEngineType obsługiwane są dwa główne modele zużycia: Spalanie i Energia elektryczna. Niepoprawne jest określenie parametrów należących do różnych modeli w tym samym żądaniu. Ponadto nie można używać parametrów modelu zużycie z następującymi wartościami travelMode : rower i pieszy.

Ograniczenia parametrów dla modelu zużycia

W obu modelach zużycia istnieją pewne zależności podczas określania parametrów. Oznacza to, że jawne określanie niektórych parametrów może wymagać określenia innych parametrów. Oto te zależności, o których należy pamiętać:

  • Wszystkie parametry wymagają określenia przez użytkownika stałejSpeedConsumption . Jest to błąd podczas określania dowolnego innego parametru modelu zużycia, jeśli nie określono parametru constantSpeedConsumption . Parametr vehicleWeight jest wyjątkiem dla tego wymagania.
  • accelerationEfficiency i decelerationEfficiency musi być zawsze określona jako para (czyli zarówno, czy żadna).
  • Jeśli określono wartość accelerationEfficiency i decelerationEfficiency , produkt ich wartości nie może być większy niż 1 (aby zapobiec ciągłemu ruchowi).
  • uphillEfficiency i downhillEfficiency musi być zawsze określony jako para (to jest zarówno albo żaden).
  • Jeśli określono wartość uphillEfficiency i downhillEfficiency , produkt ich wartości nie może być większy niż 1 (aby zapobiec ciągłemu ruchowi).
  • Jeśli użytkownik określi parametry *Wydajność , należy również określić pojazdu Waga . Jeśli vehicleEngineType jest spalaniem, należy również określić paliwoPrzecięcieleInMJoulesPerLiter .
  • maxChargeInkWh i currentChargeInkWh muszą być zawsze określane jako para (czyli zarówno albo żadna).

Uwaga

Jeśli określono tylko stałeSpeedConsumption , nie są uwzględniane żadne inne aspekty zużycia, takie jak nachylenia i przyspieszenie pojazdów.

Model zużycia spalin

Model zużycia spalania jest używany, gdy właściwość vehicleEngineType jest ustawiona na spalanie. Poniższa lista parametrów należy do tego modelu. Aby uzyskać szczegółowy opis, zapoznaj się z sekcją Parametry.

  • constantSpeedConsumptionInLitersPerHundredkm
  • waga pojazdu
  • currentFuelInLiters
  • pomocniczyPowerInLitersPerHour
  • fuelEnerdensityInMJoulesPerLiter
  • accelerationEfficiency
  • decelerationEfficiency
  • uphillEfficiency
  • downhillEfficiency (spadek)

Model zużycia energii elektrycznej

Model zużycia energii elektrycznej jest używany, gdy parametr vehicleEngineType jest ustawiony na elektryczny. Poniższa lista parametrów należy do tego modelu. Aby uzyskać szczegółowy opis, zapoznaj się z sekcją Parametry.

  • constantSpeedConsumptionInkWhPerHundredkm
  • waga pojazdu
  • currentChargeInkWh
  • maxChargeInkWh
  • pomocniczaPowerInkW
  • accelerationEfficiency
  • decelerationEfficiency
  • uphillEfficiency
  • downhillEfficiency (spadek)

Rozsądne wartości parametrów zużycia

Można odrzucić określony zestaw parametrów zużycia, mimo że zestaw może spełniać wszystkie jawne wymagania. Dzieje się tak, gdy wartość określonego parametru lub kombinacja wartości kilku parametrów jest uważana za prowadzącą do nieuzasadnionych wielkości wartości zużycia. Jeśli tak się stanie, najprawdopodobniej wskazuje błąd wejściowy, ponieważ należy zachować odpowiednią ostrożność, aby uwzględnić wszystkie rozsądne wartości parametrów zużycia. W przypadku odrzucenia określonego zestawu parametrów zużycia towarzyszący komunikat o błędzie zawiera tekstowe wyjaśnienie przyczyn. Szczegółowe opisy parametrów zawierają przykłady rozsądnych wartości dla obu modeli.