Route - Post Route Directions

서비스:: Maps

API 버전:: 2025-01-01

자동차, 상용 트럭 및 도보 경로에 대한 출발지와 목적지 사이의 최상의 경로를 얻는 데 사용합니다.

Route Directions API는 자동차(운전), 상용 트럭 및 도보 경로의 출발지와 목적지 사이의 이상적인 경로를 반환하는 HTTP POST 요청입니다. 지정된 경우 경로가 일련의 웨이포인트를 통과합니다. 중간 지점은 탐색 용도로 사용되는 경도 및 위도로 정의된 지리적 위치입니다. 이 경로는 요청된 요일 및 시간에 대한 현재 교통량 및 일반적인 도로 속도와 같은 요인을 고려합니다.

API는 거리, 예상 이동 시간 및 경로 기하 도형의 표현을 반환합니다. 사용된 매개 변수에 따라 최적화된 웨이포인트 순서 또는 순서별 순서와 같은 더 많은 라우팅 정보도 사용할 수 있습니다.

경로 방향은 트럭 특정 경로를 계산하고 복잡한 기동과 어려운 도로를 피하기 위해 현지 법률, 차량 차원,화물 유형, 최대 속도, 교량 및 터널 높이를 고려합니다. 모든 트럭이 차량 프로필 또는 화물 유형에 따른 특정 제한 사항으로 인해 다른 차량과 동일한 경로를 이동할 수 있는 것은 아닙니다. 예를 들어 고속도로에는 트럭에 대해 별도의 속도 제한이 있고, 일부 도로에서는 가연성 또는 유해 물질이 있는 트럭을 허용하지 않으며, 교량의 높이와 중량 제한이 있을 수 있습니다.

두 가지 중간 지점 사이의 최대 25개의 웨이포인트와 10개의 viaWaypoints가 운전 및 도보 경로에 지원됩니다. 각 웨이포인트 집합은 별도의 경로 Leg를 만듭니다. ViaWaypoints는 경로 경로를 정의하고 특정 위치를 통한 경로 생성에 사용할 수 있지만 경로 Leg를 만들지는 않습니다. 트럭 경로는 최대 150개의 웨이포인트를 지원하지만 viaWaypoints는 지원하지 않습니다.

국가/지역의 라우팅 가용성에 대한 자세한 내용은 Azure Maps 라우팅 적용 범위참조하세요.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
api-version	query	True	string	Azure Maps API의 버전 번호입니다.

요청 헤더

Media Types: "application/geo+json"

Name	필수	형식	Description
x-ms-client-id		string	Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정에 대한 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. To use Microsoft Entra ID security in Azure Maps see the following articles for guidance.
Accept-Language		string	라우팅 결과를 반환해야 하는 언어입니다. 자세한 내용은 Azure Maps지역화 지원을 참조하세요.

Name

필수

형식

Description

x-ms-client-id

string

Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정에 대한 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. To use Microsoft Entra ID security in Azure Maps see the following articles for guidance.

Accept-Language

string

라우팅 결과를 반환해야 하는 언어입니다.

자세한 내용은 Azure Maps지역화 지원을 참조하세요.

요청 본문

Media Types: "application/geo+json"

Name	필수	형식	Description
features	True	InputWaypointFeaturesItem[]	운전 및 도보 경로는 웨이포인트(정지) 및 viaWaypoints(경로가 통과해야 하는 중간 위치)의 집합에 의해 정의됩니다. 각 웨이포인트 집합 간에 최대 25개의 웨이포인트와 최대 10개의 viaWaypoint를 가질 수 있습니다. 트럭 경로는 최대 150개의 웨이포인트를 지원하며 viaWaypoints는 지원되지 않습니다. 경로에는 최소 2개의 웨이포인트가 있어야 하며 경로의 시작점과 끝점은 viaWaypoints일 수 없습니다. 웨이포인트 및 viaWaypoint 위치는 위치의 순서를 지정하는 pointIndex와 함께 유효한 GeoJSON Point 기능 개체로 지정되어야 합니다. For more information on the GeoJSON format, see RFC 7946.
type	True	FeatureTypeEnum	`GeoJSON` 형식을 지정합니다. 지원되는 유일한 개체 형식은 `FeatureCollection`. For more information, see RFC 7946.
arriveAt		string (date-time)	`dateTime`정의된 값으로 형식이 지정된 대상 지점의 도착 날짜 및 시간입니다. 표준 시간대 오프셋을 지정하지 않으면 UTC가 가정됩니다. `arriveAt` 매개 변수는 `departAt`함께 사용할 수 없습니다. 예: "arriveAt": "2023-06-01T09:30:00.000-07:00"
avoid		AvoidEnum[]	경로를 결정할 때 경로 계산에서 적용해야 하는 제한을 지정합니다. 요청에서 여러 값을 지원하지 않으며 운전 및 트럭 travelMode에 대해서만 지원됩니다. 예: "avoid": ["limitedAccessHighways", "tollRoads"]
departAt		string (date-time)	`dateTime`정의된 값으로 서식이 지정된 출발점에서 출발 날짜 및 시간입니다. 표준 시간대 오프셋을 지정하지 않으면 UTC가 가정됩니다. `departAt` 설정되지 않은 경우 기본값은 현재 시간입니다. Example: "departAt": "2023-06-01T09:30:00.000-07:00"
heading		integer (int64) minimum: 0 maximum: 359	실제 북쪽에서 시작하여 시계 방향으로 계속되는 차량의 초기 방향 방향입니다. 북쪽은 0도, 동쪽은 90도, 남쪽은 180도, 서쪽은 270도입니다.
maxRouteCount		integer (int64) minimum: 1 maximum: 6	반환할 최대 경로 수입니다. 운전 및 트럭 이동 모드에 사용할 수 있습니다. Default: "maxRouteCount":1
optimizeRoute		RouteDirectionOptimizeRouteEnum	경로를 최적화하는 데 사용할 매개 변수를 지정합니다. 정의되지 않은 경우 기본값은 현재 트래픽 정보를 사용하지 않고 이동 시간을 최소화하기 위해 경로를 반환하는 "fastestWithoutTraffic"입니다. Example: "optimizeRoute":"shortest"
optimizeWaypointOrder		boolean	빠른 추론 알고리즘을 사용하여 경로 웨이포인트의 순서를 다시 지정하여 최적화 매개 변수로 지정된 경로 비용을 줄입니다. 원본 및 대상은 최적화된 웨이포인트에서 제외되며 해당 위치는 고정된 것으로 간주됩니다. 허용되는 값은 true 또는 false입니다.
routeOutputOptions		RouteOutputOptionEnum[]	응답에서 원하는 경로 정보를 포함합니다. 기본적으로 일정은 응답에 포함됩니다. "routeOutputOptions": ["routePath", "itinerary"]와 같은 여러 값 지원
travelMode		TravelModeEnum	요청된 경로에 대한 이동 모드입니다. 정의되지 않은 경우 기본값은 자동차에 최적화된 경로를 반환하는 "운전"입니다. `Note`: 트럭 travelMode의 경우 요청된 트럭 경로를 전체 경로에 사용할 수 없습니다. 특정 섹션에 트럭 경로를 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"입니다. Example: "travelMode":"driving"
vehicleSpec		RouteDirectionVehicleSpec	트럭 라우팅에 대해서만 크기, 무게, 최대 속도, 화물 유형 등과 같은 차량 특성을 지정합니다. 이를 통해 낮은 교량 통관, 도로 제한, 어려운 오른쪽 회전을 방지하여 차량 사양에 따라 최적화된 트럭 경로를 제공할 수 있습니다. `Note`: 트럭 travelMode에 대해서만 지원됨

응답

Name	형식	Description
200 OK	RouteDirectionsResponse	OK Media Types: "application/geo+json", "application/json"
Other Status Codes	MapsErrorResponse	예기치 않은 오류가 발생했습니다. Media Types: "application/geo+json", "application/json" 헤더 x-ms-error-code: string

Name

형식

Description

200 OK

RouteDirectionsResponse

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

Other Status Codes

MapsErrorResponse

예기치 않은 오류가 발생했습니다.

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

헤더

x-ms-error-code: string

보안

AADToken

다음은 Microsoft Entra OAuth 2.0 흐름에 . Azure 역할 기반 액세스 컨트롤과 쌍을 이루는 경우 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 Azure Maps REST API에 대한 하나 이상의 권한으로 구성된 기본 제공 역할 또는 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.

To implement scenarios, we recommend viewing authentication concepts. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하기 위한 솔루션을 제공합니다.

Note

This security definition requires the use of the x-ms-client-id header to indicate which Azure Maps resource the application is requesting access to. 이는 Maps 관리 API가져올 수 있습니다.
Authorization URL Azure 퍼블릭 클라우드 인스턴스와 관련이 있습니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다.
Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다.
Azure Maps Web SDK 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.
Microsoft ID 플랫폼에 대한 자세한 내용은 Microsoft ID 플랫폼 개요참조하세요.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

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

subscription-key

Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스를 만들 때 프로비전되는 공유 키입니다.

이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있는 권한이 부여됩니다. 즉, 이러한 키는 현재 발급된 계정의 마스터 키로 처리될 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 이 키를 안전하게 저장할 수 있는 Azure Maps REST API의 서버-서버 액세스를 사용하는 것이 좋습니다.

형식: apiKey
In(다음 안에): header

SAS Token

공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스의 SAS 나열 작업에서 만들어집니다.

이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어를 사용하여 액세스하고 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어 권한을 부여받습니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 허용된 원본의 특정 목록을 구성하는 것이 좋습니다.

형식: apiKey
In(다음 안에): header

예제

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

샘플 요청

HTTP

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

{
  "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"
}

샘플 응답

상태 코드:: 200

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.20147,
          47.60868
        ]
      },
      "properties": {
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 0
        },
        "order": {
          "inputIndex": 0
        },
        "type": "Waypoint"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.2016,
          47.61508
        ]
      },
      "properties": {
        "routePathPoint": {
          "legIndex": 0,
          "pointIndex": 64
        },
        "order": {
          "inputIndex": 2
        },
        "type": "Waypoint"
      }
    },
    {
      "type": "Feature",
      "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": {
        "distanceInMeters": 1520,
        "durationInSeconds": 307,
        "departureAt": "2025-06-17T09:08:10+00:00",
        "arrivalAt": "2025-06-17T09:13:10+00:00",
        "durationTrafficInSeconds": 300,
        "trafficCongestion": "Medium",
        "type": "RoutePath",
        "legs": [
          {
            "distanceInMeters": 1520,
            "durationInSeconds": 307,
            "durationTrafficInSeconds": 300,
            "departureAt": "2025-06-17T09:08:10+00:00",
            "arrivalAt": "2025-06-17T09:13:10+00:00",
            "routePathRange": {
              "legIndex": 0,
              "range": [
                0,
                64
              ]
            }
          }
        ]
      },
      "bbox": [
        -122.20697,
        47.60868,
        -122.20147,
        47.61508
      ]
    }
  ],
  "alternativeRoutes": [
    {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -122.20147,
              47.60868
            ]
          },
          "properties": {
            "routePathPoint": {
              "legIndex": 0,
              "pointIndex": 0
            },
            "order": {
              "inputIndex": 0
            },
            "type": "Waypoint"
          }
        },
        {
          "type": "Feature",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -122.2016,
              47.61508
            ]
          },
          "properties": {
            "routePathPoint": {
              "legIndex": 0,
              "pointIndex": 29
            },
            "order": {
              "inputIndex": 1
            },
            "type": "Waypoint"
          }
        },
        {
          "type": "Feature",
          "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": {
            "distanceInMeters": 713,
            "durationInSeconds": 92,
            "departureAt": "2025-06-17T09:08:10+00:00",
            "arrivalAt": "2025-06-17T09:09:40+00:00",
            "durationTrafficInSeconds": 90,
            "trafficCongestion": "Medium",
            "type": "RoutePath",
            "legs": [
              {
                "distanceInMeters": 713,
                "durationInSeconds": 92,
                "durationTrafficInSeconds": 90,
                "departureAt": "2025-06-17T09:08:10+00:00",
                "arrivalAt": "2025-06-17T09:09:40+00:00",
                "routePathRange": {
                  "legIndex": 0,
                  "range": [
                    0,
                    29
                  ]
                }
              }
            ]
          },
          "bbox": [
            -122.2016,
            47.60868,
            -122.20145,
            47.61508
          ]
        }
      ]
    }
  ]
}

정의

Name	Description
Address	경로의 웨이포인트 및 기동 지점에 대한 행정 구역 및 국가 지역입니다.
AdminDistrict	주소에 대한 국가 또는 지역의 세분화 이름입니다. 이 요소는 일반적으로 첫 번째 순서 관리 세분화로 처리되지만 경우에 따라 국가, 종속성 또는 지역의 두 번째, 세 번째 또는 네 번째 순서 세분화도 포함됩니다.
AdrTunnelRestrictionCodeEnum	ADR 터널 제한 코드입니다. ADR은 도로로 위험물의 국제 운송에 관한 유럽 협정입니다. ADR 터널 제한 코드는 차량이 위험물 운송에 대한 제한 사항이 있는 터널을 통과할 수 있는지 여부를 결정하는 데 사용됩니다.
AvoidEnum	경로를 결정할 때 경로 계산에서 적용해야 하는 제한을 지정합니다. 요청에서 여러 값을 지원하지 않으며 운전 및 트럭 travelMode에 대해서만 지원됩니다. 예: "avoid": ["limitedAccessHighways", "tollRoads"]
CountryRegion	관련 세부 정보를 포함하는 국가 또는 지역을 나타냅니다.
DirectionsRequest	이 개체는 요청 본문입니다.
DrivingSideEnum	기동 지점에서 왼쪽 및 오른쪽 주행을 나타냅니다.
FeatureCollection	기능 목록을 포함하는 개체를 `GeoJSONFeatureCollection`. 자세한 내용은 RFC 7946, 섹션 3.3참조하세요.
FeaturesItem	Geometry 개체와 경로의 추가 속성을 포함하는 GeoJSON 기능 개체입니다.
FeaturesItemTypeEnum	`GeoJSON` 형식을 지정합니다. 유일하게 지원되는 개체 유형은 Feature입니다. For more information, see RFC 7946.
FeatureTypeEnum	`GeoJSON` 형식을 지정합니다. 지원되는 유일한 개체 형식은 `FeatureCollection`. For more information, see RFC 7946.
GeoJsonPoint	유효한 `GeoJSON Point` 기하 도형 형식입니다. Please refer to RFC 7946 for details.
InputWaypointFeaturesItem	입력 웨이포인트 및 viaWaypoint `GeoJSON` 기능 개체 및 추가 속성을 지정합니다. For more information, see RFC 7946.
InputWaypointProperties	참조 또는 중지 지점 역할을 하는 경로 또는 여정을 따라 특정 위치 또는 지점인 웨이포인트의 속성을 지정합니다.
InputWaypointTypeEnum	경로의 웨이포인트 유형입니다. 경로가 통과해야 하는 중지 또는 중간 위치일 수 있습니다.
Instruction	방향 집합의 기동에 대한 설명입니다.
Leg	두 중간 지점 간의 경로 섹션에 대한 정보입니다. 경로 Leg에 포함된 필드에 대한 자세한 정보:
ManeuverPointProperties	경로 Leg의 각 기동 지점에 대한 운전 지침 및 추가 속성을 지정합니다.
ManeuverTypeEnum	이 자세한 컬렉션에 설명된 기동 유형입니다. ManeuverType은 해당 명령으로 지정된 기동의 일부에 대한 정보를 제공합니다. 예를 들어 명령의 maneuverType은 TurnLeftThenTurnRight를 지정할 수 있지만 관련 세부 항목은 TurnLeft 및 TurnRight 기동에 대한 세부 정보를 제공할 수 있습니다.
MapsErrorDetail	오류 세부 정보입니다.
MapsErrorResponse	실패한 작업에 대한 오류 세부 정보를 반환하는 Azure Maps API에 대한 일반적인 오류 응답입니다.
MapsInnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
MultiLineStringGeometry	`GeoJSON` MultiLineString Geometry 개체를 지정합니다. For more information, see RFC 7946.
OptimizedWaypoint	최적화된 방법 지점 개체입니다.
Order	웨이포인트 방문 순서입니다.
PointGeometry	범위 다각형을 계산해야 하는 유효한 `GeoJSON` Geometry 개체로 전달된 원점입니다. Please refer to RFC 7946 for details. `Note`: API는 요청된 원본 지점을 가장 가까운 도로 네트워크에 스냅하고 범위 계산에 사용합니다. 응답의 `center` 지점으로 반환됩니다.
RouteDirectionOptimizeRouteEnum	경로를 최적화하는 데 사용할 매개 변수를 지정합니다. 정의되지 않은 경우 기본값은 현재 트래픽 정보를 사용하지 않고 이동 시간을 최소화하기 위해 경로를 반환하는 "fastestWithoutTraffic"입니다. Example: "optimizeRoute":"shortest"
RouteDirectionsResponse	이 개체는 성공적인 호출에서 반환됩니다.
RouteDirectionVehicleSpec	트럭 라우팅에 대해서만 크기, 무게, 최대 속도, 화물 유형 등과 같은 차량 특성을 지정합니다. 이를 통해 낮은 교량 통관, 도로 제한, 어려운 오른쪽 회전을 방지하여 차량 사양에 따라 최적화된 트럭 경로를 제공할 수 있습니다. IS`Note`: 트럭 travelMode에 대해서만 지원됩니다.
RouteOutputOptionEnum	응답에서 원하는 경로 정보를 포함합니다. 기본적으로 일정은 응답에 포함됩니다. "routeOutputOptions": ["routePath", "itinerary"]와 같은 여러 값 지원
RoutePathPoint	경로의 특정 레그 내에 있는 점의 인덱스를 참조합니다.
RoutePathProperties	응답에서 경로의 경로를 설명하는 속성을 지정합니다.
RoutePathRange	경로 또는 경로의 특정 레그에서 적용되는 범위를 나타냅니다.
RoutePathTravelModeEnum	응답의 경로 경로에 대한 이동 모드입니다.
SideOfStreetEnum	도착 방향에 따라 목적지가 발견되는 거리의 측면입니다. 이 필드는 마지막 기동 포인트에만 적용됩니다.
Step	경로 레그에는 턴 바이 턴 지침이 포함되어 있습니다. 단계는 두 개의 연속된 기동점 사이의 경로 범위를 나타냅니다.
TrafficCongestionEnum	경로를 따라 교통 혼잡의 수준입니다. `Note`: travelMode 운전에 대해서만 지원됨
TravelModeEnum	요청된 경로에 대한 이동 모드입니다. 정의되지 않은 경우 기본값은 자동차에 최적화된 경로를 반환하는 "운전"입니다. `Note`: 트럭 travelMode의 경우 요청된 트럭 경로를 전체 경로에 사용할 수 없습니다. 특정 섹션에 트럭 경로를 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"입니다. Example: "travelMode":"driving"
VehicleLoadTypeEnum	위험 물질로 분류되고 일부 도로에서 제한될 수 있는 화물 유형입니다. 사용 가능한 vehicleLoadType 값은 미국 Hazmat 클래스 1~9와 다른 국가에서 사용할 일반 분류입니다. USHazmat로 시작하는 값은 미국 라우팅을 위한 값이며 다른 모든 국가에서는 otherHazmat을 사용해야 합니다. vehicleLoadType은 요청에서 여러 값을 지원합니다.
WaypointProperties	참조 또는 중지 지점 역할을 하는 경로 또는 여정을 따라 특정 위치 또는 지점인 웨이포인트의 속성을 지정합니다.

Address

Object

경로의 웨이포인트 및 기동 지점에 대한 행정 구역 및 국가 지역입니다.

Name	형식	Description
adminDistricts	AdminDistrict[]	주소에 대한 국가 또는 지역의 세분화 이름입니다. 이 요소는 일반적으로 첫 번째 순서 관리 세분화로 처리되지만 경우에 따라 국가, 종속성 또는 지역의 두 번째, 세 번째 또는 네 번째 순서 세분화도 포함됩니다.
countryRegion	CountryRegion	관련 세부 정보를 포함하는 국가 또는 지역을 나타냅니다.

AdminDistrict

Object

주소에 대한 국가 또는 지역의 세분화 이름입니다. 이 요소는 일반적으로 첫 번째 순서 관리 세분화로 처리되지만 경우에 따라 국가, 종속성 또는 지역의 두 번째, 세 번째 또는 네 번째 순서 세분화도 포함됩니다.

Name	형식	Description
shortName	string	해당 adminDistrict 필드의 짧은 이름인 adminDistrict[0]의 경우 WA와 같은 짧은 상태 이름일 수 있습니다. 이는 미국, 캐나다 및 멕시코에서만 사용할 수 있습니다.

AdrTunnelRestrictionCodeEnum

열거형

ADR 터널 제한 코드입니다. ADR은 도로로 위험물의 국제 운송에 관한 유럽 협정입니다. ADR 터널 제한 코드는 차량이 위험물 운송에 대한 제한 사항이 있는 터널을 통과할 수 있는지 여부를 결정하는 데 사용됩니다.

값	Description
B	코드 B가 있는 차량은 ADR 터널 범주 B, C, D 및 E가 있는 도로에서 제한됩니다.
C	C 코드가 있는 차량은 ADR 터널 범주 C, D 및 E가 있는 도로에서 제한됩니다.
D	D 코드가 있는 차량은 ADR 터널 범주 D 및 E가 있는 도로에서 제한됩니다.
E	코드 E가 있는 차량은 ADR 터널 범주 E가 있는 도로에서 제한됩니다.

AvoidEnum

열거형

경로를 결정할 때 경로 계산에서 적용해야 하는 제한을 지정합니다. 요청에서 여러 값을 지원하지 않으며 운전 및 트럭 travelMode에 대해서만 지원됩니다.

예: "avoid": ["limitedAccessHighways", "tollRoads"]

값	Description
limitedAccessHighways	경로에서 제한된 액세스 고속도로의 사용을 방지합니다.
tollRoads	경로에서 유료 도로의 사용을 방지합니다.
ferries	경로에서 페리의 사용을 방지합니다.
tunnels	경로에서 터널을 사용하지 않습니다.
borderCrossings	경로에서 국가 국경을 넘지 않도록 합니다.
lowEmissionZones	경로에서 저공해 영역을 방지합니다.
unpavedRoads	경로에서 비포장 도로를 방지합니다.

CountryRegion

Object

관련 세부 정보를 포함하는 국가 또는 지역을 나타냅니다.

Name	형식	Description
ISO	string	국가/지역의 ISO는 ISO 3166-1 Alpha-2 지역/국가 코드를 나타냅니다.
name	string	국가/지역의 이름

DirectionsRequest

Object

이 개체는 요청 본문입니다.

Name	형식	Default value	Description
arriveAt	string (date-time)		`dateTime`정의된 값으로 형식이 지정된 대상 지점의 도착 날짜 및 시간입니다. 표준 시간대 오프셋을 지정하지 않으면 UTC가 가정됩니다. `arriveAt` 매개 변수는 `departAt`함께 사용할 수 없습니다. 예: "arriveAt": "2023-06-01T09:30:00.000-07:00"
avoid	AvoidEnum[]		경로를 결정할 때 경로 계산에서 적용해야 하는 제한을 지정합니다. 요청에서 여러 값을 지원하지 않으며 운전 및 트럭 travelMode에 대해서만 지원됩니다. 예: "avoid": ["limitedAccessHighways", "tollRoads"]
departAt	string (date-time)		`dateTime`정의된 값으로 서식이 지정된 출발점에서 출발 날짜 및 시간입니다. 표준 시간대 오프셋을 지정하지 않으면 UTC가 가정됩니다. `departAt` 설정되지 않은 경우 기본값은 현재 시간입니다. Example: "departAt": "2023-06-01T09:30:00.000-07:00"
features	InputWaypointFeaturesItem[]		운전 및 도보 경로는 웨이포인트(정지) 및 viaWaypoints(경로가 통과해야 하는 중간 위치)의 집합에 의해 정의됩니다. 각 웨이포인트 집합 간에 최대 25개의 웨이포인트와 최대 10개의 viaWaypoint를 가질 수 있습니다. 트럭 경로는 최대 150개의 웨이포인트를 지원하며 viaWaypoints는 지원되지 않습니다. 경로에는 최소 2개의 웨이포인트가 있어야 하며 경로의 시작점과 끝점은 viaWaypoints일 수 없습니다. 웨이포인트 및 viaWaypoint 위치는 위치의 순서를 지정하는 pointIndex와 함께 유효한 GeoJSON Point 기능 개체로 지정되어야 합니다. For more information on the GeoJSON format, see RFC 7946.
heading	integer (int64) minimum: 0 maximum: 359		실제 북쪽에서 시작하여 시계 방향으로 계속되는 차량의 초기 방향 방향입니다. 북쪽은 0도, 동쪽은 90도, 남쪽은 180도, 서쪽은 270도입니다.
maxRouteCount	integer (int64) minimum: 1 maximum: 6		반환할 최대 경로 수입니다. 운전 및 트럭 이동 모드에 사용할 수 있습니다. Default: "maxRouteCount":1
optimizeRoute	RouteDirectionOptimizeRouteEnum	fastestWithoutTraffic	경로를 최적화하는 데 사용할 매개 변수를 지정합니다. 정의되지 않은 경우 기본값은 현재 트래픽 정보를 사용하지 않고 이동 시간을 최소화하기 위해 경로를 반환하는 "fastestWithoutTraffic"입니다. Example: "optimizeRoute":"shortest"
optimizeWaypointOrder	boolean	False	빠른 추론 알고리즘을 사용하여 경로 웨이포인트의 순서를 다시 지정하여 최적화 매개 변수로 지정된 경로 비용을 줄입니다. 원본 및 대상은 최적화된 웨이포인트에서 제외되며 해당 위치는 고정된 것으로 간주됩니다. 허용되는 값은 true 또는 false입니다.
routeOutputOptions	RouteOutputOptionEnum[]	[ "itinerary" ]	응답에서 원하는 경로 정보를 포함합니다. 기본적으로 일정은 응답에 포함됩니다. "routeOutputOptions": ["routePath", "itinerary"]와 같은 여러 값 지원
travelMode	TravelModeEnum	driving	요청된 경로에 대한 이동 모드입니다. 정의되지 않은 경우 기본값은 자동차에 최적화된 경로를 반환하는 "운전"입니다. `Note`: 트럭 travelMode의 경우 요청된 트럭 경로를 전체 경로에 사용할 수 없습니다. 특정 섹션에 트럭 경로를 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"입니다. Example: "travelMode":"driving"
type	FeatureTypeEnum		`GeoJSON` 형식을 지정합니다. 지원되는 유일한 개체 형식은 `FeatureCollection`. For more information, see RFC 7946.
vehicleSpec	RouteDirectionVehicleSpec		트럭 라우팅에 대해서만 크기, 무게, 최대 속도, 화물 유형 등과 같은 차량 특성을 지정합니다. 이를 통해 낮은 교량 통관, 도로 제한, 어려운 오른쪽 회전을 방지하여 차량 사양에 따라 최적화된 트럭 경로를 제공할 수 있습니다. `Note`: 트럭 travelMode에 대해서만 지원됨

DrivingSideEnum

열거형

기동 지점에서 왼쪽 및 오른쪽 주행을 나타냅니다.

값	Description
Left	왼쪽 운전.
Right	오른쪽 운전.

FeatureCollection

Object

기능 목록을 포함하는 개체를 GeoJSONFeatureCollection. 자세한 내용은 RFC 7946, 섹션 3.3참조하세요.

Name	형식	Description
features	FeaturesItem[]	geometry 개체 및 추가 속성을 포함하는 기능 개체를 `GeoJSON`. 자세한 내용은 RFC 7946, 섹션 3.2참조하세요.
type	FeatureTypeEnum	`GeoJSON` 형식을 지정합니다. 지원되는 유일한 개체 형식은 `FeatureCollection`. For more information, see RFC 7946.

FeaturesItem

Object

Geometry 개체와 경로의 추가 속성을 포함하는 GeoJSON 기능 개체입니다.

Name	형식	Description
bbox	number[] (double)	경계 상자 개체로 정의된 지구의 사각형 영역입니다. 사각형의 측면은 위도 및 경도 값으로 정의됩니다. 자세한 내용은 RFC 7946, 섹션 5참조하세요. 예: "bbox": [-10.0, -10.0, 10.0, 10.0]
geometry	RouteDirectionsGeometry: MultiLineStringGeometry PointGeometry	유효한 `GeoJSON` Geometry 개체입니다. For more information, see RFC 7946.
properties	FeatureProperties: ManeuverPointProperties RoutePathProperties WaypointProperties	여정, 경로 다리 및 기하 도형, 여행 요약과 같은 경로의 기능 속성을 지정합니다.
type	FeaturesItemTypeEnum	`GeoJSON` 형식을 지정합니다. 유일하게 지원되는 개체 유형은 Feature입니다. For more information, see RFC 7946.

FeaturesItemTypeEnum

열거형

GeoJSON 형식을 지정합니다. 유일하게 지원되는 개체 유형은 Feature입니다. For more information, see RFC 7946.

값	Description
Feature	`GeoJSON` Feature 개체 형식을 지정합니다.

FeatureTypeEnum

열거형

GeoJSON 형식을 지정합니다. 지원되는 유일한 개체 형식은 FeatureCollection. For more information, see RFC 7946.

값	Description
FeatureCollection	`GeoJSON` `FeatureCollection` 개체 형식을 지정합니다.

GeoJsonPoint

Object

유효한 GeoJSON Point 기하 도형 형식입니다. Please refer to RFC 7946 for details.

Name	형식	Description
coordinates	number[] (double)	`Position` 두 개 이상의 요소가 있는 숫자 배열입니다. The first two elements are longitude and latitude, precisely in that order. Altitude/Elevation is an optional third element. Please refer to RFC 7946 for details.
type	string: Point	`GeoJSON` 형식을 지정합니다. Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, FeatureCollection 등 유효한 9가지 GeoJSON 개체 형식 중 하나여야 합니다.

InputWaypointFeaturesItem

Object

입력 웨이포인트 및 viaWaypoint GeoJSON 기능 개체 및 추가 속성을 지정합니다. For more information, see RFC 7946.

Name	형식	Description
geometry	GeoJsonPoint: PointGeometry	유효한 `GeoJSON Point` 기하 도형 형식입니다. Please refer to RFC 7946 for details.
properties	InputWaypointProperties	참조 또는 중지 지점 역할을 하는 경로 또는 여정을 따라 특정 위치 또는 지점인 웨이포인트의 속성을 지정합니다.
type	FeaturesItemTypeEnum	`GeoJSON` 형식을 지정합니다. 유일하게 지원되는 개체 유형은 Feature입니다. For more information, see RFC 7946.

InputWaypointProperties

Object

참조 또는 중지 지점 역할을 하는 경로 또는 여정을 따라 특정 위치 또는 지점인 웨이포인트의 속성을 지정합니다.

Name	형식	Default value	Description
pointIndex	integer (int64)		경로의 웨이포인트 시퀀스를 식별하고 순서를 지정합니다. 기본값은 기능 배열의 `index value`.
pointType	InputWaypointTypeEnum	waypoint	경로의 웨이포인트 유형입니다. 경로가 통과해야 하는 중지 또는 중간 위치일 수 있습니다.

InputWaypointTypeEnum

열거형

경로의 웨이포인트 유형입니다. 경로가 통과해야 하는 중지 또는 중간 위치일 수 있습니다.

값	Description
waypoint	중간 지점은 참조 또는 중지 지점 역할을 하는 경로 또는 여정을 따라 특정 위치 또는 지점입니다.
viaWaypoint	viaWaypoint는 경로 또는 여행을 따라 통과하거나 방문해야 하는 특정 중간 지점입니다.

Instruction

Object

방향 집합의 기동에 대한 설명입니다.

Name	형식	Description
drivingSide	DrivingSideEnum	기동 지점에서 왼쪽 및 오른쪽 주행을 나타냅니다.
formattedText	string	명령에 대한 서식이 지정된 텍스트 설명입니다.
maneuverType	ManeuverTypeEnum	이 자세한 컬렉션에 설명된 기동 유형입니다. ManeuverType은 해당 명령으로 지정된 기동의 일부에 대한 정보를 제공합니다. 예를 들어 명령의 maneuverType은 TurnLeftThenTurnRight를 지정할 수 있지만 관련 세부 항목은 TurnLeft 및 TurnRight 기동에 대한 세부 정보를 제공할 수 있습니다.
text	string	명령에 대한 일반 텍스트 설명입니다.

Leg

Object

두 중간 지점 간의 경로 섹션에 대한 정보입니다. 경로 Leg에 포함된 필드에 대한 자세한 정보:

Name	형식	Description
arrivalAt	string (date-time)	교통 상황을 고려하는 다리의 예상 도착 시간은 RFC 3339, 섹션 5.6정의된 dateTime 값으로 형식이 지정됩니다. `departAt` 또는 `arrivalAt`표준 시간대 오프셋을 참조합니다. 그렇지 않은 경우 UTC 시간이 사용됩니다.
departureAt	string (date-time)	교통 상황을 고려하는 다리의 예상 출발 시간은 RFC 3339, 섹션 5.6정의된 dateTime 값으로 형식이 지정됩니다. `departAt` 또는 `arrivalAt`표준 시간대 오프셋을 참조합니다. 그렇지 않은 경우 UTC 시간이 사용됩니다.
distanceInMeters	number	경로 Leg로 덮인 미터 단위의 물리적 거리입니다.
durationInSeconds	integer (int64)	교통 상황으로 인한 경로 지연을 포함하지 않는 예상 이동 시간(초)입니다.
durationTrafficInSeconds	integer (int64)	현재 트래픽 조건이 있는 해당 `TravelDistance` 이동하는 데 걸리는 시간(초)입니다. 이 값은 `optimizeRoute` 트래픽 고려 사항을 포함하는 경우 제공됩니다.
routePathRange	RoutePathRange	경로 또는 경로의 특정 레그에서 적용되는 범위를 나타냅니다.

ManeuverPointProperties

Object

경로 Leg의 각 기동 지점에 대한 운전 지침 및 추가 속성을 지정합니다.

Name	형식	Default value	Description
address	Address		경로의 웨이포인트 및 기동 지점에 대한 행정 구역 및 국가 지역입니다.
distanceInMeters	number		이 경로 단계에서 다루는 실제 거리(미터)입니다.
durationInSeconds	integer (int64)		해당 `TravelDistance`이동하는 데 걸리는 시간(초)입니다.
exitIdentifier	string		이 경로 단계와 연결된 종료의 이름 또는 번호입니다.
instruction	Instruction		방향 집합의 기동에 대한 설명입니다.
order	Order		웨이포인트 방문 순서입니다.
routePathPoint	RoutePathPoint		경로의 특정 레그 내에 있는 점의 인덱스를 참조합니다.
sideOfStreet	SideOfStreetEnum		도착 방향에 따라 목적지가 발견되는 거리의 측면입니다. 이 필드는 마지막 기동 포인트에만 적용됩니다.
signs	string[]		경로에 대한 사이니지 텍스트입니다. 두 개 이상의 기호 값이 있을 수 있습니다.
steps	Step[]		두 개의 연속된 기동 지점 사이의 단계입니다.
towardsRoadName	string		첫 번째 `ManeuverPoint`경로가 향하는 거리의 이름입니다.
travelMode	RoutePathTravelModeEnum	driving	응답의 경로 경로에 대한 이동 모드입니다.
type	string: ManeuverPoint		Output type.

ManeuverTypeEnum

열거형

이 자세한 컬렉션에 설명된 기동 유형입니다. ManeuverType은 해당 명령으로 지정된 기동의 일부에 대한 정보를 제공합니다. 예를 들어 명령의 maneuverType은 TurnLeftThenTurnRight를 지정할 수 있지만 관련 세부 항목은 TurnLeft 및 TurnRight 기동에 대한 세부 정보를 제공할 수 있습니다.

값	Description
ArriveFinish	최종 목적지에 도착합니다.
ArriveIntermediate	중간 중간 중간 지점에 도착합니다.
BearLeft	Bear left.
BearLeftThenBearLeft	곰은 왼쪽으로 한 다음 다시 왼쪽으로 곰.
BearLeftThenBearRight	왼쪽으로 곰을 낳은 다음 오른쪽으로 곰.
BearLeftThenTurnLeft	왼쪽으로 곰을 맡은 다음 좌회전합니다.
BearLeftThenTurnRight	왼쪽으로 곰을 낳은 다음 오른쪽으로 돌립니다.
BearRight	Bear right.
BearRightThenBearLeft	오른쪽으로 곰을 낳은 다음 왼쪽으로 곰.
BearRightThenBearRight	오른쪽으로 곰을 낳은 다음 다시 오른쪽으로 낳습니다.
BearRightThenTurnLeft	오른쪽으로 곰을 낳은 다음 좌회전합니다.
BearRightThenTurnRight	오른쪽으로 곰을 낳은 다음 오른쪽으로 돌립니다.
BearThenKeep	곰 명령 및 유지 명령
BearThenMerge	명령 및 병합 명령을 전달합니다.
Continue	현재 도로에서 계속 진행합니다.
DepartIntermediateStop	중간 중간 중간 지점을 도착한 것과 다른 방향과 도로로 둡니다.
DepartIntermediateStopReturning	중간 중간 중간 지점은 동일한 방향과 도착한 동일한 도로에 둡니다.
DepartStart	시작점을 그대로 둡니다.
EnterRoundabout	로터리를 입력합니다.
ExitRoundabout	로터리를 종료합니다.
EnterThenExitRoundabout	로터리를 입력하고 종료합니다.
ExitRoundaboutRight	로터리에서 오른쪽의 출구를 가져옵니다.
ExitRoundaboutLeft	로터리에서 왼쪽의 출구를 가져옵니다.
Follow	Follow.
GoAroundRoundabout	로터리 주위를 이동합니다.
KeepLeft	다른 도로에 남아 있습니다.
KeepOnRampLeft	왼쪽에 두고 경사로로 계속 올라갑니다.
KeepOnRampRight	오른쪽으로 유지하고 경사로로 계속 진행합니다.
KeepOnRampStraight	똑바로 유지하고 경사로로 계속 올라가십시오.
KeepRight	다른 도로에 바로 유지합니다.
KeepStraight	다른 도로에 똑바로 유지합니다.
KeepToStayLeft	같은 길에 머물 왼쪽 유지.
KeepToStayRight	같은 도로에 머물 권리를 유지합니다.
KeepToStayStraight	같은 도로에 머물 똑바로 유지합니다.
MergeFreeway	고속도로에 병합합니다.
MergeHighway	고속도로에 병합합니다.
MergeMotorway	고속도로에 병합합니다.
MotorwayExitLeft	왼쪽 출구를 가져 가라.
MotorwayExitRight	오른쪽 출구를 가져 가라.
None	No instruction.
RampThenHighwayLeft	고속도로에 왼쪽 램프를 가져 가라. 이것은 결합된 명령의 일부입니다.
RampThenHighwayRight	고속도로에 오른쪽 경사로를 타고. 이것은 결합된 명령의 일부입니다.
RampThenHighwayStraight	고속도로에 경사로를 타고 똑바로 유지. 이것은 결합된 명령의 일부입니다.
RoadNameChange	도로 이름이 변경됩니다.
SwitchToParallelRoad	병렬 도로로 전환합니다.
SwitchToMainRoad	주요 도로로 전환합니다.
Take	길을 가져 가라. 이 명령은 페리를 출입할 때 사용됩니다.
TakeFerry	페리를 타고.
TakeExit	출구를 가져 가라.
TakeRamp	Take ramp.
TakeRampLeft	경사로를 왼쪽으로 가져 가라.
TakeRampRight	오른쪽으로 경사로를 가져 가라.
TakeRampStraight	경사로를 이용하려면 똑바로 하십시오.
TurnBack	날카롭게 뒤로 돌립니다.
TurnLeft	Turn left.
TurnLeftSharp	날카로운 좌회전을 한다.
TurnLeftThenBearLeft	좌회전한 다음 왼쪽으로 감습니다.
TurnLeftThenBearRight	좌회전한 다음 오른쪽으로 감습니다.
TurnLeftThenTurnLeft	좌회전한 다음 다시 좌회전합니다.
TurnLeftThenTurnRight	좌회전한 다음 오른쪽으로 돌립니다.
TurnRight	Turn right.
TurnRightSharp	날카로운 오른쪽 회전을.
TurnRightThenBearLeft	오른쪽으로 돌고 왼쪽으로 감습니다.
TurnRightThenBearRight	오른쪽으로 돌고 오른쪽으로 감습니다.
TurnRightThenTurnLeft	오른쪽으로 돌고 좌회전합니다.
TurnRightThenTurnRight	오른쪽으로 돌고 다시 오른쪽으로 돌립니다.
TurnThenMerge	명령과 병합 명령을 차례로 켭니다.
TurnToStayLeft	좌회전하여 같은 길을 따라 가세요.
TurnToStayRight	같은 도로에 머물 오른쪽을 설정합니다.
Unknown	명령을 알 수 없습니다.
UTurn	반대 방향으로 이동하는 유턴을 합니다.
Wait	Wait
Walk	Walk

MapsErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	MapsErrorDetail[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	MapsInnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

MapsErrorResponse

Object

실패한 작업에 대한 오류 세부 정보를 반환하는 Azure Maps API에 대한 일반적인 오류 응답입니다.

Name	형식	Description
error	MapsErrorDetail	오류 세부 정보입니다.

MapsInnerError

Object

오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.

Name	형식	Description
code	string	오류 코드입니다.
innererror	MapsInnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.

MultiLineStringGeometry

Object

GeoJSON MultiLineString Geometry 개체를 지정합니다. For more information, see RFC 7946.

Name	형식	Description
coordinates	number[] (double)	`GeoJson MultiLineString` 기하 도형의 좌표입니다.
type	string: MultiLineString	`GeoJSON` Geometry 개체의 기하 도형 형식을 지정합니다. For more information, see RFC 7946.

OptimizedWaypoint

Object

최적화된 방법 지점 개체입니다.

Name	형식	Description
inputIndex	integer (int64)	사용자가 제공하는 방법 지점 인덱스입니다.
optimizedIndex	integer (int64)	시스템에서 최적화된 점 인덱스입니다.

Order

Object

웨이포인트 방문 순서입니다.

Name	형식	Description
inputIndex	integer (int64)	웨이포인트에 대한 사용자 제공 인덱스
optimizedIndex	integer (int64)	System-optimized waypoint

PointGeometry

Object

범위 다각형을 계산해야 하는 유효한 GeoJSON Geometry 개체로 전달된 원점입니다. Please refer to RFC 7946 for details.

Note: API는 요청된 원본 지점을 가장 가까운 도로 네트워크에 스냅하고 범위 계산에 사용합니다. 응답의 center 지점으로 반환됩니다.

Name	형식	Description
coordinates	number[] (double)	`Position` 두 개 이상의 요소가 있는 숫자 배열입니다. The first two elements are longitude and latitude, precisely in that order. Altitude/Elevation is an optional third element. Please refer to RFC 7946 for details.
type	string: Point	`GeoJSON` Geometry 개체의 기하 도형 형식을 지정합니다. For more information, see RFC 7946.

RouteDirectionOptimizeRouteEnum

열거형

경로를 최적화하는 데 사용할 매개 변수를 지정합니다. 정의되지 않은 경우 기본값은 현재 트래픽 정보를 사용하지 않고 이동 시간을 최소화하기 위해 경로를 반환하는 "fastestWithoutTraffic"입니다.

Example: "optimizeRoute":"shortest"

값	Description
shortest	경로를 계산하여 거리를 최소화합니다. 트래픽 정보는 사용되지 않습니다.
fastestWithoutTraffic	트래픽 정보를 고려하지 않고 가장 빠른 경로를 찾습니다.
fastestAvoidClosureWithoutTraffic
fastestWithTraffic	경로는 현재 트래픽 정보를 사용하는 시간을 최소화하기 위해 계산됩니다. `Note`: 운전 및 트럭 travelMode에 대해서만 지원합니다.

RouteDirectionsResponse

Object

이 개체는 성공적인 호출에서 반환됩니다.

Name	형식	Description
alternativeRoutes	FeatureCollection[]	Alternative route.
features	FeaturesItem[]	geometry 개체 및 추가 속성을 포함하는 기능 개체를 `GeoJSON`. 자세한 내용은 RFC 7946, 섹션 3.2참조하세요.
type	FeatureTypeEnum	`GeoJSON` 형식을 지정합니다. 지원되는 유일한 개체 형식은 `FeatureCollection`. For more information, see RFC 7946.

RouteDirectionVehicleSpec

Object

트럭 라우팅에 대해서만 크기, 무게, 최대 속도, 화물 유형 등과 같은 차량 특성을 지정합니다. 이를 통해 낮은 교량 통관, 도로 제한, 어려운 오른쪽 회전을 방지하여 차량 사양에 따라 최적화된 트럭 경로를 제공할 수 있습니다.

ISNote: 트럭 travelMode에 대해서만 지원됩니다.

Name	형식	Default value	Description
adrTunnelRestrictionCode	AdrTunnelRestrictionCodeEnum		ADR 터널 제한 코드입니다. ADR은 도로로 위험물의 국제 운송에 관한 유럽 협정입니다. ADR 터널 제한 코드는 차량이 위험물 운송에 대한 제한 사항이 있는 터널을 통과할 수 있는지 여부를 결정하는 데 사용됩니다.
axleCount	integer (int64)		차량의 차축 수입니다.
axleWeight	integer (int64) minimum: 0 maximum: 1000000	0	차량의 차축당 무게(kg)입니다. 값이 0이면 액슬당 가중치 제한이 고려되지 않습니다.
height	number (double) minimum: 0 maximum: 1000000	0	차량의 높이(미터)입니다. 값이 0이면 높이 제한이 고려되지 않습니다.
isVehicleCommercial	boolean	False	차량이 상업적 목적으로 사용되는지 여부입니다. 상용 차량은 일부 도로에서 운전할 수 없습니다.
length	number (double) minimum: 0 maximum: 1000000	0	차량의 길이(미터)입니다. 값이 0이면 길이 제한이 고려되지 않습니다.
loadType	VehicleLoadTypeEnum[]		위험 물질로 분류되고 일부 도로에서 제한될 수 있는 화물 유형입니다. 사용 가능한 vehicleLoadType 값은 미국 Hazmat 클래스 1~9와 다른 국가에서 사용할 일반 분류입니다. USHazmat로 시작하는 값은 미국 라우팅을 위한 값이며 다른 모든 국가에서는 otherHazmat을 사용해야 합니다. vehicleLoadType은 요청에서 여러 값을 지원합니다.
maxSpeed	integer (int64) minimum: 0 maximum: 250	0	차량의 최대 속도(km/hour)입니다. 차량 프로필의 최대 속도는 차량이 고속도로에서 허용되는지 여부를 확인하는 데 사용됩니다. 값이 0이면 경로 계획 중에 차량에 대한 적절한 값이 결정되고 적용됩니다. 경로 계획 중에 0이 아닌 값이 재정의될 수 있습니다. 예를 들어 현재 트래픽 흐름은 시속 60km입니다. 차량 최대 속도를 시속 50km로 설정하면 라우팅 엔진은 현재 상황이므로 60km/시속을 고려합니다. 차량의 최대 속도는 80km/시속으로 제공되지만 현재 교통 흐름은 시속 60km인 경우 라우팅 엔진은 시속 60km를 다시 사용합니다.
weight	integer (int64) minimum: 0 maximum: 1000000	0	차량의 무게(킬로그램)입니다. 값이 0이면 가중치 제한이 고려되지 않습니다.
width	number (double) minimum: 0 maximum: 1000000	0	차량 너비(미터)입니다. 값이 0이면 너비 제한이 고려되지 않습니다.

RouteOutputOptionEnum

열거형

응답에서 원하는 경로 정보를 포함합니다. 기본적으로 일정은 응답에 포함됩니다.

"routeOutputOptions": ["routePath", "itinerary"]와 같은 여러 값 지원

값	Description
routeSummary	경로에 대한 이동 시간 및 거리만 포함하고 다른 정보는 제공하지 않습니다.
routePath	응답에서 경로 경로를 설명하는 GeoJSON MultiLineString RFC 7946 섹션 3.1.5 포함합니다.
itinerary	응답에 자세한 지침을 포함합니다. 자세한 지침은 "조작 지점"으로 제공되며 턴 바이 턴 지침과 같은 세부 정보를 포함합니다.

RoutePathPoint

Object

경로의 특정 레그 내에 있는 점의 인덱스를 참조합니다.

Name	형식	Description
legIndex	integer (int64)	경로 Leg 인덱스는 경로의 여러 세그먼트를 식별하고 구분하는 데 도움이 되도록 경로의 각 레그에 할당된 순차 번호입니다.
pointIndex	integer (int64)	특정 레그 내의 점 인덱스입니다.

RoutePathProperties

Object

응답에서 경로의 경로를 설명하는 속성을 지정합니다.

Name	형식	Description
arrivalAt	string (date-time)	교통 상황을 고려하는 다리의 예상 도착 시간은 rfC 3339, 섹션 5.6정의된 값으로 . `departAt` 또는 `arrivalAt`표준 시간대 오프셋을 참조합니다. 그렇지 않은 경우 UTC 시간이 사용됩니다.
departureAt	string (date-time)	교통 상황을 고려하는 다리의 예상 출발 시간은 `dateTime`정의된 값으로 형식이 지정됩니다. `departAt` 또는 `arrivalAt`표준 시간대 오프셋을 참조합니다. 그렇지 않은 경우 UTC 시간이 사용됩니다.
distanceInMeters	number	전체 경로에서 적용되는 실제 거리(미터)입니다.
durationInSeconds	integer (int64)	교통 상황으로 인한 경로 지연을 포함하지 않는 예상 이동 시간(초)입니다.
durationTrafficInSeconds	integer (int64)	현재 트래픽 조건이 있는 해당 `TravelDistance` 이동하는 데 걸리는 시간(초)입니다. 이 값은 `optimizeRoute` 트래픽 고려 사항을 포함하는 경우 제공됩니다.
legs	Leg[]	경로 다리의 배열입니다. 자세한 내용은 경로 Leg 개체 설명을 확인하세요.
optimizedWaypoints	OptimizedWaypoint[]	최적화된 웨이포인트 시퀀스입니다. 원래 및 최적화된 목록에 대해 사용자가 제공한 웨이포인트 시퀀스의 인덱스를 표시합니다.
trafficCongestion	TrafficCongestionEnum	경로를 따라 교통 혼잡의 수준입니다. `Note`: travelMode 운전에 대해서만 지원됨
type	string: RoutePath	Output type.

RoutePathRange

Object

경로 또는 경로의 특정 레그에서 적용되는 범위를 나타냅니다.

Name	형식	Description
legIndex	integer (int64)	경로 Leg 인덱스는 경로의 여러 세그먼트를 식별하고 구분하는 데 도움이 되도록 경로의 각 레그에 할당된 순차 번호입니다.
range	integer[] (int64)	경로 또는 경로의 특정 레그에서 적용되는 범위를 나타냅니다.

RoutePathTravelModeEnum

열거형

응답의 경로 경로에 대한 이동 모드입니다.

값	Description
driving	자동차에 최적화된 경로입니다.
truck	차량 사양에 따라 대형 트럭에 최적화된 경로입니다.
walking	보행자에 최적화된 경로입니다.
other	경로의 특정 섹션에 대해 트럭 경로를 사용할 수 없는 경우 RouteTravelMode는 트럭 travelMode에 대해 "기타"로 반환됩니다.

SideOfStreetEnum

열거형

도착 방향에 따라 목적지가 발견되는 거리의 측면입니다. 이 필드는 마지막 기동 포인트에만 적용됩니다.

값	Description
Left	Left.
Right	Right.
Unknown	Unknown.

Step

Object

경로 레그에는 턴 바이 턴 지침이 포함되어 있습니다. 단계는 두 개의 연속된 기동점 사이의 경로 범위를 나타냅니다.

Name	형식	Description
maneuverType	ManeuverTypeEnum	이 자세한 컬렉션에 설명된 기동 유형입니다. ManeuverType은 해당 명령으로 지정된 기동의 일부에 대한 정보를 제공합니다. 예를 들어 명령의 maneuverType은 TurnLeftThenTurnRight를 지정할 수 있지만 관련 세부 항목은 TurnLeft 및 TurnRight 기동에 대한 세부 정보를 제공할 수 있습니다.
names	string[]	기동이 발생하는 거리, 고속도로 또는 교차로입니다. 기동이 복잡한 경우 세부 정보 컬렉션에 둘 이상의 이름 필드가 있을 수 있습니다. 이름 필드에 값이 없을 수도 있습니다. 이 문제는 이름을 알 수 없거나 거리, 고속도로 또는 교차로에 이름이 없는 경우에 발생할 수 있습니다.
routePathRange	RoutePathRange	경로 또는 경로의 특정 레그에서 적용되는 범위를 나타냅니다.

TrafficCongestionEnum

열거형

경로를 따라 교통 혼잡의 수준입니다. Note: travelMode 운전에 대해서만 지원됨

값	Description
Unknown	Unknown.
None	None.
Mild	Mild.
Medium	Medium.
Heavy	Heavy.

TravelModeEnum

열거형

요청된 경로에 대한 이동 모드입니다. 정의되지 않은 경우 기본값은 자동차에 최적화된 경로를 반환하는 "운전"입니다.

Note: 트럭 travelMode의 경우 요청된 트럭 경로를 전체 경로에 사용할 수 없습니다. 특정 섹션에 트럭 경로를 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"입니다.

Example: "travelMode":"driving"

값	Description
driving	반환된 경로는 자동차에 최적화되어 있습니다.
truck	반환된 경로는 차량 사양에 따라 대형 트럭에 최적화됩니다.
walking	반환된 경로는 보도 사용을 포함하여 보행자에 최적화되어 있습니다.

VehicleLoadTypeEnum

열거형

위험 물질로 분류되고 일부 도로에서 제한될 수 있는 화물 유형입니다. 사용 가능한 vehicleLoadType 값은 미국 Hazmat 클래스 1~9와 다른 국가에서 사용할 일반 분류입니다. USHazmat로 시작하는 값은 미국 라우팅을 위한 값이며 다른 모든 국가에서는 otherHazmat을 사용해야 합니다. vehicleLoadType은 요청에서 여러 값을 지원합니다.

값	Description
USHazmatClass1	Explosives
USHazmatClass2	Compressed gas
USHazmatClass3	Flammable liquids
USHazmatClass4	Flammable solids
USHazmatClass5	Oxidizers
USHazmatClass6	Poisons
USHazmatClass7	Radioactive
USHazmatClass8	Corrosives
USHazmatClass9	Miscellaneous
otherHazmatExplosive	Explosives
otherHazmatGeneral	Miscellaneous
otherHazmatHarmfulToWater	물에 유해

WaypointProperties

Object

참조 또는 중지 지점 역할을 하는 경로 또는 여정을 따라 특정 위치 또는 지점인 웨이포인트의 속성을 지정합니다.

Name	형식	Default value	Description
address	Address		경로의 웨이포인트 및 기동 지점에 대한 행정 구역 및 국가 지역입니다.
distanceInMeters	number		이 경로 단계에서 다루는 실제 거리(미터)입니다.
durationInSeconds	integer (int64)		해당 `TravelDistance`이동하는 데 걸리는 시간(초)입니다.
exitIdentifier	string		이 경로 단계와 연결된 종료의 이름 또는 번호입니다.
instruction	Instruction		방향 집합의 기동에 대한 설명입니다.
order	Order		웨이포인트 방문 순서입니다.
routePathPoint	RoutePathPoint		경로의 특정 레그 내에 있는 점의 인덱스를 참조합니다.
sideOfStreet	SideOfStreetEnum		도착 방향에 따라 목적지가 발견되는 거리의 측면입니다. 이 필드는 마지막 기동 포인트에만 적용됩니다.
signs	string[]		경로에 대한 사이니지 텍스트입니다. 두 개 이상의 기호 값이 있을 수 있습니다.
steps	Step[]		두 개의 연속된 기동 지점 사이의 단계입니다.
towardsRoadName	string		첫 번째 `ManeuverPoint`경로가 향하는 거리의 이름입니다.
travelMode	RoutePathTravelModeEnum	driving	응답의 경로 경로에 대한 이동 모드입니다.
type	string: Waypoint		Output type.

다음을 통해 공유

Route - Post Route Directions

URI 매개 변수

요청 헤더

요청 본문

응답

보안

AADToken

범위

subscription-key

SAS Token

예제

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

샘플 요청

샘플 응답

정의

Address

AdminDistrict

AdrTunnelRestrictionCodeEnum

AvoidEnum

CountryRegion

DirectionsRequest

DrivingSideEnum

FeatureCollection

FeaturesItem

FeaturesItemTypeEnum

FeatureTypeEnum

GeoJsonPoint

InputWaypointFeaturesItem

InputWaypointProperties

InputWaypointTypeEnum

Instruction

Leg

ManeuverPointProperties

ManeuverTypeEnum

MapsErrorDetail

MapsErrorResponse

MapsInnerError

MultiLineStringGeometry

OptimizedWaypoint

Order

PointGeometry

RouteDirectionOptimizeRouteEnum

RouteDirectionsResponse

RouteDirectionVehicleSpec

RouteOutputOptionEnum

RoutePathPoint

RoutePathProperties

RoutePathRange

RoutePathTravelModeEnum

SideOfStreetEnum

Step

TrafficCongestionEnum

TravelModeEnum

VehicleLoadTypeEnum

WaypointProperties