ABD'deki adresleri işleyin

Bu dokümanda, ABD'ye özgü adres doğrulaması ele alınmaktadır:

İş akışınızdaki USPS verileri

Adres Doğrulama API hizmeti, ABD'deki adresleri doğrularken döndürülen değerin uspsData bölümünü de doldurabilir.

Bu nesne her zaman doldurulmadığı için adresleri doğrulamak için tek yöntem olarak bu mülke güvenmemeli, bunun yerine karar ve adres bileşenlerini de sisteminize dahil etmelisiniz.

USPS Delivery Point Verification (DPV)

uspsData yanıtının bir parçası olarak dpvConfirmation alanı tek bir değer döndürür karakteriyle (USPS'in verilen adrese teslimat yapıp yapamayacağını bildirirsiniz).

Bu alanı aşağıdakileri belirlemek için kullanabilirsiniz:

  • adres geçerliliği.
  • Adreste alt tesis numarası eksikse.
  • alt tesis numarası USPS veri sisteminde yoksa.

Hizmet, dört dpvConfirmation değerinden birini döndürür veya hiç dpvConfirmation değeri döndürmez. Aşağıdaki tabloda, mantığınızın 5 olası sonucun her biri için kullanması gereken önerilen davranış gösterilmektedir. Bu mantıkla ilgili daha fazla bilgi için Doğrulama yanıtını kullanma başlıklı makalenin İş akışına genel bakış bölümüne bakın.

Değer

Davranış

Açıklama

N veya boş

Adresi düzeltme

Adres, DPV onayı almadı.

Bu, USPS'nin girilen sokakta (rota) bulunan tesis numarasını tanımadığı ve buraya teslimat yapamadığı anlamına gelir.

D

Adresi düzeltin

Adres yalnızca birincil numara için DPV onaylıdır ve ikincil numara bilgileri eksikti.

Bu, girilen bina numarasının girilen sokakta bulunduğu anlamına gelir ancak tam olarak doğrulanmış/teslimat yapılabilir bir adrese ulaşmak için geçerli bir alt bina numarasının da sağlanması gerekir. Diğer bir deyişle, girişte alt tesis eksikti.

S

Adresi onaylayın

Adres yalnızca birincil numara için DPV onaylıdır ve ikincil numara bilgisi vardı ancak onaylanmadı.

Bu, girilen bina numarasının girilen rotada olduğu anlamına gelir. ama sağlanan alt binaya göre o binanın içinde yer almıyordur. USPS'ye gönderiliyor.

Y

Adresi kabul etme

Adres, birincil ve ikincil numaralar için DPV onayı aldı.

Bu, adresin, ABD Servis Sağlayıcı Sürümü dahil olmak üzere, tamamen USPS tarafından teslim edilebildiği anlamına gelir. alt bina numarası (varsa).

Bu bölümün geri kalanında, DPV kodlarının kullanıldığı gerçek dünya senaryoları ele alınmaktadır.

DPV N örneği - adresi düzeltme

Bu örnekte, geçerli olmayan bir adreste var olmayan sokak numarası kullanılmaktadır.

  • Girilen adres: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • Bölge: ABD
  • dpvConfirmation alanı şu sonucu döndürür: N

Bu, tesis numarasının mevcut olmadığını gösteren son derece güçlü bir sinyal bu rotada. Diğer sorunlu adreslerde olduğu gibi, sisteminiz kullanıcıdan düzeltme yapmasını ister.

DPV D örneği - adresi düzeltme

Bu örnekte New York'taki Google ofisi kullanılmıştır ancak adresin zorunlu bir parçası olan alt tesis belirtilmemiştir. Bunu görmek için demoda yer alan adrese alt bina bilgisi eklemeyin.

  • Adres girildi: 111 8th Avenue, New York, NY, 10011
  • Bölge: ABD
  • dpvConfirmation alanı şunu döndürür: D

Bu, girişte alt önermenin eksik olduğunu doğrular. Y için DPV'ye ulaşmak amacıyla girişe geçerli bir alt tesis eklenmelidir. Örneğin, Y değerini dpvConfirmation elde etmek için FL 4 (4. Kat) geçerli bir alt tesisi dahil edebilirsiniz.

DPV S örneği - adresi onaylama

Bu örnekte, bina içinde bulunmayan bir alt bina numarası kullanılmaktadır:

  • Girilen adres: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • Bölge: ABD
  • dpvConfirmation alanı şunu döndürür: S

Bu, 1600 Amphitheatre Parkway adresine kayıtlı bir adres olarak ancak posta kabul edebiliyorsa, alt bina adresi Ste 101, adresin geçerli bir bölümü değildir. Sisteminiz bu bilgiyi kullanıcıyla doğrulamalı ve size düzeltme fırsatı bulur.

DPV Y örneği - adresi kabul edin

Bu örnekte, Mountain View, Kaliforniya'daki Googleplex adresi bir bilinen kaliteli bir adrestir.

  • Girilen adres: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Bölge: ABD
  • dpvConfirmation alanı şu sonucu döndürür: Y

Adres tamamen USPS tarafından teslim edilebilir. Bu size yüksek derecede API'nın yüksek kalitede bir adres döndürdüğünden emin olamaz ve bu adresi sağlandığından emin olun.

Not: DPV, Address Validation API'nin girişte yazım düzeltmesi gibi herhangi bir değişiklik yapıp yapmadığını belirtmez.

ABD adresleri için güvenlik mesajları

Bu bölümde, yapay olarak oluşturulan adresler için USPS verilerinde sağlanan güvenlik işaretleri ele alınmaktadır. Bu güvenlik önlemi, gönderilen bir adresin yapay olarak oluşturulduğunu ve yasal olarak elde edilmediğini tespit ederek adres listesinin yapay olarak oluşturulmasını önlemek için tasarlanmıştır. Bu çok nadir görülür.

USPS yapay olarak oluşturulmuş bir adres tespit ettiğinde errorMessage yanıtın uspsData özelliğinin alanında bir hata mesajı gösteriliyor. Örneğin:

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.