경로 매트릭스를 사용한 경로 계획 - Amazon Location Service

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

경로 매트릭스를 사용한 경로 계획

Amazon Location Service를 사용하여 경로 계획 및 최적화 소프트웨어에 대한 입력을 생성할 수 있습니다. 출발 위치 세트와 도착 위치 세트 사이의 경로에 대해 이동 시간 및 이동 거리를 포함한 경로 결과를 생성할 수 있습니다.

예를 들어 출발 위치 A와 B, 도착 위치 X와 Y가 주어지면 Amazon Location Service는 A에서 X, A에서 Y, B에서 X, B에서 Y까지, B에서 Y까지의 경로에 대한 이동 시간과 이동 거리를 반환합니다.

다양한 교통 수단, 회피, 교통 상황을 고려하여 경로를 계산할 수 있습니다. 예를 들어, 차량이 10.7m(35피트) 길이의 트럭이라고 지정하면 계산된 경로에서는 이러한 제한을 사용하여 이동 시간과 이동 거리를 결정합니다.

반환되는 결과 수와 계산된 경로 수는 출발 위치 수에 목적지 위치 수를 곱한 값입니다. 서비스에 대한 각 요청이 아니라 계산된 각 경로에 대해 요금이 부과되므로, 출발지가 10개이고 도착지가 10개인 경로 매트릭스는 100개의 경로로 청구됩니다.

경로 매트릭스 계산

출발 위치 세트와 도착 위치 세트 사이의 경로 매트릭스를 계산할 수 있습니다. 경로 결과에는 이동 시간과 이동 거리가 포함됩니다.

사전 조건

  • 먼저 경로 계산기 리소스를 생성하고 Amazon Location에 대한 요청에 대한 인증을 설정해야 합니다. 자세한 설명은 사전 조건 섹션을 참조하세요.

CalculateRouteMatrix 작업을 사용하여 요청을 제출합니다. 최소 요청에는 다음과 같은 필수 필드가 포함됩니다.

  • DeparturePositions – 경로를 계산할 시작 위치 세트. [longitude, latitude]의 배열로 정의됩니다.

  • DestinationPositions – 경로를 계산할 최종 위치 세트. [longitude, latitude]의 배열로 정의됩니다.

참고

도로에 있지 않은 출발 위치 또는 도착 위치를 지정하는 경우 Amazon Location은 해당 위치를 가장 가까운 도로로 이동합니다.

요청에 출발 시간이동 수단을 선택적으로 지정할 수 있습니다.

AWS CLI 또는 Amazon Location API를 사용할 수 있습니다.

API

다음 예제는 경로 계산기 리소스를 사용한 CalculateRouteMatrix ExampleCalculator요청입니다. 요청은 출발 위치 [-122.7565, 49.0021] 및 [-122.2014, 47.6101]에서 도착 위치 [-122.3394, 47.6159] 및 [-122.4813, 48.7511]까지의 경로 매트릭스를 계산하도록 지정합니다.

POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ] }
AWS CLI

다음 예제는 경로 계산기 리소스를 사용하는 calculate-route-matrix ExampleCalculator명령입니다. 요청은 출발 위치 [-122.7565, 49.0021] 및 [-122.2014, 47.6101]에서 도착 위치 [-122.3394, 47.6159] 및 [-122.4813, 48.7511]까지의 경로 매트릭스를 계산하도록 지정합니다.

aws location \ calculate-route-matrix \ --calculator-name ExampleCalculator \ --departure-positions "[[-122.7565,49.0021],[-122.2014,47.6101]]" \ --destination-positions "[[-122.3394,47.6159],[-122.4813,48.7511]]"

기본적으로 응답은 킬로미터 단위로 Distance을 반환합니다. 다음 선택적 파라미터를 사용하여 측정 단위를 마일로 변경할 수 있습니다.

  • DistanceUnit – 거리 결과에 사용할 단위 체계를 지정합니다.

POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ], "DistanceUnit": "Miles" }

출발 위치 및 도착 위치에 대한 제한

경로 매트릭스를 계산할 때 출발 위치 및 도착 위치에 제한이 있습니다. 이러한 제한은 RouteCalculator 리소스에서 사용하는 공급자에 따라 다릅니다.

제한 사항 Esri Grab HERE
위치 개수 최대 10개의 출발 위치와 10개의 도착 위치. 최대 350개의 출발 위치와 350개의 도착 위치.

최대 350개의 출발 위치와 350개의 도착 위치.

장거리 경로의 경우 추가 제한 사항이 적용됩니다. 섹션을 참조하세요.

위치 간 거리 출발 및 도착 위치 쌍은 서로 400km 이내에 있어야 합니다(도보 경로의 경우 40km).

모든 출발 및 도착 위치는 직경 180km의 원 내에 있어야 합니다.

장거리 경로의 경우 추가 제한 사항이 적용됩니다. 섹션을 참조하세요.

경로 길이 해당 경로의 총 이동 시간이 400분을 넘으면 경로가 완료되지 않습니다.

출발지와 도착지를 중심으로 한 원을 10km 이상 벗어나는 경로는 계산되지 않습니다.

장거리 경로의 경우 추가 제한 사항이 적용됩니다. 섹션을 참조하세요.

리전 한국에서는 경로 매트릭스 계산이 지원되지 않습니다. 동남아시아에서 사용 가능합니다. 지원되는 국가/리전 목록 및 자세한 내용은 대상 국가/리전 및 지역 항목을 참조하세요. 추가 제한 사항은 없습니다.

장거리 경로 계획

경로 결과 매트릭스를 계산하는 것은 효율적인 경로 계획에 유용하지만 계산에는 다소 시간이 걸릴 수 있습니다. 모든 Amazon Location Service 데이터 공급자는 계산할 수 있는 경로 수 또는 경로 거리를 제한합니다. 예를 들어, HERE로 350개의 출발 위치와 도착 위치 사이에 경로를 생성할 수 있지만, 이러한 위치는 180km의 원 안에 있어야 합니다. 장거리 경로를 계획하고 싶다면 어떻게 해야 할까요?

HERE를 데이터 공급자로 사용한 RouteCalculator를 사용하여 더 적은 수의 경로에 대해 길이 제한이 없는 경로 매트릭스를 계산할 수 있습니다. 이렇게 해도 CalculateRouteMatrix API 호출 방식이 바뀌지는 않으며, Amazon Location에서는 요구 사항을 충족하면 단순히 더 긴 경로를 허용합니다.

더 긴 길이의 경로 계산에 대한 요구 사항은 다음과 같습니다.

  • RouteCalculator는 HERE 데이터 공급자를 사용해야 합니다.

  • 출발 위치의 수는 15개를 초과할 수 없습니다.

  • 계산할 총 경로 수는 100개를 초과할 수 없습니다.

  • 경로가 1,000km를 초과할 때 통행료를 피할 수 있는 트럭 경로의 경우 장거리 경로가 허용되지 않습니다. 이 조합은 계산 속도가 느리고 호출 시간이 초과될 수 있습니다. CalculateRoute작업을 통해 이러한 경로를 개별적으로 계산할 수 있습니다.

호출이 이러한 요구 사항을 충족하지 않는 경우(예: 단일 호출로 150개의 경로 계산을 요청하는 경우) CalculateRouteMatrix는 더 짧은 경로 규칙만 허용하도록 되돌아갑니다. 그런 다음 위치가 180km의 원 이내이면 경로를 계산할 수 있습니다.

장거리 경로를 계산할 때는 다음 사항을 염두에 두세요 .

  • 경로가 길면 계산 시간이 더 오래 걸릴 수 있으며, Amazon Location API의 최대 시간보다 더 오래 걸릴 수 있습니다. 특정 경로에서 시간 초과가 자주 발생하는 경우 각 CalculateRouteMatrix 호출에서 더 적은 수의 경로를 시도할 수 있습니다.

  • CalculateRouteMatrix 요청에 도착 위치 또는 출발 위치를 더 추가하면 작업이 더 제한된 모드로 전환될 수 있으며, 생성할 경로가 적을 때 문제 없이 계산할 수 있는 경로에 오류가 발생할 수 있습니다. 이 경우 도착 또는 출발 위치의 수를 줄이고 여러 번 요청하여 필요한 전체 경로 계산 세트를 얻으세요.

응답의 예

다음은 Amazon Location Routes API에서 CalculateRouteMatrix 작업을 호출할 때 해당 응답이 포함된 요청의 예시입니다.

Example request
POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ] }
Example response
{ "RouteMatrix": [ [ { "Distance": 178.764, "DurationSeconds": 7565 }, { "Distance": 39.795, "DurationSeconds": 1955 } ], [ { "Distance": 15.31, "DurationSeconds": 1217 }, { "Distance": 142.506, "DurationSeconds": 6279 } ] ], "Summary": { "DataSource": "Here", "RouteCount": 4, "ErrorCount": 0, "DistanceUnit": "Kilometers" } }