ABD'deki adresleri işleyin

Bu belgede, ABD'ye özgü adres doğrulama işlemi 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 sağlanan adrese teslimat yapıp yapamayacağını bildirmek 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
  • Alt tesis numarası USPS veri sisteminde yoksa.

Hizmet, dört dpvConfirmation değerinden birini döndürür veya 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ıkla ilgili daha fazla bilgi için Doğrulama mantığınızı oluşturma bölümündeki İş akışına genel bakış konusunu inceleyin.

Değer

Davranış

Açıklama

H

veya boş

Adresi düzeltme

Adres, DPV tarafından onaylanmamıştır.

Bu, USPS'nin girilen sokakta (rotada) girilen tesis numarasını tanımadığı ve oraya teslimat yapamayacağı 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 mevcut olduğu ancak tamamen doğrulanmış/teslimat yapılabilir 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ıdır.

Bu, adresin USPS tarafından tamamen teslim edilebilir olduğu anlamına gelir. Buna, varsa alt tesis numarası da dahildir.

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ı şunu döndürür: N

Bu, söz konusu bina numarasının bu rotada bulunmadığı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 doğrular. DPV'nin Y olması için girişin bir parçası olarak geçerli bir alt tesis eklenmelidir. Örneğin, dpvConfirmation değerinin Y olması 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ı şunu döndürür: S

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

DPV Y örneği - adresi kabul etme

Bu örnekte, bilinen kaliteli bir adres olarak Mountain View, CA'daki Googleplex adresi kullanılmıştı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. Bu sayede, API'nin kaliteli bir adres döndürdüğünden ve bu adresi olduğu gibi kullanabileceğinizden emin olabilirsiniz.

Not: DPV, Address Validation API'nin girişte herhangi bir değişiklik (ör. yazım düzeltme) 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ğu ve yasal olarak alınmadığı tespit edildiğinde adres listesinin yapay olarak oluşturulmasını önlemek için tasarlanmıştır. Bu nadir görülen bir durumdur.

USPS, yapay olarak oluşturulmuş bir adres tespit ettiğinde yanıtın uspsData mülkünün 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.