SearchGetReverseGeocodingBatchDefaultResponse interface

API'si, tek bir istek kullanarak Ters Coğrafi Kodlama API'sine 100'e kadar sorgu içeren toplu işlemler gönderen bir HTTP isteğidir.

Zaman Uyumlu Toplu İş İsteği Gönderme

Basit toplu istekler için Zaman Uyumlu API önerilir. Hizmet bir istek aldığında, toplu iş öğeleri hesaplanır hesaplanmaz yanıt verir ve sonuçları daha sonra alma imkanı olmaz. İstek 60 saniyeden uzun sürerse Zaman Uyumlu API zaman aşımı hatası (408 yanıtı) döndürür. Toplu iş öğelerinin sayısı, bu API için 100 ile sınırlıdır.

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

Toplu İstek için POST Gövdesi

ters coğrafi kodlama sorguları göndermek için, istek gövdesinin dizisini biçimde içereceği ve üst bilgisinin olarak ayarlanacağı bir istek kullanırsınız. Aşağıda 2 ters coğrafi kodlama sorgu içeren bir örnek istek gövdesi verilmişti:

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

ters coğrafi kodlama batchItem nesnesi,desteklenen ters coğrafi kodlamaURI parametrelerinden herhangi birini kabul edebilir.

Toplu işlem en az 1 sorgu içermelidir.

Batch Yanıt Modeli

Toplu yanıt, özgün toplu iş isteğinin parçası olan summary belirten bir totalRequests bileşeni ve başarıyla yürütülen sorgular successfulRequests içerir. Toplu yanıt, toplu iş isteğindeki her sorgu için bir yanıt içeren bir batchItems dizisi de içerir. batchItems, sonuçları özgün sorguların toplu iş isteğinde gönderildiği sırayla içerir. Her öğe aşağıdaki türlerden biridir:

• GeocodingResponse - Sorgu başarıyla tamamlandıysa.

• Error - Sorgu başarısız olduysa. Yanıt, bu durumda bir code ve bir message içerir.