Route - Post Route Matrix Sync

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

Egy útvonalmátrix lekérése az összes lehetséges pár utazási idejét és távolságát ábrázoló útvonalmátrixhoz a forrás- és úti célok listájában, szinkron kérés használatával.

Megjegyzés

Azure Maps Route 1-es szolgáltatás kivonási

Az Azure Maps Route v1 szolgáltatás elavult, és 28.31-én megszűnik. A szolgáltatáskimaradások elkerülése érdekében a Route v1 szolgáltatás minden hívását frissíteni kell, hogy Route v2025-01-01 szolgáltatást használhassa 2028. 03. 31-ig. További információ: Migrate Azure Maps Route 1.0 API-k.

A Post Route Matrix Sync API egy HTTP-POST-kérés, amely lehetővé teszi a forrás- és célhelyek által meghatározott útvonalak mátrixának kiszámítását egyetlen szinkron (szinkronizálási) kérelem használatával. Ha aszinkron (aszinkron) kérést szeretne készíteni, tekintse meg útvonal utáni mátrix. A szolgáltatás minden adott forrás esetében kiszámítja az adott forrástól az adott célhelyig történő útválasztás költségét. A forráskészletet és a célhelykészletet úgy lehet elképzelni, mint egy tábla oszlop- és sorfejléceit, és a táblázat minden cellái tartalmazzák az adott cella forrásától a célhelyig történő útválasztás költségeit. Tegyük fel például, hogy egy ételkézbesítési vállalatnak 20 sofőrje van, és meg kell találniuk a legközelebbi sofőrt, aki felveszi a szállítást az étteremből. A használati eset megoldásához meghívhatják a Matrix Route API-t.

Minden útvonal esetében a rendszer visszaadja az utazási időket és a távolságokat. A kiszámított költségek alapján meghatározhatja, hogy mely részletes útvonalakat számítsa ki a Route Directions API használatával.

Az aszinkron kérelmek mátrixának maximális mérete 700, szinkronizálási kérelem esetén pedig 100 (a források száma és a célhelyek száma).

Szinkron útvonalmátrix-kérelem elküldése

Ha a forgatókönyv szinkron kéréseket igényel, és a mátrix maximális mérete kisebb vagy egyenlő 100-nál, érdemes lehet szinkron kérést küldeni. Az API-hoz tartozó mátrix maximális mérete 100 (a források száma és a célhelyek számának szorzata). Ezt a kényszert szem előtt tartva a lehetséges mátrixdimenziók például a következők: 10x10, 6x8, 9x8 (nem kell négyzetnek lennie).

POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&subscription-key={subscription-key}

Aszinkron útvonalmátrix-kérelem küldése

Az Aszinkron API alkalmas a viszonylag összetett útválasztási kérések nagy mennyiségének feldolgozására. Ha aszinkron kéréssel küld kérést, a szolgáltatás alapértelmezés szerint egy 202-s válaszkódot ad vissza egy átirányítási URL-cím mentén a válaszfejléc Hely mezőjében. Ezt az URL-címet rendszeres időközönként ellenőrizni kell, amíg a válaszadatok vagy a hibaadatok nem érhetők el. Ha waitForResults kérelem paramétere igaz, a felhasználó 200 választ kap, ha a kérés 120 másodperc alatt befejeződött.

Az API-hoz tartozó mátrix maximális mérete 700 (a források száma és a célhelyek számának szorzata). Ezt a kényszert szem előtt tartva a lehetséges mátrixdimenziók például a következők: 50x10, 10x10, 28x25. 10x70 (nem kell négyzet).

Az aszinkron válaszok tárolása 24 órán keresztül történik . Az átirányítási URL 404-választ ad vissza, ha a lejárati idő után használják.

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&subscription-key={subscription-key}

Az aszinkron műveletek jellemző sorrendje a következő:

  1. Az ügyfél útválasztási mátrix POST-kérést küld az Azure Mapsnek

  2. A kiszolgáló a következők egyikével válaszol:

    HTTP 202 Accepted – Az útvonalmátrix kérése elfogadva.

    HTTP Error – Hiba történt az útvonalmátrix-kérelem feldolgozása során. Ez lehet egy 400-ás hibás kérés vagy bármely más hibaállapot-kód.

  3. Ha a mátrixútvonal-kérést sikeresen elfogadták, a válasz Hely fejléce tartalmazza a kérelem eredményeinek letöltéséhez használt URL-címet. Az állapot URI-ja a következőhöz hasonlóan néz ki:

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}
  1. Az ügyfél get kérést ad ki a 3. lépésben beszerzett letöltési URL-címre az eredmények letöltéséhez

Szinkronizálási eredmények letöltése

Amikor POST kérelmet küld a Route Matrix Sync API-hoz, a szolgáltatás 200 válaszkódot ad vissza a sikeres kéréshez és egy választömbhöz. A válasz törzse tartalmazni fogja az adatokat, és később nem lesz lehetőség az eredmények lekérésére.

Aszinkron eredmények letöltése

Amikor egy kérés 202 Accepted választ ad ki, a kérés feldolgozása az aszinkron folyamatunkkal történik. Egy URL-címet kap, amely ellenőrzi az aszinkron kérés előrehaladását a válasz helyfejlécében. Az állapot URI-ja a következőhöz hasonlóan néz ki:

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

A hely fejléce által megadott URL-cím a következő válaszokat adja vissza GET kérés kiadásakor.

HTTP 202 Accepted – A mátrixkérelem elfogadva, de még folyamatban van. Próbálkozzon újra egy ideig.

HTTP 200 OK – A mátrixkérés feldolgozása sikeresen megtörtént. A válasz törzse tartalmazza az összes eredményt.

POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0
Opcionális paraméterekkel: 
POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&waitForResults={waitForResults}&computeTravelTimeFor={computeTravelTimeFor}&sectionType={sectionType}&arriveAt={arriveAt}&departAt={departAt}&vehicleAxleWeight={vehicleAxleWeight}&vehicleLength={vehicleLength}&vehicleHeight={vehicleHeight}&vehicleWidth={vehicleWidth}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}

URI-paraméterek

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

JsonFormat

A válasz kívánt formátuma. Csak json formátum támogatott.
api-version
 query True

string

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

string (date-time)

A célpontra való érkezés dátuma és időpontja dateTime értékként formázva, az RFC 3339 5.6 szakaszának5.6. szakaszában meghatározottak szerint, opcionális időzóna-eltolással. Ha nincs megadva időzóna-eltolás, a rendszer azt feltételezi, hogy a célpont értéke.

Példák:

  • 2023-12-19T16:39:57
  • 2023-12-19T16:39:57-08:00

A arriveAt paraméter nem használható departAt, minDeviationDistance vagy minDeviationTime.
avoid
 query

RouteAvoidType[]

Meghatároz valamit, amelyet az útvonalszámításnak el kell kerülnie 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.
computeTravelTimeFor
 query

ComputeTravelTime

Meghatározza, hogy a forgalmi adatok különböző típusaival (nincs, történelmi, élő) és az alapértelmezett legjobb becslési utazási idővel adja-e vissza a további utazási időket.
departAt
 query

string (date-time)

A kiindulási ponttól való eltérés dátuma és időpontja dateTime értékként formázva, az RFC 3339 5.6. Ha nincs megadva időzóna-eltolás, a rendszer azt feltételezi, hogy az a kiindulási ponthoz tartozik.

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

Példák:

  • 2023-12-19T16:39:57
  • 2023-12-19T16:39:57-08:00

A departAt paraméter nem használható arriveAt.
hilliness
 query

InclineLevel

A dombság foka az izgalmas útvonalhoz. Ez a paraméter csak routeType=izgalmas együtt használható.
routeType
 query

RouteType

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

SectionType[]

Megadja, hogy a szakasztípusok közül melyiket jelenti a rendszer az útvonalválaszban.

Ha például a sectionType = gyalogos, akkor a csak gyalogosoknak megfelelő szakaszok lesznek visszaadva. Egy kérelemben többször is megadható, például : "§ionType=carTrain§ionType=gyalogos§ionType=autópálya". Az alapértelmezett sectionType a travelMode bemenetre hivatkozik. Alapértelmezés szerint a travelMode autóra van állítva
traffic
 query

boolean

Lehetséges értékek:

  • true – Az útválasztás során vegye figyelembe az összes rendelkezésre álló forgalmi információt
  • false – Az aktuális forgalmi adatok figyelmen kívül hagyása az útválasztás során. Vegye figyelembe, hogy bár az útválasztás során figyelmen kívül hagyja a jelenlegi forgalmi adatokat, a korábbi forgalom hatása a tényleges közúti sebességre továbbra is be van építve.
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 é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étaverziós funkciók. A teljes korlátozási adatok nem érhetők el minden területen.
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.
vehicleHeight
 query

number (double)

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

number (double)

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

VehicleLoadType

Veszélyes anyagként besorolható és egyes utakról korlátozott rakománytípusok. A rendelkezésre álló vehicleLoadType értékek az US Hazmat 1–9. osztályai, valamint a 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 otherHazmatot minden más országban/régióban használni kell. A vehicleLoadType többször is megadható. Ez a paraméter jelenleg csak a travelMode=truck esetében tekinthető meg.
vehicleMaxSpeed
 query

integer

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.
vehicleWeight
 query

integer

A jármű súlya kilogrammban.
vehicleWidth
 query

number (double)

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.
waitForResults
 query

boolean

Logikai érték, amely jelzi, hogy a kérés szinkron módon legyen-e végrehajtva. Ha igaz értékre van állítva, a felhasználó 200 választ kap, ha a kérés 120 másodperc alatt befejeződött. Ellenkező esetben a felhasználó azonnal megkapja a 202-re adott választ. A 202-es válaszra vonatkozó további részletekért tekintse meg az API leírását. csak aszinkron kérések esetén támogatott.
windingness
 query

WindingnessLevel

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

Kérelem fejléce

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

string

A Microsoft Entra ID biztonsági modelljével való használatra szánt fiókot jelzi. Ez a Azure Maps fiók azonosítója a felügyeleti sík Account API-jából szerezhető be Azure Maps. További információ a Microsoft Entra ID biztonságának Azure Maps: Hitelesítés kezelése a Azure Maps.

Kérelem törzse

Name Típus Description
destinations

GeoJsonMultiPoint

Érvényes GeoJSON MultiPoint geometriatípus. Részletekért tekintse meg RFC 7946.
origins

GeoJsonMultiPoint

Érvényes GeoJSON MultiPoint geometriatípus. Részletekért tekintse meg RFC 7946.

Válaszok

Name Típus Description
200 OK

RouteMatrixResult

A mátrixkérés feldolgozása sikeresen megtörtént. A válasz törzse tartalmazza az összes eredményt.
Other Status Codes

ErrorResponse

Időtúllépés: A kérés befejezése hosszabb időt vett igénybe, mint az API-ban meghatározott maximális időtartam.
Other Status Codes

ErrorResponse

Váratlan hiba történt.

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.

Jegyzetek

  • 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-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 esethez.

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ó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: query

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 route matrix request result synchronously

Mintakérelem

POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&routeType=shortest

{
  "origins": {
    "type": "MultiPoint",
    "coordinates": [
      [
        4.85106,
        52.36006
      ],
      [
        4.85056,
        52.36187
      ]
    ]
  },
  "destinations": {
    "type": "MultiPoint",
    "coordinates": [
      [
        4.85003,
        52.36241
      ],
      [
        13.42937,
        52.50931
      ]
    ]
  }
}

Mintaválasz

Állapotkód:
200 
{
  "formatVersion": "0.0.1",
  "matrix": [
    [
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 495,
            "travelTimeInSeconds": 134,
            "trafficDelayInSeconds": 0,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-27T22:57:43+00:00"
          }
        }
      },
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 647651,
            "travelTimeInSeconds": 26835,
            "trafficDelayInSeconds": 489,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-28T06:22:44+00:00"
          }
        }
      }
    ],
    [
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 338,
            "travelTimeInSeconds": 104,
            "trafficDelayInSeconds": 0,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-27T22:57:13+00:00"
          }
        }
      },
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 647494,
            "travelTimeInSeconds": 26763,
            "trafficDelayInSeconds": 469,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-28T06:21:32+00:00"
          }
        }
      }
    ]
  ],
  "summary": {
    "successfulRoutes": 4,
    "totalRoutes": 4
  }
}
Állapotkód:
408 
{
  "error": {
    "code": "408 Timeout",
    "message": "Timeout: The request took longer to finish than the maximum amount of time defined in the api."
  }
}

Definíciók

Name Description
ComputeTravelTime

Meghatározza, hogy a forgalmi adatok különböző típusaival (nincs, történelmi, élő) és az alapértelmezett legjobb becslési utazási idővel adja-e vissza a további utazási időket.
ErrorAdditionalInfo

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

A hiba részletei.
ErrorResponse

Hibaválasz
GeoJsonMultiPoint

Érvényes GeoJSON MultiPoint geometriatípus. Részletekért tekintse meg RFC 7946.
InclineLevel

A dombság foka az izgalmas útvonalhoz. Ez a paraméter csak routeType=izgalmas együtt használható.
JsonFormat

A válasz kívánt formátuma. Csak json formátum támogatott.
RouteAvoidType

Meghatároz valamit, amelyet az útvonalszámításnak el kell kerülnie 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.
RouteLegSummary

Az útvonalszakasz összefoglaló objektuma.
RouteMatrix

Mátrix eredményobjektuma
RouteMatrixQuery

Egy koordináta-mátrixot tartalmazó objektum.
RouteMatrixResult

Ezt az objektumot egy sikeres útvonalmátrix-hívás adja vissza. Ha például 2 forrást és 3 célhelyet adnak meg, akkor 2 tömb lesz, amelyekben 3 elem található. Az egyes elemek tartalma a lekérdezésben megadott beállításoktól függ.
RouteMatrixResultResponse

Az aktuális cella válaszobjektuma a bemeneti mátrixban.
RouteMatrixSummary

Összegző objektum
RouteType

A kért útvonal típusa.
SectionType

Megadja, hogy a szakasztípusok közül melyiket jelenti a rendszer az útvonalválaszban.

Ha például a sectionType = gyalogos, akkor a csak gyalogosoknak megfelelő szakaszok lesznek visszaadva. Egy kérelemben többször is megadható, például : "§ionType=carTrain§ionType=gyalogos§ionType=autópálya". Az alapértelmezett sectionType a travelMode bemenetre hivatkozik. Alapértelmezés szerint a travelMode autóra van állítva
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 é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étaverziós funkciók. A teljes korlátozási adatok nem érhetők el minden területen.
VehicleLoadType

Veszélyes anyagként besorolható és egyes utakról korlátozott rakománytípusok. A rendelkezésre álló vehicleLoadType értékek az US Hazmat 1–9. osztályai, valamint a 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 otherHazmatot minden más országban/régióban használni kell. A vehicleLoadType többször is megadható. Ez a paraméter jelenleg csak a travelMode=truck esetében tekinthető meg.
WindingnessLevel

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

ComputeTravelTime

Enumerálás

Meghatározza, hogy a forgalmi adatok különböző típusaival (nincs, történelmi, élő) és az alapértelmezett legjobb becslési utazási idővel adja-e vissza a további utazási időket.

Érték Description
none

Nem számít ki további utazási időket.
all

Kiszámítja az utazási időket az összes forgalmi információtípushoz, és megadja az összes eredményt a noTrafficTravelTimeInSeconds, a historicTrafficTravelTimeInSeconds és a liveTrafficIncidentsTravelTimeInSeconds mezőkben, amelyek szerepelnek az útvonalválasz összegzéseiben.

ErrorAdditionalInfo

Objektum

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 információtípus.

ErrorDetail

Objektum

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 hibacél.

ErrorResponse

Objektum

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

GeoJsonMultiPoint

Objektum

Érvényes GeoJSON MultiPoint geometriatípus. Részletekért tekintse meg RFC 7946.

Name Típus Description
coordinates

number[] (double)

A GeoJson MultiPoint geometria koordinátái.
type string:

MultiPoint

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.

InclineLevel

Enumerálás

A dombság foka az izgalmas útvonalhoz. Ez a paraméter csak routeType=izgalmas együtt használható.

Érték Description
low

alacsony
normal

normális
high

magas

JsonFormat

Enumerálás

A válasz kívánt formátuma. Csak json formátum támogatott.

Érték Description
json

A JavaScript objektum jelölési adatcseréjének formátuma

RouteAvoidType

Enumerálás

Meghatároz valamit, amelyet az útvonalszámításnak el kell kerülnie 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.

Érték Description
tollRoads

Elkerüli a fizetős utakat.
motorways

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

Elkerüli a kompokat
unpavedRoads

Elkerüli a meg nem ásott utakat
carpools

Elkerüli azokat az útvonalakat, amelyekhez a carpool (HOV/High Occupancy Vehicle) sávok használata szükséges.
alreadyUsedRoads

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

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

RouteLegSummary

Objektum

Az útvonalszakasz összefoglaló objektuma.

Name Típus Description
arrivalTime

string (date-time)

Az útvonal vagy a láb becsült érkezési ideje. Az idő UTC-ben van.
batteryConsumptionInkWh

number (double)

Becsült elektromos energiafogyasztás kilowattóra (kWh) alatt az elektromos fogyasztási modell használatával. Tartalmazza, ha a vehicleEngineType elektromos és constantSpeedConsumptionInkWhPerHundredkm értékre van állítva. Az batteryConsumptionInkWh értéke magában foglalja a visszaszerelt elektromos energiát, ezért negatív lehet (ami az energianövekedést jelzi). Ha a maxChargeInkWh és a currentChargeInkWh is meg van adva, a rendszer leképezi az újrafeltöltést, hogy az akkumulátor töltöttségi szintje soha ne haladja meg a maxChargeInkWh értéket. Ha sem a maxChargeInkWh, sem a currentChargeInkWh nincs megadva, akkor a rendszer nem konvenciókon alapuló újrafelvételt feltételez a felhasználás kiszámításában.
departureTime

string (date-time)

Az útvonal vagy a láb becsült indulási ideje. Az idő UTC-ben van.
fuelConsumptionInLiters

number (double)

Becsült üzemanyag-fogyasztás literben az égési fogyasztási modell használatával. Tartalmazza, ha a vehicleEngineType égési van beállítva, és konstansSpeedConsumptionInLitersPerHundredkm van megadva. Az érték nem lesz negatív.
historicTrafficTravelTimeInSeconds

integer

Az időfüggő korábbi forgalmi adatok alapján kiszámított becsült utazási idő. Csak akkor tartalmazza, ha a computeTravelTimeFor = az összeset használja a lekérdezésben.
lengthInMeters

integer

Hossz a Meters tulajdonságban
liveTrafficIncidentsTravelTimeInSeconds

integer

Valós idejű sebességadatokkal kiszámított becsült utazási idő. Csak akkor tartalmazza, ha a computeTravelTimeFor = az összeset használja a lekérdezésben.
noTrafficTravelTimeInSeconds

integer

Becsült utazási idő úgy számítva, mintha a forgalmi körülmények (pl. torlódás) miatt nem történnek késések az útvonalon. Csak akkor tartalmazza, ha a computeTravelTimeFor = az összeset használja a lekérdezésben.
trafficDelayInSeconds

integer

A valós idejű incidens(ek) által okozott becsült késés másodpercben a forgalmi információk alapján. A jövőben indulási idővel tervezett útvonalak esetében a késés mindig 0. Ha több utazási időt szeretne visszaadni különböző típusú forgalmi adatok használatával, a computeTravelTimeFor=összes paramétert hozzá kell adni.
travelTimeInSeconds

integer

Becsült utazási idő másodpercben tulajdonság, amely magában foglalja a késés miatt valós idejű forgalom. Vegye figyelembe, hogy még akkor is, ha a traffic=false travelTimeInSeconds továbbra is tartalmazza a forgalom miatti késést. Ha a DepartAt a jövőben lesz, az utazási idő az időfüggő korábbi forgalmi adatok alapján lesz kiszámítva.

RouteMatrix

Objektum

Mátrix eredményobjektuma

Name Típus Description
response

RouteMatrixResultResponse

Az aktuális cella válaszobjektuma a bemeneti mátrixban.
statusCode

integer

A bemeneti mátrix aktuális cellájának StatusCode tulajdonsága.

RouteMatrixQuery

Objektum

Egy koordináta-mátrixot tartalmazó objektum.

Name Típus Description
destinations

GeoJsonMultiPoint

Érvényes GeoJSON MultiPoint geometriatípus. Részletekért tekintse meg RFC 7946.
origins

GeoJsonMultiPoint

Érvényes GeoJSON MultiPoint geometriatípus. Részletekért tekintse meg RFC 7946.

RouteMatrixResult

Objektum

Ezt az objektumot egy sikeres útvonalmátrix-hívás adja vissza. Ha például 2 forrást és 3 célhelyet adnak meg, akkor 2 tömb lesz, amelyekben 3 elem található. Az egyes elemek tartalma a lekérdezésben megadott beállításoktól függ.

Name Típus Description
formatVersion

string

Verzió formázása tulajdonság
matrix

RouteMatrix[]

Az eredmények útvonal-összefoglalók 2 dimenziós tömbjeként szolgálnak.
summary

RouteMatrixSummary

Összegző objektum

RouteMatrixResultResponse

Objektum

Az aktuális cella válaszobjektuma a bemeneti mátrixban.

Name Típus Description
routeSummary

RouteLegSummary

Az útvonalszakasz összefoglaló objektuma.

RouteMatrixSummary

Objektum

Összegző objektum

Name Típus Description
successfulRoutes

integer

A válaszban szereplő sikeres útvonalak száma.
totalRoutes

integer

A kért útvonalak teljes száma. A bemeneti mátrix celláinak száma.

RouteType

Enumerálás

A kért útvonal típusa.

Érték Description
fastest

A leggyorsabb út.
shortest

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

A gazdaságosság és a sebesség kiegyensúlyozott útvonala.
thrilling

É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 dombság fokát is. Ennek beállításához tekintse meg a dombossági és tekercselési paramétereket. A tervezett útvonalakon 900 km-es korlát routeType=izgalmas

SectionType

Enumerálás

Megadja, hogy a szakasztípusok közül melyiket jelenti a rendszer az útvonalválaszban.

Ha például a sectionType = gyalogos, akkor a csak gyalogosoknak megfelelő szakaszok lesznek visszaadva. Egy kérelemben többször is megadható, például : "§ionType=carTrain§ionType=gyalogos§ionType=autópálya". Az alapértelmezett sectionType a travelMode bemenetre hivatkozik. Alapértelmezés szerint a travelMode autóra van állítva

Érték Description
carTrain

Az útvonal szakaszai, amelyek autók vagy vonatok.
country

Szakaszok, amelyek jelzik, hogy az útvonal mely országokban/régiókban található.
ferry

A kompok útvonalának szakaszai.
motorway

Az útszakaszok, amelyek autópályák.
pedestrian

Az útvonal azon szakaszai, amelyek csak gyalogosok számára alkalmasak.
tollRoad

Az útvonal azon szakaszai, amelyek díjkötelesek.
tollVignette

Az útvonal azon szakaszai, amelyeknél autópálya-matrica szükséges.
traffic

Az útvonal forgalmi adatokat tartalmazó szakaszai.
travelMode

A kérelemparaméterhez kapcsolódó szakaszok travelMode.
tunnel

Az útvonal alagútszakaszai.
carpool

Az útvonal azon szakaszai, amelyek telekocsi (HOV/Magas kihasználtságú jármű) sávokat igényelnek.
urban

Az útvonalnak a városi területeken belüli szakaszai.

TravelMode

Enumerálás

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 é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étaverziós funkciók. A teljes korlátozási adatok nem érhetők el minden területen.

Érték Description
car

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

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

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

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

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

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

A visszaadott útvonalak kerékpárokra vannak optimalizálva, beleértve a kerékpársávok használatát is.
pedestrian

A visszaadott útvonalak a gyalogosok számára vannak optimalizálva, beleértve a járdák használatát is.

VehicleLoadType

Enumerálás

Veszélyes anyagként besorolható és egyes utakról korlátozott rakománytípusok. A rendelkezésre álló vehicleLoadType értékek az US Hazmat 1–9. osztályai, valamint a 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 otherHazmatot minden más országban/régióban használni kell. A vehicleLoadType többször is megadható. Ez a paraméter jelenleg csak a travelMode=truck esetében tekinthető meg.

É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

WindingnessLevel

Enumerálás

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

Érték Description
low

alacsony
normal

normális
high

magas