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

Address Validation API, iki üst düzey mülk içeren bir JSON nesnesi olarak yanıt gövdesi sağlar:

• result, ValidationResult türündeki bir nesne
• responseID

{
  "result": {
    // Validation verdict.
    "verdict": {},
    // Address details determined by the API.
    "address": {},
    // 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"
}

Bu dokümanda result nesnesine odaklanılmıştır. responseID hakkında bilgi edinmek için Güncellenen adresleri işleme başlıklı makaleyi inceleyin.

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. Özellik, çı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 adres 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 belirliliğini belirlemede kullanılan ayrıntı düzeyini ifade eder. validationGranularity yanıtındaki adres belirginliği, bir adresin teslim edilebilir olup olmadığına dair önemli bir sinyaldir.

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

• inputGranularity: Address Validation API'ye gönderilen adresten alınan ayrıntı düzeyini belirtir. İstekteki adres ayrıntısı düzeyi, doğrulama yanıtındaki adres ayrıntısı düzeyini etkiler. Örneğin, PREMISE seviyesinin altında inputGranularity olan bir adres genellikle validationGranularity ile PREMISE seviyesinde sonuçlanmaz.
• validationGranularity: Adres Doğrulama API'sinin 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 kodun ayrıntı düzeyini belirtir. Örneğin, Google kayıtları bir apartman numarasının bulunduğunu belirtiyor ancak büyük bir apartman kompleksindeki söz konusu dairenin kesin konumunu belirtmeyebilir. Bu durumda, validationGranularity SUB_PREMISE, geocodeGranularity ise isPREMISE` 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 bu bileşenlerde yapılan düzenlemeleri (ör. tahmin edilen veya eksik adres bileşenleri) gösterir. Örneğin, aşağıdaki verdict özelliği, onaylanmamış bileşenlere ve eksik addressComplete alanına sahip bir adresi gösterir:

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

address ve addressComponent özellikleri

address özelliği, istekte sağlanan işlenen adres için biçimlendirmenin yanı sıra adresin yanlış yazılmış kısımları, değiştirilen yanlış kısımlar ve tahmin edilen eksik bölümler dahil olmak üzere adresin bileşen düzeyindeki özetlerini sağlar.

addressComponent mülkü, Address Validation API'nin işlediği adresin öğelerinin (veya bileşenlerinin) ayrıntılı bir listesini sağlayan address'nin bir alt bileşenidir. API, her bileşen alanının sağladığı ada, türüne ve onay düzeyine göre tanımlanır.

geocode mülkü

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

metadata mülkü

Bu özellik, Address Validation API 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üvenmemeli, bunun yerine verdict ve address'yi de kontrol etmelisiniz.