RouteGetRouteDirectionsBatch202Response interface
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:
El cliente envía una
GET
solicitud mediante la dirección URL de descarga.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 successfulRequests
es 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á ycode
enmessage
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
-
{ body: unknown, headers: RawHttpHeaders, request: PipelineRequest, status: string }
Propiedades
body | |
headers | |
status |
Propiedades heredadas
request | Solicitud que generó esta respuesta. |
Detalles de las propiedades
body
body: Record<string, unknown>
Valor de propiedad
Record<string, unknown>
headers
headers: RawHttpHeaders & RouteGetRouteDirectionsBatch202Headers
Valor de propiedad
RawHttpHeaders & RouteGetRouteDirectionsBatch202Headers
status
status: "202"
Valor de propiedad
"202"
Detalles de las propiedades heredadas
request
Solicitud que generó esta respuesta.
request: PipelineRequest
Valor de propiedad
PipelineRequest
Heredado de__type.request