你当前正在访问 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}

下面是用于下载批处理结果的典型操作序列:

  1. 客户端使用下载 URL 发送GET请求。

  2. 服务器将使用以下项之一进行响应:

    HTTP 202 Accepted - 已接受 Batch 请求,但仍在处理中。 请稍后重试。

    HTTP 200 OK - 已成功处理批处理请求。 响应正文包含所有批处理结果。

批处理响应模型

对于异步和同步请求,返回的数据内容类似。 下载异步批处理请求的结果时,如果批处理已完成处理,则响应正文将包含批处理响应。 此批处理响应包含一个 summary 组件,该 totalRequests 组件指示是原始批处理请求的一部分, successfulRequests即已成功执行的查询。 批处理响应还包括一个 batchItems 数组,其中包含批处理请求中每个查询的响应。 将 batchItems 包含结果,其顺序与原始查询在批处理请求中的发送顺序完全相同。 中的每个 batchItems 项都包含 statusCoderesponse 字段。 中的每个 response 类型 batchItems 为以下类型之一:

  • RouteDirections - 如果查询成功完成。

  • Error - 如果查询失败。 在本例中,响应将包含 codemessage

下面是包含 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

body: RouteDirectionsBatchResultOutput

属性值

status

status: "200"

属性值

"200"

继承属性详细信息

headers

HTTP 响应标头。

headers: RawHttpHeaders

属性值

继承自 HttpResponse.headers

request

生成此响应的请求。

request: PipelineRequest

属性值

继承自 HttpResponse.request