ABD'deki adresleri işleyin

Bu dokümanda, ABD'ye özel adres doğrulama ele alınmaktadır:

İş akışınızdaki USPS verileri

ABD'deki adresler doğrulanırken Address Validation API hizmeti, dönüşün uspsData bölümünü de doldurabilir.

Bu nesne her zaman doldurulmadığından, adresleri doğrulamak için tek araç olarak bu özelliğe güvenmemelisiniz, bunun yerine karar ve adres bileşenlerini sisteminize de dahil etmelisiniz.

USPS Teslimat Noktası Doğrulaması (DPV)

uspsData yanıtı kapsamında dpvConfirmation alanı, USPS'nin belirtilen 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çerli olduğundan emin olun.
  • Adreste alt parça numarası yoksa.
  • (USPS veri sisteminde alt bina 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, 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üzeltme

Adres DPV onaylı değil.

Bu durum, USPS'nin girilen caddedeki (rota) girilen bina numarasını tanımadığı ve oraya teslim edemediği anlamına gelir.

D

Adresi düzeltme

Adresin DPV yalnızca birincil numara için olduğu onaylanmıştı ve ikincil numara bilgisi eksikti.

Bu, girilen tesis numarasının girilen sokakta bulunduğu ancak tam olarak doğrulanmış/teslim edilebilir bir adrese ulaşmak için geçerli bir alt tesis numarasının da sağlanması gerektiği anlamına gelir. Diğer bir deyişle, girişte alt önerme yoktu.

S

Adresi onaylayın

Adresin DPV yalnızca birincil numara için olduğu onaylanmıştı ve ikincil numara bilgisi mevcuttu ancak doğrulanmadı.

Bu, girilen tesis numarasının girilen yolda mevcut olduğu, ancak USPS'ye göre belirtilen alt tesisin bu binada bulunmadığı anlamına gelir.

Y

Adresi kabul edin

Adres, birincil ve ikincil numaralar için DPV olarak onaylanmıştır.

Bu, adresin (varsa alt tesis numarası dahil) USPS tarafından tamamen teslim edileceği anlamına gelir.

Bu bölümün geri kalanında, DPV kodlarının kullanıldığı gerçek senaryolar anlatılmaktadır.

DPV N örneği - adresi düzeltme

Bu örnekte, normalde geçerli olan bir adreste var olmayan sokak numarası kullanılmaktadır.

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

Bu mesaj, söz konusu tesis 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 bir alt tesis yoktur. Bunu, alt şirket içi bilgiler olmadan demodaki adresi kullanarak görebilirsiniz.

  • Girilen adres: 111 8th Avenue, New York, NY, 10011
  • Bölge: ABD
  • dpvConfirmation alanı, D değerini döndürür

Bu durum, girişte alt önermenin eksik olduğunu onaylamaktadır. Y'nin DPV'sini elde etmek için girişin parçası olarak geçerli bir alt önerme eklenmelidir. Örneğin, dpvConfirmation değerini Y değeri olarak elde etmek için geçerli bir FL 4 (4. Kat) alt binasını ekleyebilirsiniz.

DPV S örneği - adresi doğrulama

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

  • Girilen adres: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • Bölge: ABD
  • dpvConfirmation alanı, S değerini döndürür

Bu, 1600 Amphitheatre Parkway, posta kabul eden bir adres olarak var olsa da, alt yapılı Ste 101 adresi geçerli bir adres değildir. Sisteminiz bu bilgiyi kullanıcıyla doğrulamalı ve düzeltme için bir fırsat sunmalıdır.

DPV Y örneği - adresi kabul etme

Bu örnekte, bilinen 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ı, Y değerini döndürür

Adres USPS tarafından eksiksiz olarak teslim edilebilir. Bu, API'nin iyi kalitede bir adres döndürdüğüne dair size son derece güven verir ve API'yı sağlandığı şekilde kullanabilirsiniz.

Not: DPV, Address Validation API'nin girişte herhangi bir değişiklik (ör. yazım düzeltme) yapıp yapmadığını belirtmez.

ABD'deki adresler 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 ne zaman yapay olarak oluşturulduğunu ve meşru bir şekilde elde edilmediğini algılayarak adres listesinin yapay bir şekilde oluşturulmasını önlemek amacıyla tasarlanmıştır. Bu çok nadir görülen bir durumdur.

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