Obsługa adresów w Stanach Zjednoczonych

Ten dokument dotyczy weryfikacji adresów w Stanach Zjednoczonych:

Dane USPS w Twoim procesie

Podczas weryfikowania adresów w Stanach Zjednoczonych usługa interfejsu API weryfikacji adresów może też wypełnić część uspsData formularza zwrotu.

Ten obiekt nie jest zawsze wypełniany, dlatego nie należy polegać na tej właściwości jako jedynym sposobie weryfikacji adresów. Zamiast tego należy uwzględnić w swoim systemie także komponenty verdict i address.

USPS Delivery Point Verification (DPV)

W odpowiedzi uspsData pole dpvConfirmation zwraca 1 znak informujący o tym, czy USPS może dostarczyć przesyłkę pod podany adres.

W tym polu możesz określić:

  • i prawidłowe działanie adresu.
  • jeśli na adresie brakuje numeru lokalu;
  • jeśli numer lokalizacji podrzędnej nie istnieje w systemie danych USPS.

Usługa zwraca jedną z 4 wartości dpvConfirmation lub w ogóle nie zwraca wartości dpvConfirmation. Tabela poniżej przedstawia zalecane działanie, którego powinna użyć funkcja logiczna w przypadku każdego z 5 możliwych wyników. Więcej informacji o tej logice znajdziesz w sekcji Omówienie przepływu pracy w artykule Używanie odpowiedzi weryfikacyjnej.

Wartość

Zachowanie

Opis

N lub puste

Popraw adres

Adres nie został potwierdzony przez dostawcę.

Oznacza to, że USPS nie rozpoznaje podanego numeru lokalu na wskazanej ulicy (trasie) i nie może dostarczyć przesyłki.

D

Popraw adres

Adres został potwierdzony tylko przez DPV tylko dla numeru głównego, a także brakuje informacji o numerze dodatkowym.

Oznacza to, że podany numer budynku istnieje na podanej ulicy, ale aby uzyskać w pełni zweryfikowany adres, na który można dostarczyć przesyłkę, należy podać prawidłowy numer lokalu. Inaczej mówiąc, w danych wejściowych brakowało informacji o podstawie.

S

Potwierdź adres

Adres został potwierdzony przez DPV tylko w przypadku numeru głównego, a informacje o numerze dodatkowym były dostępne, ale nie zostały potwierdzone.

Oznacza to, że podany numer budynku istnieje na podanej trasie, ale według USPS podany budynek nie zawiera podrzędnego budynku.

T

Zaakceptuj adres

Adres został potwierdzony przez DPV w przypadku numeru głównego i dodatkowych numerów.

Oznacza to, że adres jest w pełni obsługiwany przez USPS, w tym w razie potrzeby numer lokalu.

W dalszej części tej sekcji omawiamy scenariusze praktyczne, w których wykorzystywane są kody DPV.

Przykład DPV N – popraw adres

W tym przykładzie użyto nieistniejącego numeru budynku dla adresu, który jest prawidłowy.

  • Wprowadzony adres: 12 Amphitheatre Parkway, Mountain View, CA 94043
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca: N

Jest to bardzo silny sygnał, że ten numer obiektu nie istnieje na tej trasie. Podobnie jak w przypadku innych problematycznych adresów, system powinien poprosić użytkownika o wprowadzenie poprawek.

DPV D example - fix the address

W tym przykładzie użyto adresu biura Google w Nowym Jorku, ale nie podano lokalizacji w obrębie budynku, która jest wymaganą częścią adresu. Możesz to sprawdzić, używając adresu w demonstracji bez informacji o subskrypcji.

  • Wprowadzony adres: 111 8th Avenue, Nowy Jork, NY, 10011
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca: D

Potwierdza to, że w danych wejściowych brakowało informacji o podrzędnej lokalizacji. Aby uzyskać DPV of Y, w danych wejściowych musisz podać prawidłowy podpunkt. Możesz na przykład podać prawidłową lokalizację podrzędną FL 4 (4. piętro), aby uzyskać wartość dpvConfirmation Y.

Przykład DPV S – potwierdzanie adresu

W tym przykładzie użyto numeru lokalu w ramach budynku, który nie istnieje:

  • Wprowadzony adres: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA 94043, USA
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca wartość: S

Oznacza to, że chociaż adres 1600 Amphitheatre Parkway istnieje i może przyjmować pocztę, pomieszczenie 101 nie jest prawidłową częścią adresu. Twój system powinien potwierdzić te informacje z użytkownikiem i dać mu możliwość ich poprawienia.

Przykład DPV Y – zaakceptowanie adresu

W tym przykładzie adres Googlepleksu w Mountain View w Kalifornii to adres o znacznej jakości.

  • Wprowadzony adres: 1600 Amphitheatre Parkway, Mountain View, CA 94043, USA
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca: Y

Adres jest w pełni zgodny z wymaganiami USPS. Daje to bardzo wysoki stopień pewności, że interfejs API zwrócił adres dobrej jakości, i możesz go używać w podanej formie.

Uwaga: DPV nie wskazuje, czy interfejs API weryfikacji adresów wprowadził jakiekolwiek zmiany w danych wejściowych, np. poprawę pisowni.

Wiadomości dotyczące bezpieczeństwa w przypadku adresów w Stanach Zjednoczonych

W tej sekcji omówiono flagi bezpieczeństwa w danych USPS dla adresów utworzonych sztucznie. To zabezpieczenie ma na celu zapobieganie sztucznemu tworzeniu listy adresów przez wykrywanie, kiedy przesłany adres wydaje się być sztucznie utworzony, a nie uzyskany w prawidłowy sposób. Powinien on być bardzo rzadki.

Gdy USPS wykryje sztucznie utworzony adres, pole errorMessage właściwości uspsData w odpowiedzi zawiera komunikat o błędzie opisujący problem. Na przykład:

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.