Temel adres doğrulama yanıtını anlama

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Address Validation API yanıtı şu üst düzey özellikleri içerir:

{
  // Address details determined by the API.
  "address": {},
  // Validation verdict.
  "verdict": {},
  // The geocode generated for the input address.
  "geocode": {},
  // Information indicating if the address is a business, residence, etc.
  "metadata": {},
  // Information about the address from the US Postal Service
  // ("US" and "PR" addresses only).
  "uspsData": {},
  // A unique identifier generated for every request to the API.
  "responseId": "ID"
}

verdict mülkü

verdict mülkü, adres doğrulama sonuçlarını özetler ve adres kontrol mantığı oluştururken değerlendirilecek ilk mülk olmalıdır. Mülk, çıkış adresinin kalitesine bağlı olarak çeşitli alanlar döndürebilir. Örneğin, aşağıdaki örnekte iyi kalitede bir adresin verdict mülkü gösterilmektedir. Bu istek için 4 alan döndürülür:

"verdict": {
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Aşağıdaki bölümlerde, verdict mülkünde bulunan tüm alanlar özetlenmiştir.

Adresin ayrıntı düzeyi

Adres ayrıntı düzeyi, bir adresin veya coğrafi kodun özgünlüğünü belirlemek için kullanılan ayrıntı düzeyini ifade eder. validationGranularity yanıtındaki adres özgüllüğü, bir adresin teslim edilip edilemeyeceğine dair önemli bir sinyaldir.

verdict mülkü aşağıdaki ayrıntı düzeyi sinyallerini döndürür:

• inputGranularity: Maps JavaScript API'deki Adres Doğrulama'ya gönderilen adresten alınan ayrıntı düzeyini belirtir. İstekte belirtilen adres ayrıntı düzeyi, doğrulama yanıtındaki adres ayrıntı düzeyini etkiler. Örneğin, PREMISE seviyesinin altında inputGranularity olan bir adres genellikle validationGranularity ile PREMISE seviyesinde sonuçlanmaz.
• validationGranularity: Maps JavaScript API'deki Adres Doğrulama özelliğinin adresi tam olarak doğrulayabileceği ayrıntı düzeyi. Çoğu durumda PREMISE veya SUB_PREMISE ayrıntı düzeyi, teslim edilebilecek nitelikte bir adresi gösterir.
• geocodeGranularity: Adresle ilişkili coğrafi kodla ilgili ayrıntı düzeyini belirtir. Örneğin, Google kayıtları bir apartman numarasının varlığını gösterebilir ancak büyük bir apartman kompleksindeki söz konusu apartmanın tam konumunu göstermeyebilir. Bu durumda, validationGranularity SUB_PREMISE, geocodeGranularity ise PREMISE olur.

Adresin eksiksiz olması

Sonuç, addressComplete mülkünü yüksek kaliteli bir adres sinyali olarak döndürür. Bu, adresin eksik, çözülmemiş veya beklenmedik bileşenleri olmadığı anlamına gelir:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "PREMISE",
    "geocodeGranularity": "PREMISE",
    "addressComplete": true
}

Adreste eksik, çözülmemiş veya beklenmeyen bileşenler varsa alan false olarak ayarlanır.

Adres kalitesi

Bazı alanlar, adres bileşenleriyle ilgili sorunları veya bunlarda yapılan düzenlemeleri (ör. tahmin edilen veya eksik adres bileşenleri) gösterir. Örneğin, aşağıdaki verdict mülkü, doğrulanmamış bileşenleri ve eksik addressComplete alanı olan bir adresi gösterir:

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "OTHER",
    "geocodeGranularity": "OTHER",
    "hasUnconfirmedComponents": true,
    "hasInferredComponents": true
}

address ve addressComponent özellikleri

address mülkü, istekte sağlanan işlenmiş adresin biçimlendirmesini ve adresin yanlış yazılmış bölümleri, yanlış bölümlerin değiştirilmesi ve eksik bölümlerin tahmin edilmesi dahil olmak üzere adresin bileşen düzeyinde özetlerini sağlar.

addressComponent mülkü, address'un bir alt bileşenidir. Bu mülk, Maps JavaScript API'deki Adres Doğrulama özelliğinin işlediği adresin öğelerinin (veya bileşenlerinin) ayrıntılı bir listesini sağlar. API, her bileşen alanını adı, türü ve onay düzeyine göre tanımlar.

geocode mülkü

geocode mülkü, giriş adresiyle ilişkili coğrafi kodlanmış konumu gösterir. Bu özellik, konumla ilgili ayrıntıları (ör. yer kimliği) sağlar.

metadata mülkü

Bu özellik, Maps JavaScript API'deki Adres Doğrulama tarafından işlenen her adres için doldurulmayabilir ancak adresin ikamet, işletme veya posta kutusu türü olup olmadığını belirtir.

uspsData mülkü

Bu mülk, ABD posta adresleri için yararlı bilgiler sağlar. Ancak hizmet tarafından doğrulanan her adres için bu alanın tam olarak doldurulacağı garanti edilmez. Bu nedenle, adresleri doğrulamak için tek yöntem olarak bu mülke güvenmemelisiniz. Bunun yerine verdict ve address'yi de kontrol etmelisiniz.