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.