Obsługa adresów w Stanach Zjednoczonych

Ten dokument dotyczy weryfikacji adresów w Stanach Zjednoczonych:

Dane USPS w przepływie pracy

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

Ten obiekt nie zawsze jest wypełniony, więc nie należy polegać na tej właściwości jako jedynym sposobie sprawdzania poprawności adresów. Zamiast tego należy uwzględnić w systemie również 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.

To pole pozwala określić:

  • ważność 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 działanie, które Twoja logika powinna zastosować 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 niczego nie zawiera

Poprawianie adresu

Adres nie został potwierdzony przez DPV.

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

D

Poprawianie adresu

Adres został potwierdzony przez DPV tylko w przypadku numeru głównego, a brakowało informacji o numerze dodatkowym.

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

S

Potwierdź adres

Adres został potwierdzony przez DPV tylko w przypadku numeru głównego, a informacje o numerze dodatkowym były obecne, ale nie zostały potwierdzone.

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 przez DPV pod kątem numerów głównych i dodatkowych.

Oznacza to, że adres jest w pełni dostarczalny przez USPS, w tym numer lokalu, jeśli dotyczy.

W pozostałej części tej sekcji omówiono 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 ulicy w prawidłowym adresie.

  • Wpisany adres: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • Region: USA
  • 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 poprawki.

DPV D example - fix the address

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

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

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

DPV S example - confirm the address

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: USA
  • Pole dpvConfirmation zwraca: S

Oznacza to, że chociaż adres 1600 Amphitheatre Parkway istnieje i można pod niego wysyłać pocztę, to lokal Ste 101 nie jest prawidłową częścią adresu. Twój system powinien potwierdzić te informacje u użytkownika i umożliwić ich poprawienie.

Przykład DPV Y – zaakceptuj adres

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

  • Wpisany adres: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Region: USA
  • 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 dobrej jakości i możesz go użyć w podanej postaci.

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

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

W tej sekcji opisano flagi zabezpieczeń podane w danych USPS dla sztucznie utworzonych adresów. To zabezpieczenie ma na celu zapobieganie sztucznemu tworzeniu listy adresów przez wykrywanie, kiedy przesłany adres wydaje się być utworzony sztucznie, a nie uzyskany w legalny sposób. Taka potrzeba jest jednak mało prawdopodobna.

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