RouteRequestRouteDirectionsBatchSyncDefaultResponse interface
경로 방향 일괄 처리 API적용 대상: 가격 책정 계층을 참조하세요.
Route Directions Batch API는 단일 API 호출을 사용하여 경로 방향 API 에 쿼리 일괄 처리를 보냅니다. 경로 방향 일괄 처리 API를 호출하여 비동기(비동기) 또는 동기(동기화)를 실행할 수 있습니다. 비동기 API를 사용하면 호출자가 최대 700 개의 쿼리를 일괄 처리하고 최대 100 개의 쿼리를 API를 동기화할 수 있습니다.
동기 일괄 처리 요청 제출
간단한 일괄 처리 요청에는 동기 API를 사용하는 것이 좋습니다. 서비스가 요청을 받으면 일괄 처리 항목이 계산되는 즉시 응답하며 나중에 결과를 검색할 가능성이 없습니다. 동기 API는 요청이 60초보다 오래 걸리는 경우 시간 제한 오류(408 응답)를 반환합니다. 일괄 처리 항목 수는 이 API에 대해 100 개로 제한됩니다.
POST https://atlas.microsoft.com/route/directions/batch/sync/json?api-version=1.0&subscription-key={subscription-key}
일괄 처리 응답 모델
반환된 데이터 콘텐츠는 비동기 및 동기화 요청과 유사합니다. 비동기 일괄 처리 요청의 결과를 다운로드할 때 일괄 처리가 완료되면 응답 본문에 일괄 처리 응답이 포함됩니다. 이 일괄 처리 응답에는 원래 일괄 처리 요청의 일부인 와 successfulRequests성공적으로 실행된 쿼리를 나타내는 totalRequests 구성 요소가 포함되어 summary 있습니다. 일괄 처리 응답에는 일괄 처리 요청의 batchItems 각 쿼리와 모든 쿼리에 대한 응답이 포함된 배열도 포함됩니다. 에는 batchItems 원래 쿼리가 일괄 처리 요청에서 전송된 것과 정확히 동일한 순서로 결과가 포함됩니다. 의 batchItems 각 항목에는 및 response 필드가 포함됩니다statusCode. 의 batchItems 각 response 유형은 다음 유형 중 하나입니다.
RouteDirections- 쿼리가 성공적으로 완료된 경우Error- 쿼리가 실패한 경우 응답에는 이 경우 및message가 포함code됩니다.
다음은 1의 성공 및 1 실패 결과가 있는 샘플 Batch 응답입니다.
{
"summary": {
"successfulRequests": 1,
"totalRequests": 2
},
"batchItems": [
{
"statusCode": 200,
"response": {
"routes": [
{
"summary": {
"lengthInMeters": 1758,
"travelTimeInSeconds": 387,
"trafficDelayInSeconds": 0,
"departureTime": "2018-07-17T00:49:56+00:00",
"arrivalTime": "2018-07-17T00:56:22+00:00"
},
"legs": [
{
"summary": {
"lengthInMeters": 1758,
"travelTimeInSeconds": 387,
"trafficDelayInSeconds": 0,
"departureTime": "2018-07-17T00:49:56+00:00",
"arrivalTime": "2018-07-17T00:56:22+00:00"
},
"points": [
{
"latitude": 47.62094,
"longitude": -122.34892
},
{
"latitude": 47.62094,
"longitude": -122.3485
},
{
"latitude": 47.62095,
"longitude": -122.3476
}
]
}
],
"sections": [
{
"startPointIndex": 0,
"endPointIndex": 40,
"sectionType": "TRAVEL_MODE",
"travelMode": "bicycle"
}
]
}
]
}
},
{
"statusCode": 400,
"response":
{
"error":
{
"code": "400 BadRequest",
"message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
}
}
}
]
}
- Extends
-
{ body: unknown, headers: RawHttpHeaders, request: PipelineRequest, status: string }
속성
| body | |
| status |
상속된 속성
| headers | HTTP 응답 헤더입니다. |
| request | 이 응답을 생성한 요청입니다. |
속성 세부 정보
body
status
status: string속성 값
string