Partilhar via

SearchGetReverseGeocodingBatchDefaultResponse interface

  • Referência
Pacote:
@azure-rest/maps-search

A API Get Reverse Geocoding Batch é uma solicitação de POST HTTP que envia lotes de até 100 consultas para Geocodificação Reversa API usando uma única solicitação.

Enviar solicitação de lote síncrona

A API síncrona é recomendada para solicitações em lote leves. Quando o serviço recebe uma solicitação, ele responderá assim que os itens do lote forem calculados e não haverá possibilidade de recuperar os resultados posteriormente. A API síncrona retornará um erro de tempo limite (uma resposta 408) se a solicitação demorar mais de 60 segundos. O número de itens de lote é limitado a 100 para esta API.

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

Corpo POST para solicitação de lote

Para enviar as consultas de de geocodificação reversa , você usará uma solicitação de onde o corpo da solicitação conterá a matriz em formato e o cabeçalho será definido como . Aqui está um corpo de solicitação de exemplo contendo 2 consultas de de geocodificação reversa:

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

Uma geocodificação reversa objeto batchItem pode aceitar qualquer um dos parâmetros de URIgeocodificação reversa suportados.

O lote deve conter pelo menos 1 consulta.

Modelo de resposta em lote

A resposta em lote contém um componente summary que indica os totalRequests que faziam parte da solicitação de lote original e successfulRequests ou seja, consultas que foram executadas com êxito. A resposta em lote também inclui uma matriz batchItems que contém uma resposta para cada consulta na solicitação em lote. O batchItems conterá os resultados exatamente na mesma ordem em que as consultas originais foram enviadas na solicitação de lote. Cada item é de um dos seguintes tipos:

  • GeocodingResponse - Se a consulta foi concluída com êxito.

  • Error - Se a consulta falhou. Neste caso, a resposta conterá um code e um message.

Extends
HttpResponse

Propriedades

body
status

Propriedades Herdadas

headers

Os cabeçalhos de resposta HTTP.
request

A solicitação que gerou essa resposta.

Detalhes de Propriedade

body 

body: ErrorResponseOutput

Valor de Propriedade

ErrorResponseOutput

status 

status: string

Valor de Propriedade

string

Detalhes da Propriedade Herdada

headers

Os cabeçalhos de resposta HTTP.

headers: RawHttpHeaders

Valor de Propriedade

RawHttpHeaders

herdado de HttpResponse.headers

request

A solicitação que gerou essa resposta.

request: PipelineRequest

Valor de Propriedade

PipelineRequest

herdado de HttpResponse.request