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


Route - Post Route Range

Az Útvonaltartomány API egy sokszöget hoz létre, amely egy adott helyről egy adott küszöbértéken belül elérhető területet ábrázol a megadott idő- vagy távolságkeret alapján. A sokszöghatár (vagy Isochrone) az óramutató járásával ellentétes irányban, valamint a pontos sokszög középen jelenik meg, amely a forráspont eredménye volt.

A visszaadott sokszög a térbeli szűréshez használható a megadott Isochrone-beli érdekes funkciók kereséséhez.

További információ az útválasztás elérhetőségéről az országokban/régiókban: Azure Maps útválasztási lefedettség.

POST https://atlas.microsoft.com/route/range?api-version=2025-01-01

URI-paraméterek

Name In Kötelező Típus Description
api-version
query True

string

Az Azure Maps API verziószáma.

Kérelem fejléce

Media Types: "application/geo+json"

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

string

Megadja, hogy melyik fiók legyen a Microsoft Entra ID biztonsági modellel együtt használva. 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-biztonság Azure Mapsben való használatához az alábbi cikkeket útmutatásért.

Kérelem törzse

Media Types: "application/geo+json"

Name Kötelező Típus Description
geometry True

RouteRangePointGeometry

A GeoJSON Pontgeometria objektumot adja meg. Részletekért tekintse meg RFC 7946.

properties True

InputRouteRangeProperties

Megadja az izokron sokszög kiszámításához használandó paramétereket.

type True

FeaturesItemTypeEnum

Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

Válaszok

Name Típus Description
200 OK

RouteRangeResponse

OKÉ

Media Types: "application/geo+json", "application/json"

Other Status Codes

MapsErrorResponse

Váratlan hiba történt.

Media Types: "application/geo+json", "application/json"

Fejlécek

x-ms-error-code: string

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0 folyamatok . Ha 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ői egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörön vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörön keresztül.

Forgatókönyvek implementálásához javasoljuk, hogy tekintse meg hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást kínál az alkalmazások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.

Megjegyzés

  • Ez a biztonsági definíciós megköveteli, hogy a x-ms-client-id fejléc használatával jelezze, hogy melyik Azure Maps-erőforráshoz kér hozzáférést az alkalmazás. Ez a Maps felügyeleti API-érhető el.
  • A Authorization URL az Azure nyilvános felhőpéldányára jellemző. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra-azonosító konfigurációkkal rendelkeznek.
  • Az Azure szerepköralapú hozzáférés-vezérlés a Azure felügyeleti síkjáról van konfigurálva, az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kkal vagy REST API-kkal.
  • 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 esethez.
  • További információ a Microsoft identitásplatformról: Microsoft Identitásplatform áttekintése.

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 jön létre, ha Azure Maps-erőforrást hoz létre az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül.

Ezzel a kulccsal minden alkalmazás jogosult az összes REST API elérésére. Más szóval ezek jelenleg főkulcsként kezelhetők ahhoz a fiókhoz, amelyhez ki vannak adva.

A nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy az Azure Maps REST API-k kiszolgálóról kiszolgálóra történő elérését használja, ahol ez a kulcs biztonságosan tárolható.

Típus: apiKey
In: header

SAS Token

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

Ezzel a jogkivonattal minden alkalmazás jogosult az Azure szerepköralapú hozzáférés-vezérlőivel való hozzáférésre, valamint az adott jogkivonat lejáratának, sebességének és régióinak részletes szabályozására. Más szóval az SAS-jogkivonat segítségével az alkalmazások biztonságosabban szabályozhatják a hozzáférést, mint a megosztott kulcs.

A nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfigurálja a -fiók erőforrás- engedélyezett forrásainak listáját a renderelési visszaélések korlátozása és az SAS-jogkivonat rendszeres megújítása érdekében.

Típus: apiKey
In: header

Példák

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

Mintakérelem

POST https://atlas.microsoft.com/route/range?api-version=2025-01-01

{
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      5.86605,
      50.9745
    ]
  },
  "properties": {
    "timeBudgetInSec": 6000
  }
}

Mintaválasz

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

Definíciók

Name Description
AdrTunnelRestrictionCodeEnum

Az ADR alagútkorlátozási kódja. Az ADR a veszélyes áruk nemzetközi közúti szállításáról szóló európai megállapodás. Az ADR alagútkorlátozási kódja annak meghatározására szolgál, hogy a jármű áthaladhat-e az alagúton a veszélyes áruk szállítására vonatkozó korlátozásokkal.

FeaturesItemTypeEnum

Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

FeatureTypeEnum

Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a FeatureCollection. További információ: RFC 7946.

InputRouteRangeProperties

Megadja az izokron sokszög kiszámításához használandó paramétereket.

MapsErrorDetail

A hiba részletei.

MapsErrorResponse

Az Azure Maps API-k gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához.

MapsInnerError

Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.

RouteRangeAvoidEnum

Meghatározza azokat a korlátozásokat, amelyeket az útvonalszámításnak figyelembe kell vennie az elérhető helyek meghatározásakor. Ne használjon több értéket egy kérelemben.

Például: "avoid": ["limitedAccessHighways", "tollRoads"]

RouteRangeFeatureProperties

Útvonaltartományok tulajdonságai.

RouteRangeFeaturesItem

A GeoJSON funkcióobjektum geometriai objektumot és az útvonal további tulajdonságait tartalmazza.

RouteRangeOptimizeRouteEnum

Megadja az útvonal optimalizálásához használandó paramétert. Ha nincs megadva, az alapértelmezett érték a "leggyorsabbWithoutTraffic", amely visszaadja az útvonalat, hogy az aktuális forgalmi adatok használata nélkül minimalizálja az utazási időt.

Példa: "optimizeRoute":"shortest"

RouteRangePointGeometry

A GeoJSON Pontgeometria objektumot adja meg. Részletekért tekintse meg RFC 7946.

RouteRangePolygonGeometry

A GeoJSON poligongeometriai objektumot adja meg. Részletekért tekintse meg RFC 7946.

RouteRangeRequest

Megadja a tartományszámítás kezdőpontját. GeoJSON funkcióobjektumot és további tulajdonságokat. Részletekért tekintse meg RFC 7946.

RouteRangeResponse

Ezt az objektumot egy sikeres hívás adja vissza.

RouteRangeTravelModeEnum

Megadja a tartomány sokszögének kiszámításakor figyelembe veendő utazási profilt. Ha nincs megadva, az alapértelmezett érték a "vezetés".

Példa: "travelMode":"vezetés"

RouteRangeTypeEnum

A válaszban visszaadott funkcióobjektumok szolgáltatástípusai.

RouteRangeVehicleSpec

Meghatározza a jármű attribútumait, például a jármű magasságát, súlyát, maximális sebességét, rakománytípusát stb., amelyeket figyelembe kell venni az elérhető helyek kiszámításakor. Ez segít elkerülni az alacsony hídfedéseket, az útkorlátozásokat, a nehéz jobbra fordulásokat, hogy a jármű specifikációi alapján optimalizált teherautó-útvonalat biztosítson. A járműattribútumok a vehicleSpec tulajdonságban vannak megadva.

VehicleLoadTypeEnum

Veszélyes anyagként besorolható és egyes utakról korlátozott rakománytípusok. A vehicleLoadType elérhető értékei az USA Hazmat 1–9. osztályai, valamint a más országokban használható általános besorolások. Az USHazmat kezdetű értékek az USA útválasztására szolgálnak, míg az otherHazmatot minden más országban használni kell. A vehicleLoadType több értéket is támogat egy kérelemben.

AdrTunnelRestrictionCodeEnum

Az ADR alagútkorlátozási kódja. Az ADR a veszélyes áruk nemzetközi közúti szállításáról szóló európai megállapodás. Az ADR alagútkorlátozási kódja annak meghatározására szolgál, hogy a jármű áthaladhat-e az alagúton a veszélyes áruk szállítására vonatkozó korlátozásokkal.

Érték Description
B

A B kóddal rendelkező járművek a B, C, D és E ADR alagútkategóriájú utakra korlátozódnak.

C

A C kóddal rendelkező járművek a C, D és E ADR alagútkategóriájú utaktól korlátozottak

D

A D kóddal rendelkező járművek a D és E ADR alagútkategóriájú utaktól vannak korlátozva.

E

Az E kóddal rendelkező járművek az ADR alagút E kategóriával rendelkező utakra korlátozódnak.

FeaturesItemTypeEnum

Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

Érték Description
Feature

Megadja a GeoJSON funkcióobjektum típusát.

FeatureTypeEnum

Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a FeatureCollection. További információ: RFC 7946.

Érték Description
FeatureCollection

A GeoJSONFeatureCollection objektumtípust adja meg.

InputRouteRangeProperties

Megadja az izokron sokszög kiszámításához használandó paramétereket.

Name Típus Alapértelmezett érték Description
avoid

RouteRangeAvoidEnum[]

Meghatározza azokat a korlátozásokat, amelyeket az útvonalszámításnak figyelembe kell vennie az elérhető helyek meghatározásakor. Ne használjon több értéket egy kérelemben.

Például: "avoid": ["limitedAccessHighways", "tollRoads"]

departAt

string (date-time)

A kiindulási ponttól való eltérés dátuma és időpontja dátum/idő értékként, amelyet RFC 3339, 5.6 szakasz. Ha nincs megadva időzóna-eltolás, a rendszer az UTC-t feltételezi.

Ha a departAt nincs beállítva, az alapértelmezett érték az aktuális időpont.

Példa:

"departAt": "2023-06-01T09:30:00.000-07:00"

distanceBudgetInMeters

number (float)

minimum: 0
maximum: 500000

A távolsági költségvetés határozza meg a mérők maximális tartományát, amely a kiindulási útpontról utazható. Nem állítható be timeBudgetInSec megadásakor.

A maximálisan támogatott távolság 500 000 méter.

Példa: "distanceBudgetInMeters":5000

isSimplifiedPolygon

boolean

True

Ezzel megadhatja, hogy szükség van-e egyszerűsített sokszögekre, csökkentve a csúcspontok számát a teljes alakzat megőrzése mellett.

isSimplifiedPolygon Jelenleg csak a .true A nagy felbontású sokszögek támogatása hamarosan elérhető lesz. További információkért és a nagy felbontású sokszögek kipróbálásához tekintse meg az Útválasztási szolgáltatás nyilvános előzetes verziójának Útvonal utáni tartománya című szakaszát.

optimizeRoute

RouteRangeOptimizeRouteEnum

fastestWithoutTraffic

Megadja az útvonal optimalizálásához használandó paramétert. Ha nincs megadva, az alapértelmezett érték a "leggyorsabbWithoutTraffic", amely visszaadja az útvonalat, hogy az aktuális forgalmi adatok használata nélkül minimalizálja az utazási időt.

Példa: "optimizeRoute":"shortest"

timeBudgetInSec

number (float)

minimum: 0
maximum: 21600

Az időkeret az utazáshoz másodpercben elérhető maximális időt határozza meg, amely meghatározza, hogy az adott időkorláton belül milyen messzire lehet menni a forrásútponttól. Nem állítható be distanceBudgetInMeters megadásakor.

A maximális támogatott idő 21 600 másodperc.

Példa: "timeBudgetInSec":3600

travelMode

RouteRangeTravelModeEnum

driving

Megadja a tartomány sokszögének kiszámításakor figyelembe veendő utazási profilt. Ha nincs megadva, az alapértelmezett érték a "vezetés".

Példa: "travelMode":"vezetés"

vehicleSpec

RouteRangeVehicleSpec

Meghatározza a jármű attribútumait, például a jármű magasságát, súlyát, maximális sebességét, rakománytípusát stb., amelyeket figyelembe kell venni az elérhető helyek kiszámításakor. Ez segít elkerülni az alacsony hídfedéseket, az útkorlátozásokat, a nehéz jobbra fordulásokat, hogy a jármű specifikációi alapján optimalizált teherautó-útvonalat biztosítson. A járműattribútumok a vehicleSpec tulajdonságban vannak megadva.

MapsErrorDetail

A hiba részletei.

Name Típus Description
code

string

A kiszolgáló által definiált hibakódok egyike.

details

MapsErrorDetail[]

A jelentett hibához vezető konkrét hibák részleteinek tömbje.

innererror

MapsInnerError

Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.

message

string

A hiba ember által olvasható ábrázolása.

target

string

A hiba célja.

MapsErrorResponse

Az Azure Maps API-k gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához.

Name Típus Description
error

MapsErrorDetail

A hiba részletei.

MapsInnerError

Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.

Name Típus Description
code

string

A hibakód.

innererror

MapsInnerError

Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.

RouteRangeAvoidEnum

Meghatározza azokat a korlátozásokat, amelyeket az útvonalszámításnak figyelembe kell vennie az elérhető helyek meghatározásakor. Ne használjon több értéket egy kérelemben.

Például: "avoid": ["limitedAccessHighways", "tollRoads"]

Érték Description
borderCrossings

Elkerüli az országhatárok átlépését az útvonalon.

carTrains

Elkerüli az autós vonatokat.

carpools

Elkerüli a telekocsi használatát igénylő útvonalakat.

ferries

Elkerüli a kompok használatát az útvonalon.

limitedAccessHighways

Elkerüli a korlátozott hozzáférésű autópályák használatát az útvonalon.

lowEmissionZones

Elkerüli az alacsony kibocsátású zónákat az útvonalon.

tollRoads

Elkerüli az útdíjköteles utak használatát az útvonalon.

tunnels

Elkerüli az alagutak használatát az útvonalon.

unpavedRoads

Elkerüli a fel nem ásott utakat az útvonalon.

RouteRangeFeatureProperties

Útvonaltartományok tulajdonságai.

Name Típus Description
type

RouteRangeTypeEnum

A válaszban visszaadott funkcióobjektumok szolgáltatástípusai.

RouteRangeFeaturesItem

A GeoJSON funkcióobjektum geometriai objektumot és az útvonal további tulajdonságait tartalmazza.

Name Típus Description
bbox

number[] (double)

Egy téglalap alakú terület a földön, amely határolókeret objektumként van definiálva. A téglalapok oldalait szélességi és hosszúsági értékek határozzák meg. További információ: RFC 7946, 5. szakasz.

Példa: "bbox": [-10.0, -10.0, 10.0, 10.0]

geometry RouteRangeGeometry:

Érvényes GeoJSON geometriai objektum. Részletekért tekintse meg RFC 7946.

properties

RouteRangeFeatureProperties

Útvonaltartományok tulajdonságai.

type

FeaturesItemTypeEnum

Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

RouteRangeOptimizeRouteEnum

Megadja az útvonal optimalizálásához használandó paramétert. Ha nincs megadva, az alapértelmezett érték a "leggyorsabbWithoutTraffic", amely visszaadja az útvonalat, hogy az aktuális forgalmi adatok használata nélkül minimalizálja az utazási időt.

Példa: "optimizeRoute":"shortest"

Érték Description
fastestWithTraffic

A rendszer úgy számítja ki az útvonalat, hogy az aktuális forgalmi adatok használatával minimalizálja az időt. Note: Csak a vezetés és a teherautó travelMode esetében támogatott.

fastestWithoutTraffic

Megkeresi a leggyorsabb útvonalat, anélkül, hogy a forgalmi adatokban szerepet játszik.

shortest

Az útvonal kiszámítása a távolság minimalizálása érdekében történik. A rendszer nem használja a forgalmi adatokat.

RouteRangePointGeometry

A GeoJSON Pontgeometria objektumot adja meg. Részletekért tekintse meg RFC 7946.

Name Típus Description
coordinates

number[] (double)

A Position két vagy több elemet tartalmazó számtömb. Az első két elem hosszúsági és szélességi, pontosan ebben a sorrendben. magassági/magassági nem kötelező harmadik elem. Részletekért tekintse meg RFC 7946.

type string:

Point

A GeoJSON Geometry objektum geometriai típusát adja meg. Részletekért tekintse meg RFC 7946.

RouteRangePolygonGeometry

A GeoJSON poligongeometriai objektumot adja meg. Részletekért tekintse meg RFC 7946.

Name Típus Description
coordinates

number[] (double)

A GeoJson Polygon geometriatípus koordinátái.

type string:

Polygon

A GeoJSON Geometry objektum geometriai típusát adja meg. Részletekért tekintse meg RFC 7946.

RouteRangeRequest

Megadja a tartományszámítás kezdőpontját. GeoJSON funkcióobjektumot és további tulajdonságokat. Részletekért tekintse meg RFC 7946.

Name Típus Description
geometry

RouteRangePointGeometry

A GeoJSON Pontgeometria objektumot adja meg. Részletekért tekintse meg RFC 7946.

properties

InputRouteRangeProperties

Megadja az izokron sokszög kiszámításához használandó paramétereket.

type

FeaturesItemTypeEnum

Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

RouteRangeResponse

Ezt az objektumot egy sikeres hívás adja vissza.

Name Típus Description
features

RouteRangeFeaturesItem[]

GeoJSON geometriai objektumot és további tulajdonságokat tartalmazó funkcióobjektumot. A részletekért tekintse meg RFC 7946 3.2 szakaszát.

type

FeatureTypeEnum

Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a FeatureCollection. További információ: RFC 7946.

RouteRangeTravelModeEnum

Megadja a tartomány sokszögének kiszámításakor figyelembe veendő utazási profilt. Ha nincs megadva, az alapértelmezett érték a "vezetés".

Példa: "travelMode":"vezetés"

Érték Description
driving

Az autókhoz alkalmas útválasztási profilok a távolsági sokszög kiszámításához használhatók.

truck

A haszongépjárművekhez, például teherautókhoz alkalmas útválasztási profilok többszögszámításhoz használhatók.

RouteRangeTypeEnum

A válaszban visszaadott funkcióobjektumok szolgáltatástípusai.

Érték Description
boundary

A határfunkció típusa a tartomány sokszögét jelöli.

center

A középpont jellemzőtípusa a tartomány sokszögének kiszámításához használt pontot jelöli.

RouteRangeVehicleSpec

Meghatározza a jármű attribútumait, például a jármű magasságát, súlyát, maximális sebességét, rakománytípusát stb., amelyeket figyelembe kell venni az elérhető helyek kiszámításakor. Ez segít elkerülni az alacsony hídfedéseket, az útkorlátozásokat, a nehéz jobbra fordulásokat, hogy a jármű specifikációi alapján optimalizált teherautó-útvonalat biztosítson. A járműattribútumok a vehicleSpec tulajdonságban vannak megadva.

Name Típus Alapértelmezett érték Description
adrTunnelRestrictionCode

AdrTunnelRestrictionCodeEnum

Az ADR alagútkorlátozási kódja. Az ADR a veszélyes áruk nemzetközi közúti szállításáról szóló európai megállapodás. Az ADR alagútkorlátozási kódja annak meghatározására szolgál, hogy a jármű áthaladhat-e az alagúton a veszélyes áruk szállítására vonatkozó korlátozásokkal.

axleCount

integer (int64)

A jármű tengelyeinek száma.

axleWeight

integer (int64)

minimum: 0
maximum: 1000000
0

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.

height

number (double)

minimum: 0
maximum: 1000000
0

A jármű magassága méterben. A 0 érték azt jelenti, hogy a magasságkorlátozások nem tekinthetők meg.

isVehicleCommercial

boolean

False

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

length

number (double)

minimum: 0
maximum: 1000000
0

A jármű hossza méterben. A 0 érték azt jelenti, hogy a hosszkorlátozások nem tekinthetők meg.

loadType

VehicleLoadTypeEnum[]

Veszélyes anyagként besorolható és egyes utakról korlátozott rakománytípusok. A vehicleLoadType elérhető értékei az USA Hazmat 1–9. osztályai, valamint a más országokban használható általános besorolások. Az USHazmat kezdetű értékek az USA útválasztására szolgálnak, míg az otherHazmatot minden más országban használni kell. A vehicleLoadType több értéket is támogat egy kérelemben.

maxSpeed

integer (int64)

minimum: 0
maximum: 250
0

A jármű maximális sebessége km/óra sebességgel. 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élyezett-e.

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

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 forgalom 60 km/óra, akkor az útválasztási motor ismét 60 km/órát használ.

weight

integer (int64)

minimum: 0
maximum: 1000000
0

A jármű súlya kilogrammban. A 0 érték azt jelenti, hogy a súlykorlátozásokat nem veszik figyelembe.

width

number (double)

minimum: 0
maximum: 1000000
0

A jármű szélessége méterben. A 0 érték azt jelenti, hogy a szélességi korlátozások nem tekinthetők meg.

VehicleLoadTypeEnum

Veszélyes anyagként besorolható és egyes utakról korlátozott rakománytípusok. A vehicleLoadType elérhető értékei az USA Hazmat 1–9. osztályai, valamint a más országokban használható általános besorolások. Az USHazmat kezdetű értékek az USA útválasztására szolgálnak, míg az otherHazmatot minden más országban használni kell. A vehicleLoadType több értéket is támogat egy kérelemben.

Érték Description
USHazmatClass1

Robbanóanyagok

USHazmatClass2

Sűrített gáz

USHazmatClass3

Gyúlékony folyadékok

USHazmatClass4

Gyúlékony szilárd anyagok

USHazmatClass5

Oxidálószerek

USHazmatClass6

Mérgek

USHazmatClass7

Radioaktív

USHazmatClass8

Maró anyagok

USHazmatClass9

Egyéb

otherHazmatExplosive

Robbanóanyagok

otherHazmatGeneral

Egyéb

otherHazmatHarmfulToWater

Káros a vízre