Adres doğrulama çözümü seçme

Test adımlarına genel bir bakış sunan akış şeması.

Hedef

Adres Doğrulama, çeşitli kullanım alanlarında değer sağlar. Test sonuçlarının ham kalitesinin ötesinde, incelemenizi önerdiğimiz önemli hususlar vardır. Örneğin: Yer Otomatik Tamamlama ve Haritalar gibi bir kullanıcı akışında uyumlu ürünlerin bütünsel görünümü, bölgesel kullanılabilirlik ve kurumsal güven ve güvenilirlik.

Adres Doğrulama API'sini değerlendirme aşamasına geldiğinizde, testinizin bir parçası olarak kullanmanızı önerdiğimiz bazı yönergeleri aşağıda bulabilirsiniz.

Bu testin hedefleri şunlardır:

  1. Address Validation API'nin kullanım alanınıza uygun olduğunu onaylayın.
  2. Adres Doğrulama API'sinin, çözümlerinizin gereksinimlerini nasıl karşıladığını doğrulayın. Örneğin:
    • Kaliteli adresleri belirleme
    • Düşük kaliteli girişleri düzeltme uyarısı
    • Çıkarımlar, değiştirmeler ve yazım düzeltmeleri dahil olmak üzere adres verilerinde düzeltmeler yapma
    • Kargo için biçimlendirilmiş bir adres sağlama.
    • Eksik veya yanlış alt bina verileriyle ilgili uyarılar (yalnızca ABD).
  3. API'yi uygulayarak ölçülebilir bir fayda elde edeceğinizden emin olun.

Testinizi yaptıktan sonra yukarıdaki soruları yanıtlayabilir ve API'nin işletmenize uygun olup olmadığını belirleyebilirsiniz.

Verilerinizi hazırlama

Testiniz, mevcut adres verilerinizin bir örneği üzerinde yapılmalıdır. Test için verileri manuel olarak seçmeyin. Bunun yerine, faaliyet gösterdiğiniz coğrafi bölgeleri temsil eden rastgele örnekler seçin. Bu nedenle, hem ABD hem de Birleşik Krallık'ta faaliyet gösteriyorsanız ancak işinizin% 70'i Birleşik Krallık'ta, %30'u ise ABD'de yapılıyorsa örnek bu dağılımı yansıtmalıdır.

Kayıt noktasındaki adresleri kullanın. Örneğin, e-ticaret ödeme sürecinizde adres doğrulamayı uygulamayı planlıyorsanız adresleri, Adres Doğrulama API'sinin uygulanmasıyla değiştirilebilecek mevcut bir işleme gerçekleşmeden önce müşterilerinizin forma girdiği şekilde kullanın.

Test için yaklaşık 5.000-10.000 kayıttan oluşan bir örneklem boyutu hazırlayın.

API'yi çağırma

Bölüm ön koşulu: Adres doğrulama isteği göndermeyi öğrenin.

Verileri hazırladıktan sonra her adres kaydını API'ye göre çalıştırmanız gerekir.

API'nin nasıl çağrılacağıyla ilgili yönergeler için Address Validation API belgelerine bakın. Ayrıca, Address Validation API'yi kullanarak adresleri yüksek hacimde işleme ile ilgili en iyi uygulamaları açıklayan bir makalemiz de bulunmaktadır.

Bu adımın sonucu, her adres kaydı için API'den gelen veri çıkışı olmalıdır. Ardından, API'nin kullanım alanınıza uygunluğunu belirlemek için sonuçları analiz edebilirsiniz. E-tablo, veritabanı veya başka bir araç kullanıp kullanmamak size kalmıştır.

Sonuçları inceleme

Bölüm ön koşulu: Doğrulama yanıtını nasıl işleyeceğinizi, özellikle Düzelt, Onayla ve Kabul et kavramlarını anlamış olmanız gerekir.

Bu bölümde, çözümün uygunluğunu değerlendirmek için analiz edebileceğiniz çıkış senaryolarını ele alacağız.

Bu belgede ele alınan temel API alanlarına genel bakış

Yanıt Verileri

Bu nedir?

Değerlendirme

Nasıl yardımcı olur?

verdict.inputGranularity

Adresin giriş ayrıntı düzeyini açıklar.

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

ENGELLE

ROUTE

DİĞER

Giriş adresinin geçerli olabilecek kadar yeterli veriye sahip olup olmadığını belirlemenizi sağlar.

verdict.validationGranularity

Adresin genel çıkış doğrulamasını açıklar.

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

ENGELLE

ROUTE

DİĞER

API'den gelen çıktıda genel adres kalitesini belirlemenizi sağlar.

verdict.hasInferredComponents

API'nin bir bileşeni çıkarıp çıkarmadığını gösterir.

Doğru/Yanlış

API, verileri tahmin edebildiği durumlarda eksik bileşenleri ekleyebilir. Örneğin, eyalet kodu eksik olabilir.

verdict.hasReplacedComponents

API'nin bir bileşeni değiştirip değiştirmediğini gösterir.

Doğru/Yanlış

API, bazı senaryolarda yanlış bileşenleri doğru verilerle değiştirebilir.

verdict.addressComplete

Adres tamamsa sinyaller.

Doğru/Yanlış

API, çıkış adresinin gerekli tüm bileşenlere sahip olduğunu belirlerse bu doğru olur.

address.missingComponentTypes

Adreste bileşen eksikse uyarı sinyali verilir.

Değerler için ikinci tabloya bakın.

Eksik bir adresteki bileşenleri vurgulayın.

Geçerli adresleri inceleme

Sisteminize göre geçerli kabul edilecek adresleri belirlemek için API'den döndürülen verileri sıralayın. API'den aranacak önemli sinyaller şunlardır:

  • verdict.validationGranularity, PREMISE veya daha iyi bir sürümü içerir.
  • verdict.addressComplete true.
  • Tahmin edilen veya değiştirilen bileşen yok.

Daha fazla bilgi için adresi kabul etme başlıklı makaleyi inceleyin.

Bu alıştırmanın çıktısı, sisteminiz tarafından geçerli olarak kabul edilecek adres verilerinin bir alt kümesi olmalıdır. Bu aşamada şunları belirleyebilirsiniz:

  • Kabul oranı yüzdesi kabul edilebilir mi?
  • Mevcut bir adres doğrulama iş akışı kullanıyorsanız kabul oranı eşit mi yoksa daha mı iyi?

Örnek: Geçerli adres

Girilen adres

Bölge

76 Buckingham Palace Road, Londra SW1W 9TQ

Birleşik Krallık

Sonuç

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

Geçersiz adresleri inceleme

Bu adım, geçersiz olarak işaretlenen bazı adres verilerini manuel olarak incelemek ve Adres Doğrulama API'si kullanmadan bu geçersiz adresin sonraki aşamalarda sorunlara neden olup olmayacağını görmek için bir fırsattır.

Sistemin adresleri geçersiz olarak işaretleyeceği grubu belirlemek için API'den döndürülen verileri sıralayın. API'den aranacak önemli sinyaller şunlardır:

  • verdict.validationGranularity, risk düzeyinize bağlı olarak OTHER veya ROUTE olarak ayarlanır.
  • verdict.addressComplete false.

Daha fazla bilgi için adresi düzeltme başlıklı makaleyi inceleyin.

Bu alıştırmanın çıktısı, sisteminiz tarafından geçersiz olarak işaretlenecek adres verilerinin bir alt kümesi olmalıdır. Bu noktada, geçersiz yüzde oranının kabul edilebilir olup olmadığını belirleyebilirsiniz.

Adresleri geçersiz olarak işaretlemenin, Address Validation API'nin temel işlevlerinden biri olduğunu ve geçersiz olarak işaretlenen adreslerin yüksek oranının API'nin performansını olumsuz etkilemediğini belirtmek önemlidir. API, adreste bir sorun olduğuna dair bilgi veriyor. Bu sayede, hataları daha erken tespit ederek iş akışınızda verimlilik sağlayabilir ve sonraki aşamalarda sorunlara yol açmasını önleyebilirsiniz.

Örnek: Geçersiz adres

Girilen adres

Bölge

21 45 40th street

ABD

Sonuç

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

Eksik veya onaylanmamış bileşenleri inceleme

Bu aşamada, eksik veya onaylanmamış bileşenler de incelenebilir. Bu, yanıttaki Address nesnesinin bir parçasıdır. Bu iki alan missingComponentTypes ve unconfirmedComponentTypes'dır.

Bu alanları kullanarak bir adresin API tarafından neden geçersiz olarak işaretlendiğini tespit edebilir ve yanlış olan belirli alanları veri toplama noktasına geri göndererek adresin geçerli olmasını sağlayacak doğru bilgileri toplayabilirsiniz. Bu, API'nin verilerinizin kalitesiyle ilgili belirli bilgiler vererek değer sağlama yöntemidir.

Örnek: Eksik ve onaylanmamış bileşen

Girilen adres

Bölge

Fake St, New York, NY 10011

ABD

Sonuç

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

Eksik ve onaylanmamış bileşenler

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

Düzeltmeler içeren adresleri inceleme

Adres Doğrulama API'si, giriş verilerinde düzeltmeler yapabilir. Potansiyel olarak geçersiz bir adres girişini alıp geçerli adres verileri çıkışı yapabilir. Bu, API'nin değer kattığı yollardan biridir ve testin bir parçası olarak bu durumu yakalamak önemlidir.

Dikkat edilmesi gereken önemli sinyaller şunlardır:

  • inferred, replaced veya spellCorrected, addressComponents cihazlarından herhangi birinde true olarak ayarlanmış olmalıdır.
  • verdict.hasInferredComponents veya verdict.hasReplacedComponents, true olarak ayarlanmış olmalıdır.

Daha fazla bilgi için adres onaylama başlıklı makaleyi inceleyin.

Bu alıştırmanın çıktısı, API tarafından düzeltme uygulanmış adres verilerinin bir alt kümesi olmalıdır.

Bu verilerin bir kısmı, API'nin verilerinizde aşağı akış iş akışınızdaki sürtünmeyi azaltacak düzeltmeler yapıp yapmadığını belirlemek için manuel olarak incelenebilir.

Örnek: Düzeltme içeren adres

Girilen adres

Bölge

76 Bruckingm Palace Road, London SW1W 9TQ

Birleşik Krallık

Rota addressComponent

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[Yalnızca ABD] Eksik veya yanlış alt tesis verileri içeren adresi inceleme

Adres Doğrulama API'si, ABD adresleri için alt birimin eksik veya yanlış olup olmadığını belirleyebilir.

Dikkat edilmesi gereken önemli sinyaller şunlardır:

  • Address nesnesinde:
    • unconfirmedComponentTypes, subpremise değerini içeriyor
    • missingComponentTypes, subpremise değerini içeriyor
  • UspsData nesnesinde:
    • dpvConfirmation, D (alt tesis eksik)
    • dpvConfirmation S (alt tesis onaylanmadı)

Daha fazla bilgi için ABD adreslerini işleme başlıklı makaleyi inceleyin.

Bu test, verilerinizde eksik veya yanlış alt tesisler (ör. daire numaraları) ile ilgili bir sorun olup olmadığını gösterir. Bu durum, özellikle yayın kullanım alanlarında sonraki sorunlara neden olabilir. Adres Doğrulama API'si, bu durumu daha erken tespit ederek iş akışınıza değer katabilir ve düzeltilmiş verileri toplamak için adımlar uygulamanıza olanak tanır.

Örnek: Alt bina eksik

Girilen adres

Bölge

111 8th Avenue, Manhattan, NY 10011

ABD

Eksik bileşen

"missingComponentTypes": [
    "subpremise"
]

USPS verileri DPV onayı

"dpvConfirmation": "D"

[Yalnızca ABD] USPS standartlaştırılmış adresini inceleme

Address Validation API, ABD adresleri için USPS standartlaştırılmış adresini de döndürür. Bu, özellikle kargo etiketlerinize USPS biçiminde adresler yazdırılmasını istiyorsanız önemlidir.

Bu verileri görüntülemek ve iş akışınıza değer katıp katmadığını belirlemek için UspsAddress incelenebilir.

Örnek: USPS standartlarına uygun adres

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

Sonuç

Test etmeye başlayın: Doğru adres verileri sağlamak, müşteri deneyimini iyileştirmek ve işletme işlemlerinizi kolaylaştırmak için bugün Adres Doğrulama API'si testinize başlayın. Yukarıda belirtilen test senaryolarını uyguladıktan sonra, Adres Doğrulama API'sinin iş akışınıza değer katıp katmayacağını belirlemek için ihtiyacınız olan bilgilere sahip olursunuz.

Daha fazla bilgi için önerilen kaynaklar:

Katkıda bulunanlar

Henrik Valve | DevX Mühendisi