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 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ı bildirmek için tek bir karakter döndürür.

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

  • geçerlidir.
  • Adreste alt bina numarası eksikse.
  • USPS veri sisteminde alt tesis numarası yoksa.

Hizmet, dört dpvConfirmation değerinden birini döndürür veya bir dpvConfirmation değeri döndürmez. Aşağıdaki tabloda önerilen her 5 olası sonucun her biri için mantığınızın kullanması gereken bir davranıştır. Daha fazla daha fazla bilgi için Doğrulama yanıtını kullanma konusundaki iş akışına genel bakış.

Değer

Davranış

Açıklama

N veya boş

Adresi düzeltin

Adres DPV onaylanmadı.

Bu, USPS'nin girilen tesis numarasını tanımadığı anlamına gelir. girilen caddede (rotada) mevcut ve oraya teslim edilemiyor.

D

Adresi düzeltme

Adres, yalnızca birincil numara için DPV onaylıydı ve ikincil numara bilgileri eksikti.
.
Bu demek oluyor ki, girilen numara girilen sokakta var, ancak tamamen eşit aralıklarla adresi varsa, geçerli bir alt şirket numarası da olmalıdır; sağlar. 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 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, 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, 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 düzeltmelerini isteyesiniz.

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.

  • Adres girildi: 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 için DPV'ye ulaşmak amacıyla girişe geçerli bir alt tesis eklenmelidir. Örneğin, satın almak için FL 4'ün (4. Kat) geçerli bir alt dpvConfirmation değeri (Y).

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 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 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 tamamen USPS tarafından teslim edilebilir. 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 (Adres Doğrulama API'si) herhangi bir yazım düzeltme gibi bir girişte değişiklik yapma.

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