Route - Get Route Range

Reference

Služba:: Maps

Verze rozhraní API:: 1.0

Slouží k vytvoření mapy, která znázorňuje oblast přístupnou z daného bodu v rámci určité prahové hodnoty na základě času, vzdálenosti nebo kapacity paliva.

Poznámka:

vyřazení služby Azure Maps Route v1

Služba Azure Maps Route v1 je nyní zastaralá a bude vyřazena 31. 31. 28. Aby nedošlo k přerušení služeb, bude potřeba aktualizovat všechna volání služby Route v1, aby používala službu Route v2025-01-01 do 31. 31. 28. Další informace najdete v tématu Migrace rozhraní API služby Azure Maps Route 1.0.

Rozhraní API Get Route Range (Isochrone) je požadavek HTTP GET, který vypočítá sadu umístění, která lze dosáhnout od počátečního bodu na základě zadaného rozpočtu na palivo, energii, čas nebo vzdálenost. Mnohoúhelník (neboli Isochrone) je vrácen v orientaci proti směru hodinových ručiček a přesný polygon střed, který byl výsledkem počátečního bodu.

Vrácený mnohoúhelník lze použít k dalšímu zpracování, jako je například Hledat uvnitř geometrie k vyhledání poi v zadané izochronu.

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}

S volitelnými parametry:

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}&fuelBudgetInLiters={fuelBudgetInLiters}&energyBudgetInkWh={energyBudgetInkWh}&timeBudgetInSec={timeBudgetInSec}&distanceBudgetInMeters={distanceBudgetInMeters}&departAt={departAt}&routeType={routeType}&traffic={traffic}&avoid={avoid}&travelMode={travelMode}&hilliness={hilliness}&windingness={windingness}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}&currentFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}&currentChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
format	path	True	ResponseFormat	Požadovaný formát odpovědi Hodnota může být json nebo xml.
api-version	query	True	string	Číslo verze rozhraní API služby Azure Maps
query	query	True	number[]	Souřadnice, ze které má být výpočet rozsahu zahájen.
accelerationEfficiency	query		number (double) minimum: 0 maximum: 1	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
auxiliaryPowerInkW	query		number (double)	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	query		number (double)	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	query		RouteAvoidType[]	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.
constantSpeedConsumptionInkWhPerHundredkm	query		string	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	query		string	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	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
currentFuelInLiters	query		number (double)	Určuje aktuální dodávku paliva v literech. Rozumné hodnoty : 55
decelerationEfficiency	query		number (double) minimum: 0 maximum: 1	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	query		string (date-time)	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`.
distanceBudgetInMeters	query		number (double)	Rozpočet vzdálenosti v metrech, který určuje maximální rozsah, který lze cestovat pomocí jízdy vzdálenosti. Model Consumption bude mít vliv pouze na rozsah, pokud je routeType eco. Je nutné použít přesně jeden rozpočet (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec nebo vzdálenostBudgetInMeters).
downhillEfficiency	query		number (double) minimum: 0 maximum: 1	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
energyBudgetInkWh	query		number (double)	Rozpočet elektrické energie v kilowatthodinách (kWh), který určuje maximální rozsah, který lze cestovat pomocí zadaného modelu elektrické spotřeby. Při použití energieBudgetInkWh je povinné zadat podrobný model elektrické spotřeby. Je nutné použít přesně jeden rozpočet (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec nebo vzdálenostBudgetInMeters).
fuelBudgetInLiters	query		number (double)	Rozpočet paliva v literech, který určuje maximální rozsah, který lze cestovat pomocí zadaného modelu spotřeby spalování. Při použití palivaBudgetInLiters je povinné zadat podrobný model spotřeby spalování. Je nutné použít přesně jeden rozpočet (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec nebo vzdálenostBudgetInMeters).
fuelEnergyDensityInMJoulesPerLiter	query		number (double)	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	query		InclineLevel	Stupeň kopcovitosti pro vzrušující trasu. Tento parametr lze použít pouze ve spojení s `routeType`=vzrušující.
maxChargeInkWh	query		number (double)	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
routeType	query		RouteType	Typ požadované trasy.
timeBudgetInSec	query		number (double)	Časový rozpočet v sekundách, který určuje maximální rozsah, který lze cestovat pomocí doby jízdy. Model Consumption bude mít vliv pouze na rozsah, pokud je routeType eco. Je nutné použít přesně jeden rozpočet (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec nebo vzdálenostBudgetInMeters).
traffic	query		boolean	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	query		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	query		number (double) minimum: 0 maximum: 1	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	query		integer	Hmotnost na nápravu vozidla v kg. Hodnota 0 znamená, že se nebere v úvahu omezení hmotnosti na nápravu.
vehicleCommercial	query		boolean	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	query		VehicleEngineType	Typ motoru vozidla. Při zadání podrobného modelu spotřeby musí být konzistentní s hodnotou vehicleEngineType.
vehicleHeight	query		number (double)	Výška vozidla v metrech. Hodnota 0 znamená, že se omezení výšky nepovažují.
vehicleLength	query		number (double)	Délka vozidla v metrech. Hodnota 0 znamená, že omezení délky se nepovažují.
vehicleLoadType	query		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	query		integer	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	query		integer	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	query		number (double)	Šířka vozidla v metrech. Hodnota 0 znamená, že se omezení šířky nepovažují.
windingness	query		WindingnessLevel	Úroveň otáček pro vzrušující trasu. Tento parametr lze použít pouze ve spojení s `routeType`=vzrušující.

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 pro účet Azure Maps a dá se načíst z rozhraní API účtu roviny správy Azure Maps. Informace o používání zabezpečení Microsoft Entra ID v Azure Maps najdete v následujících článcích s pokyny.

Odpovědi

Name	Typ	Description
200 OK	RouteRangeResult	OK
Other Status Codes	ErrorResponse	Došlo k neočekávané chybě.

Zabezpečení

AADToken

Jedná se o Microsoft Entra OAuth 2.0 Flow. Při spárování s přístupu na základě role Azure se dá řídit přístup k rozhraním REST API služby Azure Maps. Řízení přístupu na základě role Azure slouží k určení přístupu k jednomu nebo více účtům prostředků Nebo dílčím prostředkům Azure Maps. 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 rozhraním REST API služby Azure Maps.

Pokud chcete implementovat scénáře, doporučujeme zobrazit koncepty ověřování . Stručně ř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 rozsahy.

Poznámky

Tato definice zabezpečení vyžaduje použití hlavičky x-ms-client-id k označení, ke kterému prostředku Azure Maps aplikace žádá o přístup. To lze získat z rozhraní API pro správu Maps.

Authorization URL je specifická pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné adresy URL autorizace a konfigurace MICROSOFT Entra ID. * Řízení přístupu na základě role Azure se konfiguruje z roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad AZURE SDK nebo rozhraní REST API. * Použití webové sady SDK služby Azure Maps umožňuje nastavení aplikace na základě konfigurace pro více případů použití.

Další informace o platformě Microsoft Identity Platform najdete v tématu Přehled platformy Microsoft Identity Platform.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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 vytvoření účtu Azure Maps na webu Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.

Díky tomuto klíči má každá aplikace přístup ke všem rozhraní REST API. Jinými slovy, tento klíč lze použít jako hlavní klíč v účtu, ve který jsou vydány.

U veřejně vystavených aplikací doporučujeme používat důvěrných klientských aplikací přístup k rozhraním REST API služby Azure Maps, aby bylo možné klíč bezpečně uložit.

Typ: apiKey
V: query

SAS Token

Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace Vypsat SAS v prostředku Azure Maps prostřednictvím roviny správy Azure prostřednictvím webu Azure Portal, PowerShellu, rozhraní příkazového řádku, sad SDK Azure nebo rozhraní REST API.

S tímto tokenem má každá aplikace oprávnění k přístupu pomocí řízení přístupu na základě role Azure a jemně odstupňované řízení vypršení platnosti, rychlosti a oblastí použití pro konkrétní token. Jinými slovy, token SAS lze použít k tomu, aby aplikace mohly řídit přístup bezpečnějším způsobem než sdílený klíč.

U veřejně vystavených aplikací doporučujeme nakonfigurovat konkrétní seznam povolených zdrojů na prostředku účtu Map omezit zneužití vykreslování a pravidelně obnovovat token SAS.

Typ: apiKey
V: header

Příklady

Successfully retrieve a set of locations that can be reached from the origin point based on various conditions

Ukázkový požadavek

HTTP

GET https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&timeBudgetInSec=6000

Ukázková odpověď

Stavový kód:: 200

{
  "formatVersion": "0.0.1",
  "reachableRange": {
    "center": {
      "latitude": 50.9745,
      "longitude": 5.86605
    },
    "boundary": [
      {
        "latitude": 52.03704,
        "longitude": 5.73602
      },
      {
        "latitude": 52.09456,
        "longitude": 5.59435
      },
      {
        "latitude": 52.16815,
        "longitude": 5.42279
      },
      {
        "latitude": 52.25047,
        "longitude": 5.21276
      },
      {
        "latitude": 52.21374,
        "longitude": 5.15355
      },
      {
        "latitude": 52.25674,
        "longitude": 4.96687
      },
      {
        "latitude": 52.07834,
        "longitude": 4.739
      },
      {
        "latitude": 52.05647,
        "longitude": 4.72513
      },
      {
        "latitude": 51.94553,
        "longitude": 4.53237
      },
      {
        "latitude": 51.70119,
        "longitude": 4.31165
      },
      {
        "latitude": 51.5837,
        "longitude": 4.28917
      },
      {
        "latitude": 51.48463,
        "longitude": 3.82685
      },
      {
        "latitude": 51.21096,
        "longitude": 3.62838
      },
      {
        "latitude": 50.6814,
        "longitude": 3.89244
      },
      {
        "latitude": 50.66791,
        "longitude": 3.93493
      },
      {
        "latitude": 50.49042,
        "longitude": 3.98156
      },
      {
        "latitude": 50.30944,
        "longitude": 4.47995
      },
      {
        "latitude": 50.24448,
        "longitude": 4.60502
      },
      {
        "latitude": 50.24467,
        "longitude": 4.89999
      },
      {
        "latitude": 50.08735,
        "longitude": 5.04206
      },
      {
        "latitude": 49.99214,
        "longitude": 5.23042
      },
      {
        "latitude": 49.88478,
        "longitude": 5.40994
      },
      {
        "latitude": 49.85797,
        "longitude": 5.46178
      },
      {
        "latitude": 49.86279,
        "longitude": 5.7196
      },
      {
        "latitude": 49.83259,
        "longitude": 5.74151
      },
      {
        "latitude": 50.22239,
        "longitude": 5.9387
      },
      {
        "latitude": 50.0011,
        "longitude": 6.08535
      },
      {
        "latitude": 50.04616,
        "longitude": 6.12089
      },
      {
        "latitude": 50.09472,
        "longitude": 6.28373
      },
      {
        "latitude": 49.95863,
        "longitude": 6.51654
      },
      {
        "latitude": 50.00485,
        "longitude": 6.61034
      },
      {
        "latitude": 50.00587,
        "longitude": 6.70295
      },
      {
        "latitude": 50.2947,
        "longitude": 6.65865
      },
      {
        "latitude": 50.36903,
        "longitude": 6.79276
      },
      {
        "latitude": 50.31614,
        "longitude": 7.32163
      },
      {
        "latitude": 50.36737,
        "longitude": 7.58782
      },
      {
        "latitude": 50.46919,
        "longitude": 7.7626
      },
      {
        "latitude": 50.96246,
        "longitude": 7.9826
      },
      {
        "latitude": 51.07086,
        "longitude": 7.55924
      },
      {
        "latitude": 51.36614,
        "longitude": 7.58138
      },
      {
        "latitude": 51.52015,
        "longitude": 7.67861
      },
      {
        "latitude": 51.65781,
        "longitude": 7.35175
      },
      {
        "latitude": 51.81916,
        "longitude": 7.21664
      },
      {
        "latitude": 51.9587,
        "longitude": 7.0467
      },
      {
        "latitude": 51.82713,
        "longitude": 6.67267
      },
      {
        "latitude": 51.81133,
        "longitude": 6.48424
      },
      {
        "latitude": 51.9368,
        "longitude": 6.27316
      },
      {
        "latitude": 52.01701,
        "longitude": 6.14452
      },
      {
        "latitude": 52.20847,
        "longitude": 6.09312
      },
      {
        "latitude": 52.23705,
        "longitude": 6.01297
      }
    ]
  }
}

Definice

Name	Description
EffectiveSetting	Efektivní parametr nebo data používaná při volání tohoto rozhraní API trasy
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
InclineLevel	Stupeň kopcovitosti pro vzrušující trasu. Tento parametr lze použít pouze ve spojení s `routeType`=vzrušující.
LatLongPair	Umístění reprezentované jako zeměpisná šířka a zeměpisná délka
ResponseFormat	Požadovaný formát odpovědi Hodnota může být json nebo xml.
RouteAvoidType	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.
RouteRange	Dosažitelný rozsah
RouteRangeResult	Tento objekt se vrátí z úspěšného volání rozsahu dosažitelné trasy.
RouteReport	Zaznamenává efektivní nastavení použitá v aktuálním volání.
RouteType	Typ požadované trasy.
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.
VehicleEngineType	Typ motoru vozidla. Při zadání podrobného modelu spotřeby musí být konzistentní s hodnotou vehicleEngineType.
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.
WindingnessLevel	Úroveň otáček pro vzrušující trasu. Tento parametr lze použít pouze ve spojení s `routeType`=vzrušující.

EffectiveSetting

Objekt

Efektivní parametr nebo data používaná při volání tohoto rozhraní API trasy

Name	Typ	Description
key	string	Název použitého parametru
value	string	Hodnota použitého parametru

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

InclineLevel

Výčet

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

Hodnota	Description
high	vysoko
low	nízký
normal	normální

LatLongPair

Objekt

Umístění reprezentované jako zeměpisná šířka a zeměpisná délka

Name	Typ	Description
latitude	number (double)	Vlastnost Zeměpisná šířka
longitude	number (double)	Zeměpisná délka – vlastnost

ResponseFormat

Výčet

Požadovaný formát odpovědi Hodnota může být json nebo xml.

Hodnota	Description
json	formát výměny dat javascriptového objektu
xml	rozšiřitelného jazyka značek

RouteAvoidType

Výčet

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.

Hodnota	Description
alreadyUsedRoads	Nepoužívejte stejnou silnici vícekrát. Nejužitečnější ve spojení s `routeType`=vzrušující.
borderCrossings	Vyhne se překračování hranic při výpočtu trasy.
carpools	Vyhněte se trasám, které vyžadují použití jízdních pruhů HOV/High Occupancy Vehicle.
ferries	Vyhněte se trajektům
motorways	Vyhněte se dálnicm
tollRoads	Vyhněte se silničním poplatkům.
unpavedRoads	Vyhněte se neprůpavným cestám.

RouteRange

Objekt

Dosažitelný rozsah

Name	Typ	Description
boundary	LatLongPair[]	Mnohoúhelník dosažitelného rozsahu reprezentovaný jako seznam bodů.
center	LatLongPair	Středový bod dosažitelného rozsahu

RouteRangeResult

Objekt

Tento objekt se vrátí z úspěšného volání rozsahu dosažitelné trasy.

Name	Typ	Description
formatVersion	string	Vlastnost Format Version
reachableRange	RouteRange	Dosažitelný rozsah
report	RouteReport	Zaznamenává efektivní nastavení použitá v aktuálním volání.

RouteReport

Objekt

Zaznamenává efektivní nastavení použitá v aktuálním volání.

Name	Typ	Description
effectiveSettings	EffectiveSetting[]	Efektivní parametry nebo data používaná při volání tohoto rozhraní API trasy

RouteType

Výčet

Typ požadované trasy.

Hodnota	Description
eco	Trasa vyvážená ekonomikou a rychlostí.
fastest	Nejrychlejší trasa.
shortest	Nejkratší trasa podle vzdálenosti.
thrilling	Zahrnuje zajímavé nebo náročné silnice a využívá co nejvíce dálnic. Můžete zvolit úroveň otáček včetně a také stupeň kopcovitosti. Podívejte se na parametry kopcovitosti a vinutí, jak to nastavit. Na trasách plánovaných s `routeType`=vzrušující je limit 900 km.

TravelMode

Výčet

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.

Hodnota	Description
bus	Vrácené trasy jsou optimalizované pro autobusy, včetně použití pouze jízdních pruhů. Funkce BETA.
car	Vrácené trasy jsou optimalizované pro auta.
motorcycle	Vrácené trasy jsou optimalizované pro motocykly. Funkce BETA.
taxi	Vrácené trasy jsou optimalizované pro taxislužby. Funkce BETA.
truck	Vrácené trasy jsou optimalizované pro komerční vozidla, jako jsou nákladní vozy.
van	Vrácené trasy jsou optimalizované pro dodávky. Funkce BETA.

VehicleEngineType

Výčet

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

Hodnota	Description
combustion	Spalovací motor.
electric	Elektrický motor.

VehicleLoadType

Výčet

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.

Hodnota	Description
USHazmatClass1	Výbušniny
USHazmatClass2	Stlačený plyn
USHazmatClass3	Hořlavé kapaliny
USHazmatClass4	Hořlavé pevné látky
USHazmatClass5	Oxidační činidla
USHazmatClass6	Jedy
USHazmatClass7	Radioaktivní
USHazmatClass8	Corrosives
USHazmatClass9	Různé
otherHazmatExplosive	Výbušniny
otherHazmatGeneral	Různé
otherHazmatHarmfulToWater	Škodlivé pro vodu

WindingnessLevel

Výčet

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

Hodnota	Description
high	vysoko
low	nízký
normal	normální

Sdílet prostřednictvím

Route - Get Route Range

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

AADToken

Poznámky

Rozsahy

subscription-key

SAS Token

Příklady

Successfully retrieve a set of locations that can be reached from the origin point based on various conditions

Ukázkový požadavek

Ukázková odpověď

Definice

EffectiveSetting

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InclineLevel

LatLongPair

ResponseFormat

RouteAvoidType

RouteRange

RouteRangeResult

RouteReport

RouteType

TravelMode

VehicleEngineType

VehicleLoadType

WindingnessLevel

Další materiály