ABD'deki adresleri işleyin

Bu belgede, ABD'ye özgü Address Validation süreci ele alınmaktadır:

İş akışınızda USPS verileri

Address Validation API, ABD'deki adresleri doğrularken yanıtın uspsData bölümünü de doldurabilir.

Bu nesne her zaman doldurulmadığından adresleri doğrulamak için yalnızca 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ı bildirmeniz için tek bir karakter döndürür.

Bu alanı kullanarak aşağıdakileri belirleyebilirsiniz:

  • 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 5 olası sonucun her biri için kullanması önerilen davranış gösterilmektedir. Bu mantıkla ilgili daha fazla bilgi için Doğrulama mantığınızı oluşturma bölümündeki İş akışına genel bakış başlıklı makaleyi inceleyin.

Değer

Davranış

Açıklama

H

veya boş

Adresi düzeltme

Adres, DPV ile onaylanmadı.

Bu, USPS'nin girilen sokakta (rotada) bulunan girilen bina 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 sokakta girilen bina numarasının mevcut olduğ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, alt tesis girişte eksikti.

G

Adresi onaylayın

Adres yalnızca birincil numara için DPV onaylıydı ve ikincil numara bilgileri mevcut ancak onaylanmamıştı.

Bu, girilen bina numarasının girilen rotada mevcut olduğu ancak sağlanan alt binanın USPS'ye göre bu binada mevcut olmadığı anlamına gelir.

Y

Adresi kabul etme

Adres, birincil ve ikincil numaralar için DPV onaylı olmalıdır.

Bu, varsa alt tesis numarası da dahil olmak üzere adresin USPS tarafından tamamen teslim edilebilir olduğu anlamına gelir.

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 bir adreste var olmayan bir sokak numarası kullanılıyor.

  • Girilen adres: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • Bölge: ABD
  • dpvConfirmation alanı şu değerleri döndürür: N

Bu, bu rota üzerinde bu tesis numarasının olmadığına dair son derece güçlü bir sinyaldir. Diğer sorunlu adreslerde olduğu gibi, sisteminiz kullanıcıdan düzeltme yapmasını istemelidir.

DPV D örneği: Adresi düzeltme

Bu örnekte Google'ın New York'taki ofisi kullanılmıştır ancak adresin zorunlu bir parçası olan alt tesis bilgisi yer almamaktadır. 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 onaylar. Y değerinde bir DPV elde etmek için girişin bir parçası olarak geçerli bir alt tesis eklenmelidir. Örneğin, Y değerinde bir dpvConfirmation elde etmek için FL 4 (4. Kat) gibi geçerli bir alt tesis ekleyebilirsiniz.

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 değerleri döndürür: S

Bu, 1600 Amphitheatre Parkway'in posta kabul edebilen bir adres olduğunu ancak Ste 101 alt tesisinin adresin geçerli bir parçası olmadığını gösterir. Sisteminiz bu bilgileri kullanıcıyla onaylamalı ve düzeltme yapma fırsatı sunmalıdır.

DPV Y örneği: Adresi kabul etme

Bu örnekte, Mountain View, CA'daki Googleplex adresi bilinen kaliteli bir adres olarak kullanılıyor.

  • 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. Bu, API'nin kaliteli bir adres döndürdüğünden ve bu adresi olduğu gibi kullanabileceğinizden emin olmanızı sağlar.

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ğu ve yasal olarak alınmadığı tespit edildiğinde adres listesinin yapay olarak oluşturulmasını önlemek için tasarlanmıştır. Bu durum çok nadiren gerçekleşir.

ABD Posta Servisi, yapay olarak oluşturulmuş bir adres tespit ettiğ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.