Niniejszy dokument dotyczy weryfikacji adresu w Stanach Zjednoczonych:
- Korzystanie z danych USPS w przepływie pracy
- Pola weryfikacji punktu dostawy USPS (dpv)
- Komunikaty dotyczące bezpieczeństwa
Dane USPS w przepływie pracy
Do weryfikacji adresów w Stanach Zjednoczonych używana jest usługa Address Validation API. może też wypełniać część zwrotu uspsData.
Ten obiekt nie zawsze jest zapełniany, więc nie należy polegać na tym jako jedynego sposobu weryfikacji adresów, lecz zamiast tego zastosuj jak również dokonywać diagnoz i adresów w swoim systemie.
Weryfikacja punktu dostawy USPS (DPV)
W ramach odpowiedzi uspsData
pole dpvConfirmation
zwraca jeden
informujący, czy dostawca USPS może dostarczyć przesyłki 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 czterech wartości dpvConfirmation
lub nie zwraca
nie zwraca żadnej wartości dpvConfirmation
. W tabeli poniżej znajdziesz zalecane działania
zachowanie, którego logika powinna używać w przypadku każdego z 5 możliwych wyników. Więcej
na temat tej logiki, zob.
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 lokalu na podanej ulicy (trasie) i nie można jej dostarczyć. |
D |
Popraw adres |
Adres został potwierdzony wyłącznie przez DPV wyłącznie dla numeru głównego,
brakowało dodatkowego numeru. |
S |
Potwierdź adres |
Adres został potwierdzony wyłącznie przez DPV wyłącznie dla numeru głównego, podano dodatkowy numer, który nie został potwierdzony. Oznacza to, że wpisany numer nieruchomości istnieje na podanej trasie, ale podany element podrzędny nie istnieje w tym budynku, na USPS. |
T |
Zaakceptuj adres |
Potwierdzono adres DPV jako numer główny i numery dodatkowe. To oznacza, że adres może w całości dostarczyć USPS, łącznie z (w stosownych przypadkach) pod numerem lokalu. |
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
To bardzo silny sygnał, że lokalny numer nie istnieje. na tej trasie. Tak jak w przypadku innych problematycznych adresów, system powinien: użytkownika w celu uzyskania poprawek.
Przykład DPV D – popraw adres
W tym przykładzie użyto biura Google w Nowym Jorku, ale nie zawiera obiektu podrzędnego, który jest wymaganą częścią adresu. Możesz to sprawdzić, używając adres 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. Uzyskiwanie dostępu do DPV
Y, jako część danych wejściowych należy uwzględnić prawidłową podstawę podrzędną. Przykład:
możesz dołączyć prawidłowy lokal podrzędny FL 4 (4th Floor), aby uzyskać
Wartość Y: dpvConfirmation
.
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
- Region: Stany Zjednoczone
- Pole
dpvConfirmation
zwraca wartość:S
Oznacza to, że mimo że 1600 Amphitheatre Parkway istnieje jako adres, przyjmuje pocztę, obiekt podrzędny Ste 101 nie jest prawidłową częścią adresu. System powinien potwierdzić te informacje z użytkownikiem i podać do wprowadzenia korekty.
Przykład DPV Y – zaakceptuj adres
W tym przykładzie użyto adresu Googlepleksu w Mountain View w Kalifornii jako adresu e-mail o znanej 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. Dzięki temu możesz masz pewność, że interfejs API zwrócił adres dobrej jakości i możesz go użyć jak podano.
Uwaga: DPV nie wskazuje, czy interfejs Address Validation API wprowadził zmian w danych wejściowych, na przykład korekty pisowni.
Wiadomości dotyczące bezpieczeństwa w Stanach Zjednoczonych
Ta sekcja obejmuje flagi bezpieczeństwa dostarczane w danych USPS dla: sztucznie utworzone adresy. Ma to na celu zapobieganie sztuczne tworzenie listy adresów przez wykrywanie, czy przesłany adres został przesłany zostały zbudowane sztucznie i nie zostały uzyskane w sposób zgodny z prawem. Taka sytuacja powinna być bardzo rzadka.
Gdy USPS rozpozna sztucznie utworzony adres, errorMessage
właściwości uspsData odpowiedzi zawiera element
z opisem problemu. 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.