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

Address Validation API, JSON biçiminde bir yanıt gövdesi sağlar iki üst düzey özellik içeren nesne:

• result, ValidationResult türünde 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ılmaktadır. Daha fazla bilgi için responseID için Güncellenen adresleri işleme başlıklı makaleye göz atın.

verdict mülkü

verdict özelliği, adres doğrulamasının sonuçlarını özetler ve adres denetimi mantığı oluştururken değerlendirilecek ilk özellik olmalıdır. Özellik, öğesinin kalitesine bağlı olarak çeşitli alanlar döndürebilir. çıkış adresi. Örneğin, aşağıda birverdict olacaktır. Bu değer, söz konusu istek için 4 alan döndürür:

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

Aşağıdaki bölümlerde verdict mülkündeki tüm alanlar özetlenmektedir.

Adresin ayrıntı düzeyi

Adres ayrıntı düzeyi, belirlilik düzeyinden emin olmaktır. validationGranularity yanıtı, adres olup olmadığını belirten önemli bir sinyaldir teslimat olabilir.

verdict özelliği şu ayrıntı düzeyi sinyallerini döndürür:

• inputGranularity — Bağlantının Address Validation API'ye gönderilmesini sağlayın. URL'deki adres ayrıntı düzeyi isteği, doğrulama yanıtındaki adres ayrıntısı düzeyini etkiler. Örneğin, inputGranularity değerinin PREMISE altında olan bir adres düzeyi genellikle PREMISE değerine validationGranularity ile sonuçlanmaz. seviyesinde olmalıdır.
• validationGranularity: Address Validation API, adresini tam olarak doğrulayabilir. Çoğu durumda, PREMISE veya SUB_PREMISE ayrıntı düzeyi, kalite adresini gösterir teslimat da yapabilirsiniz.
• geocodeGranularity — Coğrafi kodun ayrıntı düzeyini tanımlar adresle ilişkilidir. Örneğin, Google kayıtları bir daire numarası olup olmadığı (buna ait tam konum değil) veya kompleks olarak değişti. Böyle bir durumda, validationGranularity SUB_PREMISE ancak geocodeGranularityisPREMISE" durumunda.

Adresin eksiksiz olması

Sonuç, addressComplete özelliğini bir yani hiçbir eksik olmadığından emin olmak için bitmemiş veya beklenmedik bileşenler içerir:

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

Adreste eksik, çözümlenmemiş veya beklenmeyen bileşenler varsa alan false olarak ayarlandı.

Adres kalitesi

Bazı olası alanlar, adres bileşenleriyle ilgili sorunları gösterir veya (ör. tahmin edilen veya eksik adres bileşenleri) Örneğin, örnek, aşağıdaki verdict özelliği onaylanmamış olan bir adresi gösterir bileşenler ve eksik addressComplete alanı:

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

address ve addressComponent özellikleri

address özelliği, aşağıdaki bilgiler dahil olmak üzere adresin bileşen düzeyindeki özetleriyle birlikte, adresin yanlış yazılmış kısımları, yanlış kısımları değiştirildi ve çıkarımda bulunulan eksik bölümü parçalar.

addressComponent özelliği, address alt bileşenidir ve adresteki öğelerin veya bileşenlerinin ayrıntılı bir listesini Address Validation API işlendi. API her bileşeni tanımlar alanı, adına, türüne ve onay düzeyine göre gösterilir.

geocode mülkü

geocode özelliği, girişle ilişkilendirilen coğrafi kodlu konumu gösterir. girin. Bu tesis, konumun kendisi hakkında ayrıntılı bilgi sağlar. Örneğin: içerir.

metadata mülkü

Bu özellik, Address Validation API (Adres Doğrulama API'si), ancak adresin konut türünde olup olmadığını gösterir. ya da Posta Kutusu'na gönderebilirsiniz.

uspsData mülkü

Bu özellik, ABD posta adresleri için yararlı bilgiler sağlar. Ancak, doğrulanan her adres için bu alanın tam olarak doldurulacağı garanti edilmez. hizmet alır. Bu nedenle, tek yöntem adresleri doğrulamaktır, bunun yerine verdict ve address.