Megosztás a következőn keresztül:

Route - Get Route Range

  • Referencia
Szolgáltatás:
Maps
API-verzió:
1.0

A használatával olyan térképet hozhat létre, amely egy adott küszöbértéken belül egy adott pontról elérhető területet ábrázol idő, távolság vagy üzemanyag-kapacitás alapján.

Az Get Route Range (Isochrone) API egy HTTP-kérés GET , amely kiszámítja a forrásponttól elérhető helyek készletét a megadott üzemanyag-, energia-, idő- vagy távolságköltségvetés alapján. A sokszöghatárt (vagy isochrone) az óramutató járásával ellentétes irányban adja vissza, valamint a pontos sokszög középpontot, amely a forráspont eredménye volt.

A visszaadott sokszög további feldolgozásra használható, például a Search Inside Geometry (Belső geometria keresése ) a poI-k kereséséhez a megadott isochrone-on belül.

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}
Opcionális paraméterekkel: 
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}

URI-paraméterek

Name In Kötelező Típus Description
format
 path True

ResponseFormat

A válasz kívánt formátuma. Az érték lehet json vagy xml.
api-version
 query True

string

Az Azure Maps API verziószáma.
query
 query True

number[]

Az a koordináta, amelyből a tartományszámításnak el kell indulnia.
accelerationEfficiency
 query

number

double

Az üzemanyagban tárolt kémiai energia mozgási energiává alakításának hatékonyságát határozza meg, amikor a jármű felgyorsul (pl. KineticEnergyGained/ChemicalEnergyConsumed). A ChemicalEnergyConsumed a felhasznált tüzelőanyagok kémiai energiává alakításával nyerhető ki AzEnergyDensityInMJoulesPerLiter használatával.

A decelerationEfficiency paraméterrel kell párosítani.

Az engedélyezett értékek tartománya 0,0 és 1/decelerationEfficiency.

Sensible Values : for Combustion Model : 0.33, for Electric Model : 0,66
auxiliaryPowerInkW
 query

number

double

A kiegészítő rendszerek fenntartásához felhasznált energia mennyiségét adja meg kilowattban (kW).

Az eszközök és rendszerek , például AC-rendszerek, rádió, fűtés stb. miatt történő fogyasztás meghatározására használható.

Ésszerű értékek: 1,7
auxiliaryPowerInLitersPerHour
 query

number

double

Meghatározza a jármű kiegészítő rendszereinek fenntartásához felhasznált üzemanyag mennyiségét óránkénti literben.

Az eszközök és rendszerek , például AC-rendszerek, rádió, fűtés stb. miatt történő fogyasztás meghatározására használható.

Ésszerű értékek: 0,2
avoid
 query

RouteAvoidType[]

Megad valamit, amelyet az útvonal számításának kerülnie kell az útvonal meghatározásakor. Egy kérelemben többször is megadható, például: "&avoid=autópályák&avoid=tollRoads&avoid=ferries". Az útvonaltartomány-kérelmekben a márUsedRoads értéket nem szabad használni.
constantSpeedConsumptionInkWhPerHundredkm
 query

string

A fogyasztás sebességfüggő összetevőjét adja meg.

A sebesség-/fogyasztás-arány párok rendezetlen listájaként van megadva. A lista egy használati görbe pontjait határozza meg. A listában nem szereplő sebességek használati arányai a következők:

  • lineáris interpolációval, ha a megadott sebesség a listában szereplő két sebesség között van

  • lineáris extrapolációval egyébként, feltételezve, hogy a lista legközelebbi két pontja által meghatározott állandó (ΔConsumption/ΔSpeed)

A lista 1 és 25 pont közötti értéket tartalmazhat (a sebességet is beleértve), és nem tartalmazhat azonos sebességre vonatkozó duplikált pontokat. Ha csak egyetlen pontot tartalmaz, akkor a rendszer további feldolgozás nélkül felhasználja az adott pont használati arányát.

A legnagyobb sebességhez megadott fogyasztásnak nagyobbnak vagy egyenlőnek kell lennie az utolsó előtti legnagyobb sebességével. Ez biztosítja, hogy az extrapoláció ne vezessen negatív fogyasztási arányokhoz.

Hasonlóképpen, a lista két legkisebb sebességéhez megadott fogyasztási értékek nem vezethetnek negatív fogyasztási arányhoz kisebb sebesség esetén.

A használati értékek érvényes tartománya (kWh/100km-ben kifejezve) 0,01 és 100000,0 között van.

Ésszerű értékek: 50,8.2:130,21.3

Ez a paraméter az elektromos fogyasztású modellhez szükséges.
constantSpeedConsumptionInLitersPerHundredkm
 query

string

A fogyasztás sebességfüggő összetevőjét adja meg.

A kettősponttal tagolt sebesség & fogyasztás-arány párok rendezetlen listájaként van megadva. A lista egy használati görbe pontjait határozza meg. A listában nem szereplő sebességek használati arányai a következők:

  • lineáris interpolációval, ha a megadott sebesség a listában szereplő két sebesség között van

  • lineáris extrapolációval egyébként, feltételezve, hogy a lista legközelebbi két pontja által meghatározott állandó (ΔConsumption/ΔSpeed)

A lista 1 és 25 pont közötti értéket tartalmazhat (a sebességet is beleértve), és nem tartalmazhat azonos sebességre vonatkozó duplikált pontokat. Ha csak egyetlen pontot tartalmaz, akkor a rendszer további feldolgozás nélkül felhasználja az adott pont használati arányát.

A legnagyobb sebességhez megadott fogyasztásnak nagyobbnak vagy egyenlőnek kell lennie az utolsó előtti legnagyobb sebességével. Ez biztosítja, hogy az extrapoláció ne vezessen negatív fogyasztási arányokhoz.

Hasonlóképpen, a lista két legkisebb sebességéhez megadott fogyasztási értékek nem vezethetnek negatív fogyasztási arányhoz kisebb sebesség esetén.

A fogyasztási értékek érvényes tartománya (l/100km-ben kifejezve) 0,01 és 100000,0 között van.

Ésszerű értékek: 50,6.3:130,11.5

Megjegyzés : Ez a paraméter az égésfelhasználási modellhez szükséges.
currentChargeInkWh
 query

number

double

A jelenlegi elektromos energiaellátást adja meg kilowattórában (kWh).

Ez a paraméter együtt létezik a maxChargeInkWh paraméterrel.

Az engedélyezett értékek tartománya 0,0 és maxChargeInkWh között van.

Ésszerű értékek: 43
currentFuelInLiters
 query

number

double

A jelenlegi üzemanyag-ellátást adja meg literben.

Ésszerű értékek: 55
decelerationEfficiency
 query

number

double

Meghatározza, hogy a mozgási energia a jármű lassulása esetén (azaz ChemicalEnergySaved/KineticyLost) megtakarított (nem felhasznált) üzemanyaggá alakuljon át. ChemicalEnergySaved úgy nyerhető , hogy a mentett (nem felhasznált) üzemanyagot energiamá alakítja azEnergyDensityInMJoulesPerLiter használatával.

Az accelerationEfficiency paraméterrel kell párosítani.

Az engedélyezett értékek tartománya 0,0 és 1/accelerationEfficiency.

Sensible Values : for Combustion Model : 0,83, for Electric Model : 0,91
departAt
 query

string

date-time

A kiindulási ponttól való indulás dátuma és időpontja az RFC 3339 5.6 szakaszában meghatározott értékkéntdateTime, opcionális időzóna-eltolással. Ha nincs megadva időzóna-eltolás, a rendszer azt feltételezi, hogy a forráspont értéke.

  • Alapértelmezett érték: most
  • Egyéb érték: dateTime

Példák:

  • 2023-12-19T16:39:57
  • 2023-12-20T00:39:57+00:00

A departAt paraméter nem használható a következővel arriveAtegyütt: .
distanceBudgetInMeters
 query

number

double

Távolsági költségkeret méterben, amely meghatározza a maximális tartományt, amely az autós távolság használatával utazható. A használati modell csak akkor befolyásolja a tartományt, ha a routeType eco.
Pontosan egy költségvetést (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec vagy distanceBudgetInMeters) kell használni.
downhillEfficiency
 query

number

double

A potenciális energia megtakarított (nem felhasznált) üzemanyaggá alakításának hatékonyságát határozza meg, ha a jármű elveszíti a jogosultságszint-emelkedést (pl. ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved úgy nyerhető , hogy a mentett (nem felhasznált) üzemanyagot energiamá alakítja azEnergyDensityInMJoulesPerLiter használatával.

Az uphillEfficiency paraméterrel kell párosítani.

Az engedélyezett értékek tartománya 0,0 és 1/uphillEfficiency.

Sensible Values : for Combustion Model : 0,51, for Electric Model : 0,73
energyBudgetInkWh
 query

number

double

Elektromos energia költségvetés kilowatt óra (kWh), amely meghatározza a maximális tartomány, amely lehet utazni a megadott elektromos fogyasztási modell.
Az energyBudgetInkWh használata esetén kötelező megadni egy részletes elektromos fogyasztási modellt.
Pontosan egy költségvetést (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec vagy distanceBudgetInMeters) kell használni.
fuelBudgetInLiters
 query

number

double

Üzemanyag-költségkeret literben, amely meghatározza a maximális tartományt, amely a megadott égésfelhasználási modellel utazható.
A fuelBudgetInLiters használata esetén kötelező megadni egy részletes égésfelhasználási modellt.
Pontosan egy költségvetést (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec vagy distanceBudgetInMeters) kell használni.
fuelEnergyDensityInMJoulesPerLiter
 query

number

double

Meghatározza a megajoulesben (MJ) egy liter üzemanyagban tárolt kémiai energia mennyiségét. A *Hatékonyság paraméterekkel együtt használatos a megtakarított vagy felhasznált energia és üzemanyag közötti átalakításokhoz. Az energiasűrűség például 34,2 MJ/l a benzin esetében, 35,8 MJ/l a dízelüzemanyag esetében.

Ez a paraméter akkor szükséges, ha a *Hatékonyság paraméter be van állítva.

Ésszerű értékek: 34,2
hilliness
 query

InclineLevel

A dombosság foka az izgalmas útvonalhoz. Ez a paraméter csak az =izgalmas paraméterrel routeTypeegyütt használható.
maxChargeInkWh
 query

number

double

Meghatározza a jármű akkumulátorában tárolható maximális elektromos áramellátást kilowattórában (kWh).

Ez a paraméter a currentChargeInkWh paraméterrel együtt létezik.

A minimális értéknek a currentChargeInkWh értéknél nagyobbnak vagy egyenlőnek kell lennie.

Ésszerű értékek: 85
routeType
 query

RouteType

A kért útvonal típusa.
timeBudgetInSec
 query

number

double

Időkeret másodpercben, amely meghatározza a maximális tartományt, amely az autós idő használatával utazható. A használati modell csak akkor befolyásolja a tartományt, ha a routeType eco.
Pontosan egy költségvetést (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec vagy distanceBudgetInMeters) kell használni.
traffic
 query

boolean

Lehetséges értékek:

  • true – Vegye figyelembe az összes elérhető forgalmi információt az útválasztás során
  • false – Az aktuális forgalmi adatok figyelmen kívül hagyása útválasztás közben. Vegye figyelembe, hogy bár az útválasztás során a jelenlegi forgalmi adatok figyelmen kívül lesznek hagyva, a korábbi forgalom tényleges közúti sebességre gyakorolt hatása továbbra is beépül.
travelMode
 query

TravelMode

A kért útvonal utazási módja. Ha nincs definiálva, az alapértelmezett érték az "autó". Vegye figyelembe, hogy a kért travelMode nem feltétlenül érhető el a teljes útvonalon. Ha a kért travelMode nem érhető el egy adott szakaszhoz, az adott szakasz válaszának travelMode eleme "egyéb" lesz. Vegye figyelembe, hogy az utazási módok busszal, motorkerékpárral, taxival és kisteherautóval BÉTA-funkciók. A teljes korlátozási adatok nem érhetők el minden területen.
uphillEfficiency
 query

number

double

Az üzemanyagban tárolt kémiai energia potenciális energiává alakításának hatékonyságát határozza meg, amikor a jármű emelkedik (pl. PotentialEnergyGained/ChemicalEnergyConsumed). A ChemicalEnergyConsumed a felhasznált tüzelőanyagok kémiai energiává alakításával nyerhető ki AzEnergyDensityInMJoulesPerLiter használatával.

A downhillEfficiency paraméterrel kell párosítani.

Az engedélyezett értékek tartománya 0,0 és 1/downhillEfficiency.

Sensible Values : for Combustion Model : 0,27, for Electric Model : 0,74
vehicleAxleWeight
 query

integer

A jármű tengelyenkénti tömege kg-ban. A 0 érték azt jelenti, hogy a tengelyenkénti súlykorlátozásokat nem veszik figyelembe.
vehicleCommercial
 query

boolean

Azt, hogy a járművet kereskedelmi célokra használják-e. A haszongépjárművek nem vezethetnek bizonyos utakon.
vehicleEngineType
 query

VehicleEngineType

A jármű motortípusa. Ha részletes használati modellt ad meg, annak konzisztensnek kell lennie a vehicleEngineType értékével.
vehicleHeight
 query

number

double

A jármű magassága méterben. A 0 érték azt jelenti, hogy a magasságra vonatkozó korlátozásokat nem veszi figyelembe a rendszer.
vehicleLength
 query

number

double

A jármű hossza méterben. A 0 érték azt jelenti, hogy a hosszkorlátozások nem számítanak.
vehicleLoadType
 query

VehicleLoadType

Veszélyes anyagként besorolható és egyes utakról korlátozott rakománytípusok. Az elérhető vehicleLoadType értékek az 1–9. US Hazmat osztályok, valamint más országokban/régiókban használható általános besorolások. Az USHazmat kezdetű értékek az USA útválasztására szolgálnak, míg az otherHazmat minden más országhoz/régióhoz használható. A vehicleLoadType többször is megadható. Ez a paraméter jelenleg csak a travelMode=truck paramétert veszi figyelembe.
vehicleMaxSpeed
 query

integer

A jármű maximális sebessége km/óra alatt. A járműprofilban szereplő maximális sebesség annak ellenőrzésére szolgál, hogy a jármű autópályákon engedélyezve van-e.

  • A 0 érték azt jelenti, hogy az útvonaltervezés során meg kell határozni és alkalmazni kell a jármű megfelelő értékét.

  • Az útvonaltervezés során felül lehet bírálni a nem nulla értéket. Az aktuális forgalom például 60 km/óra. Ha a jármű maximális sebessége 50 km/óra, az útválasztási motor 60 km/órát vesz figyelembe, mivel ez a jelenlegi helyzet. Ha a jármű maximális sebessége 80 km/óra, de az aktuális forgalmi forgalom 60 km/óra, akkor az útválasztási motor ismét 60 km/órát használ.
vehicleWeight
 query

integer

A jármű tömege kilogrammban.

  • Kötelező, ha a *Hatékonyság paraméterek bármelyike be van állítva.

  • Szigorúan pozitívnak kell lennie, ha a használati modell kontextusában használják. A súlykorlátozásokat figyelembe vesszük.

  • Ha nincs megadva részletes fogyasztási modell , és a vehicleWeight értéke nem nulla, akkor a súlykorlátozásokat veszi figyelembe.

  • Ez a paraméter minden más esetben figyelmen kívül lesz hagyva.

Sensible Values : for Combustion Model : 1600, for Electric Model : 1900
vehicleWidth
 query

number

double

A jármű szélessége méterben. A 0 érték azt jelenti, hogy a szélességkorlátozások nem számítanak.
windingness
 query

WindingnessLevel

Fordulatok szintje az izgalmas útvonalhoz. Ez a paraméter csak az =izgalmas paraméterrel routeTypeegyütt használható.

Kérelem fejléce

Name Kötelező Típus Description
x-ms-client-id

string

Meghatározza, hogy melyik fiók legyen a Microsoft Entra ID biztonsági modellel együtt használva. Ez az Azure Maps-fiók egyedi azonosítóját jelöli, amely az Azure Maps felügyeleti sík fiók API-jából kérhető le. A Microsoft Entra ID security Azure Mapsben való használatához az alábbi cikkek nyújtanak útmutatást.

Válaszok

Name Típus Description
200 OK

RouteRangeResult

OK
Other Status Codes

ErrorResponse

Váratlan hiba történt.

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0-folyamatok . Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlése egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforráshoz való hozzáférés kijelölésére szolgál. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörrel.

A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazás(ok) adott API-k és hatókörök hozzáférés-vezérlésére képes objektumokon keresztüli modellezésére.

Jegyzetek

  • Ehhez a biztonsági definícióhoz a x-ms-client-id fejléc használatával kell jelezni, hogy az alkalmazás melyik Azure Maps-erőforráshoz kér hozzáférést. Ez a Maps management API-ból szerezhető be.

A Authorization URL az Azure nyilvános felhőpéldányára vonatkozik. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID-konfigurációkkal rendelkeznek. * Az Azure-beli szerepköralapú hozzáférés-vezérlés az Azure felügyeleti síkjáról van konfigurálva az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül. * Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esetben.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiókot hoz létre az Azure Portalon, vagy PowerShell, CLI, Azure SDK-k vagy REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítését használja az Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.

Típus: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat az Azure Maps-erőforrás Sas listázása műveletéből jön létre az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül.

Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonathoz használt lejárati időhöz, sebességhez és régióhoz. Más szóval az SAS-jogkivonattal az alkalmazások a megosztott kulcsnál biztonságosabb módon szabályozhatják a hozzáférést.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfiguráljon egy adott listát az engedélyezett forrásokról a térképfiók-erőforráson a leképezési visszaélések korlátozásához és az SAS-jogkivonat rendszeres megújításához.

Típus: apiKey
In: header

Példák

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

Mintakérelem

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

Mintaválasz

Állapotkó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
      }
    ]
  }
}

Definíciók

Name Description
EffectiveSetting

A Route API meghívásakor használt érvényes paraméter vagy adatok.
ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.
ErrorDetail

A hiba részletei.
ErrorResponse

Hibaválasz
InclineLevel

A dombosság foka az izgalmas útvonalhoz. Ez a paraméter csak az =izgalmas paraméterrel routeTypeegyütt használható.
LatLongPair

Földrajzi szélességként és hosszúságként megadott hely.
ResponseFormat

A válasz kívánt formátuma. Az érték lehet json vagy xml.
RouteAvoidType

Megad valamit, amelyet az útvonal számításának kerülnie kell az útvonal meghatározásakor. Egy kérelemben többször is megadható, például: "&avoid=autópályák&avoid=tollRoads&avoid=ferries". Az útvonaltartomány-kérelmekben a márUsedRoads értéket nem szabad használni.
RouteRange

Elérhető tartomány
RouteRangeResult

Ezt az objektumot egy sikeres útvonalelérési tartomány hívása adja vissza
RouteReport

Az aktuális hívásban használt érvényes beállításokat jelenti.
RouteType

A kért útvonal típusa.
TravelMode

A kért útvonal utazási módja. Ha nincs definiálva, az alapértelmezett érték az "autó". Vegye figyelembe, hogy a kért travelMode nem feltétlenül érhető el a teljes útvonalon. Ha a kért travelMode nem érhető el egy adott szakaszhoz, az adott szakasz válaszának travelMode eleme "egyéb" lesz. Vegye figyelembe, hogy az utazási módok busszal, motorkerékpárral, taxival és kisteherautóval BÉTA-funkciók. A teljes korlátozási adatok nem érhetők el minden területen.
VehicleEngineType

A jármű motortípusa. Ha részletes használati modellt ad meg, annak konzisztensnek kell lennie a vehicleEngineType értékével.
VehicleLoadType

Veszélyes anyagként besorolható és egyes utakról korlátozott rakománytípusok. Az elérhető vehicleLoadType értékek az 1–9. US Hazmat osztályok, valamint más országokban/régiókban használható általános besorolások. Az USHazmat kezdetű értékek az USA útválasztására szolgálnak, míg az otherHazmat minden más országhoz/régióhoz használható. A vehicleLoadType többször is megadható. Ez a paraméter jelenleg csak a travelMode=truck paramétert veszi figyelembe.
WindingnessLevel

Fordulatok szintje az izgalmas útvonalhoz. Ez a paraméter csak az =izgalmas paraméterrel routeTypeegyütt használható.

EffectiveSetting

A Route API meghívásakor használt érvényes paraméter vagy adatok.

Name Típus Description
key

string

A használt paraméter neve.
value

string

A használt paraméter értéke.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.
type

string

A további adattípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.
code

string

A hibakód.
details

ErrorDetail[]

A hiba részletei.
message

string

A hibaüzenet.
target

string

A hiba célja.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

InclineLevel

A dombosság foka az izgalmas útvonalhoz. Ez a paraméter csak az =izgalmas paraméterrel routeTypeegyütt használható.

Name Típus Description
high

string

magas
low

string

alacsony
normal

string

normális

LatLongPair

Földrajzi szélességként és hosszúságként megadott hely.

Name Típus Description
latitude

number

Latitude tulajdonság
longitude

number

Hosszúság tulajdonság

ResponseFormat

A válasz kívánt formátuma. Az érték lehet json vagy xml.

Name Típus Description
json

string

A JavaScript object Notation Data Interchange formátuma
xml

string

Az extensible Markup Language (Bővíthető korrektúranyelv)

RouteAvoidType

Megad valamit, amelyet az útvonal számításának kerülnie kell az útvonal meghatározásakor. Egy kérelemben többször is megadható, például: "&avoid=autópályák&avoid=tollRoads&avoid=ferries". Az útvonaltartomány-kérelmekben a márUsedRoads értéket nem szabad használni.

Name Típus Description
alreadyUsedRoads

string

Elkerüli, hogy többször is ugyanazt az utat használja. Leginkább hasznos együtt routeType=izgalmas.
borderCrossings

string

Elkerüli a határátkeléseket az útvonal kiszámítása során.
carpools

string

Elkerüli azokat az útvonalakat, amelyek megkövetelik a kocsisor (HOV/Magas kihasználtságú jármű) sávok használatát.
ferries

string

Kerüli a kompokat
motorways

string

Elkerüli az autópályákat
tollRoads

string

Elkerüli a fizetős utakat.
unpavedRoads

string

Elkerüli a meg nem oldott utakat

RouteRange

Elérhető tartomány

Name Típus Description
boundary

LatLongPair[]

Az elérhető tartomány sokszöghatára pontlistaként jelenik meg.
center

LatLongPair

Az elérhető tartomány középpontja

RouteRangeResult

Ezt az objektumot egy sikeres útvonalelérési tartomány hívása adja vissza

Name Típus Description
formatVersion

string

Verzió formázása tulajdonság
reachableRange

RouteRange

Elérhető tartomány
report

RouteReport

Az aktuális hívásban használt érvényes beállításokat jelenti.

RouteReport

Az aktuális hívásban használt érvényes beállításokat jelenti.

Name Típus Description
effectiveSettings

EffectiveSetting[]

A Route API meghívásakor használt hatályos paraméterek vagy adatok.

RouteType

A kért útvonal típusa.

Name Típus Description
eco

string

A gazdaság és a sebesség által kiegyensúlyozott útvonal.
fastest

string

A leggyorsabb útvonal.
shortest

string

A legrövidebb útvonal távolság szerint.
thrilling

string

Érdekes vagy kihívást jelentő utakat tartalmaz, és a lehető legkevesebb autópályát használja. Kiválaszthatja a kanyarok szintjét és a hegyességet is. Ennek beállításához tekintse meg a dombossági és tekercselési paramétereket. 900 km-es korlát van a tervezett routeTypeútvonalakon az =izgalmas

TravelMode

A kért útvonal utazási módja. Ha nincs definiálva, az alapértelmezett érték az "autó". Vegye figyelembe, hogy a kért travelMode nem feltétlenül érhető el a teljes útvonalon. Ha a kért travelMode nem érhető el egy adott szakaszhoz, az adott szakasz válaszának travelMode eleme "egyéb" lesz. Vegye figyelembe, hogy az utazási módok busszal, motorkerékpárral, taxival és kisteherautóval BÉTA-funkciók. A teljes korlátozási adatok nem érhetők el minden területen.

Name Típus Description
bus

string

A visszaadott útvonalak buszokra vannak optimalizálva, beleértve a csak buszsávok használatát is. BÉTA-funkciók.
car

string

A visszaadott útvonalak autókhoz vannak optimalizálva.
motorcycle

string

A visszaadott útvonalak motorkerékpárokra vannak optimalizálva. BÉTA-funkciók.
taxi

string

A visszaadott útvonalak taxikra vannak optimalizálva. BÉTA-funkciók.
truck

string

A visszaadott útvonalak haszongépjárművekre, például teherautókra vannak optimalizálva.
van

string

A visszaadott útvonalak kisteherautókhoz vannak optimalizálva. BÉTA-funkciók.

VehicleEngineType

A jármű motortípusa. Ha részletes használati modellt ad meg, annak konzisztensnek kell lennie a vehicleEngineType értékével.

Name Típus Description
combustion

string

Belső égésű motor.
electric

string

Elektromos motor.

VehicleLoadType

Veszélyes anyagként besorolható és egyes utakról korlátozott rakománytípusok. Az elérhető vehicleLoadType értékek az 1–9. US Hazmat osztályok, valamint más országokban/régiókban használható általános besorolások. Az USHazmat kezdetű értékek az USA útválasztására szolgálnak, míg az otherHazmat minden más országhoz/régióhoz használható. A vehicleLoadType többször is megadható. Ez a paraméter jelenleg csak a travelMode=truck paramétert veszi figyelembe.

Name Típus Description
USHazmatClass1

string

Robbanóanyagok és robbanóanyagot tartalmazó tárgyak
USHazmatClass2

string

Sűrített gáz
USHazmatClass3

string

Gyúlékony folyadékok
USHazmatClass4

string

Gyúlékony szilárd anyagok
USHazmatClass5

string

Oxidálószerek
USHazmatClass6

string

Mérgek
USHazmatClass7

string

Radioaktív anyagok
USHazmatClass8

string

Maró anyagok
USHazmatClass9

string

Különböző veszélyes anyagok és tárgyak
otherHazmatExplosive

string

Robbanóanyagok és robbanóanyagot tartalmazó tárgyak
otherHazmatGeneral

string

Különböző veszélyes anyagok és tárgyak
otherHazmatHarmfulToWater

string

Káros a vízre

WindingnessLevel

Fordulatok szintje az izgalmas útvonalhoz. Ez a paraméter csak az =izgalmas paraméterrel routeTypeegyütt használható.

Name Típus Description
high

string

magas
low

string

alacsony
normal

string

normális