你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
RouteGetRouteDirectionsBatch200Response interface
适用于:请参阅定价 层。
下载异步批处理结果
若要下载异步批处理结果,需向批量下载终结点发出 GET
请求。 可以从成功的POST
批处理请求的标头获取Location
此下载 URL,如下所示:
https://atlas.microsoft.com/route/directions/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}
下面是用于下载批处理结果的典型操作序列:
客户端使用下载 URL 发送
GET
请求。服务器将使用以下项之一进行响应:
HTTP
202 Accepted
- 已接受 Batch 请求,但仍在处理中。 请稍后重试。HTTP
200 OK
- 已成功处理批处理请求。 响应正文包含所有批处理结果。
批处理响应模型
对于异步和同步请求,返回的数据内容类似。 下载异步批处理请求的结果时,如果批处理已完成处理,则响应正文将包含批处理响应。 此批处理响应包含一个 summary
组件,该 totalRequests
组件指示是原始批处理请求的一部分, successfulRequests
即已成功执行的查询。 批处理响应还包括一个 batchItems
数组,其中包含批处理请求中每个查询的响应。 将 batchItems
包含结果,其顺序与原始查询在批处理请求中的发送顺序完全相同。 中的每个 batchItems
项都包含 statusCode
和 response
字段。 中的每个 response
类型 batchItems
为以下类型之一:
RouteDirections
- 如果查询成功完成。Error
- 如果查询失败。 在本例中,响应将包含code
和message
。
下面是包含 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 | |
status |
继承属性
headers | HTTP 响应标头。 |
request | 生成此响应的请求。 |
属性详细信息
body
status
status: "200"
属性值
"200"