Route - Post Route Range

Szolgáltatás:: Maps

API-verzió:: 2025-01-01

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.

Az útvonalakról országokban/régiókban elérhető információkért lásd: Azure Maps útvonal lefedettség.

POST {endpoint}/route/range?api-version=2025-01-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	Az Azure Maps service hostname. Használd `https://atlas.microsoft.com` Azure nyilvános felhőhöz. Egy adott Azure Maps földrajz vagy szuverén felhő célzásához lásd Azure Maps földrajzi scope
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem fejléce

Media Types: "application/geo+json"

Name	Kötelező	Típus	Description
x-ms-client-id		string	Jelzi a fiókot, amelyet a Microsoft Entra ID biztonsági modellhez szántak. Ez az egyedi azonosító a Azure Maps fiókhoz a Azure Maps menedzsment síkról, a Account API-ról szerezhető meg. További információért Microsoft Entra ID biztonság használatáról Azure Maps-ben: Hitelesítéskezelés a Azure Maps területén.

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	A kérés sikeres volt. Media Types: "application/geo+json", "application/json"
Other Status Codes	MapsErrorResponse	Váratlan hibaválasz. Media Types: "application/geo+json", "application/json"

Name

Típus

Description

200 OK

RouteRangeResponse

A kérés sikeres volt.

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

Other Status Codes

MapsErrorResponse

Váratlan hibaválasz.

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

Biztonság

AadToken

Ezek a Microsoft Entra OAuth 2.0 Flows. Ha Azure szerepalapú hozzáférés vezérléssel párosítjuk, akkor használható Azure Maps REST API-k hozzáférésének vezérlésére. Az Azure szerepalapú hozzáférési vezérlők egy vagy több Azure Maps erőforrás fiókhoz vagy al-erőforráshoz 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.

Note

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 Authorization URL-ekkel és Microsoft Entra ID 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

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiók létrehozása az Azure Portalon, vagy PowerShell, CLI, Azure SDK 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.

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

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

HTTP

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

Állapotkód:: 200

{
  "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.
GeoJsonObjectType	Megadja a `GeoJSON` típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.
InputRouteRangeProperties	Megadja az izokron sokszög kiszámításához használandó paramétereket.
MapsErrorDetail	A hiba részletei.
MapsErrorResponse	Gyakori hibaválasz az Azure Maps API-knál a hibaadatok visszaadására a sikertelen műveletek esetén.
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. \n\nPélda: "elkerül": ["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.

AdrTunnelRestrictionCodeEnum

Felsorolás

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

Felsorolás

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

Felsorolás

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.

GeoJsonObjectType

Felsorolás

Megadja a GeoJSON típusát. A kilenc érvényes GeoJSON-objektumtípus egyikének kell lennie : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.

Érték	Description
Point	`GeoJSON Point` geometria.
MultiPoint	`GeoJSON MultiPoint` geometria.
LineString	`GeoJSON LineString` geometria.
MultiLineString	`GeoJSON MultiLineString` geometria.
Polygon	`GeoJSON Polygon` geometria.
MultiPolygon	`GeoJSON MultiPolygon` geometria.
GeometryCollection	`GeoJSON GeometryCollection` geometria.
Feature	`GeoJSON Feature` tárgy.
FeatureCollection	`GeoJSON FeatureCollection` tárgy.

InputRouteRangeProperties

Tárgy

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) 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. Ha `isSimplifiedPolygon` hamis, akkor a maximális támogatott távolság 90000 méter, egyébként 500 000 méter. Példa: "distanceBudgetInMeters":5000
isSimplifiedPolygon	boolean	True	Ezzel megadhatja, hogy szükség van-e egyszerűsített sokszögekre, amelyek csökkentik a sokszög csúcsainak számát az alakzat megőrzése mellett. Az API alapértelmezés szerint alacsony felbontású sokszöget ad vissza.
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) 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. Ha `isSimplifiedPolygon` hamis, a maximális támogatott idő 3600 másodperc, ellenkező esetben 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

Tárgy

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

Tárgy

Gyakori hibaválasz az Azure Maps API-knál a hibaadatok visszaadására a sikertelen műveletek esetén.

Name	Típus	Description
error	MapsErrorDetail	A hiba részletei.

MapsInnerError

Tárgy

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

Felsorolás

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. \n\nPélda: "elkerül": ["limitedAccessHighways", "tollRoads"]

Érték	Description
limitedAccessHighways	Elkerüli a korlátozott hozzáférésű autópályák használatát az útvonalon.
tollRoads	Elkerüli az útdíjköteles utak használatát az útvonalon.
ferries	Elkerüli a kompok használatát az útvonalon.
tunnels	Elkerüli az alagutak használatát az útvonalon.
borderCrossings	Elkerüli az országhatárok átlépését az útvonalon.
lowEmissionZones	Elkerüli az alacsony kibocsátású zónákat az útvonalon.
unpavedRoads	Elkerüli a fel nem ásott utakat az útvonalon.
carpools	Elkerüli a telekocsi használatát igénylő útvonalakat.
carTrains	Elkerüli az autós vonatokat.

RouteRangeFeatureProperties

Tárgy

Útvonaltartományok tulajdonságai.

Name	Típus	Description
type	RouteRangeTypeEnum	A válaszban visszaadott funkcióobjektumok szolgáltatástípusai.

RouteRangeFeaturesItem

Tárgy

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: RouteRangePointGeometry RouteRangePolygonGeometry	É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

Felsorolás

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
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.
fastestWithoutTraffic	Megkeresi a leggyorsabb útvonalat, anélkül, hogy a forgalmi adatokban szerepet játszik.
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.

RouteRangePointGeometry

Tárgy

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

Tárgy

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

Tárgy

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

Tárgy

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

Felsorolás

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

Felsorolás

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

Érték	Description
center	A középpont jellemzőtípusa a tartomány sokszögének kiszámításához használt pontot jelöli.
boundary	A határfunkció típusa a tartomány sokszögét jelöli.

RouteRangeVehicleSpec

Tárgy

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

Felsorolás

Veszélyes anyagként besorolható és egyes utakról korlátozott rakománytípusok.

É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