Obsługa adresów w Stanach Zjednoczonych

Niniejszy dokument dotyczy weryfikacji adresu w Stanach Zjednoczonych:

Dane USPS w przepływie pracy

Podczas weryfikowania adresów w Stanach Zjednoczonych usługa interfejsu Address Validation API może też wypełniać część zwracanej wartości uspsData.

Ten obiekt nie zawsze jest zapełniany, dlatego nie używaj tej właściwości jako jedynego sposobu weryfikacji adresów. Zamiast tego uwzględnij w swoim systemie komponenty oceny i adresu.

Weryfikacja punktu dostawy USPS (DPV)

W odpowiedzi uspsData pole dpvConfirmation zwraca 1 znak informujący o tym, czy USPS może dostarczyć przesyłkę pod podany adres.

W tym polu możesz określić:

  • i prawidłowe działanie adresu.
  • jeśli w adresie brakuje numeru lokalu podrzędnego.
  • , jeśli w systemie danych USPS nie ma numeru lokalu podrzędnego.

Usługa zwraca jedną z 4 wartości dpvConfirmation lub w ogóle nie zwraca wartości dpvConfirmation. Tabela poniżej przedstawia zalecane działanie, którego powinna użyć funkcja logiczna 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 Używanie odpowiedzi weryfikacyjnej.

Wartość

Zachowanie

Opis

N lub pusta

Popraw adres

Adres nie został potwierdzony przez DPV.

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

D

Popraw adres

Adres został potwierdzony tylko przez DPV tylko dla numeru głównego, a także brakuje informacji o numerze dodatkowym.

Oznacza to, że wpisany numer nieruchomości znajduje się przy podanej ulicy. Aby jednak podać w pełni zweryfikowany adres lub dostarczyć go do dostawy, musisz też podać prawidłowy numer obiektu podrzędnego. Inaczej mówiąc, w danych wejściowych brakowało elementu podrzędnego.

S

Potwierdź adres

Adres został potwierdzony tylko w przypadku numeru głównego, a informacje o numerze dodatkowym były dostępne, ale nie zostały potwierdzone.

Oznacza to, że podany numer lokalu istnieje na podanej trasie, ale zgodnie z USPS podany obiekt podrzędny nie istnieje w tym budynku.

T

Zaakceptuj adres

Potwierdzono adres DPV jako numer główny i numery dodatkowe.

Oznacza to, że adres może być w całości dostarczany przez USPS (w tym pod numer lokalny, jeśli ma to zastosowanie).

W pozostałej części tej sekcji omawiamy rzeczywiste scenariusze wykorzystujące kody DPV.

Przykład DPV N – popraw adres

W tym przykładzie użyto nieistniejącego numeru budynku dla adresu, który jest prawidłowy.

  • Podany adres: 12 Amphitheatre Parkway, Mountain View, CA 94043, USA
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca wartość: N

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

Przykład DPV D – popraw adres

W tym przykładzie korzystamy z biura Google w Nowym Jorku, ale nie zawieramy lokalu, który jest wymaganą częścią adresu. Aby to sprawdzić, użyj adresu w wersji demonstracyjnej bez informacji o lokalizacji podrzędnej.

  • Podany adres: Emilii Plater 23, 00-113 Warszawa
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca wartość: D

Jest to potwierdzenie, że w danych wejściowych nie ma elementu podrzędnego. Aby można było przejść do Y DPV, należy uwzględnić w danych wejściowych prawidłowe założenie podrzędne. Możesz na przykład uwzględnić prawidłowe zamówienie podrzędne FL 4 (4th Floor), aby uzyskać wartość dpvConfirmation Y.

Przykład DPV S – potwierdź adres

W tym przykładzie korzystamy z numeru budynku podrzędnego, który nie istnieje w budynku:

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

Oznacza to, że chociaż istnieje pod adresem 1600 Amphitheatre Parkway, podmiot podrzędny Ste 101 nie jest prawidłową częścią tego adresu. System powinien potwierdzić te informacje z użytkownikiem i umożliwić wprowadzenie poprawek.

Przykład DPV Y – zaakceptuj adres

W tym przykładzie adres Googlepleksu w Mountain View w Kalifornii to adres o znacznej jakości.

  • Podany adres: 1600 Amphitheatre Parkway, Mountain View, CA 94043, USA
  • Region: Stany Zjednoczone
  • Pole dpvConfirmation zwraca wartość: Y

Adres jest w całości dostarczany przez USPS. Daje to bardzo wysoki stopień pewności, że interfejs API zwrócił adres dobrej jakości, i możesz go używać w podanej formie.

Uwaga: DPV nie wskazuje, czy interfejs Address Validation API wprowadził jakieś zmiany w danych wejściowych, na przykład poprawiono pisownię.

Wiadomości dotyczące bezpieczeństwa w Stanach Zjednoczonych

W tej sekcji znajdziesz informacje o flagach bezpieczeństwa udostępnianych w danych USPS w przypadku adresów utworzonych sztucznie. Ma to na celu zapobieganie sztucznemu tworzeniu list adresów przez wykrywanie, czy przesłany adres wygląda na sztuczny, a nie uzyskany w sposób zgodny z prawem. Taka sytuacja powinna być bardzo rzadka.

Gdy USPS wykryje sztucznie utworzony adres, pole errorMessage 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.