RouteGetRouteDirectionsBatch200Response interface
Get Route Directions Batch API 是 HTTP GET 要求，會使用單一要求將查詢批次傳送至 取得路由指示 API。 您可以呼叫 Get Route Directions Batch API，以異步方式執行 （async） 或同步執行 （sync）。 異步 API 可讓呼叫者批處理最多 700
下載異步批次結果
若要下載異步批次結果，您將向批次下載端點發出 GET 要求。 此 下載 URL 可以從成功 Location 批次要求的 POST 標頭取得，如下所示：
https://atlas.microsoft.com/route/directions/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}
以下是下載批次結果的一般作業順序：
用戶端會使用
GET傳送 要求。伺服器會以下欄其中一項回應：
HTTP
202 Accepted- 已接受 Batch 要求，但仍正在處理中。 請稍後再試一次。HTTP
200 OK- 已成功處理批次要求。 回應本文包含所有批次結果。
批次回應模型
傳回的數據內容類似於異步和同步處理要求。 下載異步批次要求的結果時，如果批次已完成處理，響應主體就會包含批次回應。 此批次回應包含 summary 元件，指出屬於原始批次要求一部分的 totalRequests，以及成功執行的查詢 successfulRequests。 批次回應也包含 batchItems 數位列，其中包含批次要求中每個查詢的回應。
batchItems 會以與批次要求中傳送原始查詢完全相同的順序來包含結果。
batchItems 中的每個專案都包含 statusCode 和 response 欄位。
response 中的每個 batchItems 都是下列其中一種類型：
RouteDirections- 如果查詢成功完成。Error- 如果查詢失敗。 在此案例中，回應會包含code和message。
以下是 1 個成功 和 1 失敗 結果的批次回應範例：
{
"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
status
status: "200"屬性值
"200"
