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
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. |
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.