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ştururken 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 kesinliğini belirlemede kullanılan ayrıntı düzeyini ifade eder. validationGranularityYanıtın adresle ilgili ayrıntı düzeyi, bir adresin teslim edilebilir olup olmadığı konusunda ö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ındaki bir PREMISE seviyesine sahip bir adres genellikle validationGranularity seviyesinden PREMISE seviyesine yükseltilmez.
• validationGranularity: Maps JavaScript API'deki Address Validation'ın adresi tam olarak doğrulayabileceği ayrıntı düzeyi. Çoğu durumda, PREMISE veya SUB_PREMISE ayrıntı düzeyi, teslim edilebilir bir adresin kalitesini 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şenlerin 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ı alanların birçoğu, adres bileşenleriyle ilgili sorunları veya bu bileşenlerde yapılan değişiklikleri (ör. çıkarılan ya da 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 olası bir sonraki işlemi belirlemeye yardımcı olmayı amaçlar. Bu alan, API yanıtındaki diğer alanlardan türetilir ve adres doğruluğu veya teslim edilebilirliği garantisi olarak kabul edilmemelidir.

address ve addressComponent özellikleri

address özelliği, istekte belirtilen 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. Bu özellik, Haritalar JavaScript API'deki Adres Doğrulama'nın 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üzeyiyle tanımlar.

geocode özelliği

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

metadata özelliği

Bu özellik, Haritalar 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 başına bu özelliğe güvenmemeli, bunun yerine verdict ve address özelliklerini de kontrol etmelisiniz.