Obsługa adresów w Stanach Zjednoczonych

Ten dokument zawiera informacje o weryfikacji adresów w Stanach Zjednoczonych:

Dane USPS w przepływie pracy

Podczas sprawdzania poprawności adresów w Stanach Zjednoczonych usługa Address Validation API może też wypełnić część uspsData zwracanych informacji.

Ten obiekt nie zawsze jest wypełniony, więc nie należy polegać na tej właściwości jako jedynym sposobie weryfikacji adresów. Zamiast tego włącz do systemu także werdykt i składniki adresu.

Weryfikacja punktu dostawy USPS (DPV)

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

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

  • sprawdzić poprawność adresu.
  • jeśli w adresie brakuje numeru lokalu.
  • jeśli numer lokalu nie istnieje w systemie danych USPS.

Usługa zwraca jedną z 4 wartości dpvConfirmation lub nie zwraca jej wcale.dpvConfirmation W tabeli poniżej znajdziesz możliwe zachowania logiki w przypadku każdego z 5 możliwych wyników. Więcej informacji o tej logice znajdziesz w sekcji Przykładowe przepływy pracy w artykule Tworzenie logiki weryfikacji.

Wartość

Zachowanie

Opis

N lub puste

Poprawianie adresu

Adres nie został potwierdzony przez DPV.

Oznacza to, że USPS nie rozpoznaje podanego numeru lokalu znajdującego się na podanej ulicy (trasie) i prawdopodobnie nie może tam dostarczyć przesyłki.

D

Dodawanie podlokalu

Adres został potwierdzony w ramach weryfikacji DPV tylko w przypadku numeru podstawowego, a informacje o numerze dodatkowym były niekompletne.

Oznacza to, że podany numer budynku istnieje na podanej ulicy, ale aby uzyskać w pełni zweryfikowany adres, pod którym można dostarczać przesyłki, należy podać prawidłowy numer lokalu. Innymi słowy, w danych wejściowych nie było podlokalizacji.

S

Potwierdź adres

Adres został potwierdzony w ramach weryfikacji DPV tylko w przypadku numeru podstawowego, a informacje o numerze dodatkowym były obecne, ale nie zostały potwierdzone.

Oznacza to, że wpisany numer lokalu istnieje na podanej trasie, ale podany podlokal nie istnieje w tym budynku (według USPS).

T

Zaakceptuj adres.

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

Oznacza to, że adres jest w pełni obsługiwany przez USPS, w tym numer lokalu (w stosownych przypadkach).

W pozostałej części tej sekcji omówimy rzeczywiste scenariusze, w których używane są kody DPV.

DPV N example - fix the address

W tym przykładzie użyto nieistniejącego numeru domu w prawidłowym adresie.

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

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

DPV D example - add a subpremises

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

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

Potwierdza to, że w danych wejściowych nie było podrzędnego obiektu. Aby uzyskać DPV o Y, w danych wejściowych musi być uwzględniona prawidłowa podstawa. Możesz na przykład podać prawidłowy podlokal FL 4 (4th Floor), aby uzyskać wartość dpvConfirmation równą Y.

Przykład DPV S – potwierdzenie adresu

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

  • Wpisany adres: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca: S

Oznacza to, że chociaż 1600 Amphitheatre Parkway to prawidłowy adres, Suite 101 nie jest jego prawidłową częścią. Możesz poprosić użytkownika o potwierdzenie tych informacji i umożliwić mu ich poprawienie.

DPV Y example - accept the address

W tym przykładzie używamy adresu Googleplex w Mountain View w Kalifornii jako znanego, prawidłowego adresu.

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

Adres jest w pełni obsługiwany przez USPS. Daje to bardzo wysoki stopień pewności, że interfejs API zwrócił adres o dobrej jakości, i prawdopodobnie możesz go użyć w takiej postaci, w jakiej został zwrócony. Podejmując decyzję o tym, czy poprosić klienta o potwierdzenie, weź pod uwagę swój poziom ryzyka.

Uwaga: wartość DPV nie wskazuje, czy interfejs Address Validation API wprowadził jakiekolwiek zmiany w danych wejściowych, np. poprawił pisownię.

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

W tej sekcji opisujemy flagi bezpieczeństwa w danych USPS dotyczące sztucznie utworzonych adresów. To zabezpieczenie ma zapobiegać sztucznemu tworzeniu list adresów. Wykrywa ono, kiedy przesłany adres wydaje się być utworzony sztucznie, a nie uzyskany w legalny sposób. Powinno to być bardzo rzadkie zjawisko.

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