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'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 Teslimat Noktası Doğrulaması (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:

  • 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 ya da hiç dpvConfirmation değeri döndürmez. Aşağıdaki tabloda, 5 olası sonucun her biri için mantığınızın kullanması gereken önerilen davranış gösterilmektedir. Bu mantık hakkında daha fazla bilgi için Doğrulama yanıtını kullanma bölümündeki İş akışına genel bakış bölümüne bakın.

Değer

Davranış

Açıklama

N veya boş

Adresi düzeltin

Adres DPV onaylanmadı.

Bu, USPS'nin girilen tesiste (rota) numarası tanımadığı ve oraya teslim edemeyeceği anlamına gelir.

D

Adresi düzeltin

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

Bu, girilen tesis numarasının girilen sokakta mevcut olduğu ancak tamamen doğrulanmış/teslim edilebilir bir adrese ulaşmak için geçerli bir alt tesis numarası sağlandığı 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 onaylandı. İkincil numara bilgisi mevcuttu ancak onaylanmadı.

Bu, girilen tesis numarasının girilen rotada olduğu ancak USPS'e göre sağlanan alt binanın bu bina içinde yer almadığı anlamına gelir.

Y

Adresi kabul edin

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

Bu, adresin, alt tesis numarası da dahil olmak üzere, tamamen USPS tarafından teslim edilebildiği anlamına gelir.

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

DPV D örneği - adresi düzeltme

Bu örnekte Google'ın New York ofisi kullanılmaktadır ancak adresin zorunlu bir parçası olan bir alt bina yoktur. Bunu görmek için demoda yer alan, alt bina bilgileri olmadan belirtilen adresi kullanabilirsiniz.

  • 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. 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 panosunu ekleyerek dpvConfirmation değerini elde edebilirsiniz.

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 posta kabul edilebilen bir adres olarak mevcut olsa da, Ste 101 alt binasının adresin geçerli bir bölümü olmadığını göstermektedir. Sisteminiz bu bilgiyi kullanıcıyla onaylamalı ve düzeltme için bir fırsat sunmalıdır.

DPV Y örneği - adresi kabul edin

Bu örnekte, bilinen bir kalite adresi olarak Mountain View, Kaliforniya'daki Googleplex adresi kullanılmaktadır.

  • 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, API'nin iyi kalitede bir adres döndürdüğü konusunda size son derece güven verir ve bu adresi belirtildiği gibi kullanabilirsiniz.

Not: DPV, Address Validation API'nin girişte yazım düzeltme 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 meşru şekilde elde edilmemiş olduğunu tespit ederek adres listesinin yapay oluşturulmasını önlemek için tasarlanmıştır. Bu çok nadir görülür.

USPS yapay olarak oluşturulmuş bir adres belirlediğinde yanıtın uspsData özelliğinin errorMessage alanı, sorunu açıklayan bir hata mesajı içerir. Ö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.