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": {
    // 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, çı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 mülk, 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ünde bulunan tüm alanlar özetlenmiştir.

Görüntüleyin Referans kılavuzundaki sonuç'u inceleyebilirsiniz.

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ı, bir adresin olup olmadığına dair önemli bir sinyaldir teslimat olabilir.

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

  • inputGranularity — Bağlantının Address Validation API'ye gönderilmesini sağlayın. İstekte belirtilen adres ayrıntı düzeyi, doğrulama yanıtındaki adres ayrıntı 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: 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, kalite adresini gösterir teslimat da yapabilirsiniz.
  • geocodeGranularity: Adresle ilişkili coğrafi kodla ilgili ayrıntı düzeyini belirtir. Örneğin, Google kayıtları bir daire numarası olup olmadığı (buna ait tam konum değil) veya kompleks olarak değişti. Bu durumda, validationGranularity SUB_PREMISE olur ancak geocodeGranularityisPREMISE` olur.
Referans kılavuzundaki Ayrıntı düzeyi bölümüne bakın.

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 beklenmedik bileşenler varsa alan false olarak ayarlanır.

addressComplete sayfasını inceleyin Sonuç ve Başvuru kılavuzunda Adres.

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
}
Referans kılavuzunda Sonuç'a bakın.

address ve addressComponent özellikleri

address özelliği, aşağıda sağlanan işlenmiş adres için biçimlendirme sağlar: 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 adres parçalar.

Referans kılavuzundaki Address bölümüne bakın.

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ı adı, türü ve onay düzeyine göre tanımlar.

Referans kılavuzundaki addressComponent bölümüne bakın.

geocode mülkü

geocode mülkü, giriş adresiyle ilişkili coğrafi kodlanmış konumu gösterir. Bu tesis, konumun kendisi hakkında ayrıntılı bilgi sağlar. Örneğin: içerir.

Referans kılavuzundaki Geocode bölümüne bakın.

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.

Address Validation API kapsamına ve Address metadata referansına bakın.

uspsData mülkü

Bu mülk, 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, yalnızca adresleri doğrulamak anlamına gelir, ancak bunun yerine verdict ve address tane de var.

ABD adreslerini işleme bölümüne ve UspsData referansına bakın.
Önceki
Adres doğrulama isteği gönderme
Sonraki
Doğrulama mantığınızı oluşturun