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 ramach odpowiedzi uspsData pole dpvConfirmation zwraca 1 znak, aby poinformować, czy USPS może dostarczyć przesyłkę na podany adres.

Za pomocą tego pola możesz określić:

  • 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 wcale nie zwraca wartości dpvConfirmation. Tabela poniżej zawiera zalecane zachowanie, którego powinna używać logika w przypadku każdego z 5 możliwych wyników. Więcej informacji o tej logice znajdziesz w sekcji Przegląd procesu w artykule Korzystanie z 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 przez dostawcę tylko w przypadku numeru głównego, a w przypadku numeru dodatkowego brakowało informacji.

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ć również 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 – poprawianie adresu

W tym przykładzie podano nieistniejący numer domu w przypadku prawidłowego adresu.

  • 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, Twój system powinien poprosić użytkownika o ich poprawienie.

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: 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 jako adres o znanej jakości użyto adresu Googleplex w Mountain View w Kalifornii.

  • 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. Dzięki temu możesz mieć pewność, że interfejs API zwrócił adres o dobrej jakości, którego możesz używać zgodnie z podanymi informacjami.

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.