Udostępnij za pośrednictwem

SearchGetReverseGeocodingBatchDefaultResponse interface

  • Odwołanie
Pakiet:
@azure-rest/maps-search

Interfejs API Get Reverse Geocoding Batch to żądanie POST HTTP, które wysyła partie do 100 zapytań w celu odwrotnego geokodowania interfejsu API przy użyciu pojedynczego żądania.

Przesyłanie synchronicznego żądania usługi Batch

Interfejs API synchroniczny jest zalecany w przypadku lekkich żądań wsadowych. Gdy usługa odbierze żądanie, odpowie natychmiast po obliczeniu elementów wsadowych i nie będzie możliwe późniejsze pobranie wyników. Interfejs API synchroniczny zwróci błąd limitu czasu (odpowiedź 408), jeśli żądanie trwa dłużej niż 60 sekund. Liczba elementów wsadowych jest ograniczona do 100 dla tego interfejsu API.

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

Treść POST dla żądania wsadowego

Aby wysłać zapytania odwrotnego geokodowania, użyjesz żądania , w którym treść żądania będzie zawierać tablicę w formacie , a nagłówek zostanie ustawiony na wartość . Oto przykładowa treść żądania zawierająca 2 odwrotne geokodowanie zapytań:

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

Obiekt odwrotnego geokodowania batchItem może zaakceptować dowolny z obsługiwanych odwrotnego geokodowaniaparametrów identyfikatora URI.

Partia powinna zawierać co najmniej 1 kwerendy.

Model odpowiedzi wsadowej

Odpowiedź wsadowa zawiera składnik summary wskazujący totalRequests, które były częścią oryginalnego żądania wsadowego i successfulRequests tj. zapytania, które zostały wykonane pomyślnie. Odpowiedź wsadowa zawiera również tablicę batchItems zawierającą odpowiedź dla każdego zapytania w żądaniu wsadowym. batchItems będzie zawierać wyniki w dokładnie takiej samej kolejności, w jaki oryginalne zapytania zostały wysłane w żądaniu wsadowym. Każdy element jest jednym z następujących typów:

  • GeocodingResponse — jeśli zapytanie zostało ukończone pomyślnie.

  • Error — jeśli zapytanie nie powiodło się. Odpowiedź będzie zawierać code i message w tym przypadku.

Rozszerzenie
HttpResponse

Właściwości

body
status

Właściwości dziedziczone

headers

Nagłówki odpowiedzi HTTP.
request

Żądanie, które wygenerowało tę odpowiedź.

Szczegóły właściwości

body 

body: ErrorResponseOutput

Wartość właściwości

ErrorResponseOutput

status 

status: string

Wartość właściwości

string

Szczegóły właściwości dziedziczonej

headers

Nagłówki odpowiedzi HTTP.

headers: RawHttpHeaders

Wartość właściwości

RawHttpHeaders

dziedziczone z HttpResponse.headers

request

Żądanie, które wygenerowało tę odpowiedź.

request: PipelineRequest

Wartość właściwości

PipelineRequest

dziedziczone z HttpResponse.request