Omówienie interfejsu Validation API

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

Address Validation API to usługa, która przyjmuje adres. Identyfikuje i weryfikuje jego komponenty. Standaryzuje też adres na potrzeby poczty i znajduje dla niego najlepiej dopasowane współrzędne szerokości i długości geograficznej. Opcjonalnie w przypadku adresów w Stanach Zjednoczonych i Portoryko możesz włączyć system CASS™ (Coding Accuracy Support System).

Dlaczego warto korzystać z Address Validation API

Dzięki Address Validation API możesz zwiększyć przewidywalność dostaw i zmniejszyć liczbę nieudanych dostaw, co pozwoli Ci poprawić wrażenia klientów. Możesz to zrobić, wykrywając nieprawidłowe adresy i lepiej poznając ich cechy.

Inne uwagi

Address Validation API weryfikuje poprawność adresów. Geocoding API konwertuje adresy na współrzędne szerokości i długości geograficznej. Szczegółowe porównanie znajdziesz w artykule Building location validation capability using Google Maps Platform w Centrum architektury.

Jeśli nie musisz weryfikować poszczególnych komponentów adresu lub potrzebujesz szczegółowych informacji o lokalizacji, takich jak wejścia do budynku, jego obrys i punkty nawigacyjne, lepszym rozwiązaniem może być Geocoding API.

W Geocoding API w wersji 4 wprowadziliśmy metodę SearchDestinations, która zwraca współrzędne wejść do budynku, punktów nawigacyjnych i obrysów budynków. Więcej informacji znajdziesz w sekcji Wyszukiwanie miejsc docelowych w Geocoding API w wersji 4.

Co możesz robić za pomocą Address Validation API

Wypróbuj wersję demonstracyjną

Dzięki Address Validation API możesz sprawdzić, czy adres odnosi się do rzeczywistego miejsca. Jeśli adres nie odnosi się do rzeczywistego miejsca, interfejs API może zidentyfikować prawdopodobnie nieprawidłowe komponenty, które możesz przedstawić klientom do poprawy. Oto przykładowy proces korzystania z interfejsu API:

  1. Klient wpisuje adres – na ilustracji poniżej widać podstawowy formularz, w którym klient może wpisać adres, np. w ramach procesu płatności.

  2. Aplikacja wysyła adres do interfejsu API – aplikacja przekazuje ten adres jako dane wejściowe do Address Validation API.

    Adres wpisany przez klienta.

  3. Interfejs API weryfikuje i standaryzuje adres – w odpowiedzi Address Validation API zwraca pełny adres określony przez interfejs API lub wskazuje, gdzie brakuje informacji.

  4. Klient potwierdza lub poprawia adres – w zależności od tego, co zwraca interfejs API, możesz wyświetlić klientowi te prośby: A. Potwierdź zalecany adres. B. Podaj brakujące informacje. C. Popraw adres.

    Poproś klienta o potwierdzenie adresu określonego przez interfejs API.Poproś klienta o wpisanie brakujących informacji o adresie. Poproś klienta o poprawienie danych adresowych.

Jak działa Address Validation API

Usługa weryfikacji adresu akceptuje żądanie POST z adresem w postaci treści JSON. Dzieli adres na poszczególne komponenty, a następnie wykonuje te czynności:

  • Poprawia – przeprowadza kontrole weryfikacji na poziomie komponentów, w tym weryfikację podlokalizacji, jeśli są dostępne.
  • Uzupełnia – próbuje wywnioskować brakujące lub nieprawidłowe komponenty adresu.
  • Formatuje – czyści i standaryzuje format komponentów adresu.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w Address Validation API oraz zwracanych przez nie danych. Szczegółowe informacje znajdziesz w dokumentacji Address Validation API.

Zasoby danych Zwracane dane

Komponenty adresu w formacie JSON.

Zobacz Weryfikowanie adresu.

Pełny, zweryfikowany adres (jeśli to możliwe).

Stan weryfikacji każdego komponentu adresu.

Jeśli są dostępne dla adresu:

  • Kod geograficzny
  • Dokładność adresu
  • Dane usług pocztowych, jeśli są dostępne.

Zobacz Interpretowanie odpowiedzi weryfikacji.

Jak korzystać z Address Validation API

1 Wypróbuj wersję demonstracyjną Wypróbuj wersję demonstracyjną z różnymi formularzami adresowymi, zarówno prawidłowymi, jak i nieprawidłowymi. Wersja demonstracyjna to przydatny sposób na zapoznanie się zarówno z wartościami zwracanymi przez usługę, jak i z odpowiedzią interfejsu API w formacie JSON.
2 Sprawdź dostępność Sprawdź szczegóły dostępności aby dowiedzieć się, które kraje i regiony są obsługiwane przez Address Validation API.
3 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i wykonaj kolejne instrukcje.
4 Poproś o weryfikację adresu Zacznij od podstawowego adresu, a następnie, aby zwiększyć dokładność, możesz włączyć CASS (tylko w przypadku adresów w Stanach Zjednoczonych i Portoryko). Zobacz Przesyłanie prośby o weryfikację adresu.
5 Przetwarzanie odpowiedzi Odpowiedź Address Validation API zawiera 2 właściwości, z których każda jest używana na różne sposoby. Zobacz Interpretowanie podstawowej odpowiedzi.
6 Zwiększanie dokładności weryfikacji Możesz pomóc w zwiększeniu dokładności adresu, przesyłając opinie na temat odpowiedzi Address Validation API. Zobacz Obsługa zaktualizowanych adresów.

Dostępne biblioteki klienta

Listę dostępnych bibliotek klienta Address Validation API znajdziesz w sekcji Biblioteki klienta.

Informacje o CASS™

Amerykańska służba pocztowa (USPS®)1 utrzymuje system CASS™ (Coding Accuracy Support System) aby wspierać i certyfikować dostawców usług weryfikacji adresów. Usługa z certyfikatem CASS™, taka jak Address Validation API, została potwierdzona pod kątem możliwości uzupełniania brakujących informacji w adresie, standaryzowania go i aktualizowania, aby zapewnić najbardziej aktualny i dokładny adres.

CASS nie jest domyślnie włączony i jest obsługiwany tylko w regionach „US” i „PR”. Aby włączyć CASS, ustaw wartość enableUspsCass na true w ramach żądania weryfikacji. Więcej informacji znajdziesz w artykule Weryfikowanie adresu.

W ramach korzystania z usług USPS ta organizacja ocenia żądania dotyczące sztucznie utworzonych adresów. Jeśli USPS stwierdzi, że adres wejściowy został utworzony sztucznie, Google musi zaprzestać weryfikowania adresów dla klienta i przekazać USPS informacje kontaktowe klienta (imię i nazwisko oraz adres), odpowiedni adres wejściowy i zagregowane dane o użytkowaniu. Korzystając z interfejsu API, wyrażasz zgodę na te warunki dodatkowe.

Co dalej?

  1. Google Maps Platform jest niewyłącznym licencjobiorcą Amerykańskiej Służby Pocztowej(United States Postal Service®). Poniższe znaki towarowe są własnością Amerykańskiej Służby Pocztowej i są używane za jej zgodą: United States Postal Service®, CASS™, CASS Certified™. ↩