Obsługa adresów w Stanach Zjednoczonych

Niniejszy dokument zawiera informacje na temat sprawdzania poprawności adresu w Stanach Zjednoczonych:

Dane USPS w Twoim przepływie pracy

Podczas weryfikowania adresów w Stanach Zjednoczonych usługa Address Review API może też wypełniać zwracaną część uspsData.

Ten obiekt nie zawsze jest wypełniony, dlatego nie należy korzystać z tej właściwości jako jedynego sposobu weryfikacji adresów. Zamiast tego włącz też ocenę i komponenty adresu do swojego systemu.

Weryfikacja punktu dostawy USPS (DPV)

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

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

  • prawidłowość adresu.
  • jeśli w adresie nie podano numeru lokalnego.
  • jeśli tego numeru nie ma w systemie danych USPS.

Usługa zwraca jedną z 4 wartości dpvConfirmation lub w ogóle nie zwraca wartości dpvConfirmation. Poniższa tabela przedstawia zalecane zachowanie Twojej logiki w przypadku każdego z 5 możliwych wyników. Więcej informacji na ten temat znajdziesz w sekcji Omówienie przepływu pracy w artykule Używanie odpowiedzi weryfikacyjnej.

Wartość

Zachowanie

Opis

N lub pusta

Popraw adres

Adres nie został potwierdzony.

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

D

Popraw adres

Adres został potwierdzony tylko w DPV dla numeru podstawowego i brakuje dodatkowych informacji o numerze.

Oznacza to, że wpisany numer lokalu znajduje się na wskazanej ulicy, ale aby można było na nią odpowiedzieć w pełni i umożliwić dostawę, trzeba też podać prawidłowy numer lokalu. Inaczej mówiąc, w danych wejściowych brakuje podrzędnego.

S

Potwierdź adres

Adres został potwierdzony tylko w DPV jako numer główny, a dodatkowe informacje o numerze były dostępne, ale nie zostały potwierdzone.

Oznacza to, że podany numer budynku istnieje na podanej trasie, ale według USPS w tym budynku nie ma podanego podrzędnego miejsca.

T

Zaakceptuj adres

Potwierdzono adres DPV dla numerów głównych i dodatkowych.

Oznacza to, że adres jest w całości dostarczany przez USPS, wraz z numerem lokalu lokalnego, jeśli jest dostępny.

W pozostałej części tej sekcji omawiamy rzeczywiste scenariusze, w których wykorzystywane są kody DPV.

Przykład DPV N – jak poprawić adres

W tym przykładzie użyto nieistniejącego numeru budynku pod innym prawidłowym adresem.

  • Podano adres: 12 Amphitheatre Parkway, Mountain View, CA 94043, USA
  • Region: USA
  • Pole dpvConfirmation zwraca wartość: N

To bardzo silny sygnał, że tego numeru nie ma na tej trasie. Podobnie jak w przypadku innych problematycznych adresów, Twój system powinien poprosić użytkownika o wprowadzenie poprawek.

Przykład DPV D – popraw adres

W tym przykładzie korzystamy z biura Google w Nowym Jorku, ale nie zawiera on siedziby, która jest wymaganą częścią adresu. Aby to sprawdzić, użyj adresu w prezentacji bez podstawowych informacji.

  • Podano adres: ul. Główna 111, Warszawa, woj. mazowieckie
  • Region: USA
  • Pole dpvConfirmation zwraca wartość: D

Jest to potwierdzenie, że w danych wejściowych brakuje środowiska podrzędnego. Aby można było uzyskać DPV o wartości Y, dane wejściowe muszą zawierać prawidłowe podzasłony. Możesz na przykład dołączyć prawidłowe podzastrzenie FL 4 (4th Floor), aby uzyskać wartość dpvConfirmation o wartości Y.

Przykład DPV S – potwierdź adres

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

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

Oznacza to, że chociaż 1600 Amphitheatre Parkway istnieje jako adres umożliwiający odbieranie poczty, lokalny adres Ste 101 nie jest prawidłową częścią adresu. System powinien potwierdzić te informacje z użytkownikiem i zapewnić możliwość wprowadzenia korekty.

Przykład DPV Y – zaakceptuj adres

W tym przykładzie używany jest adres Googlepleks w Mountain View w Kalifornii, znany jako adres wysokiej jakości.

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

Adres jest w całości dostarczany przez USPS. Zapewnia to bardzo wysoki stopień pewności, że interfejs API zwrócił adres dobrej jakości, a Ty możesz go używać w takiej postaci, w jakiej został on udostępniony.

Uwaga: DPV nie wskazuje, czy interfejs Address Verificationation API wprowadził jakiekolwiek zmiany w danych wejściowych, np. poprawienie pisowni.

Wiadomości dotyczące bezpieczeństwa dla adresów w USA

W tej sekcji omawiamy flagi bezpieczeństwa udostępniane w danych USPS w przypadku sztucznych adresów. Ma to na celu zapobieganie sztucznemu tworzeniu listy adresów przez wykrywanie przypadków, w których wydaje się, że przesyłany adres został skonstruowany sztucznie i nie został uzyskany w sposób zgodny z prawem. Taka sytuacja powinna być bardzo rzadka.

Gdy USPS wykryje sztucznie utworzony adres, pole errorMessage właściwości uspsData odpowiedzi zawiera komunikat o błędzie 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.