Route - Post Route Directions

Služba:: Maps

Verze rozhraní API:: 2025-01-01

Umožňuje získat nejlepší trasu mezi původem a cílem pro automobily, komerční nákladní vozy a pěší trasy.
Rozhraní API Route Directions je požadavek HTTP POST, který vrací ideální trasu mezi původem a cílem pro automobil (řízení), komerční nákladní vozy a pěší trasy. Trasa prochází řadou směrovacích bodů, pokud je zadána. Waypoint je zeměpisné umístění definované zeměpisnou délkou a zeměpisnou šířkou, která se používá pro navigační účely. Trasa bere v úvahu faktory, jako je aktuální provoz a typická rychlost silničního provozu v požadovaném dni v týdnu a denní čas.

Rozhraní API vrátí vzdálenost, odhadovanou dobu cesty a reprezentaci geometrie trasy. V závislosti na použitých parametrech jsou k dispozici také další informace o směrování, jako je optimalizované pořadí směrovacích bodů nebo otáčení podle pokynů pro otáčení.

Směr trasy bere v úvahu místní zákony, rozměry vozidel, typ nákladu, maximální rychlost, most a výšku tunelu pro výpočet konkrétních tras nákladního vozu a vyhnout se složitým manévrům a obtížným cestám. Ne všechny nákladní vozy mohou cestovat stejnými trasami jako ostatní vozidla z důvodu určitých omezení na základě profilu vozidla nebo typu nákladu. Například dálnice často mají samostatné rychlostní limity pro nákladní vozy, některé silnice neumožňují nákladní vozy s hořlavým nebo nebezpečným materiálem a mohou existovat omezení výšky a hmotnosti u mostů.

Podporováno je až 150 trasových bodů a 10 průjezdních bodů viaWayPoint mezi libovolnými dvěma trasovými body. Každá sada směrových bodů vytvoří samostatnou trasu. ViaWaypoints definují trasu a je možné ji použít k vytváření tras přes konkrétní místa, ale nevytvoří trasy nohy.

Pro informace o dostupnosti směrování v zemích/regionech viz Azure Maps pokrytí směrování.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Media Types: "application/geo+json"

Name	Vyžadováno	Typ	Description
x-ms-client-id		string	Označuje účet určený pro použití s bezpečnostním modelem Microsoft Entra ID. Toto jedinečné ID pro účet Azure Maps lze získat z API účtu Azure Maps management plane. Pro více informací o používání Microsoft Entra ID bezpečnosti v Azure Maps viz Spravovat autentizaci v Azure Maps.
Accept-Language		string	Jazyk, ve kterém se mají vrátit výsledky směrování. Pro více informací viz Podpora lokalizace v Azure Maps.

Name

Vyžadováno

Typ

Description

x-ms-client-id

string

Označuje účet určený pro použití s bezpečnostním modelem Microsoft Entra ID. Toto jedinečné ID pro účet Azure Maps lze získat z API účtu Azure Maps management plane. Pro více informací o používání Microsoft Entra ID bezpečnosti v Azure Maps viz Spravovat autentizaci v Azure Maps.

Accept-Language

string

Jazyk, ve kterém se mají vrátit výsledky směrování.

Pro více informací viz Podpora lokalizace v Azure Maps.

Text požadavku

Media Types: "application/geo+json"

Name	Vyžadováno	Typ	Description
features	True	InputWaypointFeaturesItem[]	Trasy pro jízdu autem, chůzi a nákladní automobily jsou definovány sadou průjezdních bodů (zastávek) a průběžných bodů viaWaypoints (mezilehlá místa, kterými musí trasa procházet). Mezi každou sadou trasových bodů můžete mít maximálně 150 trasových bodů a mezi každou sadou trasových bodů maximálně 10 bodů viaWaypoint. Trasa musí obsahovat minimálně 2 směrové body a počáteční a koncové body trasy nesmí být přeswayové body. Umístění waypointu i viaWaypoint musí být zadány jako platný objekt funkce GeoJSON Point spolu s pointIndex, který určuje pořadí umístění. Další informace o formátu GeoJSON najdete v dokumentu RFC 7946.
type	True	FeatureTypeEnum	Určuje typ `GeoJSON`. Jediný podporovaný typ objektu je `FeatureCollection`. Další informace naleznete v tématu RFC 7946.
arriveAt		string (date-time)	Datum a čas doručení v cílovém bodě formátovaný jako hodnota `dateTime` definovaná RFC 3339, oddíl 5.6. Pokud není zadán posun časového pásma, předpokládá se utc. Parametr `arriveAt` nelze použít ve spojení s `departAt`. Příklad: "arriveAt": "2023-06-01T09:30:00.000-07:00"
avoid		AvoidEnum[]	Určuje omezení, která má výpočet trasy dodržovat při určování trasy. Vyhněte se podpoře více hodnot v požadavku a je podporován pouze pro jízdu a nákladní vůzMode. Příklad: "avoid": ["limitedAccessHighways", "tollRoads"]
departAt		string (date-time)	Datum a čas odjezdu z počátečního bodu formátovaného jako `dateTime` hodnota definovaná RFC 3339, bod 5.6. Pokud není zadán posun časového pásma, předpokládá se utc. Pokud `departAt` není nastavená, výchozí hodnota je aktuální čas. Příklad: "departAt": "2023-06-01T09:30:00.000-07:00"
heading		integer (int64) minimum: 0 maximum: 359	Počáteční směrový nadpis vozidla ve stupních počínaje skutečným severem a pokračuje ve směru hodinových ručiček. Sever je 0 stupňů, východ je 90 stupňů, jih je 180 stupňů, západ je 270 stupňů.
maxRouteCount		integer (int64) minimum: 1 maximum: 6	Maximální počet tras, které se mají vrátit. K dispozici pro režimy jízdy a nákladního vozu. Výchozí: "maxRouteCount":1
optimizeRoute		RouteDirectionOptimizeRouteEnum	Určuje parametr, který se má použít k optimalizaci trasy. Pokud není definováno, výchozí hodnota je "nejrychlejšíWithoutTraffic", která vrací trasu pro minimalizaci doby trvání cesty bez použití aktuálních informací o provozu. Příklad: "optimizeRoute":"shortest"
optimizeWaypointOrder		boolean	Přeuspořádejte směrovací body pomocí rychlého heuristického algoritmu, abyste snížili náklady na trasu zadanou parametrem optimalizace. Původ a cíl jsou vyloučeny z optimalizovaného směrového bodu a jejich pozice je považována za pevnou. Přijatelné hodnoty jsou true nebo false.
routeOutputOptions		RouteOutputOptionEnum[]	Zahrňte požadované informace o trase z odpovědi. Ve výchozím nastavení je itinerář součástí odpovědi. Podporuje více hodnot, například "routeOutputOptions": ["routePath", "itinerary"]
travelMode		TravelModeEnum	Režim cesty pro požadovanou trasu Pokud není definovaná, výchozí hodnota je "řízení", která vrací trasu optimalizovanou pro automobily. `Note`: Pro nákladní vůz TravelMode nemusí být požadovaná trasa nákladního vozu k dispozici pro celou trasu. Pokud trasa nákladního vozu není pro konkrétní oddíl k dispozici, bude prvek travelMode odpovědi pro tento oddíl "jiný". Příklad: travelMode:"driving"
vehicleSpec		RouteDirectionVehicleSpec	Určuje atributy vozidla, jako je velikost, hmotnost, maximální rychlost, typ nákladu atd. pouze pro směrování nákladního vozu. To pomáhá vyhnout se nízkým volným místům mostu, omezením silničního provozu, obtížnému pravému otáčení, aby byla zajištěna optimalizovaná trasa nákladního vozu na základě specifikací vozidel. `Note`: Podporováno pouze pro truck travelMode

Odpovědi

Name	Typ	Description
200 OK	RouteDirectionsResponse	Požadavek byl úspěšný. Media Types: "application/geo+json", "application/json"
Other Status Codes	MapsErrorResponse	Neočekávaná chybová odpověď Media Types: "application/geo+json", "application/json"

Name

Typ

Description

200 OK

RouteDirectionsResponse

Požadavek byl úspěšný.

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

Other Status Codes

MapsErrorResponse

Neočekávaná chybová odpověď

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

Zabezpečení

AadToken

Jsou to Microsoft Entra OAuth 2.0 Flows. V kombinaci s Azure řízením přístupu založeného na rolích lze použít k řízení přístupu k Azure Maps REST API. Role Azure kontroly přístupu se používají k určení přístupu k jednomu nebo více účtům nebo podzdrojům Azure Maps. Každému uživateli, skupině nebo principálu služby může být udělen přístup prostřednictvím vestavěné role nebo vlastní role složené z jednoho či více oprávnění k Azure Maps REST API.\n\nPro implementaci scénářů doporučujeme zobrazit koncepty autentizace. Shrnuto, tato definice bezpečnosti poskytuje řešení pro modelování aplikací pomocí objektů schopných kontroly přístupu ke specifickým API a rozsahům.\n\n#### Poznámky\n* Tato bezpečnostní definice vyžaduje použití hlavičky x-ms-client-id k označení, ke kterému Azure Maps zdroji aplikace žádá přístup. Tuto možnost lze získat z API pro správu Maps.\n* \nAuthorization URL je specifický pro instanci Azure veřejného cloudu. Suverénní cloudy mají unikátní autorizační URL a konfigurace Microsoft Entra ID. \n* \nŘízení přístupu založené na rolích Azure je konfigurováno z Azure management plane prostřednictvím Azure portálu, PowerShellu, CLI, Sady Azure SDK nebo REST API.\n* \nVyužití Azure Maps Web SDK umožňuje konfigurační nastavení aplikace pro více případů použití.\n* Pro více informací o Microsoft identity platform viz přehled Microsoft identity platform přehled.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

subscription-key

Jedná se o sdílený klíč, který se zpřístupní, když Vytvoříte Azure Maps účet v Azure portálu nebo pomocí PowerShell, CLI, Sady Azure SDK či REST API.\n\n S tímto klíčem může jakákoli aplikace přistupovat ke všem REST API. Jinými slovy, tento klíč lze použít jako hlavní klíč v účtu, na který jsou vydávány.\n\n Pro veřejně přístupné aplikace doporučujeme použít přístup confidential client applications k přístupu Azure Maps REST API, aby mohl být klíč bezpečně uložen.

Typ: apiKey
V: header

SAS Token

Tento token sdíleného přístupového podpisu je vytvořen operací List SAS na Azure Maps resource přes Azure management plane přes Azure portál, PowerShell, CLI, Sady Azure SDK nebo REST API.\n\n S tímto tokenem je jakákoli aplikace oprávněna přistupovat pomocí Azure Kontroly přístupu založené na rolích a jemná opatření k expiraci, rychlosti a regionům využití konkrétního tokenu. Jinými slovy, SAS Token lze použít k tomu, aby aplikace mohly bezpečněji kontrolovat přístup než sdílený klíč.\n\n Pro veřejně vystavené aplikace doporučujeme nastavit konkrétní seznam povolených původů na zdroji účtu Map, aby se omezilo zneužívání vykreslování a pravidelně obnovovat SAS Token.

Typ: apiKey
V: header

Příklady

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

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kód:: 200

{
  "type": "FeatureCollection",
  "alternativeRoutes": [
    {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -122.20147,
              47.60868
            ]
          },
          "properties": {
            "type": "Waypoint",
            "order": {
              "inputIndex": 0
            },
            "routePathPoint": {
              "legIndex": 0,
              "pointIndex": 0
            }
          }
        },
        {
          "type": "Feature",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -122.2016,
              47.61508
            ]
          },
          "properties": {
            "type": "Waypoint",
            "order": {
              "inputIndex": 1
            },
            "routePathPoint": {
              "legIndex": 0,
              "pointIndex": 29
            }
          }
        },
        {
          "type": "Feature",
          "bbox": [
            -122.2016,
            47.60868,
            -122.20145,
            47.61508
          ],
          "geometry": {
            "type": "MultiLineString",
            "coordinates": [
              [
                [
                  -122.20147,
                  47.60868
                ],
                [
                  -122.20148,
                  47.60884
                ],
                [
                  -122.20148,
                  47.60906
                ],
                [
                  -122.20148,
                  47.60919
                ],
                [
                  -122.20148,
                  47.60953
                ],
                [
                  -122.20148,
                  47.60967
                ],
                [
                  -122.20149,
                  47.60997
                ],
                [
                  -122.2015,
                  47.61011
                ],
                [
                  -122.2015,
                  47.61019
                ],
                [
                  -122.20151,
                  47.61072
                ],
                [
                  -122.20152,
                  47.61092
                ],
                [
                  -122.20152,
                  47.61097
                ],
                [
                  -122.20149,
                  47.611
                ],
                [
                  -122.20147,
                  47.61104
                ],
                [
                  -122.20145,
                  47.61117
                ],
                [
                  -122.20145,
                  47.61122
                ],
                [
                  -122.20145,
                  47.61126
                ],
                [
                  -122.20146,
                  47.61149
                ],
                [
                  -122.20147,
                  47.61166
                ],
                [
                  -122.20148,
                  47.61197
                ],
                [
                  -122.20148,
                  47.61203
                ],
                [
                  -122.2015,
                  47.61268
                ],
                [
                  -122.20151,
                  47.61289
                ],
                [
                  -122.20152,
                  47.61297
                ],
                [
                  -122.20153,
                  47.61338
                ],
                [
                  -122.20155,
                  47.61386
                ],
                [
                  -122.20158,
                  47.61464
                ],
                [
                  -122.20159,
                  47.61475
                ],
                [
                  -122.2016,
                  47.61503
                ],
                [
                  -122.2016,
                  47.61508
                ]
              ]
            ]
          },
          "properties": {
            "type": "RoutePath",
            "arrivalAt": "2025-06-17T09:09:40+00:00",
            "departureAt": "2025-06-17T09:08:10+00:00",
            "distanceInMeters": 713,
            "durationInSeconds": 92,
            "durationTrafficInSeconds": 90,
            "legs": [
              {
                "arrivalAt": "2025-06-17T09:09:40+00:00",
                "departureAt": "2025-06-17T09:08:10+00:00",
                "distanceInMeters": 713,
                "durationInSeconds": 92,
                "durationTrafficInSeconds": 90,
                "routePathRange": {
                  "legIndex": 0,
                  "range": [
                    0,
                    29
                  ]
                }
              }
            ],
            "trafficCongestion": "Medium"
          }
        }
      ]
    }
  ],
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.20147,
          47.60868
        ]
      },
      "properties": {
        "type": "Waypoint",
        "order": {
          "inputIndex": 0
        },
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 0
        }
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.2016,
          47.61508
        ]
      },
      "properties": {
        "type": "Waypoint",
        "order": {
          "inputIndex": 2
        },
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 64
        }
      }
    },
    {
      "type": "Feature",
      "bbox": [
        -122.20697,
        47.60868,
        -122.20147,
        47.61508
      ],
      "geometry": {
        "type": "MultiLineString",
        "coordinates": [
          [
            [
              -122.20147,
              47.60868
            ],
            [
              -122.20148,
              47.60884
            ],
            [
              -122.20148,
              47.60906
            ],
            [
              -122.20148,
              47.60919
            ],
            [
              -122.20148,
              47.60953
            ],
            [
              -122.20148,
              47.60967
            ],
            [
              -122.20149,
              47.60997
            ],
            [
              -122.2015,
              47.61011
            ],
            [
              -122.2015,
              47.61019
            ],
            [
              -122.20192,
              47.61021
            ],
            [
              -122.20199,
              47.61021
            ],
            [
              -122.20252,
              47.61019
            ],
            [
              -122.20264,
              47.61018
            ],
            [
              -122.20271,
              47.61015
            ],
            [
              -122.20276,
              47.61015
            ],
            [
              -122.20281,
              47.61015
            ],
            [
              -122.20286,
              47.61015
            ],
            [
              -122.20329,
              47.61016
            ],
            [
              -122.20346,
              47.61016
            ],
            [
              -122.20414,
              47.61017
            ],
            [
              -122.20416,
              47.61057
            ],
            [
              -122.20418,
              47.61083
            ],
            [
              -122.20418,
              47.61092
            ],
            [
              -122.20419,
              47.61103
            ],
            [
              -122.20419,
              47.61121
            ],
            [
              -122.2042,
              47.61126
            ],
            [
              -122.20478,
              47.61127
            ],
            [
              -122.20555,
              47.61128
            ],
            [
              -122.20569,
              47.61128
            ],
            [
              -122.20596,
              47.61128
            ],
            [
              -122.20617,
              47.61127
            ],
            [
              -122.20624,
              47.61125
            ],
            [
              -122.2066,
              47.61126
            ],
            [
              -122.20669,
              47.61127
            ],
            [
              -122.20686,
              47.61129
            ],
            [
              -122.20687,
              47.61158
            ],
            [
              -122.20689,
              47.61187
            ],
            [
              -122.20691,
              47.61233
            ],
            [
              -122.20691,
              47.61247
            ],
            [
              -122.20694,
              47.61317
            ],
            [
              -122.20695,
              47.61342
            ],
            [
              -122.20696,
              47.61362
            ],
            [
              -122.20697,
              47.61384
            ],
            [
              -122.20683,
              47.61384
            ],
            [
              -122.20638,
              47.61384
            ],
            [
              -122.20612,
              47.61384
            ],
            [
              -122.20568,
              47.61383
            ],
            [
              -122.20559,
              47.6138
            ],
            [
              -122.20467,
              47.61379
            ],
            [
              -122.20443,
              47.61379
            ],
            [
              -122.20405,
              47.61379
            ],
            [
              -122.20325,
              47.6138
            ],
            [
              -122.203,
              47.6138
            ],
            [
              -122.20274,
              47.6138
            ],
            [
              -122.20241,
              47.61381
            ],
            [
              -122.20222,
              47.6138
            ],
            [
              -122.20202,
              47.6138
            ],
            [
              -122.20193,
              47.6138
            ],
            [
              -122.20181,
              47.61386
            ],
            [
              -122.20167,
              47.61386
            ],
            [
              -122.20155,
              47.61386
            ],
            [
              -122.20158,
              47.61464
            ],
            [
              -122.20159,
              47.61475
            ],
            [
              -122.2016,
              47.61503
            ],
            [
              -122.2016,
              47.61508
            ]
          ]
        ]
      },
      "properties": {
        "type": "RoutePath",
        "arrivalAt": "2025-06-17T09:13:10+00:00",
        "departureAt": "2025-06-17T09:08:10+00:00",
        "distanceInMeters": 1520,
        "durationInSeconds": 307,
        "durationTrafficInSeconds": 300,
        "legs": [
          {
            "arrivalAt": "2025-06-17T09:13:10+00:00",
            "departureAt": "2025-06-17T09:08:10+00:00",
            "distanceInMeters": 1520,
            "durationInSeconds": 307,
            "durationTrafficInSeconds": 300,
            "routePathRange": {
              "legIndex": 0,
              "range": [
                0,
                64
              ]
            }
          }
        ],
        "trafficCongestion": "Medium"
      }
    }
  ]
}

Definice

Name	Description
AdminDistrict	Název dílčího dělení v zemi nebo oblasti adresy. Tento prvek je obvykle považován za první dílčí dělení správního řádu, ale v některých případech obsahuje také druhé, třetí nebo čtvrté rozdělení pořadí v zemi, závislosti nebo oblasti.
AdrTunnelRestrictionCodeEnum	Kód omezení tunelu ADR. ADR je evropská dohoda o mezinárodní přepravě nebezpečného zboží po silnici. Kód omezení tunelu ADR slouží k určení, zda je vozidlo povoleno projít tunelem s omezeními pro přepravu nebezpečného zboží.
AvoidEnum	Určuje omezení, která má výpočet trasy dodržovat při určování trasy. Avoid podporuje více hodnot v požadavku a je podporován pouze pro režim jízdy a nákladního vozu.\n\nPříklad: "avoid": ["limitedAccessHighways", "tollRoads"]
CountryRegion	Představuje zemi nebo oblast obsahující související podrobnosti.
DirectionsRequest	Tento objekt je text požadavku.
DrivingSideEnum	Označuje levou vs. pravou stranu řízení v místě manévru.
FeatureCollection	`GeoJSON` `FeatureCollection` objekt, který obsahuje seznam funkcí. Další informace naleznete v RFC 7946, oddíl 3.3.
FeaturesItem	Objekt funkce GeoJSON, který obsahuje objekt geometrie a další vlastnosti trasy.
FeaturesItemTypeEnum	Určuje typ `GeoJSON`. Jediným podporovaným typem objektu je Funkce. Další informace naleznete v tématu RFC 7946.
FeatureTypeEnum	Určuje typ `GeoJSON`. Jediný podporovaný typ objektu je `FeatureCollection`. Další informace naleznete v tématu RFC 7946.
GeoJsonObjectType	Určuje typ `GeoJSON`. Musí být jedním z devíti platných typů objektů GeoJSON – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature a FeatureCollection.
GeoJsonPoint	Platný typ geometrie `GeoJSON Point`. Podrobnosti najdete v RFC 7946.
InputWaypointFeaturesItem	Určuje vstupní waypoint a viaWaypoint `GeoJSON` objekt funkce a další vlastnosti. Další informace naleznete v tématu RFC 7946.
InputWaypointProperties	Určuje vlastnosti směrového bodu, což je konkrétní umístění nebo bod podél trasy nebo cesty, které slouží jako odkaz nebo zastavovací bod.
InputWaypointTypeEnum	Typ směrového bodu na trase. Může to být zastavení nebo přechodné umístění, kterým musí trasa projít.
Instruction	Popis manévru v sadě směrů.
ManeuverPointProperties	Určuje pokyny pro jízdu a další vlastnosti pro každý manévrový bod v noze trasy.
ManeuverTypeEnum	Typ manévru popsaného v této podrobné kolekci. Typ manévru poskytuje informace pro část manévru určenou odpovídající instrukcí. Například manévrType instrukce může určit TurnLeftThenTurnRight, zatímco přidružené položky podrobností mohou poskytnout specifika o TurnLeft a TurnRight manévry
MapsErrorDetail	Podrobnosti o chybě.
MapsErrorResponse	Běžná chybová odpověď pro Azure Maps API pro vrácení chybových detailů pro neúspěšné operace.
MapsInnerError	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
MultiLineStringGeometry	Určuje objekt `GeoJSON` MultiLineString Geometry. Další informace naleznete v tématu RFC 7946.
NavigationPointPropertiesAddress	Správní obvod a region země pro trasové body a manévrové body na trase.
OptimizedWaypoint	Optimalizovaný objekt bodu cesty.
Order	Posloupnost pro návštěvu waypointů.
PointGeometry	Počáteční bod předaný jako platný objekt geometrie `GeoJSON`, ze kterého se má vypočítat mnohoúhelník rozsahu. Podrobnosti najdete v RFC 7946. `Note`: Rozhraní API přichytí požadovaný počáteční bod k nejbližší silniční síti a použije ho pro výpočet rozsahu. Vrátí se jako `center` bod v odpovědi.
PropertiesTypeEnum	Typ výstupu.
RouteDirectionOptimizeRouteEnum	Určuje parametr, který se má použít k optimalizaci trasy. Pokud není definováno, výchozí hodnota je "nejrychlejšíWithoutTraffic", která vrací trasu pro minimalizaci doby trvání cesty bez použití aktuálních informací o provozu. Příklad: "optimizeRoute":"shortest"
RouteDirectionsResponse	Alternativní trasa.
RouteDirectionVehicleSpec	Určuje atributy vozidla, jako je velikost, hmotnost, maximální rychlost, typ nákladu atd. pouze pro směrování nákladního vozu. To pomáhá vyhnout se nízkým volným místům mostu, omezením silničního provozu, obtížnému pravému otáčení, aby byla zajištěna optimalizovaná trasa nákladního vozu na základě specifikací vozidel. IS`Note`: Podporováno pouze pro truck travelMode.
RouteLeg	Informace o oddílu trasy mezi dvěma směrovými body Další informace o polích obsažených v noze trasy:
RouteOutputOptionEnum	Požadované informace o trase z odpovědi.
RoutePathPoint	Odkazuje na index bodu v určité noze trasy.
RoutePathProperties	Určuje vlastnosti, které popisují cestu trasy v odpovědi.
RoutePathRange	Odkazuje na rozsah pokrytý konkrétní částí trasy nebo cesty.
RoutePathTravelModeEnum	Režim cesty trasy v odpovědi.
RouteStep	Trasa noha obsahuje pokyny pro otáčení. Krok odkazuje na rozsah trasy mezi dvěma po sobě jdoucími manévrovacími body.
SideOfStreetEnum	Strana ulice, kde se nachází cíl, na základě směru příjezdu. Toto pole platí pouze pro poslední manévrovací bod.
TrafficCongestionEnum	Úroveň dopravního zahlcení podél trasy. `Note`: Podporováno pouze pro řízení cestovníchmodů
TravelModeEnum	Režim cesty pro požadovanou trasu Pokud není definovaná, výchozí hodnota je "řízení", která vrací trasu optimalizovanou pro automobily. `Note`: Pro nákladní vůz TravelMode nemusí být požadovaná trasa nákladního vozu k dispozici pro celou trasu. Pokud trasa nákladního vozu není pro konkrétní oddíl k dispozici, bude prvek travelMode odpovědi pro tento oddíl "jiný". Příklad: travelMode:"driving"
VehicleLoadTypeEnum	Typy nákladu, které mohou být klasifikovány jako nebezpečné materiály a omezeny na některé silnice.
WaypointProperties	Určuje vlastnosti směrového bodu, což je konkrétní umístění nebo bod podél trasy nebo cesty, které slouží jako odkaz nebo zastavovací bod.

AdminDistrict

Objekt

Název dílčího dělení v zemi nebo oblasti adresy. Tento prvek je obvykle považován za první dílčí dělení správního řádu, ale v některých případech obsahuje také druhé, třetí nebo čtvrté rozdělení pořadí v zemi, závislosti nebo oblasti.

Name	Typ	Description
shortName	string	Krátký název odpovídajícího pole adminDistrict for adminDistrict[0], může to být krátký název stavu, například WA. Tato možnost je dostupná pouze pro USA, Kanadu a Mexiko.

AdrTunnelRestrictionCodeEnum

Výčet

Kód omezení tunelu ADR. ADR je evropská dohoda o mezinárodní přepravě nebezpečného zboží po silnici. Kód omezení tunelu ADR slouží k určení, zda je vozidlo povoleno projít tunelem s omezeními pro přepravu nebezpečného zboží.

Hodnota	Description
B	Vozidla s kódem B jsou omezena na silnice s kategoriemi tunelu ADR B, C, D a E.
C	Vozidla s kódem C jsou omezena na silnice s kategoriemi tunelu ADR C, D a E
D	Vozidla s kódem D jsou omezena na silnice s kategoriemi tunelu ADR D a E.
E	Vozidla s kódem E jsou omezena na silnice s kategorií tunelu ADR E.

AvoidEnum

Výčet

Určuje omezení, která má výpočet trasy dodržovat při určování trasy. Avoid podporuje více hodnot v požadavku a je podporován pouze pro režim jízdy a nákladního vozu.\n\nPříklad: "avoid": ["limitedAccessHighways", "tollRoads"]

Hodnota	Description
limitedAccessHighways	Vyhne se použití omezených přístupových dálnic v trase.
tollRoads	Vyhne se používání zpoplatněných silnic v trase.
ferries	Vyhněte se používání trajektů v trase.
tunnels	Vyhne se použití tunelů v trase.
borderCrossings	Vyhněte se překračování hranic zemí v trase.
lowEmissionZones	Vyhněte se zónám s nízkými emisemi v trase.
unpavedRoads	Vyhýbá se nepopáděným cestám v trase.

CountryRegion

Objekt

Představuje zemi nebo oblast obsahující související podrobnosti.

Name	Typ	Description
ISO	string	ISO země/oblasti představuje kód ISO 3166-1 Alpha-2 region/country code
name	string	název země/oblasti

DirectionsRequest

Objekt

Tento objekt je text požadavku.

Name	Typ	Default value	Description
arriveAt	string (date-time)		Datum a čas doručení v cílovém bodě formátovaný jako hodnota `dateTime` definovaná RFC 3339, oddíl 5.6. Pokud není zadán posun časového pásma, předpokládá se utc. Parametr `arriveAt` nelze použít ve spojení s `departAt`. Příklad: "arriveAt": "2023-06-01T09:30:00.000-07:00"
avoid	AvoidEnum[]		Určuje omezení, která má výpočet trasy dodržovat při určování trasy. Vyhněte se podpoře více hodnot v požadavku a je podporován pouze pro jízdu a nákladní vůzMode. Příklad: "avoid": ["limitedAccessHighways", "tollRoads"]
departAt	string (date-time)		Datum a čas odjezdu z počátečního bodu formátovaného jako `dateTime` hodnota definovaná RFC 3339, bod 5.6. Pokud není zadán posun časového pásma, předpokládá se utc. Pokud `departAt` není nastavená, výchozí hodnota je aktuální čas. Příklad: "departAt": "2023-06-01T09:30:00.000-07:00"
features	InputWaypointFeaturesItem[]		Trasy pro jízdu autem, chůzi a nákladní automobily jsou definovány sadou průjezdních bodů (zastávek) a průběžných bodů viaWaypoints (mezilehlá místa, kterými musí trasa procházet). Mezi každou sadou trasových bodů můžete mít maximálně 150 trasových bodů a mezi každou sadou trasových bodů maximálně 10 bodů viaWaypoint. Trasa musí obsahovat minimálně 2 směrové body a počáteční a koncové body trasy nesmí být přeswayové body. Umístění waypointu i viaWaypoint musí být zadány jako platný objekt funkce GeoJSON Point spolu s pointIndex, který určuje pořadí umístění. Další informace o formátu GeoJSON najdete v dokumentu RFC 7946.
heading	integer (int64) minimum: 0 maximum: 359		Počáteční směrový nadpis vozidla ve stupních počínaje skutečným severem a pokračuje ve směru hodinových ručiček. Sever je 0 stupňů, východ je 90 stupňů, jih je 180 stupňů, západ je 270 stupňů.
maxRouteCount	integer (int64) minimum: 1 maximum: 6		Maximální počet tras, které se mají vrátit. K dispozici pro režimy jízdy a nákladního vozu. Výchozí: "maxRouteCount":1
optimizeRoute	RouteDirectionOptimizeRouteEnum	fastestWithoutTraffic	Určuje parametr, který se má použít k optimalizaci trasy. Pokud není definováno, výchozí hodnota je "nejrychlejšíWithoutTraffic", která vrací trasu pro minimalizaci doby trvání cesty bez použití aktuálních informací o provozu. Příklad: "optimizeRoute":"shortest"
optimizeWaypointOrder	boolean	False	Přeuspořádejte směrovací body pomocí rychlého heuristického algoritmu, abyste snížili náklady na trasu zadanou parametrem optimalizace. Původ a cíl jsou vyloučeny z optimalizovaného směrového bodu a jejich pozice je považována za pevnou. Přijatelné hodnoty jsou true nebo false.
routeOutputOptions	RouteOutputOptionEnum[]	[ "itinerary" ]	Zahrňte požadované informace o trase z odpovědi. Ve výchozím nastavení je itinerář součástí odpovědi. Podporuje více hodnot, například "routeOutputOptions": ["routePath", "itinerary"]
travelMode	TravelModeEnum	driving	Režim cesty pro požadovanou trasu Pokud není definovaná, výchozí hodnota je "řízení", která vrací trasu optimalizovanou pro automobily. `Note`: Pro nákladní vůz TravelMode nemusí být požadovaná trasa nákladního vozu k dispozici pro celou trasu. Pokud trasa nákladního vozu není pro konkrétní oddíl k dispozici, bude prvek travelMode odpovědi pro tento oddíl "jiný". Příklad: travelMode:"driving"
type	FeatureTypeEnum		Určuje typ `GeoJSON`. Jediný podporovaný typ objektu je `FeatureCollection`. Další informace naleznete v tématu RFC 7946.
vehicleSpec	RouteDirectionVehicleSpec		Určuje atributy vozidla, jako je velikost, hmotnost, maximální rychlost, typ nákladu atd. pouze pro směrování nákladního vozu. To pomáhá vyhnout se nízkým volným místům mostu, omezením silničního provozu, obtížnému pravému otáčení, aby byla zajištěna optimalizovaná trasa nákladního vozu na základě specifikací vozidel. `Note`: Podporováno pouze pro truck travelMode

DrivingSideEnum

Výčet

Označuje levou vs. pravou stranu řízení v místě manévru.

Hodnota	Description
Left	Řízení na levé straně.
Right	Na pravé straně jedete.

FeatureCollection

Objekt

GeoJSON FeatureCollection objekt, který obsahuje seznam funkcí. Další informace naleznete v RFC 7946, oddíl 3.3.

Name	Typ	Description
features	FeaturesItem[]	`GeoJSON` objekt funkce, který obsahuje objekt geometrie a další vlastnosti. Další informace naleznete v RFC 7946 oddíl 3.2.
type	FeatureTypeEnum	Určuje typ `GeoJSON`. Jediný podporovaný typ objektu je `FeatureCollection`. Další informace naleznete v tématu RFC 7946.

FeaturesItem

Objekt

Objekt funkce GeoJSON, který obsahuje objekt geometrie a další vlastnosti trasy.

Name	Typ	Description
bbox	number[] (double)	Obdélníková plocha na zemi definovaná jako ohraničující objekt rámečku. Strany obdélníků jsou definovány hodnotami zeměpisné šířky a délky. Další informace naleznete v tématu RFC 7946, oddíl 5. Příklad: "bbox": [-10.0, -10.0, 10.0, 10.0]
geometry	RouteDirectionsGeometry: MultiLineStringGeometry PointGeometry	Platný objekt geometrie `GeoJSON`. Další informace naleznete v tématu RFC 7946.
properties	FeatureProperties: ManeuverPointProperties RoutePathProperties WaypointProperties	Určuje vlastnosti vlastnosti trasy, jako je itinerář, trasa Nohy a geometrie, souhrn cesty.
type	FeaturesItemTypeEnum	Určuje typ `GeoJSON`. Jediným podporovaným typem objektu je Funkce. Další informace naleznete v tématu RFC 7946.

FeaturesItemTypeEnum

Výčet

Určuje typ GeoJSON. Jediným podporovaným typem objektu je Funkce. Další informace naleznete v tématu RFC 7946.

Hodnota	Description
Feature	Určuje typ objektu `GeoJSON` Feature.

FeatureTypeEnum

Výčet

Určuje typ GeoJSON. Jediný podporovaný typ objektu je FeatureCollection. Další informace naleznete v tématu RFC 7946.

Hodnota	Description
FeatureCollection	Určuje typ objektu `GeoJSONFeatureCollection`.

GeoJsonObjectType

Výčet

Určuje typ GeoJSON. Musí být jedním z devíti platných typů objektů GeoJSON – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature a FeatureCollection.

Hodnota	Description
Point	`GeoJSON Point` geometrie.
MultiPoint	`GeoJSON MultiPoint` geometrie.
LineString	`GeoJSON LineString` geometrie.
MultiLineString	`GeoJSON MultiLineString` geometrie.
Polygon	`GeoJSON Polygon` geometrie.
MultiPolygon	`GeoJSON MultiPolygon` geometrie.
GeometryCollection	`GeoJSON GeometryCollection` geometrie.
Feature	`GeoJSON Feature` objekt.
FeatureCollection	`GeoJSON FeatureCollection` objekt.

GeoJsonPoint

Objekt

Platný typ geometrie GeoJSON Point. Podrobnosti najdete v RFC 7946.

Name	Typ	Description
coordinates	number[] (double)	`Position` je matice čísel se dvěma nebo více prvky. První dva prvky jsou zeměpisné délky a zeměpisnou šířkupřesně v daném pořadí. nadmořské výšky nebo zvýšení výšky je volitelný třetí prvek. Podrobnosti najdete v RFC 7946.
type	string: Point	Určuje typ `GeoJSON`. Musí být jedním z devíti platných typů objektů GeoJSON – Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature a FeatureCollection.

InputWaypointFeaturesItem

Objekt

Určuje vstupní waypoint a viaWaypoint GeoJSON objekt funkce a další vlastnosti. Další informace naleznete v tématu RFC 7946.

Name	Typ	Description
geometry	GeoJsonPoint	Platný typ geometrie `GeoJSON Point`. Podrobnosti najdete v RFC 7946.
properties	InputWaypointProperties	Určuje vlastnosti směrového bodu, což je konkrétní umístění nebo bod podél trasy nebo cesty, které slouží jako odkaz nebo zastavovací bod.
type	FeaturesItemTypeEnum	Určuje typ `GeoJSON`. Jediným podporovaným typem objektu je Funkce. Další informace naleznete v tématu RFC 7946.

InputWaypointProperties

Objekt

Určuje vlastnosti směrového bodu, což je konkrétní umístění nebo bod podél trasy nebo cesty, které slouží jako odkaz nebo zastavovací bod.

Name	Typ	Default value	Description
pointIndex	integer (int64)		Určete a sekvencujte pořadí směrovacích bodů v trase. Výchozí hodnota je `index value` pole funkcí.
pointType	InputWaypointTypeEnum	waypoint	Typ směrového bodu na trase. Může to být zastavení nebo přechodné umístění, kterým musí trasa projít.

InputWaypointTypeEnum

Výčet

Typ směrového bodu na trase. Může to být zastavení nebo přechodné umístění, kterým musí trasa projít.

Hodnota	Description
waypoint	Waypoint je konkrétní umístění nebo bod podél trasy nebo cesty, která slouží jako odkaz nebo zastavovací bod.
viaWaypoint	ViaWaypoint je konkrétní směrový bod, který musí být předán nebo navštíven podél trasy nebo výletu.

Instruction

Objekt

Popis manévru v sadě směrů.

Name	Typ	Description
drivingSide	DrivingSideEnum	Označuje levou vs. pravou stranu řízení v místě manévru.
formattedText	string	Formátovaný textový popis instrukce.
maneuverType	ManeuverTypeEnum	Typ manévru popsaného v této podrobné kolekci. Typ manévru poskytuje informace pro část manévru určenou odpovídající instrukcí. Například manévrType instrukce může určit TurnLeftThenTurnRight, zatímco přidružené položky podrobností mohou poskytnout specifika o TurnLeft a TurnRight manévry
text	string	Popis instrukce ve formátu prostého textu.

ManeuverPointProperties

Objekt

Určuje pokyny pro jízdu a další vlastnosti pro každý manévrový bod v noze trasy.

Name	Typ	Default value	Description
address	NavigationPointPropertiesAddress		Správní obvod a region země pro trasové body a manévrové body na trase.
distanceInMeters	number (float)		Fyzická vzdálenost v metrech pokrytá tímto krokem trasy.
durationInSeconds	integer (int64)		Doba, kterou trvá, v sekundách, cestovat odpovídající `TravelDistance`.
exitIdentifier	string		Název nebo číslo výstupu přidruženého k tomuto kroku trasy.
instruction	Instruction		Popis manévru v sadě směrů.
order	Order		Posloupnost pro návštěvu waypointů.
routePathPoint	RoutePathPoint		Odkazuje na index bodu v určité noze trasy.
sideOfStreet	SideOfStreetEnum		Strana ulice, kde se nachází cíl, na základě směru příjezdu. Toto pole platí pouze pro poslední manévrovací bod.
signs	string[]		Podepisovací text trasy Může existovat více než jedna hodnota znaménka.
steps	RouteStep[]		Kroky mezi dvěma po sobě jdoucími manévrovými body.
towardsRoadName	string		Název ulice, ke které trasa směřuje do první `ManeuverPoint`.
travelMode	RoutePathTravelModeEnum	driving	Režim cesty trasy v odpovědi.
type	string: ManeuverPoint		Typ výstupu.

ManeuverTypeEnum

Výčet

Typ manévru popsaného v této podrobné kolekci. Typ manévru poskytuje informace pro část manévru určenou odpovídající instrukcí. Například manévrType instrukce může určit TurnLeftThenTurnRight, zatímco přidružené položky podrobností mohou poskytnout specifika o TurnLeft a TurnRight manévry

Hodnota	Description
ArriveFinish	Dorazí do konečného cíle.
ArriveIntermediate	Dorazí do přechodného bodu.
BearLeft	Medvěd vlevo.
BearLeftThenBearLeft	Medvěd zleva a pak znovu medvěd zbyl.
BearLeftThenBearRight	Medvěd doleva a pak medvěd doprava.
BearLeftThenTurnLeft	Medvěd doleva a pak se otočte doleva.
BearLeftThenTurnRight	Medvěd doleva a pak zatáčí doprava.
BearRight	Medvěd vpravo.
BearRightThenBearLeft	Medvěd vpravo a pak medvěd doleva.
BearRightThenBearRight	Noste vpravo a pak znovu nesete právo.
BearRightThenTurnLeft	Noste doprava a pak se otočte doleva.
BearRightThenTurnRight	Noste doprava a pak otočte doprava.
BearThenKeep	Instrukci medvěda a pak instrukce keep
DepartStart	Nechejte výchozí bod.
BearThenMerge	Instrukci medvěda a potom slučovací instrukce.
Continue	Pokračujte na aktuální silnici.
DepartIntermediateStop	Nechejte přechodový bod v jiném směru a silnici, než jste přijeli.
DepartIntermediateStopReturning	Ve stejném směru a na stejné cestě, na které jste přijeli, ponechte přechodový bod.
EnterRoundabout	Zadejte kruhový objezd.
ExitRoundabout	Ukončete kruhový objezd.
EnterThenExitRoundabout	Zadejte a ukončete kruhový objezd.
ExitRoundaboutRight	V kruhovém kruhovém objezdu vystupte na pravé straně.
ExitRoundaboutLeft	V kruhovém kruhovém objezdu vyjíždět nalevo.
Follow	Follow.
GoAroundRoundabout	Běž kolem kruhového objezdu.
KeepLeft	Držte se na jinou cestu.
KeepOnRampLeft	Držte se doleva a pokračujte na rampu.
KeepOnRampRight	Držte se doprava a pokračujte na rampu.
KeepOnRampStraight	Držte se rovnou a pokračujte na rampu.
KeepRight	Držte se doprava na jinou cestu.
KeepStraight	Držte se rovnou na jinou cestu.
KeepToStayLeft	Zůstaňte na stejné cestě.
KeepToStayRight	Mějte právo zůstat na stejné silnici.
KeepToStayStraight	Držte se rovnou na stejné silnici.
MergeFreeway	Sloučit na volný chodník.
MergeHighway	Sloučit na dálnici.
MergeMotorway	Sloučit na dálnici.
MotorwayExitLeft	Jděte doleva.
MotorwayExitRight	Vezmi pravý konec.
None	Žádné pokyny.
RampThenHighwayLeft	Vyjeďte levou rampu na dálnici. Toto je součástí kombinované instrukce.
RampThenHighwayRight	Pojeďte na dálnici doprava. Toto je součástí kombinované instrukce.
RampThenHighwayStraight	Zůstaňte přímo na dálnici. Toto je součástí kombinované instrukce.
RoadNameChange	Změní se název cesty.
SwitchToParallelRoad	Přepněte na paralelní cestu.
SwitchToMainRoad	Přejděte na hlavní silnici.
Take	Vezmi si cestu. Tento návod se používá při vstupu nebo opuštění trajektu.
TakeFerry	Vezmi trajekt.
TakeExit	Vezmi si východ.
TakeRamp	Vezměte si rampu.
TakeRampLeft	Vezmi rampu doleva.
TakeRampRight	Vezmi rampu doprava.
TakeRampStraight	Zůstaňte rovnou na rampě.
TurnBack	Otočte se ostře.
TurnLeft	Zatočit doleva.
TurnLeftSharp	Vezmi si ostrou levou zátku.
TurnLeftThenBearLeft	Otočte se doleva a pak medvěd doleva.
TurnLeftThenBearRight	Otočte se doleva a pak medvědem doprava.
TurnLeftThenTurnLeft	Otočte se doleva a pak znovu otočte doleva.
TurnLeftThenTurnRight	Otočte se doleva a pak doprava.
TurnRight	Zatočit doprava.
TurnRightSharp	Udělejte ostrý pravý otoč.
TurnRightThenBearLeft	Otočte se doprava a pak medvěd doleva.
TurnRightThenBearRight	Otočte doprava a pak nesete doprava.
TurnRightThenTurnLeft	Otočte doprava a pak otočte doleva.
TurnRightThenTurnRight	Otočte doprava a pak znovu otočte doprava.
TurnThenMerge	Otočte instrukce následované slučovací instrukcí.
TurnToStayLeft	Otočte se doleva, abyste zůstali na stejné silnici.
TurnToStayRight	Otočte se doprava, abyste zůstali na stejné silnici.
Unknown	Instrukce je neznámá.
UTurn	Udělejte u-turn jít opačným směrem.
Wait	Wait
Walk	Walk

MapsErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
details	MapsErrorDetail[]	Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
innererror	MapsInnerError	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message	string	Čitelné znázornění chyby člověkem.
target	string	Cíl chyby.

MapsErrorResponse

Objekt

Běžná chybová odpověď pro Azure Maps API pro vrácení chybových detailů pro neúspěšné operace.

Name	Typ	Description
error	MapsErrorDetail	Podrobnosti o chybě.

MapsInnerError

Objekt

Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.

Name	Typ	Description
code	string	Kód chyby.
innererror	MapsInnerError	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.

MultiLineStringGeometry

Objekt

Určuje objekt GeoJSON MultiLineString Geometry. Další informace naleznete v tématu RFC 7946.

Name	Typ	Description
coordinates	number[] (double)	Souřadnice pro geometrii `GeoJson MultiLineString`.
type	string: MultiLineString	Určuje typ geometrie pro objekt `GeoJSON` Geometry. Další informace naleznete v tématu RFC 7946.

NavigationPointPropertiesAddress

Objekt

Správní obvod a region země pro trasové body a manévrové body na trase.

Name	Typ	Description
adminDistricts	AdminDistrict[]	Název dílčího dělení v zemi nebo oblasti adresy. Tento prvek je obvykle považován za první dílčí dělení správního řádu, ale v některých případech obsahuje také druhé, třetí nebo čtvrté rozdělení pořadí v zemi, závislosti nebo oblasti.
countryRegion	CountryRegion	Představuje zemi nebo oblast obsahující související podrobnosti.

OptimizedWaypoint

Objekt

Optimalizovaný objekt bodu cesty.

Name	Typ	Description
inputIndex	integer (int64)	Index bodu cesty poskytnutý uživatelem
optimizedIndex	integer (int64)	Optimalizovaný index bodu bodu ze systému.

Order

Objekt

Posloupnost pro návštěvu waypointů.

Name	Typ	Description
inputIndex	integer (int64)	Uživatelem poskytnutý index pro trasový bod
optimizedIndex	integer (int64)	Systémově optimalizovaný trasový bod

PointGeometry

Objekt

Počáteční bod předaný jako platný objekt geometrie GeoJSON, ze kterého se má vypočítat mnohoúhelník rozsahu. Podrobnosti najdete v RFC 7946.

Note: Rozhraní API přichytí požadovaný počáteční bod k nejbližší silniční síti a použije ho pro výpočet rozsahu. Vrátí se jako center bod v odpovědi.

Name	Typ	Description
coordinates	number[] (double)	`Position` je matice čísel se dvěma nebo více prvky. První dva prvky jsou zeměpisné délky a zeměpisnou šířkupřesně v daném pořadí. nadmořské výšky nebo zvýšení výšky je volitelný třetí prvek. Podrobnosti najdete v RFC 7946.
type	string: Point	Určuje typ geometrie pro objekt `GeoJSON` Geometry. Další informace naleznete v tématu RFC 7946.

PropertiesTypeEnum

Výčet

Typ výstupu.

Hodnota	Description
ManeuverPoint	Manévrový bod je konkrétní bod na trase nebo cestě, kde je vyžadována nebo doporučena změna směru nebo způsobu dopravy.
Waypoint	Waypoint je konkrétní umístění nebo bod podél trasy nebo cesty, která slouží jako odkaz nebo zastavovací bod.
RoutePath	routePath je čára, která představuje trasu nebo cestu.

RouteDirectionOptimizeRouteEnum

Výčet

Určuje parametr, který se má použít k optimalizaci trasy. Pokud není definováno, výchozí hodnota je "nejrychlejšíWithoutTraffic", která vrací trasu pro minimalizaci doby trvání cesty bez použití aktuálních informací o provozu.

Příklad: "optimizeRoute":"shortest"

Hodnota	Description
short	Trasa je vypočítána tak, aby vyvážila rychlou dobu jízdy a krátkou vzdálenost, spíše než aby upřednostňovala pouze jednu. Je optimalizován pro rychlost i efektivitu. Informace o provozu se nepoužívají.
shortest	Trasa se vypočítá tak, aby se minimalizovala vzdálenost. Informace o provozu se nepoužívají.
fastestWithoutTraffic	Najde nejrychlejší trasu bez faktoru v informacích o provozu.
fastestWithTraffic	Trasa se vypočítá tak, aby se minimalizoval čas pomocí aktuálních informací o provozu. `Note`: Podporuje se pouze pro řízení a nákladní vůz TravelMode.

RouteDirectionsResponse

Objekt

Alternativní trasa.

Name	Typ	Description
alternativeRoutes	FeatureCollection[]	Alternativní trasa.
features	FeaturesItem[]	`GeoJSON` objekt funkce, který obsahuje objekt geometrie a další vlastnosti. Další informace naleznete v RFC 7946 oddíl 3.2.
type	FeatureTypeEnum	Určuje typ `GeoJSON`. Jediný podporovaný typ objektu je `FeatureCollection`. Další informace naleznete v tématu RFC 7946.

RouteDirectionVehicleSpec

Objekt

Určuje atributy vozidla, jako je velikost, hmotnost, maximální rychlost, typ nákladu atd. pouze pro směrování nákladního vozu. To pomáhá vyhnout se nízkým volným místům mostu, omezením silničního provozu, obtížnému pravému otáčení, aby byla zajištěna optimalizovaná trasa nákladního vozu na základě specifikací vozidel.

ISNote: Podporováno pouze pro truck travelMode.

Name	Typ	Default value	Description
adrTunnelRestrictionCode	AdrTunnelRestrictionCodeEnum		Kód omezení tunelu ADR. ADR je evropská dohoda o mezinárodní přepravě nebezpečného zboží po silnici. Kód omezení tunelu ADR slouží k určení, zda je vozidlo povoleno projít tunelem s omezeními pro přepravu nebezpečného zboží.
axleCount	integer (int64)		Počet náprav na vozidle.
axleWeight	integer (int64) minimum: 0 maximum: 1000000	0	Hmotnost na nápravu vozidla v kg. Hodnota 0 znamená, že se nebere v úvahu omezení hmotnosti na nápravu.
height	number (double) minimum: 0 maximum: 1000000	0	Výška vozidla v metrech. Hodnota 0 znamená, že se omezení výšky nepovažují.
isVehicleCommercial	boolean	False	Zda se vozidlo používá pro komerční účely. Na některých silnicích nesmí být povolena jízda na komerčních vozidlech.
length	number (double) minimum: 0 maximum: 1000000	0	Délka vozidla v metrech. Hodnota 0 znamená, že omezení délky se nepovažují.
loadType	VehicleLoadTypeEnum[]		Typy nákladu, které mohou být klasifikovány jako nebezpečné materiály a omezeny na některé silnice. Dostupné hodnoty vehicleLoadType jsou us Hazmat třídy 1 až 9 a obecné klasifikace pro použití v jiných zemích. Hodnoty začínající usHazmat jsou určené pro směrování v USA, zatímco ostatníhazmat by se měly používat pro všechny ostatní země. vehicleLoadType podporuje více hodnot v požadavku.
maxSpeed	integer (int64) minimum: 0 maximum: 250	0	Maximální rychlost vozidla v km/hodině. Maximální rychlost profilu vozidla se používá ke kontrole, zda je vozidlo povoleno na dálnicích. Hodnota 0 znamená, že při plánování trasy se určí a použije příslušná hodnota pro vozidlo. Během plánování trasy může být přepsána nenulová hodnota. Například aktuální tok provozu je 60 km/hodina. Pokud je maximální rychlost vozidla nastavená na 50 km/hodinu, bude směrovací motor považovat za aktuální situaci 60 km/hodinu. Pokud je maximální rychlost vozidla poskytována jako 80 km/hodina, ale aktuální tok provozu je 60 km/hodina, směrovací motor znovu použije 60 km/hodinu.
weight	integer (int64) minimum: 0 maximum: 1000000	0	Hmotnost vozidla v kg. Hodnota 0 znamená, že se nebere v úvahu omezení hmotnosti.
width	number (double) minimum: 0 maximum: 1000000	0	Šířka vozidla v metrech. Hodnota 0 znamená, že se omezení šířky nepovažují.

RouteLeg

Objekt

Informace o oddílu trasy mezi dvěma směrovými body Další informace o polích obsažených v noze trasy:

Name	Typ	Description
arrivalAt	string (date-time)	Odhadovaný čas příjezdu pro nohu, který bere v úvahu dopravní podmínky, je formátován jako hodnota dateTime definovaná RFC 3339, oddíl 5.6. Bude odkazovat na posun časového pásma `departAt` nebo `arrivalAt`. Pokud ne, použije se čas UTC.
departureAt	string (date-time)	Odhadovaný čas odletu pro nohu, který bere v úvahu dopravní podmínky, je formátován jako hodnota dateTime definovaná RFC 3339, oddíl 5.6. Bude odkazovat na posun časového pásma `departAt` nebo `arrivalAt`. Pokud ne, použije se čas UTC.
distanceInMeters	number (float)	Fyzická vzdálenost v metrech pokrytá trasou Noha.
durationInSeconds	integer (int64)	Odhadovaná doba trvání cesty v sekundách, která nezahrnuje zpoždění na trase kvůli dopravním podmínkám.
durationTrafficInSeconds	integer (int64)	Doba, kterou trvá cesta odpovídajícího `TravelDistance` s aktuálními dopravními podmínkami, trvá v sekundách. Tato hodnota se poskytuje, pokud `optimizeRoute` zahrnuje aspekty provozu.
routePathRange	RoutePathRange	Odkazuje na rozsah pokrytý konkrétní částí trasy nebo cesty.

RouteOutputOptionEnum

Výčet

Požadované informace o trase z odpovědi.

Hodnota	Description
routeSummary	Uveďte pouze dobu cesty a vzdálenost pro trasu a nezadáte další informace.
routePath	Uveďte geoJSON MultiLineString RFC 7946, oddíl 3.1.5 popisující cestu trasy v odpovědi.
itinerary	Do odpovědi uveďte podrobné pokyny. Podrobné pokyny jsou k dispozici jako "Manévrovací body" a obsahují podrobnosti, jako jsou pokyny pro otáčení.

RoutePathPoint

Objekt

Odkazuje na index bodu v určité noze trasy.

Name	Typ	Description
legIndex	integer (int64)	Index tras je pořadové číslo přiřazené každé noze trasy, které pomáhá identifikovat a rozlišovat mezi různými segmenty trasy.
pointIndex	integer (int64)	Index bodu v určité noze.

RoutePathProperties

Objekt

Určuje vlastnosti, které popisují cestu trasy v odpovědi.

Name	Typ	Description
arrivalAt	string (date-time)	Odhadovaná doba příjezdu pro nohu, která bere v úvahu dopravní podmínky, je formátována jako hodnota `dateTime` definovaná RFC 3339, oddíl 5.6. Bude odkazovat na posun časového pásma `departAt` nebo `arrivalAt`. Pokud ne, použije se čas UTC.
departureAt	string (date-time)	Odhadovaná doba odletu pro nohu, která bere v úvahu dopravní podmínky, je formátována jako `dateTime` hodnota definovaná RFC 3339, oddíl 5.6. Bude odkazovat na posun časového pásma `departAt` nebo `arrivalAt`. Pokud ne, použije se čas UTC.
distanceInMeters	number (float)	Fyzická vzdálenost v metrech pokrytá celou trasou.
durationInSeconds	integer (int64)	Odhadovaná doba trvání cesty v sekundách, která nezahrnuje zpoždění na trase kvůli dopravním podmínkám.
durationTrafficInSeconds	integer (int64)	Doba, kterou trvá cesta odpovídajícího `TravelDistance` s aktuálními dopravními podmínkami, trvá v sekundách. Tato hodnota se poskytuje, pokud `optimizeRoute` zahrnuje aspekty provozu.
legs	RouteLeg[]	Pole tras nohy. Další informace najdete v popisu objektu leg trasy.
optimizedWaypoints	OptimizedWaypoint[]	Optimalizovaná posloupnost waypointů. Zobrazuje index od uživatelem poskytnuté sekvence waypointu pro původní a optimalizované seznamy.
trafficCongestion	TrafficCongestionEnum	Úroveň dopravního zahlcení podél trasy. `Note`: Podporováno pouze pro řízení cestovníchmodů
type	string: RoutePath	Typ výstupu.

RoutePathRange

Objekt

Odkazuje na rozsah pokrytý konkrétní částí trasy nebo cesty.

Name	Typ	Description
legIndex	integer (int64)	Index tras je pořadové číslo přiřazené každé noze trasy, které pomáhá identifikovat a rozlišovat mezi různými segmenty trasy.
range	integer[] (int64)	Odkazuje na rozsah pokrytý konkrétní částí trasy nebo cesty.

RoutePathTravelModeEnum

Výčet

Režim cesty trasy v odpovědi.

Hodnota	Description
driving	Trasy optimalizované pro automobily.
truck	Trasy optimalizované pro velké nákladní vozy na základě specifikace vozidla.
walking	Trasy optimalizované pro chodce.
other	RouteTravelMode se vrátí jako "jiné" pro nákladní vůz TravelMode, pokud trasa nákladního vozu není k dispozici pro konkrétní část trasy.

RouteStep

Objekt

Trasa noha obsahuje pokyny pro otáčení. Krok odkazuje na rozsah trasy mezi dvěma po sobě jdoucími manévrovacími body.

Name	Typ	Description
maneuverType	ManeuverTypeEnum	Typ manévru popsaného v této podrobné kolekci. Typ manévru poskytuje informace pro část manévru určenou odpovídající instrukcí. Například manévrType instrukce může určit TurnLeftThenTurnRight, zatímco přidružené položky podrobností mohou poskytnout specifika o TurnLeft a TurnRight manévry
names	string[]	Ulice, dálnice nebo průsečík, kde dojde k manévru. Pokud je manévr složitý, může v kolekci podrobností existovat více než jedno pole názvu. Pole názvu může mít také žádnou hodnotu. K tomu může dojít, pokud název není známý nebo pokud ulice, dálnice nebo průsečík nemá název.
routePathRange	RoutePathRange	Odkazuje na rozsah pokrytý konkrétní částí trasy nebo cesty.

SideOfStreetEnum

Výčet

Strana ulice, kde se nachází cíl, na základě směru příjezdu. Toto pole platí pouze pro poslední manévrovací bod.

Hodnota	Description
Left	Vlevo.
Right	Aha.
Unknown	Unknown.

TrafficCongestionEnum

Výčet

Úroveň dopravního zahlcení podél trasy. Note: Podporováno pouze pro řízení cestovníchmodů

Hodnota	Description
Unknown	Unknown.
None	Žádné.
Mild	Mild.
Medium	Střední.
Heavy	Heavy.

TravelModeEnum

Výčet

Režim cesty pro požadovanou trasu Pokud není definovaná, výchozí hodnota je "řízení", která vrací trasu optimalizovanou pro automobily.

Note: Pro nákladní vůz TravelMode nemusí být požadovaná trasa nákladního vozu k dispozici pro celou trasu. Pokud trasa nákladního vozu není pro konkrétní oddíl k dispozici, bude prvek travelMode odpovědi pro tento oddíl "jiný".

Příklad: travelMode:"driving"

Hodnota	Description
driving	Vrácené trasy jsou optimalizované pro auta.
truck	Vrácené trasy jsou optimalizované pro nákladní vozy s velkými velikostmi na základě specifikace vozidla.
walking	Vrácené trasy jsou optimalizované pro chodce, včetně použití chodníků.

VehicleLoadTypeEnum

Výčet

Typy nákladu, které mohou být klasifikovány jako nebezpečné materiály a omezeny na některé silnice.

Hodnota	Description
USHazmatClass1	Výbušniny
USHazmatClass2	Stlačený plyn
USHazmatClass3	Hořlavé kapaliny
USHazmatClass4	Hořlavé pevné látky
USHazmatClass5	Oxidační činidla
USHazmatClass6	Jedy
USHazmatClass7	Radioaktivní
USHazmatClass8	Corrosives
USHazmatClass9	Různé
otherHazmatExplosive	Výbušniny
otherHazmatGeneral	Různé
otherHazmatHarmfulToWater	Škodlivé pro vodu

WaypointProperties

Objekt

Určuje vlastnosti směrového bodu, což je konkrétní umístění nebo bod podél trasy nebo cesty, které slouží jako odkaz nebo zastavovací bod.

Name	Typ	Default value	Description
address	NavigationPointPropertiesAddress		Správní obvod a region země pro trasové body a manévrové body na trase.
distanceInMeters	number (float)		Fyzická vzdálenost v metrech pokrytá tímto krokem trasy.
durationInSeconds	integer (int64)		Doba, kterou trvá, v sekundách, cestovat odpovídající `TravelDistance`.
exitIdentifier	string		Název nebo číslo výstupu přidruženého k tomuto kroku trasy.
instruction	Instruction		Popis manévru v sadě směrů.
order	Order		Posloupnost pro návštěvu waypointů.
routePathPoint	RoutePathPoint		Odkazuje na index bodu v určité noze trasy.
sideOfStreet	SideOfStreetEnum		Strana ulice, kde se nachází cíl, na základě směru příjezdu. Toto pole platí pouze pro poslední manévrovací bod.
signs	string[]		Podepisovací text trasy Může existovat více než jedna hodnota znaménka.
steps	RouteStep[]		Kroky mezi dvěma po sobě jdoucími manévrovými body.
towardsRoadName	string		Název ulice, ke které trasa směřuje do první `ManeuverPoint`.
travelMode	RoutePathTravelModeEnum	driving	Režim cesty trasy v odpovědi.
type	string: Waypoint		Typ výstupu.