Niniejszy dokument zawiera informacje na temat sprawdzania poprawności adresu w Stanach Zjednoczonych:
- Używanie danych USPS w przepływie pracy
- Pola weryfikacji punktu dostawy USPS (dpv)
- Wiadomości zabezpieczające
Dane USPS w Twoim przepływie pracy
Podczas weryfikowania adresów w Stanach Zjednoczonych usługa Address Review API może też wypełniać zwracaną część uspsData.
Ten obiekt nie zawsze jest wypełniony, dlatego nie należy korzystać z tej właściwości jako jedynego sposobu weryfikacji adresów. Zamiast tego włącz też ocenę i komponenty adresu do swojego systemu.
Weryfikacja punktu dostawy USPS (DPV)
W odpowiedzi uspsData
pole dpvConfirmation
zwraca jeden znak informujący o tym, czy USPS może dostarczyć przesyłkę pod podany adres.
Za pomocą tego pola możesz określić:
- prawidłowość adresu.
- jeśli w adresie nie podano numeru lokalnego.
- jeśli tego numeru nie ma w systemie danych USPS.
Usługa zwraca jedną z 4 wartości dpvConfirmation
lub w ogóle nie zwraca wartości dpvConfirmation
. Poniższa tabela przedstawia zalecane zachowanie Twojej logiki w przypadku każdego z 5 możliwych wyników. Więcej informacji na ten temat 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. Oznacza to, że USPS nie rozpoznaje podanego numeru lokalu, który znajduje się na podanej ulicy (trasie) i nie może dostarczyć na niej dostawy. |
D |
Popraw adres |
Adres został potwierdzony tylko w DPV dla numeru podstawowego i brakuje dodatkowych informacji o numerze. |
S |
Potwierdź adres |
Adres został potwierdzony tylko w DPV jako numer główny, a dodatkowe informacje o numerze były dostępne, ale nie zostały potwierdzone. Oznacza to, że podany numer budynku istnieje na podanej trasie, ale według USPS w tym budynku nie ma podanego podrzędnego miejsca. |
T |
Zaakceptuj adres |
Potwierdzono adres DPV dla numerów głównych i dodatkowych. Oznacza to, że adres jest w całości dostarczany przez USPS, wraz z numerem lokalu lokalnego, jeśli jest dostępny. |
W pozostałej części tej sekcji omawiamy rzeczywiste scenariusze, w których wykorzystywane są kody DPV.
Przykład DPV N – jak poprawić adres
W tym przykładzie użyto nieistniejącego numeru budynku pod innym prawidłowym adresem.
- Podano adres: 12 Amphitheatre Parkway, Mountain View, CA 94043, USA
- Region: USA
- Pole
dpvConfirmation
zwraca wartość:N
To bardzo silny sygnał, że tego numeru nie ma na tej trasie. Podobnie jak w przypadku innych problematycznych adresów, Twój 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 zawiera on siedziby, która jest wymaganą częścią adresu. Aby to sprawdzić, użyj adresu w prezentacji bez podstawowych informacji.
- Podano adres: ul. Główna 111, Warszawa, woj. mazowieckie
- Region: USA
- Pole
dpvConfirmation
zwraca wartość:D
Jest to potwierdzenie, że w danych wejściowych brakuje środowiska podrzędnego. Aby można było uzyskać DPV o wartości Y, dane wejściowe muszą zawierać prawidłowe podzasłony. Możesz na przykład dołączyć prawidłowe podzastrzenie FL 4 (4th Floor), aby uzyskać wartość dpvConfirmation
o wartości Y.
Przykład DPV S – potwierdź adres
W tym przykładzie użyto numeru budynku, który nie istnieje w budynku:
- Podany adres: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA 94043, USA
- Region: USA
- Pole
dpvConfirmation
zwraca wartość:S
Oznacza to, że chociaż 1600 Amphitheatre Parkway istnieje jako adres umożliwiający odbieranie poczty, lokalny adres Ste 101 nie jest prawidłową częścią adresu. System powinien potwierdzić te informacje z użytkownikiem i zapewnić możliwość wprowadzenia korekty.
Przykład DPV Y – zaakceptuj adres
W tym przykładzie używany jest adres Googlepleks w Mountain View w Kalifornii, znany jako adres wysokiej jakości.
- Podany adres: 1600 Amphitheatre Parkway, Mountain View, CA 94043, USA
- Region: USA
- Pole
dpvConfirmation
zwraca wartość:Y
Adres jest w całości dostarczany przez USPS. Zapewnia to bardzo wysoki stopień pewności, że interfejs API zwrócił adres dobrej jakości, a Ty możesz go używać w takiej postaci, w jakiej został on udostępniony.
Uwaga: DPV nie wskazuje, czy interfejs Address Verificationation API wprowadził jakiekolwiek zmiany w danych wejściowych, np. poprawienie pisowni.
Wiadomości dotyczące bezpieczeństwa dla adresów w USA
W tej sekcji omawiamy flagi bezpieczeństwa udostępniane w danych USPS w przypadku sztucznych adresów. Ma to na celu zapobieganie sztucznemu tworzeniu listy adresów przez wykrywanie przypadków, w których wydaje się, że przesyłany adres został skonstruowany sztucznie i nie został 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 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.