Compartir a través de

RouteGetRouteDirectionsBatch200Response interface

  • Referencia
Paquete:
@azure-rest/maps-route

Se aplica a: consulte los planes de tarifa.

Descargar resultados de lotes asincrónicos

Para descargar los resultados del lote asincrónico, emitirá una GET solicitud al punto de conexión de descarga por lotes. Esta dirección URL de descarga se puede obtener del Location encabezado de una solicitud por lotes correcta POST y tiene el siguiente aspecto:

https://atlas.microsoft.com/route/directions/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}

Esta es la secuencia típica de operaciones para descargar los resultados por lotes:

  1. El cliente envía una GET solicitud mediante la dirección URL de descarga.

  2. El servidor responderá con uno de los siguientes elementos:

    HTTP 202 Accepted : se aceptó la solicitud por lotes, pero todavía se está procesando. Inténtelo de nuevo en algún momento.

    HTTP 200 OK : solicitud por lotes procesada correctamente. El cuerpo de la respuesta contiene todos los resultados por lotes.

Modelo de respuesta por lotes

El contenido de datos devuelto es similar para las solicitudes asincrónicas y de sincronización. Al descargar los resultados de una solicitud por lotes asincrónica, si el lote ha terminado de procesarse, el cuerpo de la respuesta contiene la respuesta por lotes. Esta respuesta por lotes contiene un summary componente que indica que totalRequests formaron parte de la solicitud por lotes original y successfulRequestses decir, consultas que se ejecutaron correctamente. La respuesta por lotes también incluye una batchItems matriz que contiene una respuesta para cada consulta de la solicitud por lotes. batchItems contendrá los resultados en el mismo orden en que se enviaron las consultas originales en la solicitud por lotes. Cada elemento de batchItems contiene statusCode y response campos. Cada response elemento batchItems de es de uno de los siguientes tipos:

  • RouteDirections : si la consulta se completó correctamente.

  • Error : si se produjo un error en la consulta. La respuesta contendrá y code en message este caso.

Esta es una respuesta por lotes de ejemplo con un resultado correcto y 1 con errores :

{
    "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
HttpResponse

Propiedades

body
status

Propiedades heredadas

headers

Encabezados de respuesta HTTP.
request

Solicitud que generó esta respuesta.

Detalles de las propiedades

body 

body: RouteDirectionsBatchResultOutput

Valor de propiedad

RouteDirectionsBatchResultOutput

status 

status: "200"

Valor de propiedad

"200"

Detalles de las propiedades heredadas

headers

Encabezados de respuesta HTTP.

headers: RawHttpHeaders

Valor de propiedad

RawHttpHeaders

Heredado de HttpResponse.headers

request

Solicitud que generó esta respuesta.

request: PipelineRequest

Valor de propiedad

PipelineRequest

Heredado de HttpResponse.request