Omówienie interfejsu Address Validation API

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Address Validation API to usługa, która akceptuje adres, identyfikuje komponenty i je weryfikuje. Pozwala także ujednolicić adres korespondencyjny i znaleźć dla niego najlepszą lokalizację. Może ona pomóc w ustaleniu, czy adres dotyczy prawdziwego miejsca. Jeśli adres nie odnosi się do rzeczywistego miejsca, może zidentyfikować potencjalnie nieprawidłowe komponenty, co umożliwia użytkownikom ich poprawienie.

Interfejs API do weryfikacji adresów udostępnia wiele funkcji, które ułatwiają przetwarzanie adresu, w tym:

  • Dzieli adres na poszczególne komponenty, a następnie przeprowadza weryfikację na poziomie komponentu, w tym lokale (jeśli są dostępne).

  • Oczyszcza, ustandaryzuje i wykrywa brakujące lub nieprawidłowe elementy adresu.

  • uzupełni adres dodatkowymi informacjami, w tym danymi geograficznymi, danymi adresowymi i danymi usług pocztowych.

  • Zwraca pojedynczy ciąg zawierający pełny adres określony przez interfejs API.

Wypróbuj wersję demonstracyjną, aby zobaczyć ten interfejs w praktyce.

Dodawanie interfejsu Address Validation API do przepływu pracy

Interfejs API do weryfikacji adresów jest jednym z najczęstszych przypadków, gdy warto poprawić wrażenia klientów, upewniając się, że klient podał poprawny adres. Weryfikacja adresów pomaga ograniczyć liczbę niedostarczanych błędów, wykrywając złe adresy i polepsza ich przewidywalność dzięki lepszej znajomości cech adresów.

Poniższa ilustracja przedstawia prosty formularz umożliwiający klientowi wprowadzenie adresu, prawdopodobnie w ramach procesu płatności. Prześlij ten adres jako dane wejściowe do interfejsu Address Validation API.

Adres wpisany przez klienta.

W odpowiedzi interfejs Address Validation API zwraca pełny adres określony przez interfejs API. Pokaż klientowi pełny adres jako zalecany:

Adres określony przez interfejs API.

Jeśli interfejs Address Validation API wykryje brakujące informacje, poproś użytkownika o ich dodanie:

Formularz prośby o podanie brakujących danych adresowych klienta.

Jeśli interfejs API nie może zweryfikować adresu wejściowego z powodu brakujących lub nieprawidłowych informacji, poproś użytkownika o rozwiązanie problemu:

Formularz z prośbą o poprawienie danych adresowych klienta.

Rozbieżności między interfejsem Address Validation API i interfejsem Geocode API

Zarówno interfejs API kodowania danych geograficznych, jak i interfejs API do weryfikacji adresów próbują znaleźć odpowiedź na pytanie „jaka lokalizacja będzie najlepsza dla danych wejściowych użytkownika?”. W przeciwieństwie do interfejsu Geocoding API interfejs do weryfikacji adresów sprawdza też:

  • Odpowiedz na pytanie „Czy ten wpis użytkownika zawiera prawdziwy adres?”.
  • Interpretuj adres wejściowy nawet wtedy, gdy nie można dopasować jego części do dostępnych danych
  • Prześlij opinię na temat poprawności różnych komponentów
  • Sprawdź, czy adres jest kompletny, i wskaż wszystkie brakujące komponenty.
  • Sformatować adres zwracany wyłącznie na potrzeby korespondencji

Jeśli na przykład adres to „ul. Zachodnia 123, Gdańsk”, to interfejs API kodowania danych geograficznych zwróci dane geograficznie dotyczące Wrocławia,

Natomiast interfejs API do weryfikacji adresów rozpoznaje, z kolei, że „123” to numer domu, „Fałszywy St” to ulica i zwraca wynik, który zawiera te komponenty i oznacza je jako niepotwierdzone, co daje sygnał o tym, że dane adresowe zawierają błędy dotyczące geokodowania.

Informacje o CASSTM

Amerykański urząd pocztowy [PSPS®]1 utrzymuje system kodowania pomocy w zakresie kodowania (CSSTM), aby wspierać i certyfikować dostawców weryfikacji adresów. Usługa CASS CertifiedTM, taka jak Address Validation API, została potwierdzona, ponieważ umożliwia wypełnianie informacji brakujących w adresie, standaryzację i aktualizację w celu dostarczania najnowszego i najdokładniejszego adresu.

Certyfikat CASS nie jest domyślnie włączony i obsługiwany tylko w regionach „US” i „PR”. Aby włączyć CASS, ustaw enableUspsCass jako true w ramach prośby o weryfikację. Więcej informacji znajdziesz w artykule Weryfikowanie adresu.

USPS korzysta z naszych usług i rozpatruje prośby o sztuczne adresy. Jeśli USPS zidentyfikuje adres wejściowy jako sztucznie utworzony, Google musi zatrzymać weryfikację adresów klienta i podać nam jego dane kontaktowe, imię i nazwisko, adres oraz dane zbiorcze (dane dotyczące użytkowania). Korzystając z interfejsu API, wyrażasz zgodę na te szczegółowe warunki korzystania z usługi.

Co dalej?


  1. Google Maps Platform jest niewyłącznym licencjobiorcą Stanów Zjednoczonych Poczty®®. Te znaki towarowe należą do amerykańskiej Poczty Pocztowej® i są używane za zgodą: amerykańska usługa pocztowa ®, CASSTM, CASS CertifiedTM.