Obsługa adresów w Stanach Zjednoczonych

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

Dane USPS w automatyzacji

Podczas weryfikacji adresów w Stanach Zjednoczonych interfejs Address Validation API może też wypełnić część uspsData zwracanej odpowiedzi.

Ponieważ ten obiekt nie zawsze jest wypełniony, 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 komponenty 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ę pod podany adres.

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

  • czy adres jest prawidłowy;
  • czy w adresie brakuje numeru lokalu;
  • czy 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 zalecane zachowanie, które powinna stosować Twoja logika w przypadku każdego z 5 możliwych wyników. Więcej informacji o tej logice znajdziesz w sekcji Omówienie automatyzacji w artykule Tworzenie logiki weryfikacji.

Wartość

Zachowanie

Opis

N

lub puste

Popraw adres

Nie udało się potwierdzić adresu za pomocą DPV.

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

D

Popraw adres

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

Oznacza to, że podany numer lokalu istnieje na podanej ulicy, ale aby uzyskać w pełni zweryfikowany adres, pod który można dostarczyć przesyłkę, należy podać prawidłowy numer lokalu. Innymi słowy, w danych wejściowych brakowało numeru lokalu.

S

Potwierdź adres

Adres został potwierdzony za pomocą DPV tylko w przypadku numeru podstawowego, a informacje o numerze dodatkowym były obecne, ale nie zostały potwierdzono.

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

T

Zaakceptuj adres

Adres został potwierdzony za pomocą DPV w przypadku numeru podstawowego i wszystkich numerów dodatkowych.

Oznacza to, że USPS może w pełni dostarczyć przesyłkę pod ten adres, w tym pod numer lokalu, jeśli dotyczy.

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

Przykład DPV N – popraw adres

W tym przykładzie używamy nieistniejącego numeru domu w innym przypadku prawidłowego adresu.

  • Wpisany adres: 12 Amphitheatre Parkway, Mountain View, CA, 94043, USA
  • 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 adresów, w których występują problemy, Twój system powinien poprosić użytkownika o wprowadzenie poprawek.

Przykład DPV D – popraw adres

W tym przykładzie używamy biura Google w Nowym Jorku, ale nie zawiera ono numeru lokalu, który jest wymaganą częścią adresu. Możesz to sprawdzić, używając adresu w wersji demonstracyjnej bez informacji o numerze lokalu.

  • Wpisany adres: 111 8th Avenue, New York, NY, 10011, USA
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca: D

Potwierdza to, że w danych wejściowych brakowało numeru lokalu. Aby uzyskać wartość DPV równą Y, w danych wejściowych należy podać prawidłowy numer lokalu. Możesz na przykład podać prawidłowy numer lokalu FL 4 (4. piętro), aby uzyskać wartość dpvConfirmation równą Y.

Przykład DPV S – potwierdź adres

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

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

Wskazuje to, że adres 1600 Amphitheatre Parkway istnieje i można pod niego dostarczać przesyłki, ale numer lokalu Ste 101 nie jest prawidłową częścią adresu. Twój system powinien potwierdzić te informacje z użytkownikiem i umożliwić wprowadzenie poprawek.

Przykład DPV Y – zaakceptuj adres

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

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

USPS może w pełni dostarczyć przesyłkę pod ten adres. Daje to bardzo dużą pewność, że interfejs API zwrócił adres dobrej jakości, i możesz go użyć w takiej postaci.

Uwaga: 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 Stanach Zjednoczonych

Ta sekcja zawiera informacje o flagach bezpieczeństwa podawanych w danych USPS w przypadku adresów utworzonych sztucznie. To zabezpieczenie ma zapobiegać sztucznemu tworzeniu listy adresów przez wykrywanie, kiedy przesłany adres wydaje się być utworzony sztucznie, a nie uzyskany w sposób legalny. Powinno to być bardzo rzadkie.

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