Route - Post Directions

Szolgáltatás:

Maps

API-verzió:

2023-10-01-preview

Segítségével a legjobb útvonalat a forrás és a cél között autó, haszongépjárművek és gyalogos útvonalak.

Jegyzet

Azure Maps Route 2023-10-01-preview szolgáltatás kivonása

A Azure Maps Route 2023-10-01-preview verziója már elavult, és 2025.07.31-én megszűnik. A szolgáltatáskimaradások elkerülése érdekében a Route 2023-10-01-preview verziójú szolgáltatás összes hívását frissíteni kell a Route API legújabb verziójának használatára 2025.07.31-ig.

A Route Directions API egy HTTP-POST kérés, amely az ideális útvonalat adja vissza az autós (vezetés), a haszongépjárművek és a gyalogos útvonalak származási helye és célja között. Az útvonal több útponton halad át, ha meg van adva. A waypoint egy földrajzi hely, amelyet a hosszúság és a szélesség határoz meg, és amelyet navigációs célokra használnak. Az útvonal figyelembe veszi az olyan tényezőket, mint a jelenlegi forgalom és a hét kért napján és napközbeni átlagos közúti sebesség.

Az API visszaadja a távolságot, a becsült utazási időt és az útvonalgeometria ábrázolását. A használt paraméterektől függően további útválasztási információk, például optimalizált útválasztási sorrend vagy turn by turn utasítások is elérhetők.

Az Útvonalirányok figyelembe veszi a helyi jogszabályokat, a jármű méreteit, a rakomány típusát, a maximális sebességet, a hidat és az alagút magasságát, hogy kiszámítsa a teherautó-specifikus útvonalakat, és elkerülje az összetett manővereket és a nehéz utakat. A jármű profilja vagy rakománytípusa alapján bizonyos korlátozások miatt nem minden teherautó utazhat ugyanazon az útvonalon, mint a többi jármű. Az autópályákon például gyakran külön sebességkorlátozások vonatkoznak a teherautókra, egyes utak nem teszik lehetővé a tűzveszélyes vagy veszélyes anyagokkal rendelkező teherautókat, és a hidakon magasság- és súlykorlátozás is előfordulhat.

A két útpont között legfeljebb 25 útpont és 10 viaWaypoint használható a vezetéshez és a gyalogos útvonalakhoz. Minden útpontcsoport külön útvonal-lábat hoz létre. A ViaWaypoints definiálja az útvonal elérési útját, és adott helyeken keresztüli útvonallétrehozáshoz használható, de nem hoz létre útvonallábakat. A teherautó-útvonalak legfeljebb 150 útpontot támogatnak, de a ViaWaypoints nem támogatják.

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

Fontos

Ezzel a funkcióval elfogadja az előzetes verziójú jogi feltételeket. További információ: előzetes verziójú kiegészítő feltételek.

POST https://atlas.microsoft.com/route/directions?api-version=2023-10-01-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
api-version	query	True	string	Az Azure Maps API verziószáma.

Kérelem fejléce

Media Types: "application/geo+json"

Name	Kötelező	Típus	Description
x-ms-client-id		string	Megadja, hogy melyik fiók legyen a Microsoft Entra ID biztonsági modellel együtt használva. Az Azure Maps-fiók egyedi azonosítóját jelöli, amely az Azure Maps felügyeleti sík fiók API-jából kérhető le. A Microsoft Entra ID-biztonság Azure Mapsben való használatához az alábbi cikkeket útmutatásért.
Accept-Language		string	Nyelv, amelyben az útválasztási eredményeket vissza kell adni. További információ: Honosítás támogatása az Azure Maps.

Kérelem törzse

Media Types: "application/geo+json"

Name	Kötelező	Típus	Description
features	True	InputWaypointFeaturesItem[]	A vezetési és a gyalogos útvonalakat útpontok(megállók) és viaWaypointok (köztes helyek) határozzák meg, amelyeken az útvonalnak áthaladnia kell. Az egyes útpontok között legfeljebb 25 útpont és legfeljebb 10 viaWaypoint lehet. A teherautó-útvonal legfeljebb 150 útpontot támogat, és a viaWaypointok nem támogatottak. Az útvonalaknak legalább 2 útponttal kell rendelkezniük, és az útvonal kezdő és végpontjai nem lehetnek viaWaypoint-pontok. A waypoint és a viaWaypoint helyeket érvényes GeoJSON-pont funkcióobjektumként kell megadni, valamint a helyek sorrendjét meghatározó PointIndexet. További információ a GeoJSON formátumról: RFC 7946.
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 dateTimeRFC 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. Példa: "arriveAt": "2023-06-01T09:30:00.000-07:00"
avoid		Avoid[]	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. Például: "avoid": ["limitedAccessHighways", "tolls"]
departAt		string (date-time)	A kiindulási ponttól való eltérés dátuma és időpontja dateTimeRFC 3339, 5.6. Ha nincs megadva időzóna-eltolás, a rendszer az UTC-t feltételezi. Példa: "departAt": "2023-06-01T09:30:00.000-07:00"
heading		integer (int64) minimum: 0 maximum: 359	A jármű kezdeti iránya fokban, a valódi északi iránytól indulva és az óramutató járásával megegyező irányban haladva. Észak 0 fok, keleten 90 fok, délen 180 fok, nyugaton 270 fok. Lehetséges értékek 0–359
maxRouteCount		integer (int64) minimum: 1 maximum: 3	A visszaútvonalak maximális száma. Autós és teherautós utazási módokhoz is elérhető. A vezetési útvonalak esetében ez a paraméter a forrás és a cél mellett legfeljebb két útponttal rendelkező útvonalakat is támogat, és az elkerülő paramétert nem szabad beállítani. Alapértelmezett: "maxRouteCount":1 Minimum: "maxRouteCount":1 Maximum: "maxRouteCount":3
optimizeRoute		OptimizeRoute	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"
optimizeWaypointOrder		boolean	Rendezze újra az útvonalpontokat egy gyors heurisztikus algoritmussal az optimalizáló paraméterrel megadott útvonalköltség csökkentése érdekében. A forrás és a cél ki van zárva az optimalizált útpontból, és a helyzetük rögzítettnek minősül. Az elfogadható értékek igazak vagy hamisak. Note: Csak a truck travelMode esetében támogatott.
routeOutputOptions		RouteOutputOption[]	Adja meg a kívánt útvonaladatokat a válaszból. Alapértelmezés szerint az útvonal szerepel a válaszban. Több értéket támogat, például a "routeOutputOptions": ["routePath", "regionTravelSummary"]
travelMode		TravelMode	A kért útvonal utazási módja. Ha nincs meghatározva, az alapértelmezett érték a "vezetés", amely az autókra optimalizált útvonalat adja vissza. Note: A kamionos travelMode esetében előfordulhat, hogy a kért teherautó-útvonal nem érhető el a teljes útvonalon. Ha a kamion útvonala nem érhető el egy adott szakaszhoz, az adott szakasz válaszának travelMode eleme "egyéb" lesz. Példa: "travelMode":"vezetés"
vehicleSpec		VehicleSpec	Meghatározza a jármű attribútumait, például a méretet, a súlyt, a maximális sebességet, a rakomány típusát csak a teherautó-útválasztáshoz. 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. Note: Csak a truck travelMode esetében támogatott

Válaszok

Name	Típus	Description
200 OK	RouteDirectionsResponse	OKÉ Media Types: "application/geo+json", "application/json"
Other Status Codes	MapsErrorResponse	Váratlan hiba történt. Media Types: "application/geo+json", "application/json" Fejlécek x-ms-error-code: string

Biztonság

AADToken

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

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

Jegyzet

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

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

Hatókörök

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

subscription-key

Ez egy megosztott kulcs, amely akkor jön létre, ha Azure Maps-erőforrást hoz létre az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül.

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

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

Típus: apiKey
In: header

SAS Token

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

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

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

Típus: apiKey
In: header

Példák

Successfully retrieve a route between an origin and a destination with additional parameters in the body

Mintakérelem

HTTP

POST https://atlas.microsoft.com/route/directions?api-version=2023-10-01-preview

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.201399,
          47.608678
        ],
        "type": "Point"
      },
      "properties": {
        "pointIndex": 0,
        "pointType": "waypoint"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.20687,
          47.612002
        ],
        "type": "Point"
      },
      "properties": {
        "pointIndex": 1,
        "pointType": "viaWaypoint"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.201669,
          47.615076
        ],
        "type": "Point"
      },
      "properties": {
        "pointIndex": 2,
        "pointType": "waypoint"
      }
    }
  ],
  "optimizeRoute": "fastestWithTraffic",
  "routeOutputOptions": [
    "routePath"
  ],
  "maxRouteCount": 3,
  "travelMode": "driving"
}

Mintaválasz

Állapotkód:

200

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.20147,
          47.608676
        ]
      },
      "properties": {
        "type": "Waypoint",
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 0
        },
        "order": {
          "inputIndex": 0
        },
        "compassDirection": "north",
        "instruction": {
          "formattedText": "<Action>Head</Action> <CmpsDir>north</CmpsDir> on <RoadName>Bellevue Way SE</RoadName> toward <Toward>SE 1st St</Toward>",
          "maneuverType": "DepartStart",
          "text": "Head north on Bellevue Way SE toward SE 1st St"
        },
        "sideOfStreet": "Unknown",
        "towardsRoadName": "SE 1st St",
        "distanceInMeters": 98.2,
        "durationInSeconds": 19,
        "steps": [
          {
            "routePathRange": {
              "legIndex": 0,
              "range": [
                0,
                1
              ]
            },
            "maneuverType": "DepartStart",
            "compassDegrees": 358,
            "roadType": "Arterial",
            "names": [
              "Bellevue Way SE"
            ]
          }
        ],
        "travelMode": "driving"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.201495,
          47.610109
        ]
      },
      "properties": {
        "type": "ManeuverPoint",
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 1
        },
        "compassDirection": "north",
        "instruction": {
          "formattedText": "<Action>Turn</Action> <TurnDir>left</TurnDir> onto <RoadName>Main st</RoadName>",
          "maneuverType": "TurnLeft",
          "text": "Turn left onto Main st"
        },
        "sideOfStreet": "Unknown",
        "distanceInMeters": 253.5,
        "durationInSeconds": 81,
        "steps": [
          {
            "routePathRange": {
              "legIndex": 0,
              "range": [
                1,
                3
              ]
            },
            "maneuverType": "TurnLeft",
            "compassDegrees": 358,
            "roadType": "Arterial",
            "names": [
              "Main st"
            ]
          }
        ],
        "travelMode": "driving"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.206817,
          47.610185
        ]
      },
      "properties": {
        "type": "ManeuverPoint",
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 3
        },
        "compassDirection": "north",
        "instruction": {
          "formattedText": "<Action>Turn</Action> <TurnDir>right</TurnDir> onto <RoadName>100th Ave NE</RoadName>",
          "maneuverType": "TurnRight",
          "text": "Turn right onto 100th Ave NE"
        },
        "sideOfStreet": "Unknown",
        "distanceInMeters": 252.9,
        "durationInSeconds": 49,
        "steps": [
          {
            "routePathRange": {
              "legIndex": 0,
              "range": [
                3,
                5
              ]
            },
            "maneuverType": "TurnRight",
            "compassDegrees": 357,
            "roadType": "Arterial",
            "names": [
              "100th Ave NE"
            ]
          }
        ],
        "travelMode": "driving"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.206971,
          47.61384
        ]
      },
      "properties": {
        "type": "ManeuverPoint",
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 6
        },
        "compassDirection": "east",
        "instruction": {
          "formattedText": "<Action>Turn</Action> <TurnDir>right</TurnDir> onto <RoadName>NE 4th St</RoadName>",
          "maneuverType": "TurnRight",
          "text": "Turn right onto NE 4th St"
        },
        "sideOfStreet": "Unknown",
        "distanceInMeters": 247.9,
        "durationInSeconds": 77,
        "steps": [
          {
            "routePathRange": {
              "legIndex": 0,
              "range": [
                6,
                9
              ]
            },
            "maneuverType": "TurnRight",
            "compassDegrees": 90,
            "roadType": "Arterial",
            "names": [
              "NE 4th St"
            ]
          }
        ],
        "travelMode": "driving"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.201664,
          47.61386
        ]
      },
      "properties": {
        "type": "ManeuverPoint",
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 9
        },
        "compassDirection": "east",
        "instruction": {
          "formattedText": "<Action>Turn</Action> <TurnDir>left</TurnDir> onto <RoadName>Bellevue Way NE</RoadName>",
          "maneuverType": "TurnLeft",
          "text": "Turn left onto Bellevue Way NE"
        },
        "sideOfStreet": "Unknown",
        "distanceInMeters": 94.4,
        "durationInSeconds": 38,
        "steps": [
          {
            "routePathRange": {
              "legIndex": 0,
              "range": [
                9,
                11
              ]
            },
            "maneuverType": "TurnLeft",
            "compassDegrees": 91,
            "roadType": "Arterial",
            "names": [
              "Bellevue Way NE"
            ]
          }
        ],
        "travelMode": "driving"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.201603,
          47.615137
        ]
      },
      "properties": {
        "type": "Waypoint",
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 11
        },
        "order": {
          "inputIndex": 2
        },
        "compassDirection": "north",
        "instruction": {
          "formattedText": "<Action>Arrive</Action> at <WaypointName>Bellevue Way NE</WaypointName>",
          "maneuverType": "ArriveFinish",
          "text": "Arrive at Bellevue Way NE",
          "hints": [
            {
              "hintType": "PreviousIntersection",
              "text": "The last intersection before your destination is NE 4th St"
            }
          ]
        },
        "sideOfStreet": "Unknown",
        "distanceInMeters": 0,
        "durationInSeconds": 0,
        "steps": [
          {
            "routePathRange": {
              "legIndex": 0,
              "range": [
                11,
                11
              ]
            },
            "maneuverType": "ArriveFinish",
            "compassDegrees": 357,
            "roadType": "Arterial",
            "names": [
              "Bellevue Way NE"
            ]
          }
        ],
        "travelMode": "driving"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.206894,
          47.612001
        ]
      },
      "properties": {
        "type": "ViaWaypoint",
        "names": [
          "100th Ave NE"
        ],
        "routePathPoint": {
          "pointIndex": 5,
          "legIndex": 0
        },
        "order": {
          "inputIndex": 1
        }
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "MultiLineString",
        "coordinates": [
          [
            [
              -122.20147,
              47.608675
            ],
            [
              -122.201494,
              47.610108
            ],
            [
              -122.201496,
              47.610196
            ],
            [
              -122.206817,
              47.610185
            ],
            [
              -122.206824,
              47.610369
            ],
            [
              -122.206893,
              47.612001
            ],
            [
              -122.20697,
              47.613839
            ],
            [
              -122.206832,
              47.613839
            ],
            [
              -122.204428,
              47.61379
            ],
            [
              -122.201664,
              47.61386
            ],
            [
              -122.201547,
              47.613857
            ],
            [
              -122.201603,
              47.615137
            ]
          ]
        ]
      },
      "bbox": [
        47.608676,
        -122.206971,
        47.615137,
        -122.20147
      ],
      "properties": {
        "type": "RoutePath",
        "resourceId": "v70,h-1241513931,i0,a0,cen-US,dAMA8xD0s2wg1,y1,s3,m1,o1,t4,wuOUjKenNR0CdnKG444xewA2~AISjUSdxkDoBAADgAdG_yz4A0~QmVsbGV2dWUgV2F5IFNF0~~~~~~~~v12,wFYvfFFbOR0CBIatbPY1ewA2~AISjUScpizoBAADgARBojT4A0~MTAwdGggQXZlIE5F0~~~1~~~~~v12,w-kZ0z7rOR0B95xcl6IxewA2~AISjUSchJDoBAADgAQAAgD8A0~QmVsbGV2dWUgV2F5IE5F0~~~~~~~~v12,k0,qatt:1",
        "distanceInMeters": 947,
        "durationInSeconds": 266,
        "durationTrafficInSeconds": 295,
        "trafficDataUsed": "None",
        "trafficCongestion": "Mild",
        "departureTime": "2023-08-28T18:00:00+00:00",
        "arrivalTime": "2023-08-28T18:04:55+00:00",
        "legs": [
          {
            "description": "100th Ave NE, NE 4th St",
            "routePathRange": {
              "range": [
                0,
                11
              ],
              "legIndex": 0
            },
            "subLegs": [
              {
                "routePathRange": {
                  "range": [
                    0,
                    5
                  ],
                  "legIndex": 0
                },
                "distanceInMeters": 477.8,
                "durationInSeconds": 128,
                "durationTrafficInSeconds": 138
              },
              {
                "routePathRange": {
                  "range": [
                    5,
                    11
                  ],
                  "legIndex": 0
                },
                "distanceInMeters": 469.1,
                "durationInSeconds": 137,
                "durationTrafficInSeconds": 157
              }
            ],
            "distanceInMeters": 947,
            "durationInSeconds": 266,
            "durationTrafficInSeconds": 295,
            "departureTime": "2023-08-28T18:00:00+00:00",
            "arrivalTime": "2023-08-28T18:04:55+00:00"
          }
        ]
      }
    }
  ]
}

Definíciók

Name	Description
AdminDistrict	Egy cím országának vagy régiójának alosztályneve. Ezt az elemet általában elsőrendű felügyeleti alosztályként kezelik, de bizonyos esetekben egy ország, függőség vagy régió második, harmadik vagy negyedik rendezési alosztályát is tartalmazza.
Avoid	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. Például: "avoid": ["limitedAccessHighways", "tolls"]
DirectionsRequest	Ez az objektum a kérelem törzse.
FeatureCollection	GeoJSON FeatureCollection szolgáltatások listáját tartalmazó objektumot. További információ: RFC 7946, 3.3 szakasz.
FeaturesItem	A GeoJSON funkcióobjektum geometriai objektumot és az útvonal további tulajdonságait tartalmazza.
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.
GeoJsonPoint	Érvényes GeoJSON Point geometriatípus. Részletekért tekintse meg RFC 7946.
Hint	További információk, amelyek hasznosak lehetnek egy útvonal követésében. A tippszöveg mellett ez az elem rendelkezik egy hintType attribútummal, amely meghatározza, hogy mire hivatkozik a tipp, például a "NextIntersection". A tipp nem kötelező elem. Note: Csak a travelMode vezetéséhez támogatott.
InputWaypointFeaturesItem	Megadja a bemeneti útpontot és a viaWaypoint GeoJSON funkcióobjektumot és további tulajdonságokat. További információ: RFC 7946.
InputWaypointTypeEnum	Útvonalpont típusa az útvonalon. Ez lehet egy megálló vagy egy köztes hely, amelyen az útvonalnak át kell haladnia.
Instruction	A manőver leírása egy irányok halmazában.
Leg	Információ egy útvonal két útpont közötti szakaszáról. További információ az útvonal-lábban található mezőkről:
ManeuverPointProperties	Megadja az útvonal-láb minden egyes manőverpontjához tartozó vezetési utasításokat és további tulajdonságokat.
ManeuverTypeEnum	A részletes gyűjtemény által leírt manőver típusa. Az A részletes gyűjteményben található Manővertípus a megfelelő utasítás manővertípus attribútuma által leírt manőver egy részére vonatkozó információt nyújthat. Egy utasítás manővertípus attribútuma például a TurnLeftThenTurnRightot adhatja meg manőverként, míg a kapcsolódó részletes elemek a TurnLeft és a TurnRight manőverek részleteit is megadhatják.
MapsErrorDetail	A hiba részletei.
MapsErrorResponse	Az Azure Maps API-k gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához.
MapsInnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
MultiLineStringGeometry	Megadja a GeoJSON MultiLineString Geometry objektumot. További információ: RFC 7946.
OptimizeRoute	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"
Order	Útvonalpontok és viaWaypointok meglátogatásának sorrendje.
PointGeometry	A GeoJSON Pontgeometria objektumot adja meg. További információ: RFC 7946.
RegionTravelSummary	A távolság, az idő és az útdíjköteles út távolságának utazási összegzése két entitástípus szerint: ország (pl. USA, Kanada) és közigazgatási körzet vagy alrégió (például "állam" az USA-ban és "tartomány" Kanada).
RoadTypeEnum	Az út típusa. Note: Csak a travelMode vezetéséhez támogatott.
RouteDirectionsResponse	Ezt az objektumot egy sikeres hívás adja vissza.
RouteOutputOption	Adja meg a kívánt útvonaladatokat a válaszból. Alapértelmezés szerint az útvonal szerepel a válaszban. Több értéket támogat, például a "routeOutputOptions": ["routePath", "regionTravelSummary"]
RoutePathPoint	Egy útvonal adott szakaszán belüli pont indexére hivatkozik.
RoutePathProperties	Megadja az útvonal útvonalát leíró tulajdonságokat a válaszban.
RoutePathRange	Egy útvonal vagy útvonal adott lába által lefedett tartományra hivatkozik.
RouteTravelMode	Az útvonal útvonalának utazási módja a válaszban.
SideOfStreetEnum	Az utca azon oldala, ahol a cél az érkezési irány alapján található. Ez a mező csak az utolsó manőverpointra vonatkozik.
Step	Az útválasztási láb fordulatonkénti utasításokat tartalmaz. A lépés két egymást követő manőverpont közötti útvonaltartományra utal.
SubLeg	Információk az útvonal-láb útvonalpontjai és a köztes útválasztási pontok által meghatározott szegmensekről. Ha például az útválasztási láb két útválasztási ponttal rendelkezik az indulási és a végponti útpontok mellett, három (3) útvonal-alláb is rendelkezésre áll.
TrafficCongestionEnum	A forgalmi torlódás szintje az útvonal mentén. Note: Csak a travelMode vezetéséhez támogatott
TrafficDataUsedEnum	Az útvonal létrehozásához használt valós idejű forgalmi adatok típusa.
TravelMode	A kért útvonal utazási módja. Ha nincs meghatározva, az alapértelmezett érték a "vezetés", amely az autókra optimalizált útvonalat adja vissza. Note: A kamionos travelMode esetében előfordulhat, hogy a kért teherautó-útvonal nem érhető el a teljes útvonalon. Ha a kamion útvonala nem érhető el egy adott szakaszhoz, az adott szakasz válaszának travelMode eleme "egyéb" lesz. Példa: "travelMode":"vezetés"
VehicleLoadType	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.
VehicleSpec	A járműattribútumok a vehicleSpec fájlban vannak megadva. A különböző régiók különböző definíciókkal rendelkezhetnek a teherautók besorolásához és típusaihoz, például kisteherautóhoz, közepes teherautóhoz, nehéz teherautóhoz stb. Ha a teherautó specifikációi alapján szeretné lekérni az útvonalkorlátozások legpontosabb eredményeit, adja meg a jármű attribútumait. Note: Csak a truck travelMode esetében támogatott.
ViaWaypointProperties	Egy ViaWaypoint tulajdonságait adja meg, amely egy útvonal vagy út mentén áthaladó vagy meglátogatandó útvonal.
WaypointProperties	Megadja a Waypoint tulajdonságait, amely egy adott hely vagy pont egy útvonal vagy út mentén, amely referencia- vagy megállóhelyként szolgál.

AdminDistrict

Objektum

Egy cím országának vagy régiójának alosztályneve. Ezt az elemet általában elsőrendű felügyeleti alosztályként kezelik, de bizonyos esetekben egy ország, függőség vagy régió második, harmadik vagy negyedik rendezési alosztályát is tartalmazza.

Name	Típus	Description
distanceInMeters	number	A közigazgatási körzeten belüli mérőkben megtett teljes távolság.
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.
longName	string	Egy cím hosszú neve, például Washington.

Avoid

Enumerálá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.

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

Érték	Description
borderCrossings	Elkerüli az országhatárok átlépését az útvonalon.
ferries	Elkerüli a kompok használatát az útvonalon.
limitedAccessHighways	Elkerüli a korlátozott hozzáférésű autópályák használatát az útvonalon.
lowEmissionZones	Elkerüli az alacsony kibocsátású zónákat az útvonalon. Note: Csak a truck travelMode esetében támogatott.
tollRoads	Elkerüli az útdíjköteles utak használatát az útvonalon.
tunnels	Elkerüli az alagutak használatát az útvonalon. Note: Csak a truck travelMode esetében támogatott.
unpavedRoads	Elkerüli a fel nem ásott utakat az útvonalon. Note: Csak a truck travelMode esetében támogatott.

DirectionsRequest

Objektum

Ez az objektum a kérelem törzse.

Name	Típus	Alapértelmezett érték	Description
arriveAt	string (date-time)		A célpontra való érkezés dátuma és időpontja dateTimeRFC 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. Példa: "arriveAt": "2023-06-01T09:30:00.000-07:00"
avoid	Avoid[]		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. Például: "avoid": ["limitedAccessHighways", "tolls"]
departAt	string (date-time)		A kiindulási ponttól való eltérés dátuma és időpontja dateTimeRFC 3339, 5.6. Ha nincs megadva időzóna-eltolás, a rendszer az UTC-t feltételezi. Példa: "departAt": "2023-06-01T09:30:00.000-07:00"
features	InputWaypointFeaturesItem[]		A vezetési és a gyalogos útvonalakat útpontok(megállók) és viaWaypointok (köztes helyek) határozzák meg, amelyeken az útvonalnak áthaladnia kell. Az egyes útpontok között legfeljebb 25 útpont és legfeljebb 10 viaWaypoint lehet. A teherautó-útvonal legfeljebb 150 útpontot támogat, és a viaWaypointok nem támogatottak. Az útvonalaknak legalább 2 útponttal kell rendelkezniük, és az útvonal kezdő és végpontjai nem lehetnek viaWaypoint-pontok. A waypoint és a viaWaypoint helyeket érvényes GeoJSON-pont funkcióobjektumként kell megadni, valamint a helyek sorrendjét meghatározó PointIndexet. További információ a GeoJSON formátumról: RFC 7946.
heading	integer (int64) minimum: 0 maximum: 359		A jármű kezdeti iránya fokban, a valódi északi iránytól indulva és az óramutató járásával megegyező irányban haladva. Észak 0 fok, keleten 90 fok, délen 180 fok, nyugaton 270 fok. Lehetséges értékek 0–359
maxRouteCount	integer (int64) minimum: 1 maximum: 3		A visszaútvonalak maximális száma. Autós és teherautós utazási módokhoz is elérhető. A vezetési útvonalak esetében ez a paraméter a forrás és a cél mellett legfeljebb két útponttal rendelkező útvonalakat is támogat, és az elkerülő paramétert nem szabad beállítani. Alapértelmezett: "maxRouteCount":1 Minimum: "maxRouteCount":1 Maximum: "maxRouteCount":3
optimizeRoute	OptimizeRoute	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"
optimizeWaypointOrder	boolean	False	Rendezze újra az útvonalpontokat egy gyors heurisztikus algoritmussal az optimalizáló paraméterrel megadott útvonalköltség csökkentése érdekében. A forrás és a cél ki van zárva az optimalizált útpontból, és a helyzetük rögzítettnek minősül. Az elfogadható értékek igazak vagy hamisak. Note: Csak a truck travelMode esetében támogatott.
routeOutputOptions	RouteOutputOption[]	[ "itinerary" ]	Adja meg a kívánt útvonaladatokat a válaszból. Alapértelmezés szerint az útvonal szerepel a válaszban. Több értéket támogat, például a "routeOutputOptions": ["routePath", "regionTravelSummary"]
travelMode	TravelMode	driving	A kért útvonal utazási módja. Ha nincs meghatározva, az alapértelmezett érték a "vezetés", amely az autókra optimalizált útvonalat adja vissza. Note: A kamionos travelMode esetében előfordulhat, hogy a kért teherautó-útvonal nem érhető el a teljes útvonalon. Ha a kamion útvonala nem érhető el egy adott szakaszhoz, az adott szakasz válaszának travelMode eleme "egyéb" lesz. 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	VehicleSpec		Meghatározza a jármű attribútumait, például a méretet, a súlyt, a maximális sebességet, a rakomány típusát csak a teherautó-útválasztáshoz. 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. Note: Csak a truck travelMode esetében támogatott

FeatureCollection

Objektum

GeoJSON FeatureCollection szolgáltatások listáját tartalmazó objektumot. További információ: RFC 7946, 3.3 szakasz.

Name	Típus	Description
features	FeaturesItem[]	GeoJSON geometriai objektumot és további tulajdonságokat tartalmazó funkcióobjektumot. További információ: RFC 7946, 3.2 szakasz.
nextLink	string	A visszaadott funkciók következő oldalára mutató hivatkozás. Ha ez az utolsó oldal, a mező nem fog létezni.
type	FeatureTypeEnum	Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a FeatureCollection. További információ: RFC 7946.

FeaturesItem

Objektum

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	Geometry: MultiLineStringGeometry PointGeometry	Érvényes GeoJSON geometriai objektum. További információ: RFC 7946.
properties	FeatureProperties: ManeuverPointProperties RoutePathProperties ViaWaypointProperties WaypointProperties	Megadja az útvonal jellemző tulajdonságait, például az útvonaltervet, az útvonal lábait és a geometriát, az utazás összegzését.
type	FeaturesItemTypeEnum	Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

FeaturesItemTypeEnum

Enumerálá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

Enumerálá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.

GeoJsonPoint

Objektum

Érvényes GeoJSON Point geometriatípus. 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	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.

Hint

Objektum

További információk, amelyek hasznosak lehetnek egy útvonal követésében. A tippszöveg mellett ez az elem rendelkezik egy hintType attribútummal, amely meghatározza, hogy mire hivatkozik a tipp, például a "NextIntersection". A tipp nem kötelező elem. Note: Csak a travelMode vezetéséhez támogatott.

Name	Típus	Description
hintType	string	tipp típusa.
text	string	szövegre való utalás.

InputWaypointFeaturesItem

Objektum

Megadja a bemeneti útpontot és a viaWaypoint GeoJSON funkcióobjektumot és további tulajdonságokat. További információ: RFC 7946.

Name	Típus	Alapértelmezett érték	Description
geometry	GeoJsonPoint: PointGeometry		Érvényes GeoJSON Point geometriatípus. Részletekért tekintse meg RFC 7946.
properties.pointIndex	integer (int64)		Azonosítsa és rendezze az útvonalbeli útpontok sorrendjét. Az alapértelmezett érték egy szolgáltatástömb index value.
properties.pointType	InputWaypointTypeEnum	waypoint	Útvonalpont típusa az útvonalon. Ez lehet egy megálló vagy egy köztes hely, amelyen az útvonalnak át kell haladnia.
type	FeaturesItemTypeEnum		Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a Funkció. További információ: RFC 7946.

InputWaypointTypeEnum

Enumerálás

Útvonalpont típusa az útvonalon. Ez lehet egy megálló vagy egy köztes hely, amelyen az útvonalnak át kell haladnia.

Érték	Description
viaWaypoint	A viaWaypoint egy adott útpont, amelyet át kell adni vagy meg kell látogatni egy útvonal vagy utazás mentén. Note: Csak a travelMode vezetéséhez támogatott.
waypoint	Az útpontok egy adott hely vagy pont egy útvonal vagy út mentén, amely referencia- vagy megállóhelyként szolgál.

Instruction

Objektum

A manőver leírása egy irányok halmazában.

Name	Típus	Description
formattedText	string	Az utasítás formázott szöveges leírása.
hints	Hint[]	További információk, amelyek hasznosak lehetnek egy útvonal követésében. A tippszöveg mellett ez az elem rendelkezik egy hintType attribútummal, amely meghatározza, hogy mire hivatkozik a tipp, például a "NextIntersection". A tipp nem kötelező elem, és egy útvonallépés több tippet is tartalmazhat. Note: Csak a travelMode vezetéséhez támogatott
maneuverType	ManeuverTypeEnum	A részletes gyűjtemény által leírt manőver típusa. Az A részletes gyűjteményben található Manővertípus a megfelelő utasítás manővertípus attribútuma által leírt manőver egy részére vonatkozó információt nyújthat. Egy utasítás manővertípus attribútuma például a TurnLeftThenTurnRightot adhatja meg manőverként, míg a kapcsolódó részletes elemek a TurnLeft és a TurnRight manőverek részleteit is megadhatják.
text	string	Az utasítás egyszerű szöveges leírása.

Leg

Objektum

Információ egy útvonal két útpont közötti szakaszáról. További információ az útvonal-lábban található mezőkről:

Name	Típus	Description
arrivalTime		A láb becsült érkezési ideje, amely figyelembe veszi a forgalmi feltételeket, dátum/idő é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.
departureTime		A láb becsült indulási ideje, amely figyelembe veszi a forgalmi feltételeket, dátum/idő é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.
description	string	Az útvonal rövid leírása.
distanceInMeters	number	Az útválasztási láb által lefedett mérők fizikai távolsága.
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.
regionTravelSummary	RegionTravelSummary	Adja meg a távolság, az idő és az útdíjköteles út távolságának utazási összegzését két entitástípus szerint: ország (pl. USA, Kanada) és közigazgatási körzet vagy alrégió (például "állam" az USA-ban és "tartomány" Kanada).
routePathRange	RoutePathRange	Egy útvonal vagy útvonal adott lába által lefedett tartományra hivatkozik.
subLegs	SubLeg[]	Információk az útvonal-láb útvonalpontjai és a köztes útválasztási pontok által meghatározott szegmensekről. Ha például az útválasztási láb két útválasztási ponttal rendelkezik az indulási és a végponti útpontok mellett, három (3) útvonal-alláb is rendelkezésre áll.

ManeuverPointProperties

Objektum

Megadja az útvonal-láb minden egyes manőverpontjához tartozó vezetési utasításokat és további tulajdonságokat.

Name	Típus	Alapértelmezett érték	Description
compassDirection	string		Az útvonalon ( például délen vagy délnyugaton) történő manőverhez kapcsolódó utazási irány. Note: Csak a travelMode vezetéséhez támogatott.
distanceInMeters	number		Az útvonallépés által érintett mérők fizikai távolsága.
durationInSeconds	integer (int64)		Az az idő , hogy másodpercek alatt, hogy utazik egy megfelelő TravelDistance.
exitIdentifier	string		Az útvonallépéshez társított kilépés neve vagy száma.
instruction	Instruction		A manőver leírása egy irányok halmazában.
order	Order		Útvonalpontok és viaWaypointok meglátogatásának sorrendje.
routePathPoint	RoutePathPoint		Egy útvonal adott szakaszán belüli pont indexére hivatkozik.
sideOfStreet	SideOfStreetEnum		Az utca azon oldala, ahol a cél az érkezési irány alapján található. Ez a mező csak az utolsó manőverpointra vonatkozik.
signs	string[]		Az útvonal felirata. Egynél több jelérték is lehet.
steps	Step[]		Lépések két egymást követő manőverpont között.
towardsRoadName	string		Az utca neve, amellyel az útvonal az első ManeuverPointfelé halad.
travelMode	RouteTravelMode	driving	Az útvonal útvonalának utazási módja a válaszban.
type	string: ManeuverPoint		Kimeneti típus.

ManeuverTypeEnum

Enumerálás

A részletes gyűjtemény által leírt manőver típusa. Az A részletes gyűjteményben található Manővertípus a megfelelő utasítás manővertípus attribútuma által leírt manőver egy részére vonatkozó információt nyújthat. Egy utasítás manővertípus attribútuma például a TurnLeftThenTurnRightot adhatja meg manőverként, míg a kapcsolódó részletes elemek a TurnLeft és a TurnRight manőverek részleteit is megadhatják.

Érték	Description
ArriveFinish	Érkezzen meg a végső célhelyre.
ArriveIntermediate	Érkezzen meg egy köztes útpontra.
BearLeft	Medve balra.
BearLeftThenBearLeft	Meddő balra, majd a medve ismét balra.
BearLeftThenBearRight	Meddő balra, majd a medve jobbra.
BearLeftThenTurnLeft	Meddő balra, majd forduljon balra.
BearLeftThenTurnRight	Meddő balra, majd jobbra.
BearRight	Meddő jobbra.
BearRightThenBearLeft	Meddő jobbra, majd medve balra.
BearRightThenBearRight	Meddő jobbra, majd meddő újra.
BearRightThenTurnLeft	Meddő legyen jobbra, majd forduljon balra.
BearRightThenTurnRight	Meddő legyen jobbra, majd forduljon jobbra.
BearThenKeep	Medve utasítás, majd megtartása utasítás
BearThenMerge	Adja meg az utasítást, majd egy egyesítési utasítást.
Continue	Folytassa a jelenlegi úton.
DepartIntermediateStop	Hagyjon egy köztes útpontot más irányba és útban, mint amennyire érkezett.
DepartIntermediateStopReturning	Hagyjon egy köztes útpontot ugyanabban az irányban és ugyanazon az úton, amelyen érkezett.
DepartStart	Hagyja meg a kiindulási pontot.
EnterRoundabout	Adjon meg egy körforgalmat.
EnterThenExitRoundabout	Lépjen be és lépjen ki egy körforgalomból.
ExitRoundabout	Lépjen ki egy körforgalomból.
ExitRoundaboutLeft	A körforgalomnál lépjen a bal oldali kijáratra.
ExitRoundaboutRight	A körforgalomnál lépjen a jobb oldali kijáratra.
Follow	Követ.
GoAroundRoundabout	Menj körbe a körforgalomban.
KeepLeft	Maradjon balra egy másik útra.
KeepOnRampLeft	Tartsa balra, és folytassa a rámpa.
KeepOnRampRight	Tartsa jobbra, és folytassa a rámpára.
KeepOnRampStraight	Tartsa egyenesen, és folytassa a rámpa.
KeepRight	Haladjon jobbra egy másik útra.
KeepStraight	Egyenesen egy másik útra.
KeepToStayLeft	Maradjon balra, hogy ugyanazon az úton maradjon.
KeepToStayRight	Tartsa a jogot, hogy ugyanazon az úton maradjon.
KeepToStayStraight	Tartsd egyenesben, hogy ugyanazon az úton maradj.
MergeFreeway	Egyesítés egy autópályára.
MergeHighway	Egyesítés egy autópályára.
MergeMotorway	Egyesítés egy autópályára.
MotorwayExitLeft	A bal oldali kijáraton.
MotorwayExitRight	A jobb oldali kijáratot.
None	Nincs utasítás.
RampThenHighwayLeft	A bal oldali rámpa az autópályára. Ez egy kombinált utasítás része.
RampThenHighwayRight	Haladjon jobbra az autópályára. Ez egy kombinált utasítás része.
RampThenHighwayStraight	Maradjon egyenesen, hogy rámpát vigyen az autópályára. Ez egy kombinált utasítás része.
RoadNameChange	Az út neve megváltozik.
SwitchToMainRoad	Váltson a főútra.
SwitchToParallelRoad	Váltson a párhuzamos útra.
Take	Haladjon az úton. Ezt az utasítást akkor használja a rendszer, ha kompot lép be vagy lép ki.
TakeExit	Lépjen a kijáratra.
TakeFerry	A kompon.
TakeRamp	Fogd a rámpa.
TakeRampLeft	Balra a rámpa.
TakeRampRight	Jobbra a rámpa.
TakeRampStraight	Maradjon egyenesen, hogy rámpát vegyen.
TurnBack	Forduljon vissza élesen.
TurnLeft	Fordulj balra.
TurnLeftSharp	Éles balra fordulás.
TurnLeftThenBearLeft	Forduljon balra, majd a medve balra.
TurnLeftThenBearRight	Forduljon balra, és tartsa jobbra.
TurnLeftThenTurnLeft	Forduljon balra, majd forduljon ismét balra.
TurnLeftThenTurnRight	Forduljon balra, majd jobbra.
TurnRight	Fordulj jobbra.
TurnRightSharp	Éles jobbra fordulás.
TurnRightThenBearLeft	Forduljon jobbra, és tartsa balra.
TurnRightThenBearRight	Forduljon jobbra, és tartsa jobbra.
TurnRightThenTurnLeft	Forduljon jobbra, majd forduljon balra.
TurnRightThenTurnRight	Jobbra, majd ismét jobbra
TurnThenMerge	Kapcsolja be az utasítást, majd egy egyesítési utasítást.
TurnToStayLeft	Forduljon balra, hogy ugyanazon az úton maradjon.
TurnToStayRight	Forduljon jobbra, hogy ugyanazon az úton maradjon.
UTurn	Az ellenkező irányba u-kanyart kell tenni.
Unknown	Az utasítás ismeretlen.
Wait	Várj
Walk	Sétál

MapsErrorDetail

Objektum

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

Objektum

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

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

MapsInnerError

Objektum

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.

MultiLineStringGeometry

Objektum

Megadja a GeoJSON MultiLineString Geometry objektumot. További információ: RFC 7946.

Name	Típus	Description
coordinates	number[] (double)	A GeoJson MultiLineString geometria koordinátái.
type	string: MultiLineString	A "GeoJSON" Geometry objektum geometriai típusát adja meg. További információ: RFC 7946.

OptimizeRoute

Enumerálá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
fastestAvoidClosureWithoutTraffic	Az útvonal kiszámítása az idő minimalizálása és az útlezárások elkerülése érdekében történik. A számítás nem tartalmaz forgalmi adatokat, kivéve az útlezárásokat. Note: Csak a travelMode vezetéséhez támogatott.
fastestWithTraffic	A rendszer úgy számítja ki az útvonalat, hogy az aktuális forgalmi adatok használatával minimalizálja az időt. Note: Csak a vezetés és a teherautó travelMode esetében támogatott.
fastestWithoutTraffic	Megkeresi a leggyorsabb útvonalat, anélkül, hogy a forgalmi adatokban szerepet játszik.
shortest	Az útvonal kiszámítása a távolság minimalizálása érdekében történik. A rendszer nem használja a forgalmi adatokat.

Order

Objektum

Útvonalpontok és viaWaypointok meglátogatásának sorrendje.

Name	Típus	Description
inputIndex	integer (int64)	Felhasználó által megadott index a waypoint- és viaWaypoint-bemenetekhez.
optimizedIndex	integer (int64)	Rendszeroptimalizált waypoint és viaWaypoint-index.

PointGeometry

Objektum

A GeoJSON Pontgeometria objektumot adja meg. További információ: 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. További információ: RFC 7946.

RegionTravelSummary

Objektum

A távolság, az idő és az útdíjköteles út távolságának utazási összegzése két entitástípus szerint: ország (pl. USA, Kanada) és közigazgatási körzet vagy alrégió (például "állam" az USA-ban és "tartomány" Kanada).

Name	Típus	Description
adminDistricts	AdminDistrict[]	adminDistrict tömb.
countryRegion	string	Országrégió neve.
distanceInMeters	number	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.

RoadTypeEnum

Enumerálás

Az út típusa. Note: Csak a travelMode vezetéséhez támogatott.

Érték	Description
Arterial	Artériás.
Ferry	Komp.
Highway	Autópálya.
LimitedAccessHighway	Korlátozott hozzáférésű autópálya.
MajorRoad	MajorRoad.
NotApplicable	Nem alkalmazható.
Ramp	Rámpa.
Street	Utca.
WalkingPath	Gyalogos ösvény.

RouteDirectionsResponse

Objektum

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

Name	Típus	Description
alternativeRoutes	FeatureCollection[]	Alternatív útvonal.
features	FeaturesItem[]	GeoJSON geometriai objektumot és további tulajdonságokat tartalmazó funkcióobjektumot. További információ: RFC 7946, 3.2 szakasz.
nextLink	string	A visszaadott funkciók következő oldalára mutató hivatkozás. Ha ez az utolsó oldal, a mező nem fog létezni.
type	FeatureTypeEnum	Megadja a GeoJSON típusát. Az egyetlen támogatott objektumtípus a FeatureCollection. További információ: RFC 7946.

RouteOutputOption

Enumerálás

Adja meg a kívánt útvonaladatokat a válaszból. Alapértelmezés szerint az útvonal szerepel a válaszban.

Több értéket támogat, például a "routeOutputOptions": ["routePath", "regionTravelSummary"]

Érték	Description
itinerary	Adjon részletes útmutatást a válaszhoz. A részletes irányok "Manőverpontok" néven érhetők el, és olyan részleteket tartalmaznak, mint például a turn-by-turn utasítások.
regionTravelSummary	Adja meg a távolság, az idő és az útdíjköteles út távolságának utazási összegzését két entitástípus szerint: ország (pl. USA, Kanada) és közigazgatási körzet vagy alrégió (például "állam" az USA-ban és "tartomány" Kanadában). Note: Csak a vezetéshez és a gyalogos travelMode-hoz támogatott
routePath	Adjon meg egy GeoJSON MultiLineString RFC 7946 3.1.5 szakaszt, amely leírja az útvonal útvonalát a válaszban.
routeSummary	Csak az útvonal utazási idejét és távolságát adja meg, és ne adjon meg más információkat.

RoutePathPoint

Objektum

Egy útvonal adott szakaszán belüli pont indexére hivatkozik.

Name	Típus	Description
legIndex	integer (int64)	Az útvonal legindexe az útvonal minden egyes szakaszához hozzárendelt szekvenciális szám, amely segít azonosítani és megkülönböztetni az útvonal különböző szakaszait.
pointIndex	integer (int64)	Egy adott lábon belüli pont indexe.

RoutePathProperties

Objektum

Megadja az útvonal útvonalát leíró tulajdonságokat a válaszban.

Name	Típus	Description
arrivalTime		A láb becsült érkezési ideje, amely figyelembe veszi a forgalmi feltételeket, dateTime értékként van formázva, amelyet RFC 3339, 5.6. A departAt vagy arrivalAtáltal eltolt időzónára hivatkozik. Ha nem, akkor az UTC idő lesz használva.
departureTime		A láb becsült indulási ideje, amely figyelembe veszi a forgalmi feltételeket, dateTimeRFC 3339, 5.6. A departAt vagy arrivalAtáltal eltolt időzónára hivatkozik. Ha nem, akkor az UTC idő lesz használva.
distanceInMeters	number	A teljes útvonal által lefedett mérők fizikai távolsága.
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.
legs	Leg[]	Útvonallábak tömbje. További információkért tekintse meg az útválasztási láb objektum leírását.
resourceId	string	Az erőforrás egyedi azonosítója.
trafficCongestion	TrafficCongestionEnum	A forgalmi torlódás szintje az útvonal mentén. Note: Csak a travelMode vezetéséhez támogatott
trafficDataUsed	TrafficDataUsedEnum	Az útvonal létrehozásához használt valós idejű forgalmi adatok típusa.
type	string: RoutePath	Kimeneti típus.

RoutePathRange

Objektum

Egy útvonal vagy útvonal adott lába által lefedett tartományra hivatkozik.

Name	Típus	Description
legIndex	integer (int64)	Az útvonal legindexe az útvonal minden egyes szakaszához hozzárendelt szekvenciális szám, amely segít azonosítani és megkülönböztetni az útvonal különböző szakaszait.
range	integer[] (int64)	Egy útvonal vagy útvonal adott lába által lefedett tartományra hivatkozik.

RouteTravelMode

Enumerálás

Az útvonal útvonalának utazási módja a válaszban.

Érték	Description
driving	Autóra optimalizált útvonalak.
other	A RouteTravelMode "egyébként" jelenik meg a teherautó travelMode-hoz, ha a kamion útvonala nem érhető el az útvonal egy adott szakaszához.
truck	Nagy méretű teherautókhoz optimalizált útvonalak a jármű specifikációja alapján.
walking	Gyalogosokra optimalizált útvonalak.

SideOfStreetEnum

Enumerálás

Az utca azon oldala, ahol a cél az érkezési irány alapján található. Ez a mező csak az utolsó manőverpointra vonatkozik.

Érték	Description
Left	Balra.
Right	Jobbra.
Unknown	Ismeretlen.

Step

Objektum

Az útválasztási láb fordulatonkénti utasításokat tartalmaz. A lépés két egymást követő manőverpont közötti útvonaltartományra utal.

Name	Típus	Description
compassDegrees	number	Az irány fokban. Note: Csak a travelMode vezetéséhez támogatott.
maneuverType	ManeuverTypeEnum	A részletes gyűjtemény által leírt manőver típusa. Az A részletes gyűjteményben található Manővertípus a megfelelő utasítás manővertípus attribútuma által leírt manőver egy részére vonatkozó információt nyújthat. Egy utasítás manővertípus attribútuma például a TurnLeftThenTurnRightot adhatja meg manőverként, míg a kapcsolódó részletes elemek a TurnLeft és a TurnRight manőverek részleteit is megadhatják.
names	string[]	Egy utca, autópálya vagy kereszteződés, ahol a manőver történik. Ha a manőver összetett, több névmező is lehet a részletek gyűjteményében. Előfordulhat, hogy a névmezőnek nincs értéke. Ez akkor fordulhat elő, ha a név nem ismert, vagy ha egy utca, autópálya vagy kereszteződés nem rendelkezik névvel.
roadType	RoadTypeEnum	Az út típusa. Note: Csak a travelMode vezetéséhez támogatott.
routePathRange	RoutePathRange	Egy útvonal vagy útvonal adott lába által lefedett tartományra hivatkozik.

SubLeg

Objektum

Információk az útvonal-láb útvonalpontjai és a köztes útválasztási pontok által meghatározott szegmensekről. Ha például az útválasztási láb két útválasztási ponttal rendelkezik az indulási és a végponti útpontok mellett, három (3) útvonal-alláb is rendelkezésre áll.

Name	Típus	Description
distanceInMeters	number	Az alláb által lefedett mérők fizikai távolsága.
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.
routePathRange	RoutePathRange	Egy útvonal vagy útvonal adott lába által lefedett tartományra hivatkozik.

TrafficCongestionEnum

Enumerálás

A forgalmi torlódás szintje az útvonal mentén. Note: Csak a travelMode vezetéséhez támogatott

Érték	Description
Heavy	Nehéz.
Medium	Közepes.
Mild	Enyhe.
None	Egyik sem.
Unknown	Ismeretlen.

TrafficDataUsedEnum

Enumerálás

Az útvonal létrehozásához használt valós idejű forgalmi adatok típusa.

Érték	Description
Closure	Valós idejű lezárási adatok, ha vannak.
Flow	Az utazási idő kiszámításához használt valós idejű forgalom sebessége.
FlowAndClosure	Folyamat és lezárás.
None	Egyik sem.

TravelMode

Enumerálás

A kért útvonal utazási módja. Ha nincs meghatározva, az alapértelmezett érték a "vezetés", amely az autókra optimalizált útvonalat adja vissza.

Note: A kamionos travelMode esetében előfordulhat, hogy a kért teherautó-útvonal nem érhető el a teljes útvonalon. Ha a kamion útvonala nem érhető el egy adott szakaszhoz, az adott szakasz válaszának travelMode eleme "egyéb" lesz.

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

Érték	Description
driving	A visszaadott útvonalak autókhoz vannak optimalizálva.
truck	A visszaadott útvonalak nagy méretű teherautókhoz vannak optimalizálva a jármű specifikációja alapján.
walking	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 vehicleLoadType elérhető értékei az USA Hazmat 1–9. osztályai, valamint a más országokban használható általános besorolások. Az USHazmat kezdetű értékek az USA útválasztására szolgálnak, míg az otherHazmatot minden más országban használni kell. A vehicleLoadType több értéket is támogat egy kérelemben.

Érték	Description
USHazmatClass1	Robbanóanyagok
USHazmatClass2	Sűrített gáz
USHazmatClass3	Gyúlékony folyadékok
USHazmatClass4	Gyúlékony szilárd anyagok
USHazmatClass5	Oxidálószerek
USHazmatClass6	Mérgek
USHazmatClass7	Radioaktív
USHazmatClass8	Maró anyagok
USHazmatClass9	Vegyes
otherHazmatExplosive	Robbanóanyagok
otherHazmatGeneral	Vegyes
otherHazmatHarmfulToWater	Káros a vízre

VehicleSpec

Objektum

A járműattribútumok a vehicleSpec fájlban vannak megadva. A különböző régiók különböző definíciókkal rendelkezhetnek a teherautók besorolásához és típusaihoz, például kisteherautóhoz, közepes teherautóhoz, nehéz teherautóhoz stb. Ha a teherautó specifikációi alapján szeretné lekérni az útvonalkorlátozások legpontosabb eredményeit, adja meg a jármű attribútumait.

Note: Csak a truck travelMode esetében támogatott.

Name	Típus	Alapértelmezett érték	Description
axleCount	integer (int64) minimum: 0 maximum: 1000000	0	A jármű tengelyeinek száma. A 0 érték azt jelenti, hogy a tengelykorlátozásokat nem veszik figyelembe.
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	VehicleLoadType[]		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.

ViaWaypointProperties

Objektum

Egy ViaWaypoint tulajdonságait adja meg, amely egy útvonal vagy út mentén áthaladó vagy meglátogatandó útvonal.

Name	Típus	Description
names	string[]	Egy utca, autópálya vagy kereszteződés, ahol a manőver történik. Ha a manőver összetett, több névmező is lehet a részletek gyűjteményében. Előfordulhat, hogy a névmezőnek nincs értéke. Ez akkor fordulhat elő, ha a név nem ismert, vagy ha egy utca, autópálya vagy kereszteződés nem rendelkezik névvel.
order	Order	Útvonalpontok és viaWaypointok meglátogatásának sorrendje.
routePathPoint	RoutePathPoint	Egy útvonal adott szakaszán belüli pont indexére hivatkozik.
type	string: ViaWaypoint	Kimeneti típus.

WaypointProperties

Objektum

Megadja a Waypoint tulajdonságait, amely egy adott hely vagy pont egy útvonal vagy út mentén, amely referencia- vagy megállóhelyként szolgál.

Name	Típus	Alapértelmezett érték	Description
compassDirection	string		Az útvonalon ( például délen vagy délnyugaton) történő manőverhez kapcsolódó utazási irány. Note: Csak a travelMode vezetéséhez támogatott.
distanceInMeters	number		Az útvonallépés által érintett mérők fizikai távolsága.
durationInSeconds	integer (int64)		Az az idő , hogy másodpercek alatt, hogy utazik egy megfelelő TravelDistance.
exitIdentifier	string		Az útvonallépéshez társított kilépés neve vagy száma.
instruction	Instruction		A manőver leírása egy irányok halmazában.
order	Order		Útvonalpontok és viaWaypointok meglátogatásának sorrendje.
routePathPoint	RoutePathPoint		Egy útvonal adott szakaszán belüli pont indexére hivatkozik.
sideOfStreet	SideOfStreetEnum		Az utca azon oldala, ahol a cél az érkezési irány alapján található. Ez a mező csak az utolsó manőverpointra vonatkozik.
signs	string[]		Az útvonal felirata. Egynél több jelérték is lehet.
steps	Step[]		Lépések két egymást követő manőverpont között.
towardsRoadName	string		Az utca neve, amellyel az útvonal az első ManeuverPointfelé halad.
travelMode	RouteTravelMode	driving	Az útvonal útvonalának utazási módja a válaszban.
type	string: Waypoint		Kimeneti típus.