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 olası 5 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üzeltme

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ış/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 dünya senaryoları ele alınmaktadır.

DPV N örneği - adresi düzeltme

Bu örnekte, aksi takdirde geçerli olan bir adreste var olmayan bir sokak numarası kullanılıyor.

  • 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 - 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, 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, 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, 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 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 etme

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ş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 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.