Route - Post Route Directions
Slouží k výpočtu trasy mezi daným původem a cílem, která prochází libovolnými zadanými body trasy.
Rozhraní Post Route Directions
API je požadavek HTTP POST
, který vrací trasu mezi zdrojem a cílem, která prochází body tras, pokud jsou zadané. Trasa bude brát v úvahu faktory, jako je aktuální provoz a typická rychlost silnice v požadovaný den v týdnu a denní čas.
Vrácené informace zahrnují vzdálenost, odhadovanou dobu jízdy a reprezentaci geometrie trasy. V závislosti na vybraných možnostech jsou k dispozici také další informace o směrování, jako je optimalizované pořadí trasového bodu nebo pokyny pro otočení.
Směrovací služba poskytuje sadu parametrů pro podrobný popis modelu spotřeby specifického pro vozidlo. Podrobné vysvětlení příslušných konceptů a parametrů najdete v modelu consumption .
POST https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}
POST https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}&maxAlternatives={maxAlternatives}&alternativeType={alternativeType}&minDeviationDistance={minDeviationDistance}&minDeviationTime={minDeviationTime}&instructionsType={instructionsType}&language={language}&computeBestOrder={computeBestOrder}&routeRepresentation={routeRepresentation}&computeTravelTimeFor={computeTravelTimeFor}&vehicleHeading={vehicleHeading}&report=effectiveSettings§ionType={sectionType}&arriveAt={arriveAt}&departAt={departAt}&vehicleAxleWeight={vehicleAxleWeight}&vehicleLength={vehicleLength}&vehicleHeight={vehicleHeight}&vehicleWidth={vehicleWidth}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}¤tFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}¤tChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
format
|
path | True |
Požadovaný formát odpovědi Hodnota může být json nebo xml. |
|
api-version
|
query | True |
string |
Číslo verze rozhraní API Azure Maps. |
query
|
query | True |
string |
Souřadnice, kterými se trasa počítá, oddělená dvojtečka. Vyžadují se minimálně dvě souřadnice. První z nich je původ a poslední je cíl trasy. Volitelné souřadnice mezi jednotlivými souřadnicemi fungují v trase jako waypointy. Můžete předat až 150 waypointů. |
acceleration
|
query |
number double |
Určuje účinnost přeměny chemické energie uložené v palivu na kinetickou energii při zrychlování vozidla (tj. KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed se získává převodem spotřebovaného paliva na chemickou energii pomocí palivaEnergyDensityInMJoulesPerLiter. Musí být spárovaný s deceleracíEfficiency. Rozsah povolených hodnot je 0,0 až 1/deceleraceEfficiency. Rozumné hodnoty : pro spalovací model : 0.33, pro elektrický model : 0.66 |
|
alternative
|
query |
Řídí optimální s ohledem na daná kritéria plánování počítaných alternativ v porovnání s referenční trasou. |
||
arrive
|
query |
string date-time |
Datum a čas příjezdu do cílového bodu formátované jako hodnota definovaná Příklady:
Parametr |
|
auxiliary
|
query |
number double |
Určuje množství energie spotřebované pomocnými systémy v kilowattech (kW). Může být použit k určení spotřeby vzhledem k zařízením a systémům, jako jsou systémy střídavých, rádiových, topných atd. Rozumné hodnoty : 1.7 |
|
auxiliary
|
query |
number double |
Určuje množství paliva spotřebované pro udržování pomocných systémů vozidla v litrech za hodinu. Může být použit k určení spotřeby vzhledem k zařízením a systémům, jako jsou systémy střídavých, rádiových, topných atd. Rozumné hodnoty : 0,2 |
|
avoid
|
query |
Určuje něco, čeho by se měl výpočet trasy při určování trasy snažit vyhnout. V jednom požadavku je možné zadat vícekrát, například "&avoid=motorways&avoid=tollRoads&avoid=ferries". V požadavcích na rozsah tras nesmí být použita hodnota alreadyUsedRoads. |
||
compute
|
query |
boolean |
Přeuspořádejte trasové body trasy pomocí rychlého heuristického algoritmu, abyste snížili délku trasy. Poskytuje nejlepší výsledky při použití ve spojení s routeType shortest. Všimněte si, že původ a cíl jsou vyloučeny z optimalizovaných indexů trasových bodů. Pokud chcete do odpovědi zahrnout původ a cíl, zvyšte všechny indexy o 1, aby se zohlednil původ, a pak přidejte cíl jako konečný index. Možné hodnoty jsou true nebo false. Hodnota True vypočítá lepší pořadí, pokud je to možné, ale není možné ho použít ve spojení s hodnotou maxAlternatives větší než 0 nebo ve spojení s kruhovými směrovými body. False použije umístění v daném pořadí a nesmí se použít ve spojení s routeRepresentation none. |
|
compute
|
query |
Určuje, zda se mají vrátit další doby cesty pomocí různých typů informací o provozu (žádný, historický, živý) a výchozího nejlepšího odhadu doby cesty. |
||
constant
|
query |
string |
Určuje součást spotřeby závislé na rychlosti. Poskytuje se jako neuspořádaný seznam dvojic rychlost/spotřeba-sazba. Seznam definuje body na křivce spotřeby. Sazby spotřeby pro rychlosti, které nejsou v seznamu, jsou uvedeny takto:
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 míra spotřeby tohoto bodu bez dalšího zpracování. Spotřeba zadaná pro největší rychlost musí být větší nebo rovna spotřebě předposlední největší rychlosti. Tím se zajistí, že extrapolace nepovede k negativním sazbám spotřeby. 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/100 km) je mezi 0,01 a 10 0000,0. Rozumné hodnoty : 50,8.2:130,21,3 Tento parametr je vyžadován pro model elektrické spotřeby. |
|
constant
|
query |
string |
Určuje součást spotřeby závislé na rychlosti. Poskytuje se jako neuspořádaný seznam dvojic rychlosti oddělených dvojtečkami & spotřeba-sazba. Seznam definuje body na křivce spotřeby. Sazby spotřeby pro rychlosti, které nejsou v seznamu, jsou uvedeny takto:
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 míra spotřeby tohoto bodu bez dalšího zpracování. Spotřeba zadaná pro největší rychlost musí být větší nebo rovna spotřebě předposlední největší rychlosti. Tím se zajistí, že extrapolace nepovede k negativním sazbám spotřeby. 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/100 km) je mezi 0,01 a 100000,0. Rozumné hodnoty: 50,6.3:130,11,5 Poznámka : Tento parametr je povinný pro model spotřeby spalování. |
|
current
|
query |
number double |
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 |
|
current
|
query |
number double |
Určuje aktuální dodávku paliva v litrech. Rozumné hodnoty : 55 |
|
deceleration
|
query |
number double |
Určuje účinnost přeměny kinetické energie na uložené (nespotřebované) palivo při zpomalení vozidla (tj. ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved se získává převodem uloženého (nespotřebovaného) paliva na energii pomocí fuelEnergyDensityInMJoulesPerLiter. Musí být spárovaný s accelerationEfficiency. Povolený rozsah hodnot je 0,0 až 1/accelerationEfficiency. Rozumné hodnoty : pro spalovací model : 0.83, pro elektrický model : 0.91 |
|
depart
|
query |
string date-time |
Datum a čas odjezdu od počátečního bodu naformátované jako hodnota definovaná
Příklady:
Parametr |
|
downhill
|
query |
number double |
Určuje účinnost přeměny potenciální energie na úsporu (nespotřebované) palivo, když vozidlo ztratí výšku (tj. ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved se získává převodem uloženého (nespotřebovaného) paliva na energii pomocí fuelEnergyDensityInMJoulesPerLiter. Musí být spárován s uphillEfficiency. Rozsah povolených hodnot je 0,0 až 1/uphillEfficiency. Rozumné hodnoty : pro spalovací model : 0,51, pro elektrický model : 0,73 |
|
fuel
|
query |
number double |
Určuje množství chemické energie uložené v jednom litru paliva v megajoulech (MJ). Používá se ve spojení s *parametry účinnosti 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 naftu. Tento parametr je povinný, pokud je nastaven parametr *Efficiency . Rozumné hodnoty : 34,2 |
|
hilliness
|
query |
Stupeň kopcovitosti pro vzrušující trasu. Tento parametr se dá použít pouze ve spojení s parametrem |
||
instructions
|
query |
Pokud je zadáno, vrátí se pokyny. Všimněte si, že parametr instructionsType nelze použít ve spojení s routeRepresentation=none. |
||
language
|
query |
string |
Parametr jazyka určuje jazyk zpráv s pokyny. 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. |
|
max
|
query |
integer |
Počet požadovaných alternativních tras, které se mají vypočítat. Výchozí hodnota: 0, minimum: 0 a maximum: 5 |
|
max
|
query |
number double |
Určuje maximální dodávku elektrické energie v kilowatthodinách (kWh), která může být uložena v baterii vozidla. Tento parametr existuje společně s parametrem currentChargeInkWh . Minimální hodnota musí být větší než nebo rovna currentChargeInkWh. Rozumné hodnoty : 85 |
|
min
|
query |
integer |
Všechny alternativní trasy vrácené použijí referenční trasu (viz část Požadavky POST) z bodu původu požadavku calculateRoute alespoň po dobu tohoto počtu metrů. Lze použít pouze při rekonstrukci trasy. Parametr minDeviationDistance nelze použít ve spojení s funkcí arriveAt. |
|
min
|
query |
integer |
Všechny vrácené alternativní trasy budou sledovat referenční trasu (viz část Požadavky POST) od počátečního bodu požadavku calculateRoute po dobu alespoň tohoto počtu sekund. Lze použít pouze při rekonstrukci trasy. Parametr minDeviationTime nelze použít ve spojení s funkcí arriveAt. Výchozí hodnota je 0. Nastavení )minDeviationTime_ na hodnotu větší než nula má následující důsledky:
|
|
report
|
query |
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 parametr nebyl zadán volajícím. |
||
route
|
query |
Určuje reprezentaci sady tras poskytovaných jako odpověď. Tuto hodnotu parametru lze použít pouze ve spojení s computeBestOrder=true. |
||
route
|
query |
Typ požadované trasy. |
||
section
|
query |
Určuje, které typy oddílů jsou hlášeny v odpovědi na trasu. |
||
traffic
|
query |
boolean |
Možné hodnoty:
|
|
travel
|
query |
Režim jízdy pro požadovanou trasu. Pokud není definováno, výchozí hodnota je "auto". Upozorňujeme, že požadovaný travelMode nemusí být k dispozici pro celou trasu. Pokud požadovaný travelMode není pro konkrétní oddíl k dispozici, bude prvek travelMode odpovědi pro tento oddíl "jiný". Všimněte si, že režimy cestování autobus, motocykl, taxi a dodávka jsou funkce BETA. Úplná data omezení nejsou k dispozici ve všech oblastech. |
||
uphill
|
query |
number double |
Určuje účinnost přeměny chemické energie uložené v palivu na potenciální energii při zvýšení výšky vozidla (tj. PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed se získává převodem spotřebovaného paliva na chemickou energii pomocí palivaEnergyDensityInMJoulesPerLiter. Musí být spárován s sjezdovýmEfficiency. Povolený rozsah hodnot je 0,0 až 1/sjezdovýEfficiency. Rozumné hodnoty : pro spalovací model : 0.27, pro elektrický model : 0.74 |
|
vehicle
|
query |
integer |
Hmotnost na nápravu vozidla v kg. Hodnota 0 znamená, že se nepřihlíží k hmotnostním omezením na nápravu. |
|
vehicle
|
query |
boolean |
Zda se vozidlo používá ke komerčním účelům. Na některých silnicích nemusí být povolena užitková vozidla. |
|
vehicle
|
query |
Typ motoru vozidla. Když je zadán podrobný model spotřeby, musí být konzistentní s hodnotou vehicleEngineType. |
||
vehicle
|
query |
integer |
Směrový směr vozidla ve stupních začínajících na skutečném severu a pokračujícím 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 |
|
vehicle
|
query |
number double |
Výška vozidla v metrech. Hodnota 0 znamená, že se neúčtují omezení výšky. |
|
vehicle
|
query |
number double |
Délka vozidla v metrech. Hodnota 0 znamená, že se neúčtují omezení délky. |
|
vehicle
|
query |
Druhy nákladu, které mohou být klasifikovány jako nebezpečné materiály a omezeny z některých silnic. Dostupné hodnoty vehicleLoadType jsou americké třídy Hazmat 1 až 9 a navíc obecné klasifikace pro použití v jiných zemích nebo oblastech. Hodnoty začínající na USHazmat jsou pro směrování v USA, zatímco ostatníHazmat by se měly používat pro všechny ostatní země nebo oblasti. vehicleLoadType lze zadat vícekrát. Tento parametr se v současné době zvažuje pouze pro travelMode=truck. |
||
vehicle
|
query |
integer |
Maximální rychlost vozidla v km/hod. Maximální rychlost v profilu vozidla se používá ke kontrole, zda je vozidlo povoleno na dálnicích.
|
|
vehicle
|
query |
integer |
Hmotnost vozidla v kilogramech.
Rozumné hodnoty : pro model spalování : 1600, pro elektrický model : 1900 |
|
vehicle
|
query |
number double |
Šířka vozidla v metrech. Hodnota 0 znamená, že omezení šířky nejsou brána v úvahu. |
|
windingness
|
query |
Úroveň zatáček pro vzrušující trasu. Tento parametr se dá použít pouze ve spojení s parametrem |
Hlavička požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
x-ms-client-id |
string |
Určuje, který účet je určený pro použití ve spojení s modelem zabezpečení Microsoft Entra ID. Představuje jedinečné ID účtu Azure Maps a je možné ho načíst z rozhraní API účtu roviny správy Azure Maps. Pokud chcete použít Microsoft Entra ID zabezpečení v Azure Maps pokyny najdete v následujících článcích. |
Text požadavku
Name | Typ | Description |
---|---|---|
allowVignette |
string[] |
Toto je seznam 3znakový, ISO 3166-1, alfa-3 kód zemí/oblastí, ve kterých jsou povoleny placené silnice s dálničními známkami, např. "AUS,CHE". Zadání parametru allowVignette s některými zeměmi/oblastmi X je ekvivalentem zadání argumentu avoidVignette se všemi zeměmi/oblastmi kromě X. Zadání hodnoty allowVignette s prázdným seznamem je stejné jako vyhnout se všem placeným silnicím s dálničními známkami. Poznámka: Je chyba zadat jak avoidVignette , tak allowVignette. |
avoidAreas |
GeoJSON MultiPolygon představující seznam oblastí, kterým se chcete vyhnout. Podporují se pouze mnohoúhelníky obdélníků. Maximální velikost obdélníku je asi 160x160 km. Maximální počet vyloučených oblastí je 10. Nemůže překročit 180. poledník. Musí být mezi -80 a +80 stupni zeměpisné šířky. |
|
avoidVignette |
string[] |
Toto je seznam 3znakový kód ISO 3166-1 a alfa-3 kódů zemí/oblastí, ve kterých se mají vyhnout všechny placené silnice s dálničními známkami, např. "AUS,CHE". Placené silnice s dálničními známkami v zemích nebo oblastech, které nejsou na seznamu, nejsou ovlivněny. Poznámka: Je chyba zadat jak avoidVignette , tak allowVignette. |
supportingPoints |
Kolekce geometrie GeoJSON představující posloupnost souřadnic použitých jako vstup pro rekonstrukci trasy a pro výpočet nuly nebo více alternativních tras k této referenční trase.
|
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Došlo k neočekávané chybě. |
Zabezpečení
AADToken
Toto jsou Microsoft Entra toky OAuth 2.0. Při spárování s řízením přístupu na základě role v Azure se dá použít k řízení přístupu k Azure Maps rozhraní REST API. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika Azure Maps účtu prostředku nebo dílčím prostředkům. Každému uživateli, skupině nebo instančnímu objektu je možné udělit přístup prostřednictvím předdefinované role nebo vlastní role složené z jednoho nebo více oprávnění k Azure Maps rozhraní REST API.
Pokud chcete implementovat scénáře, doporučujeme zobrazit si koncepty ověřování. Souhrnně řečeno, tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu pro konkrétní rozhraní API a obory.
Poznámky
- Tato definice zabezpečení vyžaduje použití hlavičky
x-ms-client-id
k označení Azure Maps prostředku, ke kterému aplikace žádá o přístup. Můžete ho získat z rozhraní MAPS MANAGEMENT API.
Je Authorization URL
specifický pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné autorizační adresy URL a konfigurace Microsoft Entra ID.
* Řízení přístupu na základě role v Azure se konfiguruje z roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
* Použití sady AZURE MAPS Web SDK umožňuje nastavení aplikace na základě konfigurace pro více případů použití.
- Další informace o Microsoft identity platform najdete v přehledu Microsoft identity platform.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Jedná se o sdílený klíč, který se zřídí při Create účtu Azure Maps v Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto klíčem může každá aplikace přistupovat ke všem rozhraním REST API. Jinými slovy, tento klíč se dá použít jako hlavní klíč v účtu, ve kterému je vystavený.
U veřejně vystavených aplikací doporučujeme pro přístup k Azure Maps rozhraní REST API použít přístup k důvěrným klientským aplikacím, aby se váš klíč mohl bezpečně uložit.
Type:
apiKey
In:
query
SAS Token
Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace List SAS v Azure Maps prostředku prostřednictvím roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto tokenem má každá aplikace autorizaci pro přístup pomocí řízení přístupu na základě role v Azure a podrobnou kontrolu vypršení platnosti, četnosti a oblastí použití konkrétního tokenu. Jinými slovy, token SAS je možné použít k tomu, aby aplikace mohly řídit přístup zabezpečeným způsobem než sdílený klíč.
U veřejně vystavených aplikací doporučujeme nakonfigurovat konkrétní seznam povolených zdrojů v prostředku účtu map , aby se omezilo zneužití vykreslování, a pravidelně obnovovat token SAS.
Type:
apiKey
In:
header
Příklady
Successfully retrieve a route between an origin and a destination with additional parameters in the body
Sample Request
POST https://atlas.microsoft.com/route/directions/json?api-version=1.0&query=52.50931,13.42936:52.50274,13.43872&report=effectiveSettings
{
"supportingPoints": {
"type": "GeometryCollection",
"geometries": [
{
"type": "Point",
"coordinates": [
13.42936,
52.5093
]
},
{
"type": "Point",
"coordinates": [
13.42859,
52.50844
]
}
]
},
"avoidVignette": [
"AUS",
"CHE"
],
"avoidAreas": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
-122.39456176757811,
47.489368981370724
],
[
-122.00454711914061,
47.489368981370724
],
[
-122.00454711914061,
47.65151268066222
],
[
-122.39456176757811,
47.65151268066222
],
[
-122.39456176757811,
47.489368981370724
]
]
],
[
[
[
100,
0
],
[
101,
0
],
[
101,
1
],
[
100,
1
],
[
100,
0
]
]
]
]
}
}
Sample Response
{
"formatVersion": "0.0.12",
"routes": [
{
"summary": {
"lengthInMeters": 1147,
"travelTimeInSeconds": 162,
"trafficDelayInSeconds": 0,
"departureTime": "2017-09-07T16:56:58+00:00",
"arrivalTime": "2017-09-07T16:59:40+00:00"
},
"legs": [
{
"summary": {
"lengthInMeters": 1147,
"travelTimeInSeconds": 162,
"trafficDelayInSeconds": 0,
"departureTime": "2017-09-07T16:56:58+00:00",
"arrivalTime": "2017-09-07T16:59:40+00:00"
},
"points": [
{
"latitude": 52.50931,
"longitude": 13.42937
},
{
"latitude": 52.50904,
"longitude": 13.42912
},
{
"latitude": 52.50894,
"longitude": 13.42904
},
{
"latitude": 52.50867,
"longitude": 13.42879
},
{
"latitude": 52.5084,
"longitude": 13.42857
},
{
"latitude": 52.50791,
"longitude": 13.42824
},
{
"latitude": 52.50757,
"longitude": 13.42772
},
{
"latitude": 52.50735,
"longitude": 13.42823
},
{
"latitude": 52.5073,
"longitude": 13.42836
},
{
"latitude": 52.50573,
"longitude": 13.43194
},
{
"latitude": 52.50512,
"longitude": 13.43336
},
{
"latitude": 52.50464,
"longitude": 13.43451
},
{
"latitude": 52.5045,
"longitude": 13.43481
},
{
"latitude": 52.50443,
"longitude": 13.43498
},
{
"latitude": 52.50343,
"longitude": 13.43737
},
{
"latitude": 52.50274,
"longitude": 13.43872
}
]
}
],
"sections": [
{
"startPointIndex": 0,
"endPointIndex": 15,
"sectionType": "TRAVEL_MODE",
"travelMode": "car"
}
]
}
]
}
Definice
Name | Description |
---|---|
Alternative |
Řídí optimální s ohledem na daná kritéria plánování počítaných alternativ v porovnání s referenční trasou. |
Compute |
Určuje, jestli se mají vrátit další doby cesty s použitím různých typů informací o provozu (žádný, historický, živý) a výchozího nejlepšího odhadu doby cesty. |
Delay |
Velikost zpoždění způsobeného incidentem. Tyto hodnoty odpovídají hodnotám pole odpovědi ty rozhraní API Get Traffic Incident Detail. |
Driving |
Označuje jízdu vlevo a vpravo v místě manévru. |
Effective |
Efektivní parametr nebo data použitá při volání tohoto rozhraní API směrování |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Geo |
Platný |
Guidance |
Typ instrukce, např. zatáčení nebo změna jízdního tvaru. |
Guidance |
Kód identifikující manévr. |
Incline |
Stupeň kopcovitosti pro vzrušující cestu. Tento parametr lze použít pouze ve spojení s parametrem |
Junction |
Typ křižovatky, kde se provádí manévr. Pro větší kruhové objezdy se vygenerují dva samostatné pokyny pro vstup a opuštění kruhového objezdu. |
Lat |
Umístění reprezentované jako zeměpisná šířka a délka. |
Report |
Určuje, která data by měla být hlášena 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í v případě, že parametr nebyl zadán volajícím. |
Response |
Požadovaný formát odpovědi Hodnota může být json nebo xml. |
Response |
Typy oddílů v odpovědi na ohlášenou trasu |
Response |
Režim cesty pro počítanou trasu. Pokud požadovaný způsob dopravy není v této části možný, hodnota se nastaví na |
Route | |
Route |
Určuje něco, čeho by se měl výpočet trasy při určování trasy snažit vyhnout. V jednom požadavku lze zadat vícekrát, například "&avoid=motorways&avoid=tollRoads&avoid=ferries". V požadavcích na rozsah tras nesmí být použita hodnota alreadyUsedRoads. |
Route |
Parametry textu příspěvku pro směr trasy. |
Route |
Tento objekt je vrácen úspěšným voláním trasy trasy. |
Route |
Obsahuje elementy související s pokyny. Toto pole je k dispozici pouze v případě, že byly požadovány pokyny a je k dispozici. |
Route |
Sada atributů popisujících manévr, např. "Zatáčkejte doprava", "Keep left", "Take the ferry", "Take the motorway", "Take the motorway", 'Arrive'. |
Route |
Skupiny posloupnosti instrukčních prvků, které spolu vzájemně souvisejí. Rozsah sekvence je omezen pomocí firstInstructionIndex a lastInstructionIndex. Pokud jsou pro pokyny požadovány textové zprávy čitelné pro člověka (instructionType=text nebo tagged), pak má skupina instructionGroup vrácenou souhrnnou zprávu, pokud je k dispozici. |
Route |
Pokud je zadaný, vrátí se pokyny. Všimněte si, že parametr instructionsType nelze použít ve spojení s parametrem routeRepresentation=none. |
Route |
Popis části trasy, která se skládá ze seznamu bodů. Každý další bod trasy zadaný v požadavku bude mít za následek další úsek ve vrácené trase. |
Route |
Souhrnný objekt pro oddíl trasy. |
Route |
Optimalizovaný objekt bodu cesty. |
Route |
Hlásí efektivní nastavení použitá v aktuálním volání. |
Route |
Určuje reprezentaci sady tras poskytovaných jako odpověď. Tuto hodnotu parametru lze použít pouze ve spojení s computeBestOrder=true. |
Route |
Oddíly trasy obsahují další informace o částech trasy. Každá část obsahuje alespoň elementy |
Route |
Podrobnosti o události provozu pomocí definic ve standardu TPEG2-TEC Může obsahovat elementy effectCode a způsobuje. |
Route |
Příčina dopravní události. Může obsahovat elementy mainCauseCode a subCauseCode. Lze použít k definování ikonografie a popisů. |
Route |
Souhrnný objekt |
Route |
Typ požadované trasy. |
Section |
Určuje, které typy oddílů jsou hlášeny v odpovědi na trasu. |
Simple |
Typ incidentu. V současné době může být JAM, ROAD_WORK, ROAD_CLOSURE nebo JINÉ. Podrobné informace najdete v části "tec". |
Travel |
Režim cesty pro požadovanou trasu. Pokud není definováno, výchozí hodnota je "car". Upozorňujeme, že požadovaný režim travelMode nemusí být k dispozici pro celou trasu. Pokud požadovaný travelMode není k dispozici pro konkrétní oddíl, bude prvek travelMode odpovědi pro tento oddíl "jiný". Upozorňujeme, že režimy cestování autobus, motocykl, taxi a dodávka jsou beta funkce. Úplná data omezení nejsou k dispozici ve všech oblastech. |
Vehicle |
Typ motoru vozidla. Když je zadán podrobný model spotřeby, musí být konzistentní s hodnotou vehicleEngineType. |
Vehicle |
Typy nákladu, které mohou být klasifikovány jako nebezpečné materiály a omezeny na některých silnicích. Dostupné hodnoty vehicleLoadType jsou americké třídy Hazmat 1 až 9 a navíc obecné klasifikace pro použití v jiných zemích nebo oblastech. Hodnoty začínající na USHazmat jsou určené pro směrování do USA, zatímco ostatníhazmat by se měly používat pro všechny ostatní země nebo oblasti. vehicleLoadType lze zadat vícekrát. Tento parametr se v současné době zvažuje pouze pro travelMode=truck. |
Windingness |
Úroveň zatáček pro vzrušující trasu. Tento parametr lze použít pouze ve spojení s parametrem |
AlternativeRouteType
Řídí optimální s ohledem na daná kritéria plánování počítaných alternativ v porovnání s referenční trasou.
Name | Typ | Description |
---|---|---|
anyRoute |
string |
Umožňuje vrácení jakékoli alternativní trasy bez ohledu na její porovnání s referenční trasou z hlediska optimálního výsledku. |
betterRoute |
string |
Vrátit alternativní trasu pouze v případě, že je lepší než referenční trasa podle zadaných kritérií plánování. |
ComputeTravelTime
Určuje, jestli se mají vrátit další doby cesty s použitím různých typů informací o provozu (žádný, historický, živý) a výchozího nejlepšího odhadu doby cesty.
Name | Typ | Description |
---|---|---|
all |
string |
Vypočítá dobu trvání cesty pro všechny typy informací o provozu a určuje všechny výsledky v polích noTrafficTravelTimeInSeconds, historicTrafficTravelTimeInSeconds a liveTrafficIncidentsTravelTimeInSeconds zahrnutých v souhrnech v odpovědi na trasu. |
none |
string |
Nevypočítá další doby trvání cesty. |
DelayMagnitude
Velikost zpoždění způsobeného incidentem. Tyto hodnoty odpovídají hodnotám pole odpovědi ty rozhraní API Get Traffic Incident Detail.
Name | Typ | Description |
---|---|---|
0 |
string |
Neznámý |
1 |
string |
Menší. |
2 |
string |
Střední. |
3 |
string |
Hlavní. |
4 |
string |
Nedefinované, používané pro uzavírky silnic a jiná neomezená zpoždění. |
DrivingSide
Označuje jízdu vlevo a vpravo v místě manévru.
Name | Typ | Description |
---|---|---|
LEFT |
string |
Levá strana. |
RIGHT |
string |
Pravá strana. |
EffectiveSetting
Efektivní parametr nebo data použitá při volání tohoto rozhraní API směrování
Name | Typ | Description |
---|---|---|
key |
string |
Název použitého parametru |
value |
string |
Hodnota použitého parametru |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
GeoJsonGeometry
Platný GeoJSON
objekt geometrie. Typ musí být jeden ze sedmi platných typů geometrie GeoJSON – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon a GeometryCollection. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
type |
Geo |
Určuje |
GeoJsonGeometryCollection
Platný GeoJSON GeometryCollection
typ objektu. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
geometries | GeoJsonGeometry[]: |
Obsahuje seznam platných |
type |
string:
Geometry |
Určuje |
GeoJsonLineString
Platný GeoJSON LineString
typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Line |
Určuje |
GeoJsonMultiLineString
Platný GeoJSON MultiLineString
typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Multi |
Určuje |
GeoJsonMultiPoint
Platný GeoJSON MultiPoint
typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Multi |
Určuje |
GeoJsonMultiPolygon
Platný GeoJSON MultiPolygon
typ objektu. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
Obsahuje seznam platných |
type |
string:
Multi |
Určuje |
GeoJsonPoint
Platný GeoJSON Point
typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
A |
type |
string:
Point |
Určuje |
GeoJsonPolygon
Platný GeoJSON Polygon
typ geometrie. Podrobnosti najdete v dokumentu RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
Souřadnice typu |
type |
string:
Polygon |
Určuje |
GuidanceInstructionType
Typ instrukce, např. zatáčení nebo změna jízdního tvaru.
Name | Typ | Description |
---|---|---|
DIRECTION_INFO |
string |
Informace o směru. |
LOCATION_ARRIVAL |
string |
Místo příjezdu. |
LOCATION_DEPARTURE |
string |
Místo odjezdu. |
LOCATION_WAYPOINT |
string |
Umístění bodu cesty. |
ROAD_CHANGE |
string |
Změna cesty. |
TURN |
string |
Zase. |
GuidanceManeuver
Kód identifikující manévr.
Name | Typ | Description |
---|---|---|
ARRIVE |
string |
Přišli jste. |
ARRIVE_LEFT |
string |
Přišli jste. Cíl je na levé straně. |
ARRIVE_RIGHT |
string |
Přišli jste. Tvůj cíl je na pravé straně. |
BEAR_LEFT |
string |
Medvěd doleva. |
BEAR_RIGHT |
string |
Mějte pravdu. |
DEPART |
string |
Opustit. |
ENTER_FREEWAY |
string |
Jeďte po dálnici. |
ENTER_HIGHWAY |
string |
Jeďte po dálnici. |
ENTER_MOTORWAY |
string |
Jeďte po dálnici. |
ENTRANCE_RAMP |
string |
Vezmi rampu. |
FOLLOW |
string |
Sledovat. |
KEEP_LEFT |
string |
Drž se doleva. |
KEEP_RIGHT |
string |
Mějte pravdu. |
MAKE_UTURN |
string |
Otočte se do U. |
MOTORWAY_EXIT_LEFT |
string |
Jděte levým východem. |
MOTORWAY_EXIT_RIGHT |
string |
Vyjděte správným východem. |
ROUNDABOUT_BACK |
string |
Běžte kolem kruhového objezdu. |
ROUNDABOUT_CROSS |
string |
Přechánět kruhový objezd. |
ROUNDABOUT_LEFT |
string |
Na kruhovém objezdu vyjděte vlevo. |
ROUNDABOUT_RIGHT |
string |
Na kruhovém objezdu vyjděte vpravo. |
SHARP_LEFT |
string |
Otočte se doleva. |
SHARP_RIGHT |
string |
Otočte se ostře doprava. |
STRAIGHT |
string |
Držte se rovně. |
SWITCH_MAIN_ROAD |
string |
Přepne se na hlavní silnici. |
SWITCH_PARALLEL_ROAD |
string |
Přepněte na paralelní silnici. |
TAKE_EXIT |
string |
Jděte na východ. |
TAKE_FERRY |
string |
Jeďte trajektem. |
TRY_MAKE_UTURN |
string |
Zkuste otočit oušku. |
TURN_LEFT |
string |
Zatočit doleva. |
TURN_RIGHT |
string |
Zatočit doprava. |
WAYPOINT_LEFT |
string |
Dosáhli jste bodu cesty. Je nalevo. |
WAYPOINT_REACHED |
string |
Dosáhli jste bodu cesty. |
WAYPOINT_RIGHT |
string |
Dosáhli jste bodu cesty. Je na pravé straně. |
InclineLevel
Stupeň kopcovitosti pro vzrušující cestu. Tento parametr lze použít pouze ve spojení s parametrem routeType
=thrilling.
Name | Typ | Description |
---|---|---|
high |
string |
high |
low |
string |
Nízké |
normal |
string |
Normální |
JunctionType
Typ křižovatky, kde se provádí manévr. Pro větší kruhové objezdy se vygenerují dva samostatné pokyny pro vstup a opuštění kruhového objezdu.
Name | Typ | Description |
---|---|---|
BIFURCATION |
string |
Bifurkace |
REGULAR |
string |
Pravidelné |
ROUNDABOUT |
string |
Roundabout |
LatLongPair
Umístění reprezentované jako zeměpisná šířka a délka.
Name | Typ | Description |
---|---|---|
latitude |
number |
Vlastnost Zeměpisná šířka |
longitude |
number |
Zeměpisná délka – vlastnost |
Report
Určuje, která data by měla být hlášena 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í v případě, že parametr nebyl zadán volajícím.
Name | Typ | Description |
---|---|---|
effectiveSettings |
string |
Hlásí efektivní parametry nebo data použitá při volání rozhraní API. |
ResponseFormat
Požadovaný formát odpovědi Hodnota může být json nebo xml.
Name | Typ | Description |
---|---|---|
json |
string |
|
xml |
string |
ResponseSectionType
Typy oddílů v odpovědi na ohlášenou trasu
Name | Typ | Description |
---|---|---|
CARPOOL |
string |
Úseky trasy, které vyžadují použití jízdních pruhů pro vozidla s vysokou obsazeností. |
CAR_TRAIN |
string |
Úseky trasy, které jsou osobními nebo vlaky. |
COUNTRY |
string |
Oddíly označující, ve kterých zemích nebo oblastech se trasa nachází. |
FERRY |
string |
Části trasy, které jsou trajekty. |
MOTORWAY |
string |
Úseky trasy, které jsou dálnicemi. |
PEDESTRIAN |
string |
Úseky trasy, které jsou vhodné pouze pro pěší. |
TOLL_ROAD |
string |
Úseky trasy, které vyžadují zaplacení placené linky. |
TOLL_VIGNETTE |
string |
Úseky trasy, které vyžadují placenou dálniční známku. |
TRAFFIC |
string |
Části trasy, které obsahují informace o provozu. |
TRAVEL_MODE |
string |
Oddíly ve vztahu k parametru |
TUNNEL |
string |
Části trasy, které jsou tunely. |
URBAN |
string |
Úseky trasy, které se nacházejí v městských oblastech. |
ResponseTravelMode
Režim cesty pro počítanou trasu. Pokud požadovaný způsob dopravy není v této části možný, hodnota se nastaví na other
hodnotu .
Name | Typ | Description |
---|---|---|
bicycle |
string |
Vrácené trasy jsou optimalizované pro jízdní kola, včetně použití cyklostezek. |
bus |
string |
Vrácené trasy jsou optimalizované pro autobusy, včetně použití jízdních pruhů pouze pro autobusy. Beta funkce. |
car |
string |
Vrácené trasy jsou optimalizované pro auta. |
motorcycle |
string |
Vrácené trasy jsou optimalizované pro motocykly. Funkce BETA. |
other |
string |
Daný způsob dopravy není v této části možný. |
pedestrian |
string |
Vrácené trasy jsou optimalizované pro chodce, včetně použití chodníků. |
taxi |
string |
Vrácené trasy jsou optimalizované pro taxislužby. Beta funkce. |
truck |
string |
Vrácené trasy jsou optimalizované pro užitková vozidla, například pro nákladní vozy. |
van |
string |
Vrácené trasy jsou optimalizované pro dodávky. Funkce BETA. |
Route
Name | Typ | Description |
---|---|---|
guidance |
Obsahuje elementy související s pokyny. Toto pole je k dispozici pouze v případě, že byly požadovány pokyny a je k dispozici. |
|
legs |
Route |
Pole nohou |
sections |
Pole Sections |
|
summary |
Souhrnný objekt |
RouteAvoidType
Určuje něco, čeho by se měl výpočet trasy při určování trasy snažit vyhnout. V jednom požadavku lze zadat vícekrát, například "&avoid=motorways&avoid=tollRoads&avoid=ferries". V požadavcích na rozsah tras nesmí být použita hodnota alreadyUsedRoads.
Name | Typ | Description |
---|---|---|
alreadyUsedRoads |
string |
Vyhne se použití stejné cesty vícekrát. Nejužitečnější ve spojení s |
borderCrossings |
string |
Vyhýbá se překračování hranic ve výpočtu tras. |
carpools |
string |
Vyhýbá se trasám, které vyžadují použití jízdních pruhů HOV /High Occupancy Vehicle( HOV/ High Occupancy Vehicle). |
ferries |
string |
Vyhýbá se trajektům |
motorways |
string |
Vyhýbá se dálnici |
tollRoads |
string |
Vyhýbá se placeným silnicm. |
unpavedRoads |
string |
Vyhýbá se nezpavovaným cestám. |
RouteDirectionParameters
Parametry textu příspěvku pro směr trasy.
Name | Typ | Description |
---|---|---|
allowVignette |
string[] |
Toto je seznam 3znakový, ISO 3166-1, alfa-3 kód zemí/oblastí, ve kterých jsou povoleny placené silnice s dálničními známkami, např. "AUS,CHE". Zadání parametru allowVignette s některými zeměmi/oblastmi X je ekvivalentem zadání argumentu avoidVignette se všemi zeměmi/oblastmi kromě X. Zadání hodnoty allowVignette s prázdným seznamem je stejné jako vyhnout se všem placeným silnicím s dálničními známkami. Poznámka: Je chyba zadat jak avoidVignette , tak allowVignette. |
avoidAreas |
GeoJSON MultiPolygon představující seznam oblastí, kterým se chcete vyhnout. Podporují se pouze mnohoúhelníky obdélníků. Maximální velikost obdélníku je asi 160x160 km. Maximální počet vyloučených oblastí je 10. Nemůže překročit 180. poledník. Musí být mezi -80 a +80 stupni zeměpisné šířky. |
|
avoidVignette |
string[] |
Toto je seznam 3znakový kód ISO 3166-1 a alfa-3 kódů zemí/oblastí, ve kterých se mají vyhnout všechny placené silnice s dálničními známkami, např. "AUS,CHE". Placené silnice s dálničními známkami v zemích nebo oblastech, které nejsou na seznamu, nejsou ovlivněny. Poznámka: Je chyba zadat jak avoidVignette , tak allowVignette. |
supportingPoints |
Kolekce geometrie GeoJSON představující posloupnost souřadnic použitých jako vstup pro rekonstrukci trasy a pro výpočet nuly nebo více alternativních tras k této referenční trase.
|
RouteDirections
Tento objekt je vrácen úspěšným voláním trasy trasy.
Name | Typ | Description |
---|---|---|
formatVersion |
string |
Vlastnost Formát verze |
optimizedWaypoints |
Optimalizovaná posloupnost waypoints. Zobrazuje index z pořadí waypointu poskytnutého uživatelem pro původní a optimalizovaný seznam. Například odpověď:
znamená, že původní sekvence je [0, 1, 2] a optimalizovaná sekvence je [1, 2, 0]. Vzhledem k tomu, že index začíná o 0, původní je "první, druhý, třetí", zatímco optimalizovaný je "second, third, first". |
|
report |
Hlásí efektivní nastavení použitá v aktuálním volání. |
|
routes |
Route[] |
Pole Routes |
RouteGuidance
Obsahuje elementy související s pokyny. Toto pole je k dispozici pouze v případě, že byly požadovány pokyny a je k dispozici.
Name | Typ | Description |
---|---|---|
instructionGroups |
Skupiny posloupnost instrukčních prvků, které spolu vzájemně souvisejí. |
|
instructions |
Seznam instrukcí popisujících manévry. |
RouteInstruction
Sada atributů popisujících manévr, např. "Zatáčkejte doprava", "Keep left", "Take the ferry", "Take the motorway", "Take the motorway", 'Arrive'.
Name | Typ | Description |
---|---|---|
combinedMessage |
string |
Lidsky čitelná zpráva pro manévr v kombinaci se zprávou z další instrukce. Někdy je možné zkombinovat dvě po sobě jdoucí instrukce do jedné instrukce, což usnadňuje sledování. V takovém případě bude příznak possibleCombineWithNext pravdivý. Příklad:
Příznak possibleCombineWithNext v instrukci 10 je true. To indikuje klientům programových pokynů, že je možné je kombinovat s instrukcemi 11. Pokyny se automaticky zkombinují pro klienty, kteří požadují pokyny čitelné pro člověka. Pole combinedMessage obsahuje kombinovanou zprávu:
|
countryCode |
string |
3znakový kód země ISO 3166-1 alfa-3. Např. USA. |
drivingSide |
Označuje jízdu vlevo a vpravo v místě manévru. |
|
exitNumber |
string |
Čísla exitu z dálnice pořízená aktuálním manévrem. Pokud má exit více výstupních čísel, bude oddělen "," a pravděpodobně agregován podle "-", například "10, 13-15". |
instructionType |
Typ instrukce, např. zatáčení nebo změna jízdního tvaru. |
|
junctionType |
Typ křižovatky, kde se provádí manévr. Pro větší kruhové objezdy se vygenerují dva samostatné pokyny pro vstup a opuštění kruhového objezdu. |
|
maneuver |
Kód identifikující manévr. |
|
message |
string |
Lidsky čitelná zpráva pro tento manévr. |
point |
Umístění reprezentované jako zeměpisná šířka a délka. |
|
pointIndex |
integer |
Index bodu v seznamu "bodů" křivky odpovídající bodu instrukce. |
possibleCombineWithNext |
boolean |
Volitelně je možné zkombinovat instrukce s další. Můžete ho použít k vytváření zpráv jako "Turn left and then turn right" (Otočit se doleva a pak doprava). |
roadNumbers |
string[] |
Čísla silnic dalších významných segmentů silnic po manévru nebo silnic, které se mají sledovat. Příklad: ["E34", "N205"] |
roundaboutExitNumber |
string |
To označuje, který východ se má provést na kruhovém objezdu. |
routeOffsetInMeters |
integer |
Vzdálenost od začátku trasy k bodu instrukce. |
signpostText |
string |
Text na rozcestníku, který je nejrelevantní pro manévr nebo směr, který se má sledovat. |
stateCode |
string |
Dílčí dělení (např. stát) země, reprezentované druhou částí kódu ISO 3166-2 . Tato možnost je dostupná jenom pro některé země nebo oblasti, jako jsou USA, Kanada a Mexiko. |
street |
string |
Název ulice dalšího významného úseku silnice po manévru nebo ulice, která by měla následovat. |
travelTimeInSeconds |
integer |
Odhadovaná doba cesty až do bodu odpovídajícího routeOffsetInMeters. |
turnAngleInDecimalDegrees |
integer |
Označuje směr instrukce. Pokud junctionType indikuje instrukci otočení:
Pokud junctionType indikuje instrukce bifurcation:
|
RouteInstructionGroup
Skupiny posloupnosti instrukčních prvků, které spolu vzájemně souvisejí. Rozsah sekvence je omezen pomocí firstInstructionIndex a lastInstructionIndex. Pokud jsou pro pokyny požadovány textové zprávy čitelné pro člověka (instructionType=text nebo tagged), pak má skupina instructionGroup vrácenou souhrnnou zprávu, pokud je k dispozici.
Name | Typ | Description |
---|---|---|
firstInstructionIndex |
integer |
Index první instrukce v pokynech a patřící do této skupiny. |
groupLengthInMeters |
integer |
Délka skupiny. |
groupMessage |
string |
Souhrnná zpráva, když jsou požadovány textové zprávy čitelné pro člověka jako doprovodné materiály (instructionType=text nebo tagged). |
lastInstructionIndex |
integer |
Index poslední instrukce v pokynech a patřící do této skupiny. |
RouteInstructionsType
Pokud je zadaný, vrátí se pokyny. Všimněte si, že parametr instructionsType nelze použít ve spojení s parametrem routeRepresentation=none.
Name | Typ | Description |
---|---|---|
coded |
string |
Vrátí nezpracovaná instrukční data bez čitelných zpráv. |
tagged |
string |
Vrátí nezpracovaná instrukční data se označenými zprávami čitelnými pro člověka, které umožňují formátování. Zpráva čitelná pro člověka je vytvořena z opakovatelných identifikovaných prvků. Ty jsou označené tak, aby je mohly klientské aplikace správně formátovat. Následující komponenty zprávy jsou označené, když instructionsType=tagged: street, roadNumber, signpostText, exitNumber, roundaboutExitNumber. Příklad označené zprávy "Turn left" (Odbočit doleva):
|
text |
string |
Vrátí nezpracovaná data instrukcí s zprávami čitelnými pro člověka ve formátu prostého textu. |
RouteLeg
Popis části trasy, která se skládá ze seznamu bodů. Každý další bod trasy zadaný v požadavku bude mít za následek další úsek ve vrácené trase.
Name | Typ | Description |
---|---|---|
points |
Pole bodů |
|
summary |
Souhrnný objekt pro oddíl trasy. |
RouteLegSummary
Souhrnný objekt pro oddíl trasy.
Name | Typ | Description |
---|---|---|
arrivalTime |
string |
Odhadovaný čas příjezdu na trasu nebo úsek. Čas je ve standardu UTC. |
batteryConsumptionInkWh |
number |
Odhadovaná spotřeba elektrické energie v kilowatthodinách (kWh) s využitím modelu elektrické spotřeby Zahrnuje, pokud je vlastnost vehicleEngineType nastavená na elektrický a je zadána konstantaSpeedConsumptionInkWhPerHundredkm. Hodnota batteryConsumptionInkWh zahrnuje recuperated elektrickou energii, a proto může být negativní (což značí získávání energie). Pokud jsou zadány hodnoty maxChargeInkWh i currentChargeInkWh, bude rekuperace omezena, aby se zajistilo, že úroveň nabití baterie nikdy nepřekročí maxChargeInkWh. Pokud není zadána hodnota maxChargeInkWh ani currentChargeInkWh, předpokládá se ve výpočtu spotřeby neomezená rekuperace. |
departureTime |
string |
Odhadovaný čas odjezdu trasy nebo úseku. Čas je ve standardu UTC. |
fuelConsumptionInLiters |
number |
Odhadovaná spotřeba paliva v litrech pomocí modelu spotřeby spalování. Zahrnuje, pokud je vlastnost vehicleEngineType nastavená na spalování a je zadána konstantaSpeedConsumptionInLitersPerHundredkm. Hodnota nebude záporná. |
historicTrafficTravelTimeInSeconds |
integer |
Odhadovaná doba trvání cesty vypočítaná na základě historických dopravních dat závislých na čase Zahrne se jenom v případě, že se v dotazu použije computeTravelTimeFor = all. |
lengthInMeters |
integer |
Vlastnost Length In Meters |
liveTrafficIncidentsTravelTimeInSeconds |
integer |
Odhadovaná doba trvání cesty vypočítaná pomocí dat o rychlosti v reálném čase Zahrne se jenom v případě, že se v dotazu použije computeTravelTimeFor = all. |
noTrafficTravelTimeInSeconds |
integer |
Odhadovaná doba trvání cesty vypočítaná, jako by na trase nedošlo k žádnému zpoždění kvůli dopravním podmínkám (např. zahlcení). Zahrne se jenom v případě, že se v dotazu použije computeTravelTimeFor = all. |
trafficDelayInSeconds |
integer |
Odhadované zpoždění v sekundách způsobené incidenty v reálném čase podle informací o provozu U tras plánovaných s časem odjezdu v budoucnu je zpoždění vždy 0. Pokud chcete vrátit další doby cesty pomocí různých typů informací o provozu, je potřeba přidat parametr computeTravelTimeFor=all. |
travelTimeInSeconds |
integer |
Odhadovaná doba trvání cesty v sekundách, která zahrnuje zpoždění způsobené provozem v reálném čase. Mějte na paměti, že i když traffic=false travelTimeInSeconds stále zahrnuje zpoždění způsobené provozem. Pokud je DepartAt v budoucnosti, doba trvání cesty se počítá na základě historických dopravních dat závislých na čase. |
RouteOptimizedWaypoint
Optimalizovaný objekt bodu cesty.
Name | Typ | Description |
---|---|---|
optimizedIndex |
integer |
Optimalizovaný index bodu cesty ze systému. |
providedIndex |
integer |
Index bodu cesty poskytnutý uživatelem. |
RouteReport
Hlásí efektivní nastavení použitá v aktuálním volání.
Name | Typ | Description |
---|---|---|
effectiveSettings |
Efektivní parametry nebo data používaná při volání tohoto rozhraní API trasy |
RouteRepresentationForBestOrder
Určuje reprezentaci sady tras poskytovaných jako odpověď. Tuto hodnotu parametru lze použít pouze ve spojení s computeBestOrder=true.
Name | Typ | Description |
---|---|---|
none |
string |
Zahrnuje pouze optimalizované indexy trasových bodů, ale nezahrnuje geometrii trasy v odpovědi. |
polyline |
string |
Zahrne do odpovědi geometrii trasy. |
summaryOnly |
string |
Souhrn podle křivky, ale s výjimkou prvků geometrie bodu pro trasy v odpovědi. |
RouteSection
Oddíly trasy obsahují další informace o částech trasy. Každá část obsahuje alespoň elementy startPointIndex
, endPointIndex
a sectionType
.
Name | Typ | Description |
---|---|---|
delayInSeconds |
integer |
Zpoždění v sekundách způsobené incidentem. |
effectiveSpeedInKmh |
integer |
Efektivní rychlost incidentu v km/h, zprůměrovaná v celé délce. |
endPointIndex |
integer |
Index posledního bodu (posun 0) na trase, na které se tento oddíl vztahuje. |
magnitudeOfDelay |
Velikost zpoždění způsobeného incidentem. Tyto hodnoty odpovídají hodnotám pole odpovědi ty rozhraní API Get Traffic Incident Detail. |
|
sectionType |
Typy oddílů v odpovědi na ohlášenou trasu |
|
simpleCategory |
Typ incidentu Aktuálně může být JAM, ROAD_WORK, ROAD_CLOSURE nebo JINÉ. Podrobné informace najdete v části "tec". |
|
startPointIndex |
integer |
Index prvního bodu (posun 0) na trase, na které se tento oddíl vztahuje. |
tec |
Podrobnosti o události provozu pomocí definic ve standardu TPEG2-TEC . Může obsahovat elementy effectCode a causes. |
|
travelMode |
Režim cesty pro počítanou trasu. Pokud požadovaný způsob dopravy není v této části možný, hodnota se nastaví na |
RouteSectionTec
Podrobnosti o události provozu pomocí definic ve standardu TPEG2-TEC Může obsahovat elementy effectCode a způsobuje.
Name | Typ | Description |
---|---|---|
causes |
Způsobuje pole |
|
effectCode |
integer |
Vliv na tok provozu. Obsahuje hodnotu v tabulce tec001:EffectCode, jak je definována ve standardu TPEG2-TEC . Lze použít k barevnému kódování událostí provozu podle závažnosti. |
RouteSectionTecCause
Příčina dopravní události. Může obsahovat elementy mainCauseCode a subCauseCode. Lze použít k definování ikonografie a popisů.
Name | Typ | Description |
---|---|---|
mainCauseCode |
integer |
Hlavní příčina dopravní události. Obsahuje hodnotu v tabulce tec002:CauseCode definovanou ve standardu TPEG2-TEC . |
subCauseCode |
integer |
Subcause události provozu. Obsahuje hodnotu v tabulce dílčí příčiny definovanou parametrem mainCauseCode, jak je definováno ve standardu TPEG2-TEC . |
RouteSummary
Souhrnný objekt
Name | Typ | Description |
---|---|---|
arrivalTime |
string |
Odhadovaný čas příjezdu na trasu nebo úsek. Čas je ve standardu UTC. |
departureTime |
string |
Odhadovaný čas odjezdu trasy nebo úseku. Čas je ve standardu UTC. |
lengthInMeters |
integer |
Vlastnost Length In Meters |
trafficDelayInSeconds |
integer |
Odhadované zpoždění v sekundách způsobené incidenty v reálném čase podle informací o provozu U tras plánovaných s časem odjezdu v budoucnu je zpoždění vždy 0. Pokud chcete vrátit další doby cesty pomocí různých typů informací o provozu, je potřeba přidat parametr computeTravelTimeFor=all. |
travelTimeInSeconds |
integer |
Odhadovaná doba trvání cesty v sekundách, která zahrnuje zpoždění způsobené provozem v reálném čase. Mějte na paměti, že i když traffic=false travelTimeInSeconds stále zahrnuje zpoždění způsobené provozem. Pokud je DepartAt v budoucnosti, doba trvání cesty se počítá na základě historických dopravních dat závislých na čase. |
RouteType
Typ požadované trasy.
Name | Typ | Description |
---|---|---|
eco |
string |
Cesta vyvážená ekonomikou a rychlostí. |
fastest |
string |
Nejrychlejší trasa. |
shortest |
string |
Nejkratší trasa podle vzdálenosti. |
thrilling |
string |
Zahrnuje zajímavé nebo náročné silnice a využívá co nejméně dálnic. Můžete zvolit úroveň zatáčky a také stupeň kopcovitosti. Informace o tom, jak to nastavit, najdete v parametrech hillness a windingness. Na trasách je naplánovaný limit 900 km s |
SectionType
Určuje, které typy oddílů jsou hlášeny v odpovědi na trasu.
Pokud například sectionType = chodec, vrátí se oddíly, které jsou vhodné pouze pro chodce. Je možné použít více typů. Výchozí sectionType odkazuje na vstup travelMode. Ve výchozím nastavení je travelMode nastavený na car.
Name | Typ | Description |
---|---|---|
carTrain |
string |
Úseky trasy, které jsou osobními nebo vlaky. |
carpool |
string |
Úseky trasy, které vyžadují použití jízdních pruhů pro vozidla s vysokou obsazeností. |
country |
string |
Oddíly označující, ve kterých zemích nebo oblastech se trasa nachází. |
ferry |
string |
Části trasy, které jsou trajekty. |
motorway |
string |
Úseky trasy, které jsou dálnicemi. |
pedestrian |
string |
Úseky trasy, které jsou vhodné pouze pro pěší. |
tollRoad |
string |
Úseky trasy, které vyžadují zaplacení placené linky. |
tollVignette |
string |
Úseky trasy, které vyžadují placenou dálniční známku. |
traffic |
string |
Části trasy, které obsahují informace o provozu. |
travelMode |
string |
Oddíly ve vztahu k parametru |
tunnel |
string |
Části trasy, které jsou tunely. |
urban |
string |
Úseky trasy, které se nacházejí v městských oblastech. |
SimpleCategory
Typ incidentu. V současné době může být JAM, ROAD_WORK, ROAD_CLOSURE nebo JINÉ. Podrobné informace najdete v části "tec".
Name | Typ | Description |
---|---|---|
JAM |
string |
Dopravní zácpy. |
OTHER |
string |
Jiné |
ROAD_CLOSURE |
string |
Uzavírka silnice. |
ROAD_WORK |
string |
Práce na silnici. |
TravelMode
Režim cesty pro požadovanou trasu. Pokud není definováno, výchozí hodnota je "car". Upozorňujeme, že požadovaný režim travelMode nemusí být k dispozici pro celou trasu. Pokud požadovaný travelMode není k dispozici pro konkrétní oddíl, bude prvek travelMode odpovědi pro tento oddíl "jiný". Upozorňujeme, že režimy cestování autobus, motocykl, taxi a dodávka jsou beta funkce. Úplná data omezení nejsou k dispozici ve všech oblastech.
Name | Typ | Description |
---|---|---|
bicycle |
string |
Vrácené trasy jsou optimalizované pro jízdní kola, včetně použití cyklostezek. |
bus |
string |
Vrácené trasy jsou optimalizované pro autobusy, včetně použití jízdních pruhů pouze pro autobusy. Beta funkce. |
car |
string |
Vrácené trasy jsou optimalizované pro auta. |
motorcycle |
string |
Vrácené trasy jsou optimalizované pro motocykly. Beta funkce. |
pedestrian |
string |
Vrácené trasy jsou optimalizované pro chodce, včetně použití chodníků. |
taxi |
string |
Vrácené trasy jsou optimalizované pro taxislužby. Beta funkce. |
truck |
string |
Vrácené trasy jsou optimalizované pro užitková vozidla, například pro nákladní vozy. |
van |
string |
Vrácené trasy jsou optimalizované pro dodávky. Beta funkce. |
VehicleEngineType
Typ motoru vozidla. Když je zadán podrobný model spotřeby, musí být konzistentní s hodnotou vehicleEngineType.
Name | Typ | Description |
---|---|---|
combustion |
string |
Spalovací motor. |
electric |
string |
Elektrický motor. |
VehicleLoadType
Typy nákladu, které mohou být klasifikovány jako nebezpečné materiály a omezeny na některých silnicích. Dostupné hodnoty vehicleLoadType jsou americké třídy Hazmat 1 až 9 a navíc obecné klasifikace pro použití v jiných zemích nebo oblastech. Hodnoty začínající na USHazmat jsou určené pro směrování do USA, zatímco ostatníhazmat by se měly používat pro všechny ostatní země nebo oblasti. vehicleLoadType lze zadat vícekrát. Tento parametr se v současné době zvažuje pouze pro travelMode=truck.
Name | Typ | Description |
---|---|---|
USHazmatClass1 |
string |
Výbušniny |
USHazmatClass2 |
string |
Stlačený plyn |
USHazmatClass3 |
string |
Hořlavé kapaliny |
USHazmatClass4 |
string |
Hořlavé pevné látky |
USHazmatClass5 |
string |
Oxidační prostředky |
USHazmatClass6 |
string |
Jedy |
USHazmatClass7 |
string |
Radioaktivní látky |
USHazmatClass8 |
string |
Žíravé |
USHazmatClass9 |
string |
Různé |
otherHazmatExplosive |
string |
Výbušniny |
otherHazmatGeneral |
string |
Různé |
otherHazmatHarmfulToWater |
string |
Škodlivé pro vodu |
WindingnessLevel
Úroveň zatáček pro vzrušující trasu. Tento parametr lze použít pouze ve spojení s parametrem routeType
=thrilling.
Name | Typ | Description |
---|---|---|
high |
string |
high |
low |
string |
Nízké |
normal |
string |
Normální |