Azure Maps Route Service에 대한 모범 사례

Azure Maps Route Service의 경로 방향 및 경로 매트릭스 API를 사용하여 요청된 각 경로에 대한 ETA(예상 도착 시간)를 계산할 수 있습니다. 경로 API는 요청한 날짜 및 시간의 일반적인 도로 속도와 같은 실시간 트래픽 정보 및 과거 트래픽 데이터와 같은 요소를 고려합니다. 이 API는 시간 또는 거리를 기준으로 차례대로 또는 최적화된 순서대로 한 번에 여러 대상에서 사용할 수 있는 최단 경로 또는 가장 빠른 경로를 반환합니다. 또한 사용자가 도보 이동자, 자전거 이용자 및 트럭 같은 상업용 차량의 특수 경로 및 세부 정보를 요청할 수 있습니다. 이 문서에서는 다음 방법을 포함하여 Azure Maps Route Service 호출에 대한 모범 사례를 설명합니다.

• 경로 방향 API와 매트릭스 라우팅 API 중에서 선택
• 실시간 및 과거 트래픽 데이터를 기반으로 기록 및 예측된 이동 시간 요청
• 전체 경로 및 경로의 각 지선에 대한 시간 및 거리와 같은 경로 세부 정보 요청
• 트럭과 같은 상업용 차량에 대한 경로 요청
• 경로와 함께 정체 및 톨게이트 요금 정보와 같은 교통 정보 요청
• 하나 이상의 경유지(중간 지점)로 구성된 경로 요청
• 각 경유지(이동 경로)를 방문할 최적의 순서를 가져오기 위해 하나 이상의 중지점 경로 최적화
• 지원 지점을 사용하여 대체 경로를 최적화합니다. 예를 들어 전기 차량 충전소를 통과하는 대체 경로를 제공합니다.
• Azure Maps 웹 SDK에서 Route Service 사용

필수 조건

• Azure Maps 계정
• 구독 키

Route Service의 적용 범위에 대한 자세한 내용은 라우팅 적용 범위를 참조하세요.

Postman 또는 bruno와 같은 API 개발 환경을 사용하여 이 문서에 표시된 HTTP 요청 샘플을 실행하거나 REST 호출을 빌드할 수 있습니다.

경로 방향 및 매트릭스 라우팅 중에서 선택

경로 방향 API는 경로에 대한 좌표 및 이동 시간을 포함한 지침을 반환합니다. 경로 매트릭스 API를 사용하면 출발지 위치와 목적지 위치로 정의된 경로 세트에 대한 이동 시간과 거리를 계산할 수 있습니다. 매트릭스 API는 지정된 모든 출발지에 대해 해당 출발지부터 지정된 모든 목적지까지의 라우팅 비용(이동 시간 및 거리)을 계산합니다. 이러한 API를 사용하여 원하는 출발 시간, 도착 시간 및 차량 유형(예: 자동차 또는 트럭)과 같은 매개 변수를 지정할 수 있습니다. 매개 변수는 모두 그에 따라 실시간 또는 예측 교통 데이터를 사용하여 가장 최적의 경로를 반환합니다.

다음과 같은 시나리오에서는 경로 방향 API를 호출하는 것이 좋습니다.

• 배달 차량의 정확한 도착 시간을 확인하려면 둘 이상의 알려진 위치 사이의 가장 짧거나 가장 빠른 주행 경로를 요청합니다.
• 경로 기하 도형을 비롯한 자세한 경로 안내를 요청하여 지도에 경로를 시각화합니다.
• 고객 위치 목록이 제공된 경우 각 고객 위치를 방문하고 출발지로 돌아갈 수 있는 가장 짧은 경로를 계산합니다. 이 시나리오를 일반적으로 여행하는 외판원 문제라고 합니다. 한 요청에서 최대 150개의 중간 지점(경유지)을 통과할 수 있습니다.
• 단일 API 호출을 사용하여 경로 방향 일괄 처리 API에 쿼리 일괄 처리를 보냅니다.

다음과 같은 시나리오에서는 매트릭스 라우팅 API를 호출하는 것이 좋습니다.

• 출발지와 목적지 세트 간 이동 시간 및 거리를 계산합니다. 예를 들어 운전자가 12명이고, 식당에서 배달 음식을 픽업할 수 있는 가장 가까운 운전자를 찾아야 합니다.
• 실제 이동 거리 또는 시간별로 가능한 경로를 정렬합니다. 매트릭스 API는 각 출발지와 목적지 조합에 대한 이동 시간과 거리만 반환합니다.
• 이동 시간 또는 거리를 기준으로 데이터를 클러스터링합니다. 예를 들어 회사에는 50명의 직원이 있으며, 사무실에서 차로 20분 이내에 거주하는 모든 직원을 찾습니다.

다음은 경로 방향 및 매트릭스 API의 몇 가지 기능을 비교하여 보여 준 것입니다.

전기 차량 라우팅 기능에 대해 자세히 알아보려면 Azure Notebooks를 사용하여 전기 차량 라우팅(Python) 방법에 대한 자습서를 참조하세요.

기록 및 실시간 데이터 요청

기본적으로 Route Service는 이동 수단이 자동차이며 출발 시간이 현재라고 가정합니다. 경로 계산 요청에서 달리 지정하지 않는 한 실시간 교통 상황에 따라 경로를 반환합니다. 라우팅 엔진 요소는 '오후 4시부터 오후 6시 사이에는 좌회전이 허용되지 않습니다'와 같은 시간에 따른 트래픽 제한을 고정했습니다. 현재 실시간 교통을 무시하는 경로를 구체적으로 요청하지 않을 경우 도로 공사와 같은 도로 폐쇄가 고려됩니다. 현재 교통을 무시하려면 API 요청에서 traffic을 false로 설정합니다.

경로 계산 travelTimeInSeconds 값에 교통으로 인한 지연 시간이 포함됩니다. 출발 시간이 지금으로 설정된 경우 현재 및 과거 이동 시간 데이터를 사용하여 생성됩니다. 출발 시간이 미래로 설정된 경우 API는 기록 데이터를 기반으로 예측된 이동 시간을 반환합니다.

요청에 computeTravelTimeFor=all 매개 변수를 포함하는 경우 응답의 요약 요소에는 과거 트래픽 상황을 포함하여 다음 필드가 포함됩니다.

다음 섹션에서는 설명한 매개 변수를 사용하여 경로 API를 호출하는 방법을 보여 줍니다.

샘플 쿼리

아래의 첫 번째 예제에서 출발 시간은 작성할 때 미래로 설정됩니다.

https://atlas.microsoft.com/route/directions/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&query=51.368752,-0.118332:51.385426,-0.128929&travelMode=car&traffic=true&departAt=2025-03-29T08:00:20&computeTravelTimeFor=all

응답에는 다음 예와 같은 요약 요소가 포함되어 있습니다. 출발 시간이 미래로 설정되므로 trafficDelayInSeconds 값은 0입니다. travelTimeInSeconds 값은 시간 종속 기록 교통 데이터를 사용하여 계산됩니다. 따라서 이 경우 travelTimeInSeconds 값은 historicTrafficTravelTimeInSeconds 값과 동일합니다.

"summary": {
    "lengthInMeters": 2131,
    "travelTimeInSeconds": 248,
    "trafficDelayInSeconds": 0,
    "departureTime": "2025-03-29T08:00:20Z",
    "arrivalTime": "2025-03-29T08:04:28Z",
    "noTrafficTravelTimeInSeconds": 225,
    "historicTrafficTravelTimeInSeconds": 248,
    "liveTrafficIncidentsTravelTimeInSeconds": 248
},

샘플 쿼리

다음 예에는 출발 시간이 현재인 실시간 경로 요청이 있습니다. 현재 출발 시간이 기본값이므로 URL에 명시적으로 지정되지 않았습니다.

https://atlas.microsoft.com/route/directions/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&query=47.6422356,-122.1389797:47.6641142,-122.3011268&travelMode=car&traffic=true&computeTravelTimeFor=all

응답에는 다음 예와 같이 요약이 포함됩니다. 정체로 인해 trafficDelaysInSeconds 값이 0보다 큽니다. 또한 historicTrafficTravelTimeInSeconds 값보다 큽니다.

"summary": {
    "lengthInMeters": 16637, 
    "travelTimeInSeconds": 2905, 
    "trafficDelayInSeconds": 1604, 
    "departureTime": "2020-02-28T01:00:20+00:00",
    "arrivalTime": "2020-02-28T01:48:45+00:00", 
    "noTrafficTravelTimeInSeconds": 872, 
    "historicTrafficTravelTimeInSeconds": 1976, 
    "liveTrafficIncidentsTravelTimeInSeconds": 2905 
},

경로 및 지선 세부 정보 요청

기본적으로 Route Service는 좌표 배열을 반환합니다. 응답에는 points라는 목록의 경로를 구성하는 좌표가 포함되어 있습니다. 또한 경로 응답에는 경로의 출발 위치부터의 거리와 예상 경과 시간이 포함됩니다. 이러한 값을 사용하여 전체 경로의 평균 속도를 계산할 수 있습니다.

다음 이미지에서는 points 요소를 보여 줍니다.

경로에 대한 좌표 목록을 보려면 point 요소를 확장합니다.

경로 방향 API는 instructionsType 매개 변수를 지정하여 사용할 수 있는 다양한 명령 형식을 지원합니다. 간단한 컴퓨터 처리를 위한 명령 형식을 지정하려면 instructionsType=coded를 사용합니다. instructionsType=tagged를 사용하여 텍스트로 명령을 표시합니다. 또한 명령의 일부 요소가 표시되는 텍스트로 명령 형식을 지정할 수 있고, 명령이 특수 형식으로 제공됩니다. 자세한 내용은 지원되는 명령 유형 목록을 참조하세요.

명령을 요청하면 응답은 guidance라는 새 요소를 반환합니다. guidance 요소는 턴바이턴 안내와 요약된 명령이라는 두 가지 정보를 포함합니다.

instructions 요소는 이동에 대한 턴바이턴 안내를 포함하고 instructionGroups는 요약된 명령을 포함합니다. 각 명령 요약은 여러 도로에 적용될 수 있는 이동 세그먼트를 포함합니다. 이 API는 교통 혼잡에 대한 좌표 범위 또는 현재 차량 속도 등 경로의 섹션에 대한 세부 정보를 반환할 수 있습니다.

상업용 차량에 대한 경로 요청

Azure Maps 라우팅 API는 상업용 트럭 라우팅을 포함한 상업용 차량 라우팅을 지원합니다. 이 API는 차량의 높이와 무게 및 차량이 위험한 화물을 운반하는지 여부 등 지정된 제한 사항을 고려합니다. 예를 들어 차량이 인화성 물질을 운반하는 경우 라우팅 엔진은 주택 지역 근처에 있는 특정 터널을 피합니다.

샘플 쿼리

아래 샘플 요청은 상업용 트럭에 대한 경로를 쿼리합니다. 트럭이 1등급 유해 폐기물을 운반합니다.

https://atlas.microsoft.com/route/directions/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&vehicleWidth=2&vehicleHeight=2&vehicleCommercial=true&vehicleLoadType=USHazmatClass1&travelMode=truck&instructionsType=text&query=51.368752,-0.118332:41.385426,-0.128929

경로 API가 트럭의 크기 및 유해 폐기물을 수용하는 길 찾기를 반환합니다. guidance 요소를 확장하여 경로 지침을 읽을 수 있습니다.

샘플 쿼리

위 쿼리에서 US Hazmat Class를 변경하면 이 변경 내용을 수용할 수 있는 다른 경로가 생성됩니다.

https://atlas.microsoft.com/route/directions/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&vehicleWidth=2&vehicleHeight=2&vehicleCommercial=true&vehicleLoadType=USHazmatClass9&travelMode=truck&instructionsType=text&query=51.368752,-0.118332:41.385426,-0.128929

다음 응답은 클래스 1 위험 물질보다 덜 위험한 클래스 9 위험 물질을 운반하는 트럭에 대한 것입니다. 길찾기를 읽기 위해 guidance 요소를 확장할 때 길찾기가 동일하지 않다는 점에 유의해야 합니다. 1등급 유해 물질을 운반하는 트럭에 대한 경로 지침이 더 많이 있습니다.

경로를 따라 교통 정보 요청

Azure Maps 경로 방향 API를 사용하면 개발자가 요청에 sectionType 매개 변수를 포함하여 각 섹션 유형에 대한 세부 정보를 요청할 수 있습니다. 예를 들어 각 교통 혼잡 세그먼트에 대한 속도 정보를 요청할 수 있습니다. 요청할 수 있는 다양한 세부 정보를 알아보려면 list of values for the sectionType key(sectionType 키에 대한 값 목록)를 참조하세요.

샘플 쿼리

다음 쿼리는 sectionType을 traffic으로 설정합니다. 이 쿼리는 시애틀부터 샌디에고까지의 교통 정보가 포함된 섹션을 요청합니다.

https://atlas.microsoft.com/route/directions/json?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=1.0&sectionType=traffic&query=47.6062,-122.3321:32.7157,-117.1611

응답에는 지정된 좌표를 따라 교통에 적합한 섹션이 포함되어 있습니다.

이 옵션은 다음 이미지와 같이 맵을 렌더링할 때 섹션 색을 지정하는 데 사용할 수 있습니다.

다중 경유 경로 계산 및 최적화

Azure Maps는 현재 다음 두 가지 형태의 경로 최적화를 제공합니다.

• 중간 지점의 순서를 변경하지 않고 요청된 경로 유형을 기반으로 최적화. 자세한 내용은 RouteType을 참조하세요.

• 각 경유지를 방문할 최적의 순서를 얻기 위해 중간 지점의 순서를 변경하는 여행하는 외판원 최적화

다중 경유 라우팅의 경우 단일 경로 요청에 최대 150개의 중간 지점을 지정할 수 있습니다. 왕복의 경우와 마찬가지로 시작 및 끝 좌표 위치는 동일할 수 있습니다. 하지만 경로를 계산하려면 경유지를 하나 이상 더 제공해야 합니다. 중간 지점은 출발지 좌표와 목적지 좌표 사이의 쿼리에 추가할 수 있습니다.

지정된 중간 지점을 방문하는 최적의 순서를 최적화하려면 computeBestOrder=true를 지정해야 합니다. 이 시나리오를 여행하는 외판원 최적화 문제라고도 합니다.

샘플 쿼리

다음 쿼리는 computeBestOrder 매개 변수를 false로 설정하여 6개의 중간 지점에 대한 경로를 요청합니다. 이는 computeBestOrder 매개 변수의 기본값이기도 합니다.

https://atlas.microsoft.com/route/directions/json?api-version=1.0&subscription-key={Your-Azure-Maps-Subscription-key}&computeBestOrder=false&query=47.606544,-122.336502:47.759892,-122.204821:47.670682,-122.120415:47.480133,-122.213369:47.615556,-122.193689:47.676508,-122.206054:47.495472,-122.360861

응답은 경로 길이가 140,851미터이며 해당 경로를 이동하는 데 9,991초가 소요된다고 설명합니다.

다음 이미지는 이 쿼리의 결과 경로를 보여 줍니다. 이 경로는 가능한 1개 경로입니다. 시간이나 거리를 기반으로 한 최적의 경로가 아닙니다.

이 경로의 중간 지점 순서는 0, 1, 2, 3, 4, 5, 6입니다.

샘플 쿼리

다음 쿼리는 위의 샘플처럼 동일한 6개의 중간 지점에 대한 경로를 요청합니다. 이번에는 computeBestOrder 매개 변수를 true로 설정했습니다(여행하는 외판원 최적화).

https://atlas.microsoft.com/route/directions/json?api-version=1.0&subscription-key={Your-Azure-Maps-Subscription-key}&computeBestOrder=true&query=47.606544,-122.336502:47.759892,-122.204821:47.670682,-122.120415:47.480133,-122.213369:47.615556,-122.193689:47.676508,-122.206054:47.495472,-122.360861

응답은 경로 길이가 91,814미터이며 해당 경로를 이동하는 데 7,797초가 소요된다고 설명합니다. API가 최적화된 경로를 반환했으므로 이동 거리와 이동 시간은 둘 다 여기가 더 낮습니다.

다음 이미지는 이 쿼리의 결과 경로를 보여 줍니다.

최적 경로의 중간 지점 순서는 0, 5, 1, 2, 4, 3, 6입니다.

지원 지점을 사용하여 대체 경로 계산 및 보정

참조 경로에 대한 0개 이상의 대체 경로를 계산하기 위해 경로를 다시 구성하는 상황이 발생할 수 있습니다. 예를 들어, 소매점을 통과하는 대체 경로를 고객에게 보여줄 수 있습니다. 이 경우 지원 지점을 사용하여 위치를 보정해야 합니다. 위치를 보정하는 단계는 다음과 같습니다.

1. 경로를 있는 그대로 계산하고 경로 응답에서 경로 얻기
2. 경로를 사용하여 경로를 따라 또는 경로 주위에서 원하는 위치를 찾습니다. 예를 들어, 관심 지점 요청을 사용하거나 데이터베이스에서 고유의 데이터를 쿼리할 수 있습니다.
3. 경로 시작부터의 거리를 기준으로 위치 순서를 정합니다.
4. 사후 경로 방향에 대한 새 경로 요청의 지원 지점으로 이러한 위치를 추가합니다. 지원 지점에 대한 자세한 내용은 Post Route Directions API documentation(사후 경로 방향 API 설명서)을 참조하세요.

사후 경로 방향을 호출할 때 지원 지점과 함께 최소 편차 시간 또는 거리 제한을 설정할 수 있습니다. 대체 경로를 제공하되 이동 시간도 제한하려는 경우에는 이러한 매개 변수를 사용합니다. 이러한 제약 조건을 사용하는 경우 대체 경로는 지정된 시간 또는 거리에 대해 출발 지점부터 참조 경로를 따릅니다. 즉, 다른 경로는 지정된 제약 조건에 따라 참조 경로에서 분기됩니다.

다음 이미지는 시간과 거리에 대해 지정된 편차 제한을 사용하여 대체 경로를 렌더링하는 예입니다.

웹앱에서 라우팅 서비스 사용

Azure Maps 웹 SDK는 Service module(서비스 모듈)을 제공합니다. 이 모듈은 JavaScript 또는 TypeScript를 사용하여 웹 또는 Node.js 애플리케이션에서 Azure Maps REST API를 쉽게 사용할 수 있도록 지원하는 도우미 라이브러리입니다. 서비스 모듈을 사용하여 반환된 경로를 지도에 렌더링할 수 있습니다. 이 모듈은 GET 및 POST 요청과 함께 사용할 API를 자동으로 결정합니다.

다음 단계

자세한 내용은 다음을 참조하세요.