ABD'deki adresleri işleyin

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

İş akışınızdaki USPS verileri

ABD'de Adres Doğrulama API'si hizmeti, ABD'deki adresleri doğrularken iadenin uspsData bölümünü de doldurabilir.

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

USPS Delivery Point Verification (DPV)

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

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

  • adres geçerliliği.
  • Adreste alt bina 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 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ıydı ve ikincil numara bilgileri eksikti.

Bu, girilen bina numarasının girilen sokakta bulunduğu ancak tam olarak doğrulanmış/teslim edilebilir bir adrese ulaşmak için geçerli bir alt bina numarasının da sağlanması gerektiği anlamına gelir. Başka bir deyişle, girişte alt önerme eksiktir.

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 mevcut olduğ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 onaylandı.

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 olmayan bir adreste var olmayan 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, söz konusu tesis numarasının bu rotada mevcut olmadığı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 - 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, alt bina bilgileri içermeyen adresi kullanarak görebilirsiniz.

  • Girilen adres: 111 8th Avenue, New York, NY, 10011
  • Bölge: ABD
  • dpvConfirmation alanı şu sonucu 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 önerme dahil edilmelidir. Örneğin, FL 4'ün (4. Kat) geçerli bir alt tesisini ekleyerek dpvConfirmation değerini elde edebilirsiniz.

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ı şu sonucu döndürür: S

Bu, 1600 Amphitheatre Parkway posta kabul edebilecek bir adres olarak mevcut olsa da Ste 101 alt tesisinin adresin geçerli bir parçası olmadığını gösterir. Sisteminiz bu bilgileri kullanıcıyla onaylamalı ve düzeltme fırsatı sunmalıdır.

DPV Y örneği - adresi kabul edin

Bu örnekte, bilinen bir kalite adresi olarak Mountain View, CA'daki Googleplex adresi kullanılmaktadı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 bu adresi sağlandığı şekilde kullanabilirsiniz.

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ş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ğ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 tanımladığında yanıtın uspsData mülkünün errorMessagealanında sorunu açıklayan bir hata mesajı yer alır. Ö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.