RouteGetRouteDirectionsWithAdditionalParametersQueryParamProperties interface

Balíček:

@azure-rest/maps-route

Vlastnosti

accelerationEfficiency	Určuje účinnost převodu chemické energie uložené v palivu na kinetickou energii, když vozidlo zrychluje (tj. KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed je získán převodem spotřebovaného paliva na chemickou energii pomocí fuelEnergyDensityInMJoulesPerLiter. Musí být spárovány s deceleračníEfficiency. Rozsah povolených hodnot je 0,0 až 1/deceleraceEfficiency. Rozumné hodnoty : pro spalovací model : 0,33, pro elektrický model : 0,66
alternativeType	Řídí optimální výkon vzhledem k zadaným kritériím plánování počítaných alternativ v porovnání s referenční trasou.
arriveAt	Datum a čas doručení v cílovém bodě formátovaný jako hodnota dateTime definovaná v RFC 3339, oddíl 5.6s volitelným posunem časového pásma. Pokud není zadán posun časového pásma, předpokládá se, že se jedná o cílový bod. Příklady: 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 Parametr arriveAt nelze použít ve spojení s departAt, minDeviationDistance nebo minDeviationTime.
auxiliaryPowerInkW	Určuje množství energie spotřebované pro udržitelné pomocné systémy v kilowattech (kW). Lze ji použít k určení spotřeby z důvodu zařízení a systémů, jako jsou systémy AC, rádio, topení atd. Rozumné hodnoty : 1,7
auxiliaryPowerInLitersPerHour	Určuje množství paliva spotřebované pro udržování pomocných systémů vozidla v litrech za hodinu. Lze ji použít k určení spotřeby z důvodu zařízení a systémů, jako jsou systémy AC, rádio, topení atd. Rozumné hodnoty : 0,2
avoid	Určuje něco, čeho se má výpočet trasy při určování trasy pokusit vyhnout. V jedné žádosti je možné zadat vícekrát, například "&se vyhnout =dálnice&vyhnout=tollRoads&vyhnout se =trajekty". V požadavcích rozsahu tras se hodnota alreadyUsedRoads nesmí použít.
computeBestOrder	Přeuspořádejte směrovací body pomocí rychlého heuristického algoritmu, abyste snížili délku trasy. Poskytuje nejlepší výsledky při použití ve spojení s routeType nejkratší. Všimněte si, že původ a cíl jsou vyloučené z optimalizovaných indexů směrových bodů. Pokud chcete do odpovědi zahrnout původ a cíl, zvyšte všechny indexy o 1, abyste zohlednili původ, a pak přidejte cíl jako konečný index. Možné hodnoty jsou true nebo false. Pravda vypočítá lepší pořadí, pokud je to možné, ale není povoleno používat ve spojení s hodnotou maxAlternatives větší než 0 nebo ve spojení s kruhovými směrovými body. False bude používat umístění v daném pořadí a nesmí být použity ve spojení s routeRepresentation žádné.
computeTravelTimeFor	Určuje, jestli se mají vrátit další doby cesty pomocí různých typů informací o provozu (žádné, historické, živé) a výchozí doby jízdy s nejlepším odhadem.
constantSpeedConsumptionInkWhPerHundredkm	Určuje součást spotřeby závislá na rychlosti. Poskytuje se jako neuspořádaný seznam dvojic rychlostí/spotřeba. Seznam definuje body na křivkě spotřeby. Sazby spotřeby pro rychlosti, které nejsou v seznamu, se nacházejí takto: lineární interpolací, pokud daná rychlost leží mezi dvěma rychlostmi v seznamu lineární extrapolací jinak za předpokladu, že konstanta (ΔConsumption/ΔSpeed) určená nejbližšími dvěma body v seznamu Seznam musí obsahovat 1 až 25 bodů (včetně) a nesmí obsahovat duplicitní body pro stejnou rychlost. Pokud obsahuje pouze jeden bod, použije se spotřeba tohoto bodu bez dalšího zpracování. Spotřeba zadaná pro největší rychlost musí být větší nebo rovna hodnotě předposlední největší rychlosti. Tím se zajistí, že extrapolace nezáporná míra spotřeby nezáporná. Podobně hodnoty spotřeby zadané pro dvě nejmenší rychlosti v seznamu nemohou vést k záporné spotřebě pro jakoukoli menší rychlost. Platný rozsah pro hodnoty spotřeby (vyjádřený v kWh/100km) je mezi 0,01 a 100000,0. Rozumné hodnoty : 50,8.2:130,21,3 Tento parametr je vyžadován pro model elektrické spotřeby.
constantSpeedConsumptionInLitersPerHundredkm	Určuje součást spotřeby závislá na rychlosti. Poskytuje se jako neuspořádaný seznam rychlostí oddělených dvojtečkami & páry spotřeby. Seznam definuje body na křivkě spotřeby. Sazby spotřeby pro rychlosti, které nejsou v seznamu, se nacházejí takto: lineární interpolací, pokud daná rychlost leží mezi dvěma rychlostmi v seznamu lineární extrapolací jinak za předpokladu, že konstanta (ΔConsumption/ΔSpeed) určená nejbližšími dvěma body v seznamu Seznam musí obsahovat 1 až 25 bodů (včetně) a nesmí obsahovat duplicitní body pro stejnou rychlost. Pokud obsahuje pouze jeden bod, použije se spotřeba tohoto bodu bez dalšího zpracování. Spotřeba zadaná pro největší rychlost musí být větší nebo rovna hodnotě předposlední největší rychlosti. Tím se zajistí, že extrapolace nezáporná míra spotřeby nezáporná. Podobně hodnoty spotřeby zadané pro dvě nejmenší rychlosti v seznamu nemohou vést k záporné spotřebě pro jakoukoli menší rychlost. Platný rozsah pro hodnoty spotřeby (vyjádřený v l/100km) je mezi 0,01 a 100000,0. Rozumné hodnoty : 50,6.3:130,11,5 Poznámka: Tento parametr je vyžadován pro model spotřeby spalování.
currentChargeInkWh	Určuje aktuální zdroj elektrické energie v kilowatthodinách (kWh). Tento parametr existuje společně s parametrem maxChargeInkWh. Rozsah povolených hodnot je 0,0 až maxChargeInkWh. Rozumné hodnoty : 43
currentFuelInLiters	Určuje aktuální dodávku paliva v literech. Rozumné hodnoty : 55
decelerationEfficiency	Určuje účinnost převodu kinetické energie na úsporné (nezpotřebované) paliva, když vozidlo deceleruje (tj. ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved je získán převodem uloženého (nespotřebovaného) paliva na energii pomocí fuelEnergyDensityInMJoulesPerLiter. Musí být spárovány s akceleracíEfficiency. Rozsah povolených hodnot je 0,0 až 1/akceleraceEfficiency. Rozumné hodnoty : pro spalovací model : 0,83, pro elektrický model : 0,91
departAt	Datum a čas odjezdu od počátečního bodu formátované jako dateTime hodnota definovaná v RFC 3339, oddíl 5.6, s volitelným posunem časového pásma. Pokud není zadán posun časového pásma, předpokládá se, že se jedná o počáteční bod. Výchozí hodnota: teď Jiná hodnota: dateTime Příklady: 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 Parametr departAt nelze použít ve spojení s arriveAt.
downhillEfficiency	Určuje účinnost převodu potenciální energie na úsporné (nezpotřebované) paliva, když vozidlo ztratí zvýšení (tj. ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved je získán převodem uloženého (nespotřebovaného) paliva na energii pomocí fuelEnergyDensityInMJoulesPerLiter. Musí být spárovány s . Povolený rozsah hodnot je 0,0 až 1/. Rozumné hodnoty : pro spalovací model : 0,51, pro elektrický model : 0,73
fuelEnergyDensityInMJoulesPerLiter	Určuje množství chemické energie uložené v jednom litru paliva v megajoules (MJ). Používá se ve spojení s *Účinnost parametry pro převody mezi uloženou nebo spotřebovanou energií a palivem. Například hustota energie je 34,2 MJ/l pro benzín a 35,8 MJ/l pro naftové palivo. Tento parametr se vyžaduje, pokud je nastavený parametr *Efficiency. Rozumné hodnoty : 34,2
hilliness	Stupeň kopcovitosti pro vzrušující trasu. Tento parametr lze použít pouze ve spojení s routeType=vzrušující.
instructionsType	Pokud je zadáno, vrátí se pokyny. Všimněte si, že parametr instructionsType nelze použít ve spojení s routeRepresentation=none.
language	Parametr jazyka určuje jazyk doprovodných zpráv. Nemá vliv na správné podstatná jména (názvy ulic, náměstí atd.) Nemá žádný vliv, když instructionsType=coded. Povolené hodnoty jsou (podmnožinou) popisovaných značek jazyka IETF.
maxAlternatives	Počet požadovaných alternativních tras, které se mají vypočítat. Výchozí hodnota: 0, minimum: 0 a maximum: 5
maxChargeInkWh	Určuje maximální přívod elektrické energie v kilowatthodinách (kWh), který může být uložen v baterii vozidla. Tento parametr existuje společně s parametrem currentChargeInkWh. Minimální hodnota musí být větší nebo rovna currentChargeInkWh. Rozumné hodnoty : 85
minDeviationDistance	Všechny vrácené alternativní trasy se budou řídit referenční trasou (viz část POST Requests) z počátečního bodu požadavku calculateRoute pro alespoň tento počet měřičů. Lze použít pouze při rekonstrukci trasy. Parametr minDeviationDistance nelze použít ve spojení s funkcí arriveAt.
minDeviationTime	Všechny vrácené alternativní trasy se budou řídit referenční trasou (viz část POST Requests) z počátečního bodu požadavku calculateRoute alespoň na tento počet sekund. Lze použít pouze při rekonstrukci trasy. Parametr minDeviationTime nelze použít ve spojení s arriveAt. Výchozí hodnota je 0. Nastavení )minDeviationTime_ na hodnotu větší než nula má následující důsledky: Počáteční bod calculateRoute Požadavek musí být na vstupní referenční trase (nebo velmi blízko). Pokud tomu tak není, vrátí se chyba. Počáteční bod však nemusí být na začátku vstupní referenční trasy (lze ji považovat za aktuální pozici vozidla na referenční trase). Referenční trasa vrácená jako první trasa v calculateRoute Response začne v počátečním bodě zadaném v calculateRoute Request. Počáteční část vstupní referenční trasy nahoru až do doby, než bude počáteční bod vyloučen z odpovědi. Hodnoty minDeviationDistance a minDeviationTime určují, jak daleko se budou alternativní trasy řídit referenční trasou od počátečního bodu dál. Trasa musí používat odjezdu. heading vozidel se ignoruje.
query	Souřadnice, kterými se trasa vypočítá, oddělená dvojtečkam. Vyžaduje se minimálně dvě souřadnice. První je původ a poslední je cílem trasy. Volitelné souřadnice mezi jednotlivými body fungují jako waypointy v trase. Můžete předat až 150 waypointů.
report	Určuje, která data se mají hlásit pro účely diagnostiky. Jedinou možnou hodnotou je effectiveSettings. Hlásí efektivní parametry nebo data použitá při volání rozhraní API. V případě výchozích parametrů se výchozí hodnota projeví tam, kde volající nezadával parametr.
routeRepresentation	Určuje reprezentaci sady tras zadaných jako odpověď.
routeType	Typ požadované trasy.
sectionType	Určuje, které typy oddílů jsou hlášeny v odpovědi trasy. Pokud je například sectionType = chodci, které jsou vhodné pouze pro chodce, jsou vráceny. V jednom požadavku lze zadat vícekrát, například '§ionType=carTrain§ionType=pedestrian§ionType=motorway'. Výchozí sectionType odkazuje na vstup travelMode. Ve výchozím nastavení je travelMode nastaveno na auto
traffic	Možné hodnoty: true – Zvažte všechny dostupné informace o provozu během směrování. false – Během směrování ignorujte aktuální data provozu. Mějte na paměti, že i když se aktuální data provozu během směrování ignorují, vliv historického provozu na efektivní rychlosti silničního provozu je stále začleněn.
travelMode	Režim cesty pro požadovanou trasu Pokud není definováno, výchozí hodnota je "auto". Všimněte si, že požadovaný travelMode nemusí být k dispozici pro celou trasu. Pokud požadovaný travelMode není pro určitou část k dispozici, bude prvek travelMode odpovědi pro tento oddíl "jiný". Všimněte si, že cestovní režimy autobus, motocykl, taxi a dodávka jsou funkce BETA. Úplná data omezení nejsou dostupná ve všech oblastech.
uphillEfficiency	Určuje účinnost převodu chemické energie uložené v palivu na potenciální energii, když vozidlo získá zvýšení (tj. PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed je získán převodem spotřebovaného paliva na chemickou energii pomocí fuelEnergyDensityInMJoulesPerLiter. Musí být spárovány s sjezdovéefekce. Rozsah povolených hodnot je 0,0 až 1/sjezdovéefekce. Rozumné hodnoty : pro spalovací model : 0,27, pro elektrický model : 0,74
vehicleAxleWeight	Hmotnost na nápravu vozidla v kg. Hodnota 0 znamená, že se nebere v úvahu omezení hmotnosti na nápravu.
vehicleCommercial	Zda se vozidlo používá pro komerční účely. Na některých silnicích nesmí být povolena jízda na komerčních vozidlech.
vehicleEngineType	Typ motoru vozidla. Při zadání podrobného modelu spotřeby musí být konzistentní s hodnotou vehicleEngineType.
vehicleHeading	Směrový nadpis vozidla ve stupních počínaje skutečným severem a pokračuje ve směru hodinových ručiček. Sever je 0 stupňů, východ je 90 stupňů, jih je 180 stupňů, západ je 270 stupňů. Možné hodnoty 0–359
vehicleHeight	Výška vozidla v metrech. Hodnota 0 znamená, že se omezení výšky nepovažují.
vehicleLength	Délka vozidla v metrech. Hodnota 0 znamená, že omezení délky se nepovažují.
vehicleLoadType	Typy nákladu, které mohou být klasifikovány jako nebezpečné materiály a omezeny na některé silnice. Dostupné hodnoty vehicleLoadType jsou us Hazmat třídy 1 až 9 a obecné klasifikace pro použití v jiných zemích/oblastech. Hodnoty začínající usHazmat jsou určené pro směrování v USA, zatímco ostatníhazmat by se měly používat pro všechny ostatní země/oblasti. vehicleLoadType lze zadat vícekrát. Tento parametr je aktuálně považován pouze za travelMode=truck.
vehicleMaxSpeed	Maximální rychlost vozidla v km/hodině. Maximální rychlost profilu vozidla se používá ke kontrole, zda je vozidlo povoleno na dálnicích. Hodnota 0 znamená, že při plánování trasy se určí a použije příslušná hodnota pro vozidlo. Během plánování trasy může být přepsána nenulová hodnota. Například aktuální tok provozu je 60 km/hodina. Pokud je maximální rychlost vozidla nastavená na 50 km/hodinu, bude směrovací motor považovat za aktuální situaci 60 km/hodinu. Pokud je maximální rychlost vozidla poskytována jako 80 km/hodina, ale aktuální tok provozu je 60 km/hodina, směrovací motor znovu použije 60 km/hodinu.
vehicleWeight	Hmotnost vozidla v kg. Je povinné, pokud jsou nastaveny některé z parametrů efektivity. Při použití v kontextu modelu consumption musí být přísně pozitivní. Zvažují se omezení hmotnosti. Pokud není zadán žádný podrobný model spotřeby a hodnota hmotnosti vozidla není nulová, zvažují se omezení hmotnosti. Ve všech ostatních případech se tento parametr ignoruje. Rozumné hodnoty : pro spalovací model : 1600, pro elektrický model : 1900
vehicleWidth	Šířka vozidla v metrech. Hodnota 0 znamená, že se omezení šířky nepovažují.
windingness	Úroveň otáček pro vzrušující trasu. Tento parametr lze použít pouze ve spojení s routeType=vzrušující.

Podrobnosti vlastnosti

accelerationEfficiency

Určuje účinnost převodu chemické energie uložené v palivu na kinetickou energii, když vozidlo zrychluje (tj. KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed je získán převodem spotřebovaného paliva na chemickou energii pomocí fuelEnergyDensityInMJoulesPerLiter.

Musí být spárovány s deceleračníEfficiency.

Rozsah povolených hodnot je 0,0 až 1/deceleraceEfficiency.

Rozumné hodnoty : pro spalovací model : 0,33, pro elektrický model : 0,66

accelerationEfficiency?: number

Hodnota vlastnosti

number

alternativeType

Řídí optimální výkon vzhledem k zadaným kritériím plánování počítaných alternativ v porovnání s referenční trasou.

alternativeType?: "anyRoute" | "betterRoute"

Hodnota vlastnosti

"anyRoute" | "betterRoute"

arriveAt

Datum a čas doručení v cílovém bodě formátovaný jako hodnota dateTime definovaná v RFC 3339, oddíl 5.6s volitelným posunem časového pásma. Pokud není zadán posun časového pásma, předpokládá se, že se jedná o cílový bod.

Příklady:

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

Parametr arriveAt nelze použít ve spojení s departAt, minDeviationDistance nebo minDeviationTime.

arriveAt?: string | Date

Hodnota vlastnosti

string | Date

auxiliaryPowerInkW

Určuje množství energie spotřebované pro udržitelné pomocné systémy v kilowattech (kW).

Lze ji použít k určení spotřeby z důvodu zařízení a systémů, jako jsou systémy AC, rádio, topení atd.

Rozumné hodnoty : 1,7

auxiliaryPowerInkW?: number

Hodnota vlastnosti

number

auxiliaryPowerInLitersPerHour

Určuje množství paliva spotřebované pro udržování pomocných systémů vozidla v litrech za hodinu.

Lze ji použít k určení spotřeby z důvodu zařízení a systémů, jako jsou systémy AC, rádio, topení atd.

Rozumné hodnoty : 0,2

auxiliaryPowerInLitersPerHour?: number

Hodnota vlastnosti

number

avoid

Určuje něco, čeho se má výpočet trasy při určování trasy pokusit vyhnout. V jedné žádosti je možné zadat vícekrát, například "&se vyhnout =dálnice&vyhnout=tollRoads&vyhnout se =trajekty". V požadavcích rozsahu tras se hodnota alreadyUsedRoads nesmí použít.

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

Hodnota vlastnosti

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

computeBestOrder

Přeuspořádejte směrovací body pomocí rychlého heuristického algoritmu, abyste snížili délku trasy. Poskytuje nejlepší výsledky při použití ve spojení s routeType nejkratší. Všimněte si, že původ a cíl jsou vyloučené z optimalizovaných indexů směrových bodů. Pokud chcete do odpovědi zahrnout původ a cíl, zvyšte všechny indexy o 1, abyste zohlednili původ, a pak přidejte cíl jako konečný index. Možné hodnoty jsou true nebo false. Pravda vypočítá lepší pořadí, pokud je to možné, ale není povoleno používat ve spojení s hodnotou maxAlternatives větší než 0 nebo ve spojení s kruhovými směrovými body. False bude používat umístění v daném pořadí a nesmí být použity ve spojení s routeRepresentation žádné.

computeBestOrder?: boolean

Hodnota vlastnosti

boolean

computeTravelTimeFor

Určuje, jestli se mají vrátit další doby cesty pomocí různých typů informací o provozu (žádné, historické, živé) a výchozí doby jízdy s nejlepším odhadem.

computeTravelTimeFor?: "none" | "all"

Hodnota vlastnosti

"none" | "all"

constantSpeedConsumptionInkWhPerHundredkm

Určuje součást spotřeby závislá na rychlosti.

Poskytuje se jako neuspořádaný seznam dvojic rychlostí/spotřeba. Seznam definuje body na křivkě spotřeby. Sazby spotřeby pro rychlosti, které nejsou v seznamu, se nacházejí takto:

• lineární interpolací, pokud daná rychlost leží mezi dvěma rychlostmi v seznamu

• lineární extrapolací jinak za předpokladu, že konstanta (ΔConsumption/ΔSpeed) určená nejbližšími dvěma body v seznamu

Seznam musí obsahovat 1 až 25 bodů (včetně) a nesmí obsahovat duplicitní body pro stejnou rychlost. Pokud obsahuje pouze jeden bod, použije se spotřeba tohoto bodu bez dalšího zpracování.

Spotřeba zadaná pro největší rychlost musí být větší nebo rovna hodnotě předposlední největší rychlosti. Tím se zajistí, že extrapolace nezáporná míra spotřeby nezáporná.

Podobně hodnoty spotřeby zadané pro dvě nejmenší rychlosti v seznamu nemohou vést k záporné spotřebě pro jakoukoli menší rychlost.

Platný rozsah pro hodnoty spotřeby (vyjádřený v kWh/100km) je mezi 0,01 a 100000,0.

Rozumné hodnoty : 50,8.2:130,21,3

Tento parametr je vyžadován pro model elektrické spotřeby.

constantSpeedConsumptionInkWhPerHundredkm?: string

Hodnota vlastnosti

string

constantSpeedConsumptionInLitersPerHundredkm

Určuje součást spotřeby závislá na rychlosti.

Poskytuje se jako neuspořádaný seznam rychlostí oddělených dvojtečkami & páry spotřeby. Seznam definuje body na křivkě spotřeby. Sazby spotřeby pro rychlosti, které nejsou v seznamu, se nacházejí takto:

• lineární interpolací, pokud daná rychlost leží mezi dvěma rychlostmi v seznamu

• lineární extrapolací jinak za předpokladu, že konstanta (ΔConsumption/ΔSpeed) určená nejbližšími dvěma body v seznamu

Seznam musí obsahovat 1 až 25 bodů (včetně) a nesmí obsahovat duplicitní body pro stejnou rychlost. Pokud obsahuje pouze jeden bod, použije se spotřeba tohoto bodu bez dalšího zpracování.

Spotřeba zadaná pro největší rychlost musí být větší nebo rovna hodnotě předposlední největší rychlosti. Tím se zajistí, že extrapolace nezáporná míra spotřeby nezáporná.

Podobně hodnoty spotřeby zadané pro dvě nejmenší rychlosti v seznamu nemohou vést k záporné spotřebě pro jakoukoli menší rychlost.

Platný rozsah pro hodnoty spotřeby (vyjádřený v l/100km) je mezi 0,01 a 100000,0.

Rozumné hodnoty : 50,6.3:130,11,5

Poznámka: Tento parametr je vyžadován pro model spotřeby spalování.

constantSpeedConsumptionInLitersPerHundredkm?: string

Hodnota vlastnosti

string

currentChargeInkWh

Určuje aktuální zdroj elektrické energie v kilowatthodinách (kWh).

Tento parametr existuje společně s parametrem maxChargeInkWh.

Rozsah povolených hodnot je 0,0 až maxChargeInkWh.

Rozumné hodnoty : 43

currentChargeInkWh?: number

Hodnota vlastnosti

number

currentFuelInLiters

Určuje aktuální dodávku paliva v literech.

Rozumné hodnoty : 55

currentFuelInLiters?: number

Hodnota vlastnosti

number

decelerationEfficiency

Určuje účinnost převodu kinetické energie na úsporné (nezpotřebované) paliva, když vozidlo deceleruje (tj. ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved je získán převodem uloženého (nespotřebovaného) paliva na energii pomocí fuelEnergyDensityInMJoulesPerLiter.

Musí být spárovány s akceleracíEfficiency.

Rozsah povolených hodnot je 0,0 až 1/akceleraceEfficiency.

Rozumné hodnoty : pro spalovací model : 0,83, pro elektrický model : 0,91

decelerationEfficiency?: number

Hodnota vlastnosti

number

departAt

Datum a čas odjezdu od počátečního bodu formátované jako dateTime hodnota definovaná v RFC 3339, oddíl 5.6, s volitelným posunem časového pásma. Pokud není zadán posun časového pásma, předpokládá se, že se jedná o počáteční bod.

• Výchozí hodnota: teď
• Jiná hodnota: dateTime

Příklady:

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

Parametr departAt nelze použít ve spojení s arriveAt.

departAt?: string | Date

Hodnota vlastnosti

string | Date

downhillEfficiency

Určuje účinnost převodu potenciální energie na úsporné (nezpotřebované) paliva, když vozidlo ztratí zvýšení (tj. ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved je získán převodem uloženého (nespotřebovaného) paliva na energii pomocí fuelEnergyDensityInMJoulesPerLiter.

Musí být spárovány s .

Povolený rozsah hodnot je 0,0 až 1/.

Rozumné hodnoty : pro spalovací model : 0,51, pro elektrický model : 0,73

downhillEfficiency?: number

Hodnota vlastnosti

number

fuelEnergyDensityInMJoulesPerLiter

Určuje množství chemické energie uložené v jednom litru paliva v megajoules (MJ). Používá se ve spojení s *Účinnost parametry pro převody mezi uloženou nebo spotřebovanou energií a palivem. Například hustota energie je 34,2 MJ/l pro benzín a 35,8 MJ/l pro naftové palivo.

Tento parametr se vyžaduje, pokud je nastavený parametr *Efficiency.

Rozumné hodnoty : 34,2

fuelEnergyDensityInMJoulesPerLiter?: number

Hodnota vlastnosti

number

hilliness

Stupeň kopcovitosti pro vzrušující trasu. Tento parametr lze použít pouze ve spojení s routeType=vzrušující.

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

Hodnota vlastnosti

"low" | "normal" | "high"

instructionsType

Pokud je zadáno, vrátí se pokyny. Všimněte si, že parametr instructionsType nelze použít ve spojení s routeRepresentation=none.

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

Hodnota vlastnosti

"coded" | "text" | "tagged"

language

Parametr jazyka určuje jazyk doprovodných zpráv. Nemá vliv na správné podstatná jména (názvy ulic, náměstí atd.) Nemá žádný vliv, když instructionsType=coded. Povolené hodnoty jsou (podmnožinou) popisovaných značek jazyka IETF.

language?: string

Hodnota vlastnosti

string

maxAlternatives

Počet požadovaných alternativních tras, které se mají vypočítat. Výchozí hodnota: 0, minimum: 0 a maximum: 5

maxAlternatives?: number

Hodnota vlastnosti

number

maxChargeInkWh

Určuje maximální přívod elektrické energie v kilowatthodinách (kWh), který může být uložen v baterii vozidla.

Tento parametr existuje společně s parametrem currentChargeInkWh.

Minimální hodnota musí být větší nebo rovna currentChargeInkWh.

Rozumné hodnoty : 85

maxChargeInkWh?: number

Hodnota vlastnosti

number

minDeviationDistance

Všechny vrácené alternativní trasy se budou řídit referenční trasou (viz část POST Requests) z počátečního bodu požadavku calculateRoute pro alespoň tento počet měřičů. Lze použít pouze při rekonstrukci trasy. Parametr minDeviationDistance nelze použít ve spojení s funkcí arriveAt.

minDeviationDistance?: number

Hodnota vlastnosti

number

minDeviationTime

Všechny vrácené alternativní trasy se budou řídit referenční trasou (viz část POST Requests) z počátečního bodu požadavku calculateRoute alespoň na tento počet sekund. Lze použít pouze při rekonstrukci trasy. Parametr minDeviationTime nelze použít ve spojení s arriveAt. Výchozí hodnota je 0. Nastavení )minDeviationTime_ na hodnotu větší než nula má následující důsledky:

• Počáteční bod calculateRoute Požadavek musí být na vstupní referenční trase (nebo velmi blízko).
  • Pokud tomu tak není, vrátí se chyba.
  • Počáteční bod však nemusí být na začátku vstupní referenční trasy (lze ji považovat za aktuální pozici vozidla na referenční trase).
• Referenční trasa vrácená jako první trasa v calculateRoute Response začne v počátečním bodě zadaném v calculateRoute Request. Počáteční část vstupní referenční trasy nahoru až do doby, než bude počáteční bod vyloučen z odpovědi.
• Hodnoty minDeviationDistance a minDeviationTime určují, jak daleko se budou alternativní trasy řídit referenční trasou od počátečního bodu dál.
• Trasa musí používat odjezdu.
• heading vozidel se ignoruje.

minDeviationTime?: number

Hodnota vlastnosti

number

query

Souřadnice, kterými se trasa vypočítá, oddělená dvojtečkam. Vyžaduje se minimálně dvě souřadnice. První je původ a poslední je cílem trasy. Volitelné souřadnice mezi jednotlivými body fungují jako waypointy v trase. Můžete předat až 150 waypointů.

query: string

Hodnota vlastnosti

string

report

Určuje, která data se mají hlásit pro účely diagnostiky. Jedinou možnou hodnotou je effectiveSettings. Hlásí efektivní parametry nebo data použitá při volání rozhraní API. V případě výchozích parametrů se výchozí hodnota projeví tam, kde volající nezadával parametr.

report?: "effectiveSettings"

Hodnota vlastnosti

"effectiveSettings"

routeRepresentation

Určuje reprezentaci sady tras zadaných jako odpověď.

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

Hodnota vlastnosti

"polyline" | "summaryOnly" | "none"

routeType

Typ požadované trasy.

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

Hodnota vlastnosti

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

sectionType

Určuje, které typy oddílů jsou hlášeny v odpovědi trasy.

Pokud je například sectionType = chodci, které jsou vhodné pouze pro chodce, jsou vráceny. V jednom požadavku lze zadat vícekrát, například '§ionType=carTrain§ionType=pedestrian§ionType=motorway'. Výchozí sectionType odkazuje na vstup travelMode. Ve výchozím nastavení je travelMode nastaveno na auto

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

Hodnota vlastnosti

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

traffic

Možné hodnoty:

• true – Zvažte všechny dostupné informace o provozu během směrování.
• false – Během směrování ignorujte aktuální data provozu. Mějte na paměti, že i když se aktuální data provozu během směrování ignorují, vliv historického provozu na efektivní rychlosti silničního provozu je stále začleněn.

traffic?: boolean

Hodnota vlastnosti

boolean

travelMode

Režim cesty pro požadovanou trasu Pokud není definováno, výchozí hodnota je "auto". Všimněte si, že požadovaný travelMode nemusí být k dispozici pro celou trasu. Pokud požadovaný travelMode není pro určitou část k dispozici, bude prvek travelMode odpovědi pro tento oddíl "jiný". Všimněte si, že cestovní režimy autobus, motocykl, taxi a dodávka jsou funkce BETA. Úplná data omezení nejsou dostupná ve všech oblastech.

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

Hodnota vlastnosti

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

uphillEfficiency

Určuje účinnost převodu chemické energie uložené v palivu na potenciální energii, když vozidlo získá zvýšení (tj. PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed je získán převodem spotřebovaného paliva na chemickou energii pomocí fuelEnergyDensityInMJoulesPerLiter.

Musí být spárovány s sjezdovéefekce.

Rozsah povolených hodnot je 0,0 až 1/sjezdovéefekce.

Rozumné hodnoty : pro spalovací model : 0,27, pro elektrický model : 0,74

uphillEfficiency?: number

Hodnota vlastnosti

number

vehicleAxleWeight

Hmotnost na nápravu vozidla v kg. Hodnota 0 znamená, že se nebere v úvahu omezení hmotnosti na nápravu.

vehicleAxleWeight?: number

Hodnota vlastnosti

number

vehicleCommercial

Zda se vozidlo používá pro komerční účely. Na některých silnicích nesmí být povolena jízda na komerčních vozidlech.

vehicleCommercial?: boolean

Hodnota vlastnosti

boolean

vehicleEngineType

Typ motoru vozidla. Při zadání podrobného modelu spotřeby musí být konzistentní s hodnotou vehicleEngineType.

vehicleEngineType?: "combustion" | "electric"

Hodnota vlastnosti

"combustion" | "electric"

vehicleHeading

Směrový nadpis vozidla ve stupních počínaje skutečným severem a pokračuje ve směru hodinových ručiček. Sever je 0 stupňů, východ je 90 stupňů, jih je 180 stupňů, západ je 270 stupňů. Možné hodnoty 0–359

vehicleHeading?: number

Hodnota vlastnosti

number

vehicleHeight

Výška vozidla v metrech. Hodnota 0 znamená, že se omezení výšky nepovažují.

vehicleHeight?: number

Hodnota vlastnosti

number

vehicleLength

Délka vozidla v metrech. Hodnota 0 znamená, že omezení délky se nepovažují.

vehicleLength?: number

Hodnota vlastnosti

number

vehicleLoadType

Typy nákladu, které mohou být klasifikovány jako nebezpečné materiály a omezeny na některé silnice. Dostupné hodnoty vehicleLoadType jsou us Hazmat třídy 1 až 9 a obecné klasifikace pro použití v jiných zemích/oblastech. Hodnoty začínající usHazmat jsou určené pro směrování v USA, zatímco ostatníhazmat by se měly používat pro všechny ostatní země/oblasti. vehicleLoadType lze zadat vícekrát. Tento parametr je aktuálně považován pouze za travelMode=truck.

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

Hodnota vlastnosti

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

vehicleMaxSpeed

Maximální rychlost vozidla v km/hodině. Maximální rychlost profilu vozidla se používá ke kontrole, zda je vozidlo povoleno na dálnicích.

• Hodnota 0 znamená, že při plánování trasy se určí a použije příslušná hodnota pro vozidlo.

• Během plánování trasy může být přepsána nenulová hodnota. Například aktuální tok provozu je 60 km/hodina. Pokud je maximální rychlost vozidla nastavená na 50 km/hodinu, bude směrovací motor považovat za aktuální situaci 60 km/hodinu. Pokud je maximální rychlost vozidla poskytována jako 80 km/hodina, ale aktuální tok provozu je 60 km/hodina, směrovací motor znovu použije 60 km/hodinu.

vehicleMaxSpeed?: number

Hodnota vlastnosti

number

vehicleWeight

Hmotnost vozidla v kg.

• Je povinné, pokud jsou nastaveny některé z parametrů efektivity.

• Při použití v kontextu modelu consumption musí být přísně pozitivní. Zvažují se omezení hmotnosti.

• Pokud není zadán žádný podrobný model spotřeby a hodnota hmotnosti vozidla není nulová, zvažují se omezení hmotnosti.

• Ve všech ostatních případech se tento parametr ignoruje.

Rozumné hodnoty : pro spalovací model : 1600, pro elektrický model : 1900

vehicleWeight?: number

Hodnota vlastnosti

number

vehicleWidth

Šířka vozidla v metrech. Hodnota 0 znamená, že se omezení šířky nepovažují.

vehicleWidth?: number

Hodnota vlastnosti

number

windingness

Úroveň otáček pro vzrušující trasu. Tento parametr lze použít pouze ve spojení s routeType=vzrušující.

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

Hodnota vlastnosti

"low" | "normal" | "high"