Route - Post Route Matrix

Szolgáltatás:: Maps

API-verzió:: 2025-01-01

A Route Matrix API egy HTTP-POST-kérés, amely lehetővé teszi az útvonal-összefoglalók mátrixának kiszámítását a forrás- és célhelyek által meghatározott útvonalakhoz egy szinkronizálási kérelem használatával. 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. Az útválasztási mátrixok kiszámolhatók a vezetés, a gyalogos és a teherautós útvonalak esetében. Egy ételkézbesítési vállalatnak például 20 sofőrje van, és meg kell találniuk a legközelebbi sofőrt, aki felveszi a szállítást az étteremből. Ennek a használati esetnek a megoldásához meghívhatják a Route Matrix API-t, és az utazási költséggel rendezhetik a sofőröket az étteremtől való tényleges utazási távolságuk vagy idejük alapján.

Az útválasztási mátrixokat számos különböző típusú alkalmazásban használják, leggyakrabban az utazó értékesítői probléma (TSP) és a jármű-útválasztási probléma (VRP) megoldására. A mátrixban szereplő egyes forrás-cél párok esetében a rendszer visszaadja az utazási időt és a távolságot. 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.

A szinkronizálási kérelem mátrixának maximális mérete 2500 (a források száma és a célhelyek számának szorzata).

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ő 2500-nál, érdemes lehet szinkron kérést készíteni. Az API-hoz tartozó mátrix maximális mérete 2500 (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: 50x50, 60x40, 90x20 (nem kell négyzetnek lennie).

API-korlátozások

A mátrix szinkron feldolgozása a legjobban alkalmas az útvonalszámítás gyors, kis mátrixainak elvégzésére. A nagyobb mátrixok és a nehéz útvonalak kiszámításához használja az aszinkron végpontot. A szinkron kérelmekre az alábbi korlátozás vonatkozik. Ha a következő táblázat egyik sora sem felel meg a kérelem paramétereinek, a kérés nem felel meg a követelményeknek, és nem lesz feldolgozva.

| Maximális mátrix méret | Maximális számú eredet | A célállomások maximális száma | További korlátok

|------------------|------------------------|----------------------------|------------| | 100 | 100 | 100 | N/A | | 200 | 200 | 200 | Minden kiindulást és célállomást egy tengely irányú 400 km x 400 km-es határmezőben kell tárolni. Ellenkező esetben egyes mátrixcellák OUT_OF_REGION lesznek feloldva. | | 2500 | 1000 | 1000 | - Vagy departAtarriveAt biztosan bármi van.
- traffic előzménynek kell lennie.
- travelMode kell vezetni vagy teherautó
- Más paraméterek nem használhatók kifejezetten |

Példák:

10x20-as mátrix kérése traffic=live: Ezt a kérést a rendszer egy határolókeret-korláttal dolgozza fel, mivel az legfeljebb 200 korlátnak felel meg, beleértve a határolókeret-korlátozásokat is.
10x20-as mátrix kérése alapértelmezett paraméterekkel (traffic=historical): Ezt a kérést a rendszer határolókeret-korlát nélkül dolgozza fel, mivel az legfeljebb 2500 korlátnak felel meg, ami nem ír elő határolókeret-korlátozásokat.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string
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
features	True	InputRouteMatrixFeaturesItem[]	A bemeneti mátrix GeoJSON MultiPoint-funkcióiként átadott forrás- és célpontok halmaza. A GeoJSON formátummal kapcsolatos részletekért tekintse meg az RFC 7946-ot .
type	True	FeatureTypeEnum	Megadja a `GeoJSON` típusát. Az egyetlen támogatott objektumtípus a `FeatureCollection`. További információ: RFC 7946.
arriveAt		string (date-time)	A célpontra való érkezés dátuma és időpontja `dateTime`RFC 3339, 5.6. szakasz. Ha nincs megadva időzóna-eltolás, a rendszer az UTC-t feltételezi. A `arriveAt` paraméter nem használható `departAt`. A `arriveAtany` értéket is támogat, amely a használati esethez igazodik, ahol az időkörnyezet irreleváns. A `traffic=live` paraméter értéke nem használható `any`együtt. Alapértelmezett érték: `any`, ha nincs megadva `arriveAt`. Példa: "arriveAt": "2024-12-01T09:30:00.000-07:00"
avoid		RouteMatrixAvoidEnum[]	Meghatározza azokat a korlátozásokat, amelyeket az útvonal számításának figyelembe kell vennie az útvonal meghatározásakor. Kerülje a több érték használatát egy kérelemben, és csak a vezetés és a teherautó travelMode esetében támogatott.
departAt		string (date-time)	A kiindulási ponttól való eltérés dátuma és időpontja `dateTime`RFC 3339, 5.6. Ha nincs megadva időzóna-eltolás, a rendszer az UTC-t feltételezi. A `departAt` paraméter nem használható `arriveAt`. A `departAt` a következőket is támogatja: `any` használati esethez igazított érték, ahol az időkörnyezet irreleváns. A `traffic=live` paraméter értéke nem használható `any`együtt. `now` értéket, amely az indulási időt az egyes cellák feldolgozási idejére állítja. A feldolgozási idő a beküldés és a befejezés között bármikor előfordulhat. Ez a mód a traffic=live szolgáltatással együtt használható legjobban. Alapértelmezett érték: `any`, ha nincs megadva `departAt`. Példa: "departAt": "2024-12-01T09:30:00.000-07:00"
optimizeRoute		RouteMatrixOptimizeRouteEnum	Megadja az útvonal optimalizálásához használandó paramétert. Ha nincs megadva, az alapértelmezett érték a "leggyorsabb", amely visszaadja az útvonalat az utazási idő minimalizálása érdekében. Példa: "optimizeRoute":"leggyorsabb"
traffic		RouteMatrixTrafficEnum	Meghatározza, hogy a forgalom hogyan legyen figyelembe véve a számítási útvonalak esetében. Alapértelmezett érték: `historical`
travelMode		RouteMatrixTravelModeEnum	Megadja a mátrix 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		RouteMatrixVehicleSpec	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 útvonalmátrix kiszámításakor. Ez segít elkerülni az alacsony hídhézagokat, az útkorlátozásokat, a nehéz jobbra fordulásokat, hogy a jármű specifikációi alapján optimalizált útvonalat biztosítson. A járműattribútumok a vehicleSpec tulajdonságban vannak megadva.

Válaszok

Name	Típus	Description
200 OK	RouteMatrixResponse	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

RouteMatrixResponse

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ási alap hozzáférést kaphat beépített szerep vagy egy egyedi szerep révén, amely egy vagy több jogosultságot tartalmaz a REST API-k Azure Maps használatához.\n\nForgatókönyvek megvalósításához javasoljuk a authentication concepts megtekintését. Összefoglalva, ez a biztonsági definíció megoldást kínál alkalmazások modellezésére olyan objektumokon keresztül, amelyek képesek hozzáférés-vezérlésre bizonyos API-kon és scope-kon.\n\n#### Jegyzetek\n* Ez a biztonsági definíció c0 a x-ms-client-id fejléc használatát követeli annak megmutatására, hogy melyik Azure Maps erőforráshoz kér hozzáférést az alkalmazás. Ez a Maps menedzsment API segítségével szerezhető be.\n* \nAz Authorization URL specifikusan a Azure nyilvános felhő példányra vonatkozik. A szuverén felhők egyedi Authorization URL-ekkel és Microsoft Entra ID konfigurációkkal rendelkeznek. \n* \nAz Azure szerepalapú hozzáférés-vezérlés a Azure menedzsment síkról konfigurálható Azure portálon, PowerShellen, CLI-n, Azure SDK-k vagy REST API-kon keresztül.\n* \nA Azure Maps Web SDK lehetővé teszi az alkalmazás konfigurációs beállítását több felhasználási esetre.\n* További információért Microsoft Identitásplatform lásd: Microsoft Identitásplatform áttekintés.

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, amelyet akkor állítanak ki, amikor fiókot hozol létre a Azure portálban, vagy PowerShell, CLI, Azure SDK-k vagy REST API használatával.\n\n Ezzel a kulmillal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval, ez a kulcs főkulcsként használható abban a számlán, ahol a kiadott fiók van.\n\n Nyilvánosan elérhető alkalmazások esetén javasoljuk, hogy a confidential kliens alkalmazások megközelítést használd Azure Maps REST API-khoz, hogy a kulcsod biztonságosan tárolható legyen.

Típus: apiKey
In: header

SAS Token

Ez egy közös hozzáférésű aláírási token, amelyet a List SAS műveletből hoznak létre a Azure Maps resource a Azure menedzsment síkon keresztül Azure portálon, PowerShellen, CILI-n, Azure SDK-k vagy REST API-kon keresztül.\n\n Ezzel a tokenrel bármely alkalmazás jogosult hozzáférésre Azure szerepalapú hozzáférési kontrollok és finom szemcsés kontroll az adott token lejárati idejére, rátájára és használatára vonatkozó régió(k)ra. Más szóval, a SAS Token lehetővé teszi az alkalmazások számára, hogy biztonságosabb módon irányítsák a hozzáférést, mint a megosztott kulcs.\n\n Nyilvánosan elérhető alkalmazások esetén javasoljuk, hogy állítsunk be egy specifikus engedélyezett eredetlistát a Map fiók erőforráson , hogy csökkentsük a renderelési visszaéléseket, és rendszeresen frissítsük a SAS Tokent.

Típus: apiKey
In: header

Példák

Successfully retrieve a route matrix with additional parameters in the body

Mintakérelem

HTTP

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

{
  "type": "FeatureCollection",
  "avoid": [
    "unpavedRoads"
  ],
  "departAt": "2022-12-19T16:39:57+01:00",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "MultiPoint",
        "coordinates": [
          [
            9.15049,
            45.458545
          ],
          [
            11.050541,
            45.403337
          ]
        ]
      },
      "properties": {
        "pointType": "origins"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "MultiPoint",
        "coordinates": [
          [
            11.499931,
            48.149853
          ],
          [
            14.538226,
            50.033688
          ]
        ]
      },
      "properties": {
        "pointType": "destinations"
      }
    }
  ],
  "optimizeRoute": "fastest",
  "traffic": "historical",
  "travelMode": "truck"
}

Mintaválasz

Állapotkód:: 200

{
  "type": "Feature",
  "geometry": null,
  "properties": {
    "matrix": [
      {
        "arrivalAt": "2022-12-19T22:30:03+01:00",
        "departureAt": "2022-12-19T16:39:57+01:00",
        "destinationIndex": 0,
        "distanceInMeters": 492466,
        "durationInSeconds": 21007,
        "durationTrafficInSeconds": 21007,
        "originIndex": 0,
        "statusCode": 200
      },
      {
        "arrivalAt": "2022-12-20T02:00:19+01:00",
        "departureAt": "2022-12-19T16:39:57+01:00",
        "destinationIndex": 1,
        "distanceInMeters": 877028,
        "durationInSeconds": 33623,
        "durationTrafficInSeconds": 33623,
        "originIndex": 0,
        "statusCode": 200
      },
      {
        "arrivalAt": "2022-12-19T22:05:16+01:00",
        "departureAt": "2022-12-19T16:39:57+01:00",
        "destinationIndex": 0,
        "distanceInMeters": 427769,
        "durationInSeconds": 19520,
        "durationTrafficInSeconds": 19520,
        "originIndex": 1,
        "statusCode": 200
      },
      {
        "arrivalAt": "2022-12-20T01:34:27+01:00",
        "departureAt": "2022-12-19T16:39:57+01:00",
        "destinationIndex": 1,
        "distanceInMeters": 836080,
        "durationInSeconds": 32070,
        "durationTrafficInSeconds": 32070,
        "originIndex": 1,
        "statusCode": 200
      }
    ],
    "summary": {
      "successfulCount": 4,
      "totalCount": 4
    }
  }
}

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.
CommonErrorDetail	A hiba részletei.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
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.
GeoJsonMultiPoint	Érvényes `GeoJSON MultiPoint` geometriatípus. Részletekért tekintse meg 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.
InputRouteMatrixFeaturesItem	Megadja a `GeoJSON` MultiPoint-funkcióobjektum bemeneti forrás- és célpontjait, valamint további tulajdonságait. Részletekért tekintse meg RFC 7946.
InputRouteMatrixProperties	Megadja a bemeneti mátrix tulajdonságobjektumát.
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.
RouteMatrixAvoidEnum	Meghatározza azokat a korlátozásokat, amelyeket az útvonal számításának figyelembe kell vennie az útvonal meghatározásakor. Kerülje a több érték használatát egy kérelemben, és csak a vezetés és a teherautó travelMode esetében támogatott.
RouteMatrixFeatureProperties	Útvonalmátrix tulajdonságai.
RouteMatrixItemResult	Útvonalmátrix-elem eredménye
RouteMatrixOptimizeRouteEnum	Megadja az útvonal optimalizálásához használandó paramétert. Ha nincs megadva, az alapértelmezett érték a "leggyorsabb", amely visszaadja az útvonalat az utazási idő minimalizálása érdekében. Példa: "optimizeRoute":"leggyorsabb"
RouteMatrixRequest	Egy útvonalmátrix lekérésére használható, amely megjeleníti az összes lehetséges pár utazási idejét és távolságát a forrás- és céllistában. `GeoJSON` funkcióobjektumot és további tulajdonságokat. Részletekért tekintse meg RFC 7946.
RouteMatrixResponse	Ezt az objektumot egy sikeres hívás adja vissza.
RouteMatrixSummary	Az útvonalmátrix-kérelem összegzése
RouteMatrixTrafficEnum	Meghatározza, hogy a forgalom hogyan legyen figyelembe véve a számítási útvonalak esetében. Alapértelmezett érték: `historical`
RouteMatrixTravelModeEnum	Megadja a mátrix 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"
RouteMatrixTypeEnum	Megadja a forrás MultiPoint-típusát és a cél MultiPoint-típusát a bemeneti mátrixhoz.
RouteMatrixVehicleSpec	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 útvonalmátrix kiszámításakor. Ez segít elkerülni az alacsony hídhézagokat, az útkorlátozásokat, a nehéz jobbra fordulásokat, hogy a jármű specifikációi alapján optimalizált ú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.

CommonErrorDetail

Tárgy

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	CommonErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorAdditionalInfo

Tárgy

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.

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.

GeoJsonMultiPoint

Tárgy

É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.

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.

InputRouteMatrixFeaturesItem

Tárgy

Megadja a GeoJSON MultiPoint-funkcióobjektum bemeneti forrás- és célpontjait, valamint további tulajdonságait. Részletekért tekintse meg RFC 7946.

Name	Típus	Description
geometry	GeoJsonMultiPoint	Érvényes `GeoJSON MultiPoint` geometriatípus. Részletekért tekintse meg RFC 7946.
properties	InputRouteMatrixProperties	MultiPoint-funkciótulajdonság-objektum, amely meghatározza a bemeneti mátrix forrás- és célfunkcióit.
type	FeaturesItemTypeEnum	Megadja a `GeoJSON` típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

InputRouteMatrixProperties

Tárgy

Megadja a bemeneti mátrix tulajdonságobjektumát.

Name	Típus	Description
pointType	RouteMatrixTypeEnum	Megadja a forrás MultiPoint-típusát és a cél MultiPoint-típusát a bemeneti mátrixhoz.

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.

RouteMatrixAvoidEnum

Felsorolás

Meghatározza azokat a korlátozásokat, amelyeket az útvonal számításának figyelembe kell vennie az útvonal meghatározásakor. Kerülje a több érték használatát egy kérelemben, és csak a vezetés és a teherautó travelMode esetében támogatott.

Érték	Description
tollRoads	Elkerüli az útdíjköteles utak használatát az útvonalon.
unpavedRoads	Elkerüli a fel nem ásott utakat az útvonalon.

RouteMatrixFeatureProperties

Tárgy

Útvonalmátrix tulajdonságai.

Name	Típus	Description
matrix	RouteMatrixItemResult[]	Az útvonaleredmények mátrixa.
summary	RouteMatrixSummary	Az útvonalmátrix-kérelem összegzése

RouteMatrixItemResult

Tárgy

Útvonalmátrix-elem eredménye

Name	Típus	Description
arrivalAt	string (date-time)	A becsült érkezési idő, amely figyelembe veszi a forgalmi feltételeket, `dateTime` értékként van formázva, amelyet RFC 3339, 5.6 szakasz. A `departAt` vagy `arrivalAt`által eltolt időzónára hivatkozik. Ha nem, akkor az UTC idő lesz használva. Ha a departAt vagy a arriveAt értéke bármelyik, akkor a departureAt hiányzik.
departureAt	string (date-time)	A becsült indulási idő, amely figyelembe veszi a forgalmi feltételeket, `dateTime` a RFC 3339 5.6. A `departAt` vagy `arrivalAt`által eltolt időzónára hivatkozik. Ha nem, akkor az UTC idő lesz használva. Ha departAt vagy arriveAt , `any`akkor a departureAt hiányzik.
destinationIndex	integer (int32)	A célpont indexe
distanceInMeters	number (double)	Hossz a Meters tulajdonságban
durationInSeconds	integer (int64)	Becsült utazási idő másodpercben, amely nem tartalmaz késést az útvonalon a forgalmi feltételek miatt.
durationTrafficInSeconds	integer (int64)	A megfelelő `TravelDistance` az aktuális forgalmi feltételekkel való utazás másodpercek alatt megtelik. Ez az érték akkor adható meg, ha `optimizeRoute` forgalmi szempontokat is figyelembe kell vennie.
error	CommonErrorDetail	A hiba részletei.
originIndex	integer (int32)	A forráspont indexe
statusCode	integer (int32)	Az aktuális cella HTTP-állapotkódja.

RouteMatrixOptimizeRouteEnum

Felsorolás

Megadja az útvonal optimalizálásához használandó paramétert. Ha nincs megadva, az alapértelmezett érték a "leggyorsabb", amely visszaadja az útvonalat az utazási idő minimalizálása érdekében.

Példa: "optimizeRoute":"leggyorsabb"

Érték Description

fastest

Érték	Description
fastest	Megkeresi a leggyorsabb útvonalat az útvonal utazási idő szerinti optimalizálásához. Az Útvonalmátrix szinkronizálási API csak `fastest` támogatott. A többi típus használatához ellenőrizze a Route Matrix async API-t.

Megkeresi a leggyorsabb útvonalat az útvonal utazási idő szerinti optimalizálásához.

Az Útvonalmátrix szinkronizálási API csak fastest támogatott. A többi típus használatához ellenőrizze a Route Matrix async API-t.

RouteMatrixRequest

Tárgy

Egy útvonalmátrix lekérésére használható, amely megjeleníti az összes lehetséges pár utazási idejét és távolságát a forrás- és céllistában. GeoJSON funkcióobjektumot és további tulajdonságokat. Részletekért tekintse meg RFC 7946.

Name	Típus	Alapértelmezett érték	Description
arriveAt	string (date-time)		A célpontra való érkezés dátuma és időpontja `dateTime`RFC 3339, 5.6. szakasz. Ha nincs megadva időzóna-eltolás, a rendszer az UTC-t feltételezi. A `arriveAt` paraméter nem használható `departAt`. A `arriveAtany` értéket is támogat, amely a használati esethez igazodik, ahol az időkörnyezet irreleváns. A `traffic=live` paraméter értéke nem használható `any`együtt. Alapértelmezett érték: `any`, ha nincs megadva `arriveAt`. Példa: "arriveAt": "2024-12-01T09:30:00.000-07:00"
avoid	RouteMatrixAvoidEnum[]		Meghatározza azokat a korlátozásokat, amelyeket az útvonal számításának figyelembe kell vennie az útvonal meghatározásakor. Kerülje a több érték használatát egy kérelemben, és csak a vezetés és a teherautó travelMode esetében támogatott.
departAt	string (date-time)		A kiindulási ponttól való eltérés dátuma és időpontja `dateTime`RFC 3339, 5.6. Ha nincs megadva időzóna-eltolás, a rendszer az UTC-t feltételezi. A `departAt` paraméter nem használható `arriveAt`. A `departAt` a következőket is támogatja: `any` használati esethez igazított érték, ahol az időkörnyezet irreleváns. A `traffic=live` paraméter értéke nem használható `any`együtt. `now` értéket, amely az indulási időt az egyes cellák feldolgozási idejére állítja. A feldolgozási idő a beküldés és a befejezés között bármikor előfordulhat. Ez a mód a traffic=live szolgáltatással együtt használható legjobban. Alapértelmezett érték: `any`, ha nincs megadva `departAt`. Példa: "departAt": "2024-12-01T09:30:00.000-07:00"
features	InputRouteMatrixFeaturesItem[]		A bemeneti mátrix GeoJSON MultiPoint-funkcióiként átadott forrás- és célpontok halmaza. A GeoJSON formátummal kapcsolatos részletekért tekintse meg az RFC 7946-ot .
optimizeRoute	RouteMatrixOptimizeRouteEnum	fastest	Megadja az útvonal optimalizálásához használandó paramétert. Ha nincs megadva, az alapértelmezett érték a "leggyorsabb", amely visszaadja az útvonalat az utazási idő minimalizálása érdekében. Példa: "optimizeRoute":"leggyorsabb"
traffic	RouteMatrixTrafficEnum	historical	Meghatározza, hogy a forgalom hogyan legyen figyelembe véve a számítási útvonalak esetében. Alapértelmezett érték: `historical`
travelMode	RouteMatrixTravelModeEnum	driving	Megadja a mátrix 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"
type	FeatureTypeEnum		Megadja a `GeoJSON` típusát. Az egyetlen támogatott objektumtípus a `FeatureCollection`. További információ: RFC 7946.
vehicleSpec	RouteMatrixVehicleSpec		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 útvonalmátrix kiszámításakor. Ez segít elkerülni az alacsony hídhézagokat, az útkorlátozásokat, a nehéz jobbra fordulásokat, hogy a jármű specifikációi alapján optimalizált útvonalat biztosítson. A járműattribútumok a vehicleSpec tulajdonságban vannak megadva.

RouteMatrixResponse

Tárgy

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

Name	Típus	Description
geometry		A geometriai objektum null értékű
properties	RouteMatrixFeatureProperties	Útvonalmátrix tulajdonságai.
type	FeaturesItemTypeEnum	Megadja a `GeoJSON` típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

RouteMatrixSummary

Tárgy

Az útvonalmátrix-kérelem összegzése

Name	Típus	Description
successfulCount	integer (int32)	A mátrixon belüli sikeres útvonalak száma.
totalCount	integer (int32)	A mátrixon belüli útvonalak teljes száma.

RouteMatrixTrafficEnum

Felsorolás

Meghatározza, hogy a forgalom hogyan legyen figyelembe véve a számítási útvonalak esetében.

Alapértelmezett érték: historical

Érték Description

historical

Érték	Description
historical	Az útvonalszámítás figyelembe veszi a korábbi utazási időket és a hosszú távú lezárásokat. Az utazási idő alatt a forgalmi dugók és a rövid távú lezárások nem befolyásolják az útválasztást és az utazási időt.
live	A korábbi utazási idők mellett az útvonal számítása a forgalmi dugókat és a rövid és hosszú távú lezárásokat is figyelembe veszi az utazási idő alatt. `Note`: `traffic=live` nem használható `arriveAt=any` és `departAt=any`

Az útvonalszámítás figyelembe veszi a korábbi utazási időket és a hosszú távú lezárásokat. Az utazási idő alatt a forgalmi dugók és a rövid távú lezárások nem befolyásolják az útválasztást és az utazási időt.

live

A korábbi utazási idők mellett az útvonal számítása a forgalmi dugókat és a rövid és hosszú távú lezárásokat is figyelembe veszi az utazási idő alatt.

Note: traffic=live nem használható arriveAt=any és departAt=any

RouteMatrixTravelModeEnum

Felsorolás

Megadja a mátrix 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	A személygépkocsikhoz alkalmas útválasztási profil az útvonalmátrix kiszámításához használható.
truck	A haszongépjárművek, például teherautók útválasztási profilja az útvonalmátrix kiszámításához használatos.
walking	A visszaadott útvonalak a gyalogosok számára vannak optimalizálva, beleértve a járdák használatát is.

RouteMatrixTypeEnum

Felsorolás

Megadja a forrás MultiPoint-típusát és a cél MultiPoint-típusát a bemeneti mátrixhoz.

Érték	Description
origins	A bemeneti mátrix forráshelyeit meghatározó MultiPoint-funkciók.
destinations	A bemeneti mátrix célhelyeit meghatározó MultiPoint-funkciók.

RouteMatrixVehicleSpec

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 útvonalmátrix kiszámításakor. Ez segít elkerülni az alacsony hídhézagokat, az útkorlátozásokat, a nehéz jobbra fordulásokat, hogy a jármű specifikációi alapján optimalizált ú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.
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	Miscellaneous
otherHazmatExplosive	Robbanóanyagok
otherHazmatGeneral	Miscellaneous
otherHazmatHarmfulToWater	Káros a vízre