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

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 özelliği

verdict özelliği, adres doğrulama sonuçlarını özetler ve adres kontrolü mantığı oluşturulurken değerlendirilecek ilk özellik olmalıdır. Çıkış adresinin kalitesine bağlı olarak özellik çeşitli alanlar döndürebilir. Örneğin, aşağıda kaliteli bir adresin verdict özelliği gösterilmektedir. Bu özellik, söz konusu istek için aşağıdaki alanları döndürür:

"verdict": {
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "ACCEPT",
  "addressComplete": true,
  "hasUnconfirmedComponents": false,
  "hasInferredComponents": true,
  "hasReplacedComponents": false
}

Aşağıdaki bölümlerde, verdict özelliğindeki tüm alanlar özetlenmektedir.

Adresin ayrıntı düzeyi

Adres ayrıntı düzeyi, bir adresin veya coğrafi kodun özgüllüğünü belirlemede kullanılan ayrıntı düzeyini ifade eder. validationGranularity yanıttaki adresin ne kadar spesifik olduğu, adresin teslim edilebilir olup olmadığıyla ilgili önemli bir sinyaldir.

verdict özelliği şu 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 açıklar. İstekteki adres ayrıntı düzeyi, doğrulama yanıtındaki adres ayrıntı düzeyini etkiler. Örneğin, inputGranularity seviyesinin altında PREMISE seviyesinin altında bir adres genellikle PREMISE seviyesine validationGranularity ile sonuçlanmaz.
• validationGranularity: Maps JavaScript API'deki Adres Doğrulama'nın adresi tam olarak doğrulayabileceği ayrıntı düzeyi. Çoğu durumda, PREMISE veya SUB_PREMISE ayrıntı düzeyi, teslim edilebilirliği yüksek kaliteli bir adresi gösterir.
• geocodeGranularity: Adresle ilişkili coğrafi kodun ayrıntı düzeyini açıklar. Örneğin, Google kayıtları bir daire numarasının varlığını gösterebilir ancak büyük bir apartman kompleksindeki söz konusu dairenin tam konumunu göstermeyebilir. Bu durumda, validationGranularity SUB_PREMISE, geocodeGranularity ise PREMISE olur.

Adresin eksiksiz olması

Karar, addressComplete özelliğini yüksek kaliteli bir adresin sinyali olarak döndürür. Bu, özellikle eksik, çözümlenmemiş veya beklenmedik bileşenler olmadığı anlamına gelir:

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

Adreste eksik, çözümlenmemiş veya beklenmedik bileşenler olduğunda alan false olarak ayarlanır.

Adres kalitesi

Olası alanlardan bazıları, adres bileşenleriyle ilgili sorunları veya adres bileşenlerinde yapılan değişiklikleri (ör. çıkarılan veya eksik adres bileşenleri) gösterir. Örneğin, aşağıdaki verdict özelliği, bileşenleri onaylanmamış bir adresi ve eksik bir addressComplete alanını belirtir:

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

Olası sonraki işlem

possibleNextAction Değerlendirme alanı, API yanıtının yorumlayıcı bir özetini sunar ve sonraki olası işlemin belirlenmesine yardımcı olmayı amaçlar. Bu alan, API yanıtındaki diğer alanlardan türetilir ve adresin doğruluğu veya teslim edilebilirliği konusunda garanti olarak kabul edilmemelidir.

address ve addressComponent özellikleri

address özelliği, istekte sağlanan işlenmiş adres için biçimlendirme sağlar. Ayrıca, adresin bileşen düzeyindeki özetlerini (ör. adresin yanlış yazılmış kısımları, değiştirilen yanlış kısımlar ve eksik olduğu çıkarılan kısımlar) içerir.

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

geocode özelliği

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

metadata özelliği

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

uspsData özelliği

Bu özellik, ABD posta adresleri için yararlı bilgiler sağlar. Ancak hizmet tarafından doğrulanan her adres için 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 mülklerini de kontrol etmelisiniz.