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 w 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 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 - 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, New York, 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 wartości Y, w danych wejściowych musi być uwzględniona prawidłowa podstawa. 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ą tego 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.