ABD'deki adresleri işleyin

Bu belgede, ABD'ye özgü adres doğrulama konusu ele alınmaktadır:

İş akışınızdaki USPS verileri

ABD'deki adresler doğrulanırken Address Validation API hizmeti, yanıttaki uspsData bölümünü de doldurabilir.

Bu nesne her zaman doldurulmadığı için adresleri doğrulamak için tek başına bu özelliğe güvenmemeli, bunun yerine kararı ve adres bileşenlerini de sisteminize dahil etmelisiniz.

USPS Teslimat Noktası Doğrulaması (DPV)

uspsData yanıtının bir parçası olarak, dpvConfirmation alanı, USPS'nin belirtilen adrese teslimat yapıp yapamayacağını bildirmenizi sağlayan tek bir karakter döndürür.

Bu alanı kullanarak aşağıdakileri belirleyebilirsiniz:

  • adres geçerliliği.
  • Adreste alt tesis numarası eksikse
  • Alt bina 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 kullanabileceği olası davranış gösterilmektedir. Bu mantıkla ilgili daha fazla ayrıntı için Doğrulama mantığınızı oluşturma bölümündeki Örnek iş akışları'na bakın.

Değer

Davranış

Açıklama

N veya boş

Adresi düzeltme

Adres DPV onaylı değil.

Bu, USPS'nin girilen sokakta (rotada) bulunan girilen bina numarasını tanımadığı ve büyük olasılıkla teslimat yapamayacağı anlamına gelir.

D

Alt bina ekleme

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

Bu, girilen sokakta girilen bina numarasının mevcut olduğu anlamına gelir. Ancak tam olarak doğrulanmış/teslim edilebilir bir adrese ulaşmak için geçerli bir alt bina numarası da sağlanmalıdır. Diğer bir deyişle, girişten alt tesis eksikti.

S

Adresi onaylayın

Adres, yalnızca birincil numara için DPV ile onaylanmış ve ikincil numara bilgileri mevcut ancak onaylanmamış.

Bu, girilen rota üzerinde girilen bina numarasının bulunduğu ancak USPS'ye göre sağlanan alt binanın bu binada bulunmadığı anlamına gelir.

Y

Adresi kabul etme

Adres, birincil ve ikincil numaralar için DPV doğrulandı.

Bu, adresin USPS tarafından tamamen teslim edilebilir olduğu anlamına gelir. Varsa alt tesis numarası da buna dahildir.

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 bir adresin var olmayan bir sokak numarası kullanılıyor.

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

Bu, bu rota üzerinde bu tesis numarasının bulunmadığını gösteren son derece güçlü bir sinyaldir. Diğer sorunlu adreslerde olduğu gibi, sisteminiz kullanıcının düzeltme yapmasını istemelidir.

DPV D örneği - alt tesis ekleme

Bu örnekte New York'taki Google ofisi kullanılıyor ancak adresin zorunlu bir parçası olan alt tesis bilgisi yer almıyor. Bunu, alt tesis bilgisi olmadan demodaki adresi kullanarak görebilirsiniz.

  • Girilen adres: 111 8th Avenue, New York, NY, 10011
  • Bölge: ABD
  • dpvConfirmation alanı şu değeri döndürür: D

Bu, alt tesisin girişte eksik olduğunu doğrular. Y'nin DPV'sine ulaşmak için girişe geçerli bir alt öncül eklenmelidir. Örneğin, FL 4 (4. Kat) geçerli alt tesisini dahil ederek Y dpvConfirmation değerini elde edebilirsiniz.

DPV S örneği: Adresi onaylama

Bu örnekte, bina içinde bulunmayan bir alt tesis numarası kullanılıyor:

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

Bu, 1600 Amphitheatre Parkway'in geçerli bir adres olduğunu ancak alt tesis Suite 101'in adresin geçerli bir parçası olmadığını gösterir. Bu bilgiyi kullanıcıyla onaylamayı ve düzeltme yapma fırsatı vermeyi düşünebilirsiniz.

DPV Y örneği: Adresi kabul etme

Bu örnekte, Mountain View, CA'daki Googleplex adresi bilinen geçerli bir adres olarak kullanılmaktadır.

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

Adres, USPS tarafından tam olarak teslim edilebilir. Bu, API'nin kaliteli bir adres döndürdüğüne dair çok yüksek bir güven düzeyi sağlar ve büyük olasılıkla adresi olduğu gibi kullanabilirsiniz. Müşterinizden onay isteyip istemeyeceğinize karar verirken her zaman risk seviyenizi göz önünde bulundurun.

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

ABD adresleri için güvenlik mesajları

Bu bölümde, yapay olarak oluşturulmuş 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ğu ve yasal yollarla elde edilmediği tespit edildiğinde adres listesinin yapay olarak oluşturulmasını önlemek için tasarlanmıştır. Bu durum nadiren görülür.

USPS, yapay olarak oluşturulmuş bir adres tespit ettiğinde yanıtın uspsData özelliğinin errorMessage alanı, sorunu açıklayan bir hata mesajı içerir. Ö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.