ABD'deki adresleri işleyin

Bu dokümanda, Amerika Birleşik Devletleri'ne özel adres doğrulama konuları ele alınmaktadır:

İş akışınızdaki USPS verileri

ABD'deki adresleri doğrularken Address Validation API hizmeti dönüşün uspsData bölümünü de doldurabilir.

Bu nesne her zaman doldurulmadığından, özelliğini kullanmak yerine bileşenlerine ekleyin.

USPS Teslimat Noktası Doğrulaması (DPV)

uspsData yanıtının bir parçası olarak dpvConfirmation alanı tek bir değer döndürür karakteriyle (USPS'in verilen adrese teslimat yapıp yapamayacağını bildirirsiniz).

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

  • geçerlidir.
  • Adreste alt bina numarası eksikse.
  • alt tesis numarası USPS veri sisteminde 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üzeltin

Adres yalnızca birincil numara için DPV onaylıdır 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ıdır ve ikincil numara bilgisi vardı ancak onaylanmadı.

Bu, girilen bina numarasının girilen rotada olduğu anlamına gelir. ama sağlanan alt binaya göre o binanın içinde yer almıyordur. USPS'ye gönderiliyor.

Y

Adresi kabul edin

Adres, birincil ve ikincil numaralar için DPV onayı aldı.

Bu, adresin, ABD Servis Sağlayıcı Sürümü dahil olmak üzere, tamamen USPS tarafından teslim edilebildiği anlamına gelir. alt bina numarası (varsa).

Bu bölümün geri kalanında, DPV kodlarının kullanıldığı gerçek 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.

  • Adres girildi: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • Bölge: ABD
  • dpvConfirmation alanı şu sonucu 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 Google'ın New York ofisi kullanılmaktadır ancak herhangi bir emin olun. Bunu görmek için demoda yer alan adrese alt bina bilgisi eklemeyin.

  • Adres girildi: 111 8th Avenue, New York, NY, 10011
  • Bölge: ABD
  • dpvConfirmation alanı şu sonucu döndürür: D

Bu, girişte alt önermenin eksik olduğunu doğrular. DPV'ye ulaşmak için Y'de geçerli bir alt önerme, girişe dahil edilmelidir. Örneğin, lisans almak için FL 4'ün (4. Kat) geçerli bir alt dpvConfirmation değeri (Y).

DPV S örneği - adresi onaylama

Bu örnekte, bina içinde bulunmayan bir alt bina numarası kullanılmaktadır:

  • Adres girildi: 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 adresine kayıtlı bir adres olarak ancak posta kabul edebiliyorsa, alt bina adı 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 edin

Bu örnekte, Mountain View, Kaliforniya'daki Googleplex adresi bir bilinen kaliteli bir adrestir.

  • Adres girildi: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Bölge: ABD
  • dpvConfirmation alanı şu sonucu döndürür: Y

Adres tamamen USPS tarafından teslim edilebilir. Bu size yüksek derecede API'nın yüksek kalitede bir adres döndürdüğünden emin olamaz ve bu adresi sağlandığından emin olun.

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, şunlar için USPS verilerinde sağlanan güvenlik işaretleri ele alınmaktadır: yapay olarak oluşturulmuş adresler Bu güvenlik önlemi, gönderilen bir adresin ne zaman gönderildiğini tespit ederek yapay bir adres listesi oluşturma yapay olarak inşa edildiği ve meşru şekilde elde edilmemiş olduğu anlaşılmaktadır. Bu ç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.