RequestRouteMatrix interface

Get Route Matrix API는 원본 및 대상 목록에서 가능한 모든 쌍의 이동 시간과 거리를 계산하는 HTTP GET 요청입니다. 자세한 경로 지침을 제공하는 경로 방향 가져오기 API와 달리, 이 API는 각 출발지에서 모든 목적지로 라우팅하는 비용(이동 시간 및 거리)을 제공하여 효율성에 중점을 둡니다. 자세한 내용은 Azure Maps Route 서비스대한 모범 사례를 참조하세요.

지정된 모든 원본에 대해 서비스는 해당 원본에서 지정된 모든 대상으로 라우팅하는 비용을 계산합니다. 원본 집합 및 대상 집합은 테이블의 열 및 행 머리글로 간주할 수 있으며 테이블의 각 셀에는 원본에서 해당 셀의 대상으로 라우팅하는 비용이 포함됩니다. 예를 들어 음식 배달 회사에는 20명의 운전자가 있으며 식당에서 배달을 받을 가장 가까운 드라이버를 찾아야 한다고 가정해 보겠습니다. 이 사용 사례를 해결하기 위해 행렬 경로 API를 호출할 수 있습니다.

각 경로에 대해 이동 시간 및 거리가 반환됩니다. 계산 비용을 사용하여 경로 방향 API를 사용하여 계산할 자세한 경로를 결정할 수 있습니다.

비동기 요청에 대한 행렬의 최대 크기는 700 동기화 요청의 경우 100(원본 수에 대상 수를 곱한 값)입니다.

동기 경로 매트릭스 요청 제출

시나리오에 동기 요청이 필요하고 행렬의 최대 크기가 100보다 작거나 같은 경우 동기 요청을 수행할 수 있습니다. 이 API에 대한 행렬의 최대 크기는 100(원본 수에 대상 수를 곱한 값)입니다. 이러한 제약 조건을 염두에 두고 가능한 행렬 차원의 예는 10x10, 6x8, 9x8입니다(정사각형일 필요는 없음).

GET https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&subscription-key={subscription-key}

비동기 경로 매트릭스 요청 제출

비동기 API는 비교적 복잡한 라우팅 요청의 큰 볼륨을 처리하는 데 적합합니다. 비동기 요청을 사용하여 요청을 수행하면 기본적으로 서비스는 응답 헤더의 위치 필드에 있는 리디렉션 URL을 따라 202 응답 코드를 반환합니다. 이 URL은 응답 데이터 또는 오류 정보를 사용할 수 있을 때까지 주기적으로 확인해야 합니다. 요청의 waitForResults 매개 변수가 true로 설정된 경우 요청이 120초 미만으로 완료되면 사용자에게 200 응답이 표시됩니다.

이 API에 대한 행렬의 최대 크기는 700(원본 수에 대상 수를 곱한 값)입니다. 이러한 제약 조건을 염두에 두고 가능한 행렬 차원의 예는 50x10, 10x10, 28x25입니다. 10x70(정사각형일 필요는 없음).

비동기 응답은 24시간 동안 저장됩니다. 리디렉션 URL은 만료 기간 이후에 사용되는 경우 404 응답을 반환합니다.

GET https://atlas.microsoft.com/route/matrix/json?api-version=1.0&subscription-key={subscription-key}

다음은 일반적인 비동기 작업 시퀀스입니다.

1. 클라이언트가 Azure Maps에 Route Matrix GET 요청을 보냅니다.

2. 서버는 다음 중 하나로 응답합니다.

   HTTP 202 Accepted - 경로 매트릭스 요청이 수락되었습니다.

   HTTP Error - Route Matrix 요청을 처리하는 동안 오류가 발생했습니다. 400 잘못된 요청 또는 기타 오류 상태 코드일 수 있습니다.

3. 행렬 경로 요청이 성공적으로 수락된 경우 응답의 위치 헤더에는 요청 결과를 다운로드할 URL이 포함됩니다. 이 상태 URI는 다음과 같습니다.

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

4. 클라이언트가 3단계에서 가져온 다운로드 URL에 대해 GET 요청을 실행하여 결과를 다운로드합니다.

동기화 결과 다운로드

경로 매트릭스 동기화 API에 대한 GET 요청을 수행하면 서비스는 성공적인 요청 및 응답 배열에 대해 200개의 응답 코드를 반환합니다. 응답 본문에는 데이터가 포함되며 나중에 결과를 검색할 가능성이 없습니다.

비동기 결과 다운로드

요청이 202 Accepted 응답을 발급하면 비동기 파이프라인을 사용하여 요청이 처리됩니다. 응답의 위치 헤더에서 비동기 요청의 진행률을 확인하는 URL이 제공됩니다. 이 상태 URI는 다음과 같습니다.

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

위치 헤더에서 제공하는 URL은 GET 요청이 실행될 때 다음 응답을 반환합니다.

HTTP 202 Accepted - 행렬 요청이 수락되었지만 여전히 처리 중입니다. 잠시 후 다시 시도하세요.

HTTP 200 OK - 행렬 요청이 성공적으로 처리되었습니다. 응답 본문에는 모든 결과가 포함됩니다.

function get(options?: RequestParameters): StreamableMethod<RouteGetRouteMatrix200Response | RouteGetRouteMatrix202Response>

매개 변수

반환

Post Route Matrix API는 비동기(비동기) 요청을 사용하여 원본 및 대상 위치에 정의된 경로 집합에 대한 경로 요약 행렬을 계산할 수 있는 HTTP POST 요청입니다. 동기(동기화) 요청을 만들려면 경로 매트릭스 동기화참조하세요. 지정된 모든 원본에 대해 서비스는 해당 원본에서 지정된 모든 대상으로 라우팅하는 비용을 계산합니다. 원본 집합 및 대상 집합은 테이블의 열 및 행 머리글로 간주할 수 있으며 테이블의 각 셀에는 원본에서 해당 셀의 대상으로 라우팅하는 비용이 포함됩니다. 예를 들어 음식 배달 회사에는 20명의 운전자가 있으며 식당에서 배달을 받을 가장 가까운 드라이버를 찾아야 한다고 가정해 보겠습니다. 이 사용 사례를 해결하기 위해 행렬 경로 API를 호출할 수 있습니다.

각 경로에 대해 이동 시간 및 거리가 반환됩니다. 계산 비용을 사용하여 경로 방향 API를 사용하여 계산할 자세한 경로를 결정할 수 있습니다.

비동기 요청에 대한 행렬의 최대 크기는 700 동기화 요청의 경우 100(원본 수에 대상 수를 곱한 값)입니다.

동기 경로 매트릭스 요청 제출

시나리오에 동기 요청이 필요하고 행렬의 최대 크기가 100보다 작거나 같은 경우 동기 요청을 수행할 수 있습니다. 이 API에 대한 행렬의 최대 크기는 100(원본 수에 대상 수를 곱한 값)입니다. 이러한 제약 조건을 염두에 두고 가능한 행렬 차원의 예는 10x10, 6x8, 9x8입니다(정사각형일 필요는 없음).

POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&subscription-key={subscription-key}

비동기 경로 매트릭스 요청 제출

비동기 API는 비교적 복잡한 라우팅 요청의 큰 볼륨을 처리하는 데 적합합니다. 비동기 요청을 사용하여 요청을 수행하면 기본적으로 서비스는 응답 헤더의 위치 필드에 있는 리디렉션 URL을 따라 202 응답 코드를 반환합니다. 이 URL은 응답 데이터 또는 오류 정보를 사용할 수 있을 때까지 주기적으로 확인해야 합니다. 요청의 waitForResults 매개 변수가 true로 설정된 경우 요청이 120초 미만으로 완료되면 사용자에게 200 응답이 표시됩니다.

이 API에 대한 행렬의 최대 크기는 700(원본 수에 대상 수를 곱한 값)입니다. 이러한 제약 조건을 염두에 두고 가능한 행렬 차원의 예는 50x10, 10x10, 28x25입니다. 10x70(정사각형일 필요는 없음).

비동기 응답은 24시간 동안 저장됩니다. 리디렉션 URL은 만료 기간 이후에 사용되는 경우 404 응답을 반환합니다.

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&subscription-key={subscription-key}

다음은 일반적인 비동기 작업 시퀀스입니다.

1. 클라이언트가 Azure Maps에 경로 매트릭스 POST 요청을 보냅니다.

2. 서버는 다음 중 하나로 응답합니다.

   HTTP 202 Accepted - 경로 매트릭스 요청이 수락되었습니다.

   HTTP Error - Route Matrix 요청을 처리하는 동안 오류가 발생했습니다. 400 잘못된 요청 또는 기타 오류 상태 코드일 수 있습니다.

3. 행렬 경로 요청이 성공적으로 수락된 경우 응답의 위치 헤더에는 요청 결과를 다운로드할 URL이 포함됩니다. 이 상태 URI는 다음과 같습니다.

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

4. 클라이언트가 3단계에서 가져온 다운로드 URL에 대해 GET 요청을 실행하여 결과를 다운로드합니다.

동기화 결과 다운로드

경로 매트릭스 동기화 API에 대한 POST 요청을 수행하면 서비스는 성공적인 요청 및 응답 배열에 대해 200개의 응답 코드를 반환합니다. 응답 본문에는 데이터가 포함되며 나중에 결과를 검색할 가능성이 없습니다.

비동기 결과 다운로드

요청이 202 Accepted 응답을 발급하면 비동기 파이프라인을 사용하여 요청이 처리됩니다. 응답의 위치 헤더에서 비동기 요청의 진행률을 확인하는 URL이 제공됩니다. 이 상태 URI는 다음과 같습니다.

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

위치 헤더에서 제공하는 URL은 GET 요청이 실행될 때 다음 응답을 반환합니다.

HTTP 202 Accepted - 행렬 요청이 수락되었지만 여전히 처리 중입니다. 잠시 후 다시 시도하세요.

HTTP 200 OK - 행렬 요청이 성공적으로 처리되었습니다. 응답 본문에는 모든 결과가 포함됩니다.

function post(options: RouteRequestRouteMatrixParameters): StreamableMethod<RouteRequestRouteMatrix200Response | RouteRequestRouteMatrix202Response>

매개 변수

반환