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ı, USPS'nin belirtilen adrese teslimat yapıp yapamayacağını bildirmek için tek bir karakter döndürür.

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

  • adres geçerliliği.
  • Adreste alt tesis numarası eksikse.
  • USPS veri sisteminde alt tesis numarası 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 bilgi için Doğrulama mantığınızı oluşturma 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 muhtemelen buraya teslimat yapamayacağı anlamına gelir.

D

Alt tesis ekleme

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

Bu, girilen bina numarasının girilen sokakta bulunduğu anlamına gelir ancak tam olarak doğrulanmış/posta 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ıydı ve ikincil numara bilgileri mevcuttu ancak onaylanmadı.

Bu, girilen tesis numarasının girilen rotada bulunduğu ancak USPS'ye göre sağlanan alt tesisin bu binada bulunmadığı anlamına gelir.

Y

Adresi kabul etme

Adres, birincil ve ikincil numaralar için DPV onayı almıştır.

Bu, varsa alt tesis numarası dahil olmak üzere USPS tarafından tamamen teslim edilebilir

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

DPV N örneği - adresi düzeltme

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

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

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

DPV D örneği - alt tesis ekleme

Bu örnekte New York'taki Google ofisi kullanılmıştır ancak adresin zorunlu bir parçası olan alt tesis belirtilmemiştir. Bunu, demo'daki adresi alt tesis bilgileri olmadan kullanarak görebilirsiniz.

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

Bu, alt tesisin girişte eksik olduğunu doğrular. Y için DPV'ye ulaşmak amacıyla girişe geçerli bir alt tesis eklenmelidir. Örneğin, dpvConfirmation değeri Y almak için geçerli bir FL 4 (4. Kat) alt tesisi ekleyebilirsiniz.

DPV S örneği - adresi onaylama

Bu örnekte, binada bulunmayan bir alt tesis numarası kullanılmıştı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 geçerli bir adres olsa da alt tesis 101 numaralı daire adresinin geçerli bir parçası olmadığını gösterir. Bu bilgileri kullanıcıyla onaylayabilir ve düzeltme fırsatı sunabilirsiniz.

DPV Y örneği - adresi kabul etme

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

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

Adres, USPS tarafından tamamen teslim edilebilir durumda olmalıdır. Bu, API'nin iyi kalitede bir adres döndürdüğüne dair çok yüksek düzeyde güven sağlar ve büyük olasılıkla bu adresi sağlandığı şekilde kullanabilirsiniz. Her zaman olduğu gibi, müşterinizden onay isteyip istemeyeceğiniz konusunda karar verirken risk düzeyinizi göz önünde bulundurun.

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 durum çok nadir görülür.

USPS, yapay olarak oluşturulmuş bir adres tespit ettiğinde yanıtın uspsData mülkünün errorMessage alanında sorunu açıklayan bir hata mesajı bulunur. Ö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.