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 interfejs Address Validation API może też wypełnić część uspsData zwracanej odpowiedzi.

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 żadnej wartości dpvConfirmation. W tabeli poniżej znajdziesz zalecane zachowanie logiki w przypadku każdego z 5 możliwych wyników. Więcej informacji o tej logice znajdziesz w sekcji Omówienie przepływu pracy w artykule Tworzenie logiki weryfikacji.

Wartość

Zachowanie

Opis

N

lub puste

Poprawianie adresu

Adres nie został potwierdzony przez DPV.

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

D

Poprawianie adresu

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

Oznacza to, że wpisany 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 - fix the address

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 podteza. Możesz na przykład podać prawidłowy podlokal, np. FL 4 (4. piętro), aby uzyskać wartość dpvConfirmation 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 adres 1600 Amphitheatre Parkway istnieje i można na niego wysyłać pocztę, ale lokal Ste 101 nie jest prawidłową częścią adresu. System powinien potwierdzić te informacje z użytkownikiem i umożliwić mu wprowadzenie poprawek.

DPV Y example - accept the address

W tym przykładzie jako znanego adresu o wysokiej jakości używamy adresu Googleplex w Mountain View w Kalifornii.

  • 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 dużą pewność, że interfejs API zwrócił adres o dobrej jakości, i możesz go używać w takiej postaci, w jakiej został zwrócony.

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.