SearchGetReverseGeocodingBatchDefaultResponse interface

Paquete:

@azure-rest/maps-search

de Batch API de geocodificación inversa

Se aplica a: consulte precios niveles.

La API de Batch de geocodificación inversa envía lotes de consultas a API de geocodificación inversa mediante una sola llamada API. La API permite al autor de la llamada procesar por lotes hasta 100 consultas.

Enviar solicitud por lotes sincrónica

Se recomienda la API sincrónica para solicitudes por lotes ligeras. Cuando el servicio recibe una solicitud, responderá tan pronto como se calculen los elementos por lotes y no habrá posibilidad de recuperar los resultados más adelante. La API sincrónica devolverá un error de tiempo de espera (una respuesta 408) si la solicitud tarda más de 60 segundos. El número de elementos por lotes se limita a 100 para esta API.

POST https://atlas.microsoft.com/reverseGeocode:batch?api-version=2023-06-01

Cuerpo POST para solicitud por lotes

Para enviar las consultas de de geocodificación inversa , usará una solicitud de donde el cuerpo de la solicitud contendrá la matriz de en formato y el encabezado se establecerá en . Este es un cuerpo de solicitud de ejemplo que contiene 2 geocodificación inversa consultas:

{
  "batchItems": [
    {
      "coordinates": [-122.128275, 47.639429],
      "resultTypes": ["Address", "PopulatedPlace"]
    },
    {
      "coordinates": [-122.341979399674, 47.6095253501216]
    }
  ]
}

Un objeto geocodificación inversa batchItem puede aceptar cualquiera de los parámetros de geocodificación inversa admitidos URI.

El lote debe contener al menos 1 consulta de.

Modelo de respuesta por lotes

La respuesta por lotes contiene un componente de summary que indica el totalRequests que formaron parte de la solicitud por lotes original y successfulRequests es decir, las consultas que se ejecutaron correctamente. La respuesta por lotes también incluye una matriz de batchItems que contiene una respuesta para cada consulta y cada consulta de la solicitud por lotes. El batchItems contendrá los resultados en el mismo orden en que se enviaron las consultas originales en la solicitud por lotes. Cada elemento es de uno de los siguientes tipos:

• GeocodingResponse: si la consulta se completó correctamente.

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

Extends

HttpResponse

Propiedades

body
status

Propiedades heredadas

headers	Encabezados de respuesta HTTP.
request	Solicitud que generó esta respuesta.

Detalles de las propiedades

body

body: ErrorResponseOutput

Valor de propiedad

ErrorResponseOutput

status

status: string

Valor de propiedad

string

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