Obsługa adresów w Stanach Zjednoczonych

Niniejszy dokument dotyczy weryfikacji adresu w Stanach Zjednoczonych:

Dane USPS w przepływie pracy

Do weryfikacji adresów w Stanach Zjednoczonych używana jest usługa Address Validation API. może też wypełniać część zwrotu uspsData.

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ż dokonywać diagnoz i adresów w swoim systemie.

Weryfikacja punktu dostawy USPS (DPV)

W ramach odpowiedzi uspsData pole dpvConfirmation zwraca jeden informujący, czy dostawca USPS może dostarczyć przesyłki pod podany adres.

W tym polu możesz określić:

  • i prawidłowe działanie adresu.
  • jeśli w adresie brakuje numeru lokalu podrzędnego.
  • , jeśli w systemie danych USPS nie ma numeru lokalu podrzędnego.

Usługa zwraca jedną z czterech wartości dpvConfirmation lub nie zwraca nie zwraca żadnej wartości dpvConfirmation. W tabeli poniżej znajdziesz zalecane działania zachowanie, którego logika powinna używać 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 pusta

Popraw adres

Adres nie został potwierdzony przez DPV.

Oznacza to, że USPS nie rozpoznaje podanego numeru lokalu na podanej ulicy (trasie) i nie można jej dostarczyć.

D

Popraw adres

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

Oznacza to, że założenie znajduje się na podanej ulicy, ale w celu osiągnięcia pełnego zweryfikowany/możliwy do dostarczenia, należy również podać prawidłowy numer lokalny dostępna. Inaczej mówiąc, w danych wejściowych brakowało elementu podrzędnego.

S

Potwierdź adres

Adres został potwierdzony wyłącznie przez DPV wyłącznie dla numeru głównego, podano dodatkowy numer, który nie został potwierdzony.

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

Potwierdzono adres DPV jako numer główny i numery dodatkowe.

To oznacza, że adres może w całości dostarczyć USPS, łącznie z (w stosownych przypadkach) pod numerem lokalu.

W pozostałej części tej sekcji omawiamy rzeczywiste scenariusze wykorzystujące 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 wartość: N

To bardzo silny sygnał, że lokalny numer nie istnieje. na tej trasie. Tak jak w przypadku innych problematycznych adresów, system powinien: użytkownika w celu uzyskania poprawek.

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

Jest to potwierdzenie, że w danych wejściowych nie ma elementu podrzędnego. Uzyskiwanie dostępu do DPV Y, jako część danych wejściowych należy uwzględnić prawidłową podstawę podrzędną. Przykład: możesz dołączyć prawidłowy lokal podrzędny FL 4 (4th Floor), aby uzyskać Wartość Y: dpvConfirmation.

Przykład DPV S – potwierdź adres

W tym przykładzie korzystamy z numeru budynku 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 wartość: S

Oznacza to, że mimo że 1600 Amphitheatre Parkway istnieje jako adres, przyjmuje pocztę, obiekt podrzędny Ste 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 użyto adresu Googlepleksu w Mountain View w Kalifornii jako adresu e-mail o znanej jakości.

  • Podany adres: 1600 Amphitheatre Parkway, Mountain View, CA 94043, USA
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca wartość: Y

Adres jest w całości dostarczany przez USPS. Dzięki temu możesz masz pewność, że interfejs API zwrócił adres dobrej jakości i możesz go użyć jak podano.

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 dostarczane w danych USPS dla: sztucznie utworzone adresy. Ma to na celu zapobieganie sztuczne tworzenie listy adresów przez wykrywanie, czy przesłany adres został przesłany zostały zbudowane sztucznie i nie zostały uzyskane w sposób zgodny z prawem. Taka sytuacja powinna być bardzo rzadka.

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.