RouteGetRouteDirectionsWithAdditionalParametersQueryParamProperties interface

Pakiet:

@azure-rest/maps-route

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
alternativeType	Kontroluje optymalność, w odniesieniu do podanych kryteriów planowania, obliczonych alternatyw w porównaniu z trasą referencyjną.
arriveAt	Data i godzina przybycia do punktu docelowego sformatowane jako wartość dateTime zdefiniowana w RFC 3339, sekcja 5.6, z opcjonalnym przesunięciem strefy czasowej. Jeśli przesunięcie strefy czasowej nie zostanie określone, przyjmuje się, że jest to przesunięcie punktu docelowego. Przykłady: 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 Nie można użyć parametru arriveAt w połączeniu z departAt, minDeviationDistance lub minDeviationTime.
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.
computeBestOrder	Zmień kolejność punktów drogi tras przy użyciu szybkiego algorytmu heurystycznego, aby zmniejszyć długość trasy. Daje najlepsze wyniki w połączeniu z routeType najkrótszym. Zwróć uwagę, że źródło i miejsce docelowe są wykluczone ze zoptymalizowanych indeksów punktów waypoint. Aby uwzględnić źródło i miejsce docelowe w odpowiedzi, zwiększ wszystkie indeksy o 1, aby uwzględnić źródło, a następnie dodaj miejsce docelowe jako końcowy indeks. Możliwe wartości to true lub false. Prawda oblicza lepszą kolejność, jeśli jest to możliwe, ale nie może być używana w połączeniu z wartością maxAlternatives większą niż 0 lub w połączeniu z punktami kierunkowymi. Wartość False będzie używać lokalizacji w podanej kolejności i nie może być używana w połączeniu z routeRepresentation brak.
computeTravelTimeFor	Określa, czy zwracać dodatkowe czasy podróży przy użyciu różnych typów informacji o ruchu (brak, historyczny, na żywo), a także domyślny najlepszy szacowany czas podróży.
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.
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
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.
instructionsType	Jeśli zostanie określona, zostaną zwrócone instrukcje dotyczące wskazówek. Należy pamiętać, że parametr instructionsType nie może być używany w połączeniu z routeRepresentation=none.
language	Parametr języka określa język komunikatów ze wskazówkami. Nie ma to wpływu na odpowiednie nouns (nazwy ulic, placu itp.) Nie ma wpływu na instrukcjeType=coded. Dozwolone wartości to (podzbiór) opisane tagi języka IETF
maxAlternatives	Liczba tras alternatywnych do obliczenia. Ustawienie domyślne: 0, minimum: 0 i maksimum: 5
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
minDeviationDistance	Wszystkie zwrócone trasy alternatywne będą podążać za trasą referencyjną (zobacz sekcję POST Requests) z punktu początkowego żądania calculateRoute dla co najmniej tej liczby metrów. Można go używać tylko podczas rekonstrukcyjnej trasy. Nie można użyć parametru minDeviationDistance w połączeniu z elementem arriveAt
minDeviationTime	Wszystkie zwrócone trasy alternatywne będą podążać za trasą referencyjną (zobacz sekcję POST Requests) z punktu początkowego żądania calculateRoute przez co najmniej tę liczbę sekund. Można go używać tylko podczas rekonstrukcyjnej trasy. Parametr minDeviationTime nie może być używany w połączeniu z arriveAt. Wartość domyślna to 0. Ustawienie parametru )minDeviationTime_ wartości większej niż zero ma następujące konsekwencje: Punkt początkowy calculateRoute Request musi znajdować się (lub bardzo blisko) trasy referencyjnej wejściowej. Jeśli tak nie jest, zwracany jest błąd. Jednak punkt początkowy nie musi znajdować się na początku trasy odniesienia wejściowej (można ją traktować jako bieżącą pozycję pojazdu na trasie referencyjnej). Trasa referencyjna zwrócona jako pierwsza trasa w calculateRoute Response rozpocznie się w punkcie początkowym określonym w calculateRoute Request. Początkowa część trasy referencyjnej wejściowej do punktu początkowego zostanie wykluczona z odpowiedzi. Wartości minDeviationDistance i minDeviationTime określają, jak daleko alternatywne trasy będą zgodne z trasą referencyjną z punktu początkowego. Trasa musi używać departAt. Pojazd Przerzut jest ignorowany.
query	Współrzędne, przez które jest obliczana trasa, rozdzielana dwukropkiem. Wymagana jest minimalna liczba dwóch współrzędnych. Pierwszy z nich to źródło, a ostatni to miejsce docelowe trasy. Opcjonalne współrzędne między działają jako punkty WayPoint w trasie. Możesz przekazać maksymalnie 150 punktów WayPoint.
report	Określa, które dane mają być zgłaszane w celach diagnostycznych. Jedyną możliwą wartością jest effectiveSettings. Raportuje obowiązujące parametry lub dane używane podczas wywoływania interfejsu API. W przypadku domyślnych parametrów wartość domyślna zostanie odzwierciedlona, gdy parametr nie został określony przez obiekt wywołujący.
routeRepresentation	Określa reprezentację zestawu tras podanych jako odpowiedź.
routeType	Żądany typ trasy.
sectionType	Określa, które typy sekcji są zgłaszane w odpowiedzi trasy. Na przykład jeśli sekcja sectionType = sekcja dla pieszych, które są odpowiednie tylko dla pieszych, są zwracane. Można określić wiele razy w jednym żądaniu, na przykład "§ionType=carTrain§ionType=pedestrian§ionType=highway". Domyślny typ sekcji odnosi się do danych wejściowych travelMode. Domyślnie element travelMode jest ustawiony na samochód
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.
vehicleHeading	Kierunek pojazdu w stopniach rozpoczynających się od prawdziwej Północy i kontynuowany w kierunku wskazówek zegara. Północ jest 0 stopni, wschód jest 90 stopni, południe jest 180 stopni, zachód jest 270 stopni. Możliwe wartości 0–359
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

alternativeType

Kontroluje optymalność, w odniesieniu do podanych kryteriów planowania, obliczonych alternatyw w porównaniu z trasą referencyjną.

alternativeType?: "anyRoute" | "betterRoute"

Wartość właściwości

"anyRoute" | "betterRoute"

arriveAt

Data i godzina przybycia do punktu docelowego sformatowane jako wartość dateTime zdefiniowana w RFC 3339, sekcja 5.6, z opcjonalnym przesunięciem strefy czasowej. Jeśli przesunięcie strefy czasowej nie zostanie określone, przyjmuje się, że jest to przesunięcie punktu docelowego.

Przykłady:

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

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

arriveAt?: string | Date

Wartość właściwości

string | Date

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")[]

computeBestOrder

Zmień kolejność punktów drogi tras przy użyciu szybkiego algorytmu heurystycznego, aby zmniejszyć długość trasy. Daje najlepsze wyniki w połączeniu z routeType najkrótszym. Zwróć uwagę, że źródło i miejsce docelowe są wykluczone ze zoptymalizowanych indeksów punktów waypoint. Aby uwzględnić źródło i miejsce docelowe w odpowiedzi, zwiększ wszystkie indeksy o 1, aby uwzględnić źródło, a następnie dodaj miejsce docelowe jako końcowy indeks. Możliwe wartości to true lub false. Prawda oblicza lepszą kolejność, jeśli jest to możliwe, ale nie może być używana w połączeniu z wartością maxAlternatives większą niż 0 lub w połączeniu z punktami kierunkowymi. Wartość False będzie używać lokalizacji w podanej kolejności i nie może być używana w połączeniu z routeRepresentation brak.

computeBestOrder?: boolean

Wartość właściwości

boolean

computeTravelTimeFor

Określa, czy zwracać dodatkowe czasy podróży przy użyciu różnych typów informacji o ruchu (brak, historyczny, na żywo), a także domyślny najlepszy szacowany czas podróży.

computeTravelTimeFor?: "none" | "all"

Wartość właściwości

"none" | "all"

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

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

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"

instructionsType

Jeśli zostanie określona, zostaną zwrócone instrukcje dotyczące wskazówek. Należy pamiętać, że parametr instructionsType nie może być używany w połączeniu z routeRepresentation=none.

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

Wartość właściwości

"coded" | "text" | "tagged"

language

Parametr języka określa język komunikatów ze wskazówkami. Nie ma to wpływu na odpowiednie nouns (nazwy ulic, placu itp.) Nie ma wpływu na instrukcjeType=coded. Dozwolone wartości to (podzbiór) opisane tagi języka IETF

language?: string

Wartość właściwości

string

maxAlternatives

Liczba tras alternatywnych do obliczenia. Ustawienie domyślne: 0, minimum: 0 i maksimum: 5

maxAlternatives?: number

Wartość właściwości

number

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

minDeviationDistance

Wszystkie zwrócone trasy alternatywne będą podążać za trasą referencyjną (zobacz sekcję POST Requests) z punktu początkowego żądania calculateRoute dla co najmniej tej liczby metrów. Można go używać tylko podczas rekonstrukcyjnej trasy. Nie można użyć parametru minDeviationDistance w połączeniu z elementem arriveAt

minDeviationDistance?: number

Wartość właściwości

number

minDeviationTime

Wszystkie zwrócone trasy alternatywne będą podążać za trasą referencyjną (zobacz sekcję POST Requests) z punktu początkowego żądania calculateRoute przez co najmniej tę liczbę sekund. Można go używać tylko podczas rekonstrukcyjnej trasy. Parametr minDeviationTime nie może być używany w połączeniu z arriveAt. Wartość domyślna to 0. Ustawienie parametru )minDeviationTime_ wartości większej niż zero ma następujące konsekwencje:

• Punkt początkowy calculateRoute Request musi znajdować się (lub bardzo blisko) trasy referencyjnej wejściowej.
  • Jeśli tak nie jest, zwracany jest błąd.
  • Jednak punkt początkowy nie musi znajdować się na początku trasy odniesienia wejściowej (można ją traktować jako bieżącą pozycję pojazdu na trasie referencyjnej).
• Trasa referencyjna zwrócona jako pierwsza trasa w calculateRoute Response rozpocznie się w punkcie początkowym określonym w calculateRoute Request. Początkowa część trasy referencyjnej wejściowej do punktu początkowego zostanie wykluczona z odpowiedzi.
• Wartości minDeviationDistance i minDeviationTime określają, jak daleko alternatywne trasy będą zgodne z trasą referencyjną z punktu początkowego.
• Trasa musi używać departAt.
• Pojazd Przerzut jest ignorowany.

minDeviationTime?: number

Wartość właściwości

number

query

Współrzędne, przez które jest obliczana trasa, rozdzielana dwukropkiem. Wymagana jest minimalna liczba dwóch współrzędnych. Pierwszy z nich to źródło, a ostatni to miejsce docelowe trasy. Opcjonalne współrzędne między działają jako punkty WayPoint w trasie. Możesz przekazać maksymalnie 150 punktów WayPoint.

query: string

Wartość właściwości

string

report

Określa, które dane mają być zgłaszane w celach diagnostycznych. Jedyną możliwą wartością jest effectiveSettings. Raportuje obowiązujące parametry lub dane używane podczas wywoływania interfejsu API. W przypadku domyślnych parametrów wartość domyślna zostanie odzwierciedlona, gdy parametr nie został określony przez obiekt wywołujący.

report?: "effectiveSettings"

Wartość właściwości

"effectiveSettings"

routeRepresentation

Określa reprezentację zestawu tras podanych jako odpowiedź.

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

Wartość właściwości

"polyline" | "summaryOnly" | "none"

routeType

Żądany typ trasy.

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

Wartość właściwości

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

sectionType

Określa, które typy sekcji są zgłaszane w odpowiedzi trasy.

Na przykład jeśli sekcja sectionType = sekcja dla pieszych, które są odpowiednie tylko dla pieszych, są zwracane. Można określić wiele razy w jednym żądaniu, na przykład "§ionType=carTrain§ionType=pedestrian§ionType=highway". Domyślny typ sekcji odnosi się do danych wejściowych travelMode. Domyślnie element travelMode jest ustawiony na samochód

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

Wartość właściwości

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

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"

vehicleHeading

Kierunek pojazdu w stopniach rozpoczynających się od prawdziwej Północy i kontynuowany w kierunku wskazówek zegara. Północ jest 0 stopni, wschód jest 90 stopni, południe jest 180 stopni, zachód jest 270 stopni. Możliwe wartości 0–359

vehicleHeading?: number

Wartość właściwości

number

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"