Obsługa adresów w Stanach Zjednoczonych

Niniejszy dokument dotyczy weryfikacji adresu 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 zawsze jest zapełniany, więc nie należy polegać na tym jako jedynego sposobu weryfikacji adresów, lecz zamiast tego zastosuj jak również identyfikować i adresować komponenty w swoim systemie.

USPS Delivery Point Verification (DPV)

W ramach odpowiedzi uspsData pole dpvConfirmation zwraca 1 znak, który informuje, czy USPS może dostarczyć przesyłkę na podany adres.

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

  • adresu.
  • jeśli w adresie brakuje numeru lokalu podrzędnego.
  • jeśli numer lokalizacji podrzędnej nie istnieje w systemie danych USPS.

Usługa zwraca jedną z czterech wartości dpvConfirmation lub nie zwraca nie zwraca żadnej 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 na temat tej logiki, zob. Omówienie przepływu pracy w artykule Używanie odpowiedzi weryfikacyjnej.

Wartość

Zachowanie

Opis

N lub puste

Popraw adres

Adres nie został potwierdzony przez DPV.

Oznacza to, że USPS nie rozpoznaje podanego numeru lokalu, który znajduje się na podanej ulicy (trasie), i nie może dostarczyć przesyłki.

D

Popraw adres

Adres został potwierdzony wyłącznie przez DPV wyłącznie dla numeru głównego, brakowało dodatkowego numeru.

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 elementu podrzędnego.

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 wpisany numer nieruchomości istnieje na podanej trasie, ale podany element podrzędny nie istnieje w tym budynku, na USPS.

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 zgodny z USPS, w tym w razie potrzeby numerem 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.

  • Podany adres: 12 Amphitheatre Parkway, Mountain View, CA 94043, USA
  • 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.

Przykład DPV D – popraw adres

W tym przykładzie użyto biura Google w Nowym Jorku, ale nie zawiera obiektu podrzędnego, który jest wymaganą częścią adresu. Możesz to sprawdzić, używając adres w wersji demonstracyjnej bez informacji o lokalizacji podrzędnej.

  • Podany adres: Emilii Plater 23, 00-113 Warszawa
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca wartość: D

Potwierdza to, że w danych wejściowych brakowało informacji o podrzędnej lokalizacji. Uzyskiwanie dostępu do DPV Y, jako część danych wejściowych należy uwzględnić prawidłową podstawę podrzędną. 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 – potwierdź adres

W tym przykładzie używany jest numer obiektu podrzędnego, który nie istnieje w budynku:

  • Podany adres: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • 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. System powinien potwierdzić te informacje z użytkownikiem i podać do wprowadzenia korekty.

Przykład DPV Y – zaakceptuj adres

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 całości dostarczany przez 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 Address Validation API wprowadził zmian w danych wejściowych, na przykład korekty pisowni.

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

Ta sekcja obejmuje flagi bezpieczeństwa udostępniane w danych USPS dla: sztucznie utworzonych adresów. 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 rozpozna sztucznie utworzony adres, errorMessage właściwości uspsData odpowiedzi zawiera element z opisem problemu. 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.